Browse Source

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 <mackyle@gmail.com>
master
Kyle J. McKay 3 years ago
parent
commit
a9781245b3
  1. 18
      Markdown.pl

18
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 causing missing closing tags to be inserted where required by the
standard. Non-raw mode always enables these semantics. 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 Unfortunately, it will also fail to accept some documents that
the plain B<--raw-xml> option will. the plain B<--raw-xml> option will.
For example, this document: For example, this document:
<p><pre></pre></p> <dt><li>a</li></dt>
Will be rejected because upon encountering the C<< <pre> >> open Will be rejected because upon encountering the C<< <li> >> open
tag a closing C<< </p> >> will automatically be inserted resulting tag a closing C<< </dt> >> will automatically be inserted resulting
in this document: in this document:
<p></p><pre></pre></p> <dt></dt><li>a</li></dt>
Which, of course, no longer validates. Since C<pre> blocks cannot Which, of course, no longer validates. Since C<li> blocks cannot
actually be nested within C<p> blocks (according to the standard), directly be nested within C<dt> blocks (according to the standard),
the input document is not strictly correct. In this case, an the input document is not strictly correct.
opening C<< <p> >> ought to be inserted before the final C<< </p> >>
but that is currently beyond the capability of B<--raw-html>.
Remember that any B<--stub> and/or B<--stylesheet> options are Remember that any B<--stub> and/or B<--stylesheet> options are
I<completely ignored> when B<--raw-html> is given. I<completely ignored> when B<--raw-html> is given.

Loading…
Cancel
Save