On 29 August 2014 08:51, Dan Allen <[email protected]> wrote: > > On Thu, Aug 28, 2014 at 5:05 AM, Lex Trotman <[email protected]> wrote: >> >> I read the docs as saying that if a two line header was found, >> then compatibility mode was switched on, preventing the use of the new >> syntax. > > > The two-line header just switches the compat mode on by default. You can > still disable compat mode explicitly using: > > :compat-mode!:
Ok, great, thanks. > > The reason we enable compat-mode by default is so that the syntax just works > for notable older documents like the AsciiDoc User Guide and the Git guide > and man pages that use two-line section titles. It was a compromise to > prevent unnecessary disruption for these influential projects. > Yes, its a reasonable way of doing it since there is currently no way for a document to specify a version of the markup it conforms to. Maybe adding ASAP a version attribute that a doc can set to say "this is the version of markup I'm using", so the processor can then switch to that mode, or refuse if its not capable. That will open up the possibility of further syntax fixes/additions without breaking older documents. Cheers Lex > > -Dan > > -- > Dan Allen | http://google.com/profiles/dan.j.allen > > -- > You received this message because you are subscribed to the Google Groups > "asciidoc" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to [email protected]. > To post to this group, send email to [email protected]. > Visit this group at http://groups.google.com/group/asciidoc. > For more options, visit https://groups.google.com/d/optout. -- You received this message because you are subscribed to the Google Groups "asciidoc" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. Visit this group at http://groups.google.com/group/asciidoc. For more options, visit https://groups.google.com/d/optout.
