RFC: Upgrading to DocBook 5.0

Gabor Kovesdan gabor at FreeBSD.org
Fri May 31 07:27:36 UTC 2013


Em 28-05-2013 23:06, Gabor Kovesdan escreveu:
> 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. 
There are three more changes I would like to do. The maketarget and 
makevar elements always sounded a bit weird to me. I think they are too 
specific and do not reflect well the more general semantic nature of 
their content.

1, As for makevar, it is just a variable just like in any other 
programming language, so I propose that.

2, As for maketarget, it is a build target. Unfortunately, DocBook 
doesn't have an appropriate element for this, I'd like to use 
buildtarget and submit a feature request for that.

3, To mark up revision numbers, we use svnref, which generates links to 
our SVNWeb interface. The same happens here, revnumber would be just 
fine. The problem is plain DocBook doesn't allow it inline but I'd like 
to submit a feature request for this.

Gabor


More information about the freebsd-doc mailing list