[CFR] Migrating the documentation to a real XML toolchain

[Gabor Kovesdan]

Em 08-05-2013 14:28, Marc Fonvieille escreveu:
> On Fri, Mar 15, 2013 at 08:42:01AM +0100, Gabor Kovesdan wrote:
>>> > >
>>> > >Good question.  I know this is given as a reason why acronyms should
>>> > >always be marked up, and I thought I'd seen it at some point in the
>>> > >FreeBSD docs.  But it does not do it now, and I may have been looking
>>> > >at something else.  It is something that would really benefit the reader.
>> >I also agree that it would be a nice feature but actually I don't even
>> >understand how it is supposed to work at the moment. In most cases, the
>> >markup does not hold the expansion, it just says e.g.
>> ><acronym>NFS</acronym> but does not include what it needs to expand to.
>> >We could add an attribute but then it would only appear if the attribute
>> >is present. Shall we expand all occurrences (would mean lots of
>> >redundancy) or just the first?
> It was supposed working in the same way as the trademarks, i.e., the 1st
> occurence is expanded/rendered.
>
I just don't where the expanded text is taken from. I cannot find it in 
our markup. I googled about it and I see very different pieces of 
information. I'll look at it better when the current changeset is merged 
back.

Gabor