From a9781245b3f8973cb2253cfeb61955a31bb7c32e Mon Sep 17 00:00:00 2001
From: "Kyle J. McKay"
Date: Tue, 16 Feb 2021 17:30:50 -0700
Subject: [PATCH] Markdown.pl: update help description
Add missing conjunction.
Update example of document that fails with --raw-html but
not --raw-xml. With the recent changes, the old example
no longer fails. Use a different example that still fails.
Signed-off-by: Kyle J. McKay
---
Markdown.pl | 18 ++++++++----------
1 file changed, 8 insertions(+), 10 deletions(-)
diff --git a/Markdown.pl b/Markdown.pl
index 89ea554..bf20d72 100755
--- a/Markdown.pl
+++ b/Markdown.pl
@@ -4614,26 +4614,24 @@ optional closing tag semantics are activated during the validation
causing missing closing tags to be inserted where required by the
standard. Non-raw mode always enables these semantics.
-This will transform HTML into valid XHTML fail with an error message.
+This will transform HTML into valid XHTML or fail with an error message.
Unfortunately, it will also fail to accept some documents that
the plain B<--raw-xml> option will.
For example, this document:
-
+ a
-Will be rejected because upon encountering the C<< >> open
-tag a closing C<< >> will automatically be inserted resulting
+Will be rejected because upon encountering the C<<
>> open
+tag a closing C<< >> will automatically be inserted resulting
in this document:
-
+ a
-Which, of course, no longer validates. Since C blocks cannot
-actually be nested within C blocks (according to the standard),
-the input document is not strictly correct. In this case, an
-opening C<<
>> ought to be inserted before the final C<<
>>
-but that is currently beyond the capability of B<--raw-html>.
+Which, of course, no longer validates. Since C
blocks cannot
+directly be nested within C blocks (according to the standard),
+the input document is not strictly correct.
Remember that any B<--stub> and/or B<--stylesheet> options are
I when B<--raw-html> is given.