Subject: Re: Proposition for Releases page changes
To: NetBSD Users's Discussion List <>
From: Greg A. Woods <>
List: netbsd-users
Date: 04/01/2007 13:31:46
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: quoted-printable

At Sat, 31 Mar 2007 20:39:05 +0200, Martin S. Weber wrote:
Subject: Re: Proposition for Releases page changes
> Now, some time later, users begin to complain about the quality and outda=
> of our documentation. Go find the links yourself. If you want manpages in=
> xml, I'm looking forward to see wrong and outdated information creeping i=
nto the
> running system, too.  The roff hackers will love to learn docbook-xml, I'=
m sure.

well said!  :-)

> The point is that this great technical improvement has bought us nothing =
> a print-ready guide (for those two dozen users who print the guide), driv=
en off
> contributors to documentation and an increasing share of outdated informa=

Let's not forget that we already had stunningly good looking
typeset-quality printed documentation (if we wanted it) long before XML
weaseled its way into more than a few places.

The thing that was originally lacking was an easy way to produce HTML
output for online publishing in a form that permitted better structuring
and cross referencing (not that plain text documents can't be used
easily in any web browser).  However that problem was greatly relieved
quite some time ago by improvements to groff and the html*.tmac macros.
It seemed to me that further simple improvements to the html*.tmac stuff
would have solved all the online publishing issues and then some.

						Greg A. Woods

H:+1 416 218-0098 W:+1 416 489-5852 x122 VE3TCP RoboHack <>
Planix, Inc. <>       Secrets of the Weird <>

Content-Type: application/pgp-signature
Content-Transfer-Encoding: 7bit

Version: PGPfreeware 5.0i for non-commercial use
MessageID: nHbJtdM6+peqcULQmStFrC3H9+d7IdYH