RFC: Upgrading to DocBook 5.0

Warren Block wblock at wonkity.com
Wed May 29 00:24:27 UTC 2013


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.


More information about the freebsd-doc mailing list