Need more info.

[ikiwiki.git] / doc / bugs / enumerations_of_dates_not_formatted_correctly.mdwn

diff --git a/doc/bugs/enumerations_of_dates_not_formatted_correctly.mdwn b/doc/bugs/enumerations_of_dates_not_formatted_correctly.mdwn
index 4a78ea3f93a2c8f3c3a756ee39f8f87c03ee6c24..263ddd78b05d4858dc42f39cf9b8da234d5c71e5 100644 (file)
--- a/doc/bugs/enumerations_of_dates_not_formatted_correctly.mdwn
+++ b/doc/bugs/enumerations_of_dates_not_formatted_correctly.mdwn
@@ -9,3 +9,35 @@ Testcase:
 * 27. March
 * 99. November
 * 42. April
+
+> That's a consequence of Markdown syntax. The syntax for ordered lists
+> (HTML `<ol>`) in Markdown is to use arbitrary numeric prefixes in that style,
+> so your text gets parsed as:
+>
+>     <ul>
+>         <li>
+>             <ol>
+>                 <li>January</li>
+>             </ol>
+>         </li>
+>         ...
+>
+> You can avoid that interpretation by escaping the dot with a backslash
+> (`1\. January`) like so:
+>
+> * 1\. January
+> * 27\. March
+>
+> or by writing "1st January" and so on. --[[smcv]]
+
+>> I think that this is a bug in Text::Markdown (and probably other
+>> versions of markdown). The [markdown spec)(http://daringfireball.net/projects/markdown/syntax.text),
+>> though unmaintained and bitrotted into near illegibility, seems to say
+>> that list items can only be preceeded by whitespace:
+>> 
+>>> "List markers typically start at the left margin, but may be indented by
+>>> up to three spaces."
+>> 
+>> So "* * * 1. 2. 3." should not be parsed as a deeply nested list.
+>> 
+>> Forwarded to [upsteam RT](https://rt.cpan.org/Ticket/Display.html?id=65116). [[done]] --[[Joey]]