Re: [Boost-docs] The beauty of LATEX

Subject: Re: [Boost-docs] The beauty of LATEX
From: Joel de Guzman (joel_at_[hidden])
Date: 2011-10-26 15:22:41

On 10/26/2011 11:05 PM, Dave Abrahams wrote:
> 
> on Wed Oct 26 2011, Daniel James <dnljms-AT-gmail.com> wrote:
> 
>> On Tuesday, 25 October 2011, Joel de Guzman wrote:
>>
>>     On 10/25/2011 6:02 PM, Daniel James wrote:
>>     > On 25 October 2011 10:14, Matias Capeletto <
>>     matias.capeletto_at_[hidden]> wrote:
>>     >>
>>     >>  [custom_section This is not]
>>     >>
>>     >> The only thing that it will change for the user is that he
>>     will have
>>     >> to wrap this kind of lines:
>>     >>
>>     >>  [custom_bold This is not a paragraph]
>>     >
>>     > If anyone doesn't realise, I proposed a 'block' element in
>>     another
>>     > thread to deal with this issue.
>>    
>>     I think I'm still confused with it and the whole lot of issues
>>     including how it was before and how it is now, etc. Can we do a
>>     reset and tell us how this 'block' element can help with the
>>     issues we are discussing (namely the wiki as a decoupled
>>     preprocessor and a template engine that does not know anything
>>     about wiki style markups), please?
>>
>>
>> The problem is that to do a decent job of generating documentation,
>> the engine needs to understand the document structure (for
>> chunking, generating  paragraphs, anchor placement, footnotes etc.),
>> and that can't be known until after templates have been expanded. So
>> you probably need some form of representation, i.e. the document's
>> 'DOM' (although I'm not suggesting that you copy XML's DOM), which you
>> can transform appropriately.
> 
> I'm not sure I follow Daniel's argument, but I agree that any attempt to
> do this without a DOM or AST or some other structured abstract
> representation would be a step backwards from best existing practices in
> this domain.

Of course we have an AST. But that's not we are discussing. Discussing
too many issues all at the same time becomes confusing. Right now,
this sub thread is about preprocessing wiki markups.

Regards,
-- 
Joel de Guzman
http://www.boostpro.com
http://boost-spirit.com