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.