From owner-freebsd-doc@FreeBSD.ORG  Wed May 29 00:24:27 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 48F40F2D;
 Wed, 29 May 2013 00:24:27 +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 0EAF97C7;
 Wed, 29 May 2013 00:24:26 +0000 (UTC)
Received: from wonkity.com (localhost [127.0.0.1])
 by wonkity.com (8.14.7/8.14.7) with ESMTP id r4T0OK5X049519;
 Tue, 28 May 2013 18:24:20 -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 r4T0OKs0049516;
 Tue, 28 May 2013 18:24:20 -0600 (MDT)
 (envelope-from wblock@wonkity.com)
Date: Tue, 28 May 2013 18:24:19 -0600 (MDT)
From: Warren Block <wblock@wonkity.com>
To: Gabor Kovesdan <gabor@FreeBSD.org>
Subject: Re: RFC: Upgrading to DocBook 5.0
In-Reply-To: <51A51C40.1030205@FreeBSD.org>
Message-ID: <alpine.BSF.2.00.1305281820360.49386@wonkity.com>
References: <519FA4FE.4030305@FreeBSD.org> <51A51C40.1030205@FreeBSD.org>
User-Agent: Alpine 2.00 (BSF 1167 2008-08-23)
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; format=flowed; charset=US-ASCII
X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.4.3
 (wonkity.com [127.0.0.1]); Tue, 28 May 2013 18:24:20 -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: Wed, 29 May 2013 00:24:27 -0000

On Tue, 28 May 2013, Gabor Kovesdan wrote:

> I have a patch to preview how it would look like:
> http://kovesdan.org/patches/fbsd-docbook5.diff
>
> Please comment on this. It is very important to discuss this kind of changes.

I think that keeping up with DocBook versions is important.

Leaving out the systemitem class simplifies markup.  One nice thing 
about those classes is that they remove ambiguity during editing. 
Without them, it may be difficult to tell from context whether a 
systemitem is a username or a directory name, for example.  Although if 
that is not clear from context, it suggests the text needs improvement.