[CFR] Migrating the documentation to a real XML toolchain

[Warren Block]

On Thu, 14 Mar 2013, Gabor Kovesdan wrote:

> Em 27-02-2013 02:24, Warren Block escreveu:
>> Author info is a little off.  Compare the authors at the start of the 
>> bsdinstall chapter:
>> http://people.freebsd.org/~gabor/db45/en_US.ISO8859-1/books/handbook/bsdinstall.html 
>> http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/bsdinstall.html
>> 
>> In the standard version, each section is rendered as a sentence, with 
>> multiple authors separated by commas.
>> 
>> Acronyms don't have any highlights, they just look like normal text.
>> 
> Thank you Warren for the exhaustive list, I've been fixing the issues you 
> reported. However, I don't find highlighted acronyms in the old rendering 
> either. Could you please point me to a concrete example, please?

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.