From: Stuart Rackham <srackham@methods.co.nz>
Date: Wed, 04 Oct 2006 23:40:33 GMT
Subject: Re: asciidoc 7--8 compatibility
Message-ID: <45244671.4030509@methods.co.nz>
In-Reply-To: <4524343B.8060709@s5r6.in-berlin.de>

Stefan Richter wrote:
> Stuart Rackham wrote:
>> --- asciidoc.conf	(revision 53)
>> +++ asciidoc.conf	(working copy)
>> @@ -62,9 +62,9 @@
>>  __=#emphasis
>>  ++=#monospaced
>>  \##=#unquoted
>> -endif::asciidoc7compatible[]
>>  ^=#superscript
>>  ~=#subscript
>> +endif::asciidoc7compatible[]
> 
> Could git/Documentation/asciidoc.conf just kill all the various meanings
> of +, ~, ^ and make them into regular characters? In a way that works
> with all versions of asciidoc?

[quotes]
^=
~=
+=

 From the AsciiDoc User Guide: "A configuration file [quotes] entry can 
be subsequently undefined by setting it to a blank value."


> 
> (Frankly, using + as a special character may sound like a neat idea if
> all one wants to do is to typeset poems.)

The rationale for the + is discussed in the AsciiDoc changelog 
(http://www.methods.co.nz/asciidoc/CHANGELOG.html). It also brings 
AsciiDoc in line with the Ruby RDoc source code documentation system syntax.


--
Stuart Rackham