Date: Tue, 4 Mar 2003 11:30:41 +1100 (EST) From: =?iso-8859-1?q?Sue=20Blake?= <aunty_sue@yahoo.com.au> To: freebsd-doc@freebsd.org Subject: keeping /usr/share/doc up to date Message-ID: <20030304003041.51869.qmail@web14007.mail.yahoo.com>
next in thread | raw e-mail | index | archive | help
After upgrading I need to get an up to date handbook, faq, and preferably the other material that resides under /usr/share/doc too. Our Internet access is limited to web browser with passworded proxy, so I can only get to ftp sites by point and click. Downloading each of these book.html.tar.gz and article.html.tar.gz files, in case they might have been updated, is tedious but doable. We do have access to a local CVS repository here, but it only gives SGML for docs. It would be much nicer if there existed a small simple tool that could quietly convert the SGML to rough HTML or text during the upgrade. We have lots of tiny gems that convert other document formats, but I don't know of any for this task. Processing SGML seems to need several huge and small pieces of interdependent software probably of various origins and license types, each one requiring approval installation documentation auditing and maintenance. That's not realistic for this site. We will face the same problem each time the systems are upgraded: the expectation that the online documentation that appears on the OS filesystem alongside the binaries would be approximately the documentation that speaks for those binaries. I think I could whip up a script that takes the checked out sgml and simply removes anything between angle brackets and presents the result as a text file (with big thanks to the neatness of the docs writers!), but I would be grateful for any better suggestions. http://mobile.yahoo.com.au - Yahoo! Mobile - Exchange IMs with Messenger friends on your Telstra or Vodafone mobile phone. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20030304003041.51869.qmail>