- Fixes in the Q2 DocBook entry

Submitted by:	bjk, wblock
This commit is contained in:
Gabor Pali 2013-07-03 06:21:44 +00:00
parent e0d40d0885
commit fc4ef79422
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=42122

View file

@ -425,29 +425,29 @@
</contact>
<body>
<p>The Documentation Project has been behind with the used
standards until recently when we switched to a real XML toolchain
and DocBook 4.5. However, we still depend on obsoleted
<p>The Documentation Project has been using old versions of markup
standards until recently when we switched to a real XML
toolchain and DocBook 4.5. However, we still depend on obsolete
technologies &mdash; DSSSL and Jade. Besides, DocBook 5.0
provides a cleaner markup and some nice new features.</p>
provides cleaner markup and some nice new features.</p>
<p>The objective of this project is to upgrade the documentation
set to DocBook 5.0 and to find a way to properly render our
sources without using DSSSL since the DSSSL stylesheets are
sources without using DSSSL, since the DSSSL stylesheets are
discontinued and cannot render DocBook 5.0. The documentation
sources have already been successfully transformed to DocBook
5.0 and the development of the rendering process is under
5.0 and updates to the rendering process are under
development. The common opinion among &os; developers is that
Java is a heavy dependency that should be avoided. This has
suggested the transformation of DocBook sources to TeX and use
TeX as a rendering backend. There are two ways to do this; the
sources can be transformed either directly or through the XSL FO
output generated by the stylesheets that the DocBook Project
provides. The latter approach has been chosen as a preferred
output generated by the stylesheets provided for the DocBook Project.
The latter approach has been chosen as a preferred
way since it better fits the existing documentation
infrastructure and provides easier customization.</p>
<p>This project is generously founded by The &os; Foundation.</p>
<p>This project is generously funded by The &os; Foundation.</p>
</body>
<help>