Date: Tue, 2 Jul 2013 19:23:04 -0400 (EDT) From: Benjamin Kaduk <kaduk@MIT.EDU> To: Gabor Pali <pgj@freebsd.org> Cc: svn-doc-head@freebsd.org, svn-doc-all@freebsd.org, doc-committers@freebsd.org Subject: Re: svn commit: r42117 - head/en_US.ISO8859-1/htdocs/news/status Message-ID: <alpine.GSO.1.10.1307021917170.26275@multics.mit.edu> In-Reply-To: <201307021441.r62EfNOi068696@svn.freebsd.org> References: <201307021441.r62EfNOi068696@svn.freebsd.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On Tue, 2 Jul 2013, Gabor Pali wrote: > Author: pgj > Date: Tue Jul 2 14:41:23 2013 > New Revision: 42117 > URL: http://svnweb.freebsd.org/changeset/doc/42117 > > > Modified: > head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml > > Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml > ============================================================================== > --- head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Tue Jul 2 13:55:18 2013 (r42116) > +++ head/en_US.ISO8859-1/htdocs/news/status/report-2013-04-2013-06.xml Tue Jul 2 14:41:23 2013 (r42117) > @@ -404,4 +410,53 @@ > <task>Remove the dependency on HAL.</task> > </help> > </project> > + > + <project cat='docs'> > + <title>Upgrading the Documentation Set to DocBook 5.0</title> > + > + <contact> > + <person> > + <name> > + <given>Gábor</given> > + <common>Kövesdán</common> > + </name> > + <email>gabor@FreeBSD.org</email> > + </person> > + </contact> > + > + <body> > + <p>The Documentation Project has been behind with the used > + standards until recently when we switched to a real XML toolchain s/behind with the used standards/using old versions of markup standards/, perhaps? That's still not great, there may be a better wording. > + and DocBook 4.5. However, we still depend on obsoleted Probably s/obsoleted/obsolete/ > + technologies — DSSSL and Jade. Besides, DocBook 5.0 > + provides a cleaner markup and some nice new features.</p> Maybe s/a //? > + <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 missing comma (before 'since'). Some would quibble with the use of since instead of because, but I think that usage is well represented in the popular lexicon. > + 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 > + development. The common opinion among &os; developers is that Two uses of "development" in the same sentence is disrecommended; maybe "updates to the rendering process are under development"? > + 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 > + way since it better fits the existing documentation > + infrastructure and provides easier customization.</p> I think "provides for" is slightly more correct. -Ben > + <p>This project is generously founded by The &os; Foundation.</p> > + </body>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?alpine.GSO.1.10.1307021917170.26275>