# HG changeset patch
# User Paul Boddie <paul@boddie.org.uk>
# Date 1532354614 -7200
# Node ID 04558a6a6219ce9028c89d848add6aac05aef23f
# Parent  fe4054485f21caba4ef3b73976e26a9273b688c9
Improved the comments slightly.

diff -r fe4054485f21 -r 04558a6a6219 moinformat/parsers/moin.py
--- a/moinformat/parsers/moin.py	Tue Jul 17 23:30:23 2018 +0200
+++ b/moinformat/parsers/moin.py	Mon Jul 23 16:03:34 2018 +0200
@@ -489,7 +489,9 @@
                                 group("args", ".*?"), "\n")),                   # text-excl-nl
 
         # Region contents:
-        # Line-oriented patterns:
+
+        # Line-oriented patterns support features which require their own
+        # separate lines.
 
         "break"         : r"^(\s*?)\n",                                         # blank line
 
@@ -541,7 +543,10 @@
         "tablerow"      : r"^\|\|",                                             # ||
 
         # Region contents:
-        # Inline patterns:
+
+        # Inline patterns are for markup features that appear within blocks.
+        # The patterns below start inline spans that can contain other markup
+        # features.
 
         "fontstyle"     : group("style", repeat("'", 2, 6)),                    # ''...
         "larger"        : r"~\+",                                               # ~+
@@ -553,14 +558,15 @@
         "super"         : r"\^",                                                # ^
         "underline"     : r"__",                                                # __
 
-        # Complete inline patterns:
+        # Complete inline patterns are for markup features that do not support
+        # arbitrary content within them:
 
         "link"          : join((r"\[\[",                                        # [[
                                 group("target", ".*?"),                         # target
                                 optional(join((r"\|", group("text", ".*?")))),  # | text (optional)
                                 "]]")),                                         # ]]
 
-        # Inline contents:
+        # Ending patterns for inline features:
 
         "largerend"     : r"\+~",                                               # +~
         "monospaceend"  : r"`",                                                 # `
@@ -623,7 +629,7 @@
 
 
 
-    # Pattern details.
+    # Patterns available within certain markup features.
 
     table_pattern_names = [
         "attrname", "colour", "colspan", "halign", "rowspan", "tableattrsend",