Re: [Boost-docs] The beauty of LATEX

Subject: Re: [Boost-docs] The beauty of LATEX
From: Dave Abrahams (dave_at_[hidden])
Date: 2011-10-26 15:05:23

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.

-- 
Dave Abrahams
BoostPro Computing
http://www.boostpro.com