Hi,

Just checking in to see if the PATCH was okay.  The default value 
attrdropline does not change Asciidoc current behavior.  The default 
behavior only changes if the user changes the conf value to 'False'. 
'False' means the entire line from the user's source will not be dropped if 
a simple attribute reference does not exist (i.e., typo, inadvertent 
mistake)* * and a timely warning message will be display.

I use Asciidoc and simple attribute references in system documentation. The 
simple markup text is very easy to maintain.  The HTML is easy to 
distribute and pleasant to read, and the PDF is helpful for 
off-storage/disaster recovery. This PATCH is something we have used for 
some time  and would like to contribute to Asciidoc if others find it 
helpful.

Let me know if you need anything else.

Thank you.
Peg Russell 

On Thursday, March 7, 2013 2:10:09 PM UTC-6, Stargazer wrote:
>
> Hi Lex,
>
> The patch has been updated to include an asciidoc.conf attribute in the 
> [miscellaneous] section to control the deletion of a line with a missing 
> simple attribute reference.
>
> The Asciidoc configuration option is called 'attrdropline' and the default 
> value is 'True' causing no change in current processing
> of missing simple attribute references.  If the value is 'False', such a 
> line will be emitted with the missing simple attribute reference unchanged 
> and a warning message identifying the file name, line number, and simple 
> attribute reference will be emitted as well.
>
> The patch also includes a documentation update to doc/asciidoc.txt.
>
> It has been tested using the current Asciidoc repository trunk.
>
> Thank you.
> Peg Russell
>
> On Wednesday, March 6, 2013 7:28:06 PM UTC-6, Lex Trotman wrote:
>>
>> On 7 March 2013 12:09, Stargazer <prussell...@gmail.com> wrote: 
>> > Hi, 
>> > 
>> > I have been applying this patch to Asciidoc for a couple of releases 
>> now. It 
>> > really has been a time saver and allows for more automation. I hope you 
>> will 
>> > consider it for permanent inclusion in Asciidoc. 
>> > 
>> > Summary: 
>> > Rather than quietly deleting an entire line when a simple attribute 
>> > reference is missing, --- more often just a fat-finger typo --- leave 
>> the 
>> > line alone and issue a warning message.  In large documents throwing 
>> away a 
>> > line without notice can be frustrating and time consuming. 
>> > 
>> > Patch: 
>> > The patch (diff -u) has been tested on the current Asciidoc release, 
>> 8.6.8, 
>> > as well as the current trunk. 
>> > 
>> > Attached: 
>> > 1. Patch 
>> > 2. Small Asciidoc source example 
>> > 3. Output from source 
>> > 
>>
>> Hi Peg, 
>>
>> I think you can do similar in a configurable way with the existing 
>> trace facilities, see 
>> http://www.methods.co.nz/asciidoc/userguide.html#X82. 
>>
>> Certainly such a patch cannot be accepted without an option to enable 
>> it, so that by default documents that mean to drop stuff don't have 
>> their behaviour changed. 
>>
>> Cheers 
>> Lex 
>>
>> > Thank you. 
>> > Peg Russell 
>> > 
>> > -- 
>> > 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 asciidoc+u...@googlegroups.com. 
>> > To post to this group, send email to asci...@googlegroups.com. 
>> > Visit this group at http://groups.google.com/group/asciidoc?hl=en. 
>> > For more options, visit https://groups.google.com/groups/opt_out. 
>> > 
>> > 
>>
>

-- 
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 asciidoc+unsubscr...@googlegroups.com.
To post to this group, send email to asciidoc@googlegroups.com.
Visit this group at http://groups.google.com/group/asciidoc?hl=en.
For more options, visit https://groups.google.com/groups/opt_out.


Reply via email to