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.