RFC: Upgrading to DocBook 5.0

[Eitan Adler]

On 29 May 2013 02:24, Warren Block <wblock at wonkity.com> wrote:
> 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.

Agreed.

Unless the class could be used to provide additional formatting
options I don't see the need for it here.
It provides semantic value, but I don't think much is gained from that here.


-- 
Eitan Adler