From owner-freebsd-doc@FreeBSD.ORG  Thu May  9 03:25:11 2013
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: doc@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org
 [IPv6:2001:1900:2254:206a::19:1])
 by hub.freebsd.org (Postfix) with ESMTP id 2F7ACF44;
 Thu,  9 May 2013 03:25:11 +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 E8BEB1A7B;
 Thu,  9 May 2013 03:25:10 +0000 (UTC)
Received: from wonkity.com (localhost [127.0.0.1])
 by wonkity.com (8.14.7/8.14.7) with ESMTP id r493P9E2006895;
 Wed, 8 May 2013 21:25:09 -0600 (MDT)
 (envelope-from wblock@wonkity.com)
Received: from localhost (wblock@localhost)
 by wonkity.com (8.14.7/8.14.7/Submit) with ESMTP id r493P9ms006892;
 Wed, 8 May 2013 21:25:09 -0600 (MDT)
 (envelope-from wblock@wonkity.com)
Date: Wed, 8 May 2013 21:25:09 -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: <518A40C1.3000107@FreeBSD.org>
Message-ID: <alpine.BSF.2.00.1305082104100.6793@wonkity.com>
References: <512D2F9C.8080403@FreeBSD.org> <515DDE5E.1070405@FreeBSD.org>
 <alpine.BSF.2.00.1304041952140.38333@wonkity.com>
 <518A40C1.3000107@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.4.3
 (wonkity.com [127.0.0.1]); Wed, 08 May 2013 21:25:09 -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, 09 May 2013 03:25:11 -0000

On Wed, 8 May 2013, Gabor Kovesdan wrote:

> I've fixed all the reported problems again. (Except those that were already 
> there before my work, since they are not trivial to fix in this phase.) I've 
> also updated the generated documentation set:
> http://people.freebsd.org/~gabor/db45/ 
> <http://people.freebsd.org/%7Egabor/db45/>
>
> Please let me know if you find more problems. I remind you again that the new 
> generation process is quite different so there are differences in the 
> rendering but please report only differences that you think that are 
> problematic. We plan to merge back this changeset to head quite soon so that 
> we can progress with further improvements and to avoid the maintenance cost 
> of the branch.

HTML versions don't have a single/split HTML selection.


>From the FDP:

"Last modified on 2013-02-18 bygabor." (missing space)
                               ^^

>From the Handbook:

The FreeBSD copyright and the trademarks are both shown as "Legal 
Notice" links.  I don't know if they should be shown inline as they were 
previously, but the links ought to have different names.

One other thing that jumps out is that <userinput> sections are in bold, 
while the rest of the <screen> section is not bold.


I didn't see anything that was a serious problem.