Date: Tue, 28 May 2013 18:24:19 -0600 (MDT) From: Warren Block <wblock@wonkity.com> To: Gabor Kovesdan <gabor@FreeBSD.org> Cc: doc@freebsd.org Subject: Re: RFC: Upgrading to DocBook 5.0 Message-ID: <alpine.BSF.2.00.1305281820360.49386@wonkity.com> In-Reply-To: <51A51C40.1030205@FreeBSD.org> References: <519FA4FE.4030305@FreeBSD.org> <51A51C40.1030205@FreeBSD.org>
next in thread | previous in thread | raw e-mail | index | archive | help
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.
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?alpine.BSF.2.00.1305281820360.49386>