From owner-freebsd-doc@FreeBSD.ORG  Thu Mar 14 23:33:53 2013
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: doc@freebsd.org
Received: from mx1.freebsd.org (mx1.FreeBSD.org [8.8.178.115])
 by hub.freebsd.org (Postfix) with ESMTP id B0FC3E7B;
 Thu, 14 Mar 2013 23:33:53 +0000 (UTC)
 (envelope-from wblock@wonkity.com)
Received: from wonkity.com (wonkity.com [67.158.26.137])
 by mx1.freebsd.org (Postfix) with ESMTP id 66613225;
 Thu, 14 Mar 2013 23:33:53 +0000 (UTC)
Received: from wonkity.com (localhost [127.0.0.1])
 by wonkity.com (8.14.6/8.14.6) with ESMTP id r2ENXqO8084332;
 Thu, 14 Mar 2013 17:33:52 -0600 (MDT)
 (envelope-from wblock@wonkity.com)
Received: from localhost (wblock@localhost)
 by wonkity.com (8.14.6/8.14.6/Submit) with ESMTP id r2ENXqNd084329;
 Thu, 14 Mar 2013 17:33:52 -0600 (MDT)
 (envelope-from wblock@wonkity.com)
Date: Thu, 14 Mar 2013 17:33:52 -0600 (MDT)
From: Warren Block <wblock@wonkity.com>
To: Gabor Kovesdan <gabor@FreeBSD.org>
Subject: Re: [CFR] Migrating the documentation to a real XML toolchain
In-Reply-To: <5142357A.9070301@FreeBSD.org>
Message-ID: <alpine.BSF.2.00.1303141642470.84119@wonkity.com>
References: <512D2F9C.8080403@FreeBSD.org>
 <alpine.BSF.2.00.1302261759420.49330@wonkity.com>
 <5142357A.9070301@FreeBSD.org>
User-Agent: Alpine 2.00 (BSF 1167 2008-08-23)
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed
X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.2.7
 (wonkity.com [127.0.0.1]); Thu, 14 Mar 2013 17:33:52 -0600 (MDT)
Cc: doc@freebsd.org
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Thu, 14 Mar 2013 23:33:53 -0000

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.