[CFR] Migrating the documentation to a real XML toolchain

[Marc Fonvieille]

On Sat, May 11, 2013 at 08:11:42PM +0200, Gabor Kovesdan wrote:
> 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.

en_US.ISO8859-1/share/xml/glossary.ent

-- 
Marc