Version 2.0.0

Signed-off-by: Miek Gieben <[email protected]>

Author: miekg

Diff for: README.md

@@ -14,7 +14,8 @@ It provides an advanced markdown dialect that processes file(s) to produce inter
 [RFC 7991](https://tools.ietf.org/html/rfc7991) format. Mmark can produce xml2rfc (aforementioned
 RFC 7991), RFC 7749 (xml2rfc version 2) and HTML5 output.
 
-Example RFCs can be [found in the Github repository](https://github.com/mmarkdown/mmark/tree/master/rfc).
+Example RFCs in Mmark format can be [found in the Github
+repository](https://github.com/mmarkdown/mmark/tree/master/rfc).
 
 Mmark uses [gomarkdown](https://github.com/gomarkdown/markdown) which is a fork of
 [blackfriday](https://github.com/russross/blackfriday/).
@@ -38,8 +39,8 @@ Mmark adds the following syntax elements to
 * [Document divisions](https://mmark.nl/syntax#document-divisions).
 * [Captions](https://mmark.nl/syntax#captions) for code, tables and quotes
 * [Asides](https://mmark.nl/syntax#asides).
-* [Figures and Subfigures](https://mmark.nl/syntax#figures-and-subfigures) - this syntax is still under consideration as is
-  "do we really need this?"
+* [Figures and Subfigures](https://mmark.nl/syntax#figures-and-subfigures) - bundle (sub)figures
+  into a larger figure.
 * [Block Level Attributes](https://mmark.nl/syntax#block-level-attributes) that allow to specify attributes, classes and
   IDs for elements.
 * [Indices](https://mmark.nl/syntax#indices) to mark an item (and/or a subitem) to be referenced in the document index.
@@ -88,7 +89,7 @@ cd rfc
 make txt
 ~~~
 
-For v2 (i.e. the current (2018) way a making RFC), just run:
+For v2 (i.e. the current (2018) way of making RFC), just run:
 ~~~ sh
 cd rfc
 make TWO="yes" txt

Diff for: Syntax.md

@@ -5,10 +5,9 @@ aliases: [/syntax/]
 toc: true
 ---
 
-This is version 2 of [Mmark](https://github.com/mmarkdown/mmark):
-based on a [new markdown implementation](https://github.com/mmarkdown/markdown)
-and some (small) language changes as well. We think these language changes lead to a more consistent
-user experience and lead to less confusion.
+This is version 2 of [Mmark](https://github.com/mmarkdown/mmark): based on a [new markdown
+implementation](https://github.com/mmarkdown/markdown) and some (small) language changes as well. We
+think these language changes lead to a more consistent user experience and lead to less confusion.
 
 See [changes from v1](#changes-from-version-1) if you're coming from version 1.
 
@@ -49,7 +48,7 @@ article](https://notes.peter-baumgartner.net/archive/content-organisation/blackf
 
 For the rest we build up on <https://github.com/gomarkdown/markdown> and support all syntax
 [it supports](https://github.com/gomarkdown/markdown/blob/master/README.md). We enable the following
-extensions by default:
+[extensions](https://github.com/gomarkdown/markdown/blob/master/README.md#extensions) by default:
 
 * *Strikethrough*, allow strike through text using `~~test~~`.
 * *Autolink*, detect embedded URLs that are not explicitly marked.
@@ -61,7 +60,7 @@ extensions by default:
 * *OrderedListStart*, notice start element of ordered list.
 * *Attributes*, allow block level attributes.
 * *Smartypants*, expand `--` and `---` into ndash and mdashes.
-* *SuperSubscript*, parse super and subscript: H~2~O is water and 2^10^ is 1024.
+* *SuperSubscript*, parse super- and subscript: H~2~O is water and 2^10^ is 1024.
 * *Tables*, parse tables.
 
 Mmark adds numerous enhancements to make it suitable for writing ([IETF](https://ietf.org)) Internet
@@ -80,10 +79,10 @@ Drafts and even complete books. It <strike>steals</strike> borrows syntax elemen
 
 Mmark adds:
 
-* (Extended) [title block](#title-block).
-* [Special sections](#special-sections).
+* (Extended) [title block](#title-block) to specify authors and IETF specific bits.
+* [Special sections](#special-sections), for abstracts or notes.
 * [Including other files](#including-files) with the option to specify line ranges, regular
-  expressions and/or prefix each line with a string.
+  expressions and/or prefix each line with a custom string.
 * [Document divisions](#document-divisions).
 * [Captions](#captions) for code, tables, quotes and subfigures.
 * [Asides](#asides).
@@ -177,8 +176,8 @@ Title Block:
     *Area* defaults to "Internet" and *Ipr* defaults to `trust200902`.
 
 BCP 14/RFC 2119 Keywords:
-:   If an RFC 2119 word is found enclosed in `**` it will be rendered normally
-    i.e. `**MUST**` becomes `MUST`.
+:   If an RFC 2119 word is found enclosed in `**` it will be rendered normally i.e. `**MUST**`
+    becomes `MUST`.
 
 Artwork/Source code:
 :   There is no such distinction so these will be rendered in the same way regardless.

Diff for: version.go

@@ -1,4 +1,4 @@
 package main
 
 // Version of mmark.
-var Version = "1.9.982"
+var Version = "2.0.0"