From owner-svn-doc-head@FreeBSD.ORG Tue Jul 2 23:28:16 2013 Return-Path: Delivered-To: svn-doc-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 74AEBF85; Tue, 2 Jul 2013 23:28:16 +0000 (UTC) (envelope-from kaduk@mit.edu) Received: from dmz-mailsec-scanner-1.mit.edu (dmz-mailsec-scanner-1.mit.edu [18.9.25.12]) by mx1.freebsd.org (Postfix) with ESMTP id EACD61BDC; Tue, 2 Jul 2013 23:28:15 +0000 (UTC) X-AuditID: 1209190c-b7fa48e000000947-ed-51d360dcea40 Received: from mailhub-auth-3.mit.edu ( [18.9.21.43]) by dmz-mailsec-scanner-1.mit.edu (Symantec Messaging Gateway) with SMTP id E1.45.02375.CD063D15; Tue, 2 Jul 2013 19:23:08 -0400 (EDT) Received: from outgoing.mit.edu (outgoing-auth-1.mit.edu [18.9.28.11]) by mailhub-auth-3.mit.edu (8.13.8/8.9.2) with ESMTP id r62NN7Hp008571; Tue, 2 Jul 2013 19:23:07 -0400 Received: from multics.mit.edu (system-low-sipb.mit.edu [18.187.2.37]) (authenticated bits=56) (User authenticated as kaduk@ATHENA.MIT.EDU) by outgoing.mit.edu (8.13.8/8.12.4) with ESMTP id r62NN5SX019808 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Tue, 2 Jul 2013 19:23:06 -0400 Received: (from kaduk@localhost) by multics.mit.edu (8.12.9.20060308) id r62NN4MB023373; Tue, 2 Jul 2013 19:23:04 -0400 (EDT) Date: Tue, 2 Jul 2013 19:23:04 -0400 (EDT) From: Benjamin Kaduk To: Gabor Pali Subject: Re: svn commit: r42117 - head/en_US.ISO8859-1/htdocs/news/status In-Reply-To: <201307021441.r62EfNOi068696@svn.freebsd.org> Message-ID: References: <201307021441.r62EfNOi068696@svn.freebsd.org> User-Agent: Alpine 1.10 (GSO 962 2008-03-14) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFnrHIsWRmVeSWpSXmKPExsUixCmqrXsn4XKgwbZTHBY/Ph5ispiz+imj xY1F+5ksdvf3MjuweMz4NJ8lgDGKyyYlNSezLLVI3y6BK2PhPt2CJomKye1HmRsY5wl3MXJw SAiYSHTcDehi5AQyxSQu3FvP1sXIxSEksI9RYu/VGUwQzgZGicvbF0JlDjJJzJyzhxWkRUig XuLqxcMsIDaLgJZE17HHTCA2m4CKxMw3G9lAbBEBBYnTO3rAapgFoiT2LG1kBdksLOApMf9H BkiYU8BK4sTD10wgYV4BR4lJ+6ogpltKdG44zwhiiwroSKzePwVsCq+AoMTJmU+gJlpKnPtz nW0Co+AsJKlZSFILGJlWMcqm5Fbp5iZm5hSnJusWJyfm5aUW6Rrq5WaW6KWmlG5iBAerJM8O xjcHlQ4xCnAwKvHwOjy7FCjEmlhWXJl7iFGSg0lJlHdG3OVAIb6k/JTKjMTijPii0pzU4kOM EhzMSiK83MJAOd6UxMqq1KJ8mJQ0B4uSOO/Tp2cDhQTSE0tSs1NTC1KLYLIyHBxKErxT44Ea BYtS01Mr0jJzShDSTBycIMN5gIavA6nhLS5IzC3OTIfIn2JUlBKHaBYASWSU5sH1wpLJK0Zx oFeEeatAqniAiQiu+xXQYCagwdLLL4EMLklESEk1MC67/IjNyj+zavdXZr1zLw7Y7NtR8OF4 /ZX9LOa767e/UmnPX1XEvTJErVPZJvmTwbvHHgJRi+MMhBpm+Rf6J2a3Tq9zPGBWsE4kS/7Y V4vsrNZ5nPOmzNydYp+iMzeU++P3OkcdHzkRAasXzwOEVvvP2JfY9WJ+7gHLuZuOnVY4++nS StV7d5RYijMSDbWYi4oTAf2iyegBAwAA Cc: svn-doc-head@freebsd.org, svn-doc-all@freebsd.org, doc-committers@freebsd.org X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 02 Jul 2013 23:28:16 -0000 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 @@ > Remove the dependency on HAL. > > > + > + > + Upgrading the Documentation Set to DocBook 5.0 > + > + > + > + > + Gábor > + Kövesdán > + > + gabor@FreeBSD.org > + > + > + > + > +

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.

Maybe s/a //? > +

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.

I think "provides for" is slightly more correct. -Ben > +

This project is generously founded by The &os; Foundation.

> +