From owner-freebsd-doc Tue Mar 3 15:52:36 1998 Return-Path: Received: (from majordom@localhost) by hub.freebsd.org (8.8.8/8.8.8) id PAA20358 for freebsd-doc-outgoing; Tue, 3 Mar 1998 15:52:36 -0800 (PST) (envelope-from owner-freebsd-doc@FreeBSD.ORG) Received: from allegro.lemis.com (allegro.lemis.com [192.109.197.134]) by hub.freebsd.org (8.8.8/8.8.8) with ESMTP id PAA19870; Tue, 3 Mar 1998 15:50:58 -0800 (PST) (envelope-from grog@lemis.com) Received: from freebie.lemis.com (freebie.lemis.com [192.109.197.137]) by allegro.lemis.com (8.8.7/8.8.5) with ESMTP id KAA10189; Wed, 4 Mar 1998 10:20:52 +1030 (CST) Received: (from grog@localhost) by freebie.lemis.com (8.8.8/8.8.7) id KAA19934; Wed, 4 Mar 1998 10:20:52 +1030 (CST) (envelope-from grog) Message-ID: <19980304102052.13296@freebie.lemis.com> Date: Wed, 4 Mar 1998 10:20:52 +1030 From: Greg Lehey To: stuart henderson , chat@FreeBSD.ORG Cc: FreeBSD Documenters Subject: Re: ps2pdf (was: newbies mailing list) Reply-To: doc@FreeBSD.ORG References: <199803030441.VAA11558@const.> <34FBE0CB.C1697F2D@internationalschool.co.uk> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.89i In-Reply-To: <34FBE0CB.C1697F2D@internationalschool.co.uk>; from stuart henderson on Tue, Mar 03, 1998 at 10:51:55AM +0000 WWW-Home-Page: http://www.lemis.com/~grog Organization: LEMIS, PO Box 460, Echunga SA 5153, Australia Phone: +61-8-8388-8286 Fax: +61-8-8388-8725 Mobile: +61-41-739-7062 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Tue, 3 March 1998 at 10:51:55 +0000, stuart henderson wrote: >> IMHO, HTML is the best choice for this documentation. HTML is >> accessible from nearly everywhere, space efficient and by definition, >> hypertext. > >> If a plain text version is necessary for ease of printing and access >> where a browser isn't available, use the existing SGML tools to >> produce HTML and text from one base. > > At the moment, it's not very easy to get at the handbook or FAQ offline > until FreeBSD is installed. It would probably be more useful for many > people to be able to read it first - certainly in countries where phone > calls have to be paid for, online reading isn't a very sensible option. > > I think at the very least, there should be a (preferably .zip) archive > of the HTML versions for offline reading. > > A printable version as well would be nice: .ps is not a very good choice > because very few people in the Windows world know about ghostscript - > RTF/Word/PDF all have the advantage of being printer-independent and > usable on a reasonably standard configuration. I'm picking on your message to answer mainly because it's the last in sequence in my incoming mail :-) I don't have time to answer each message blow-by-blow, and I'm not sure it would be the best way to do it if I did. I have a number of points to make: 1. This is really an issue to discuss in -doc, not in -chat. I'm following up there. 2. The ASCII (latin1) version of the handbook doesn't contain any high-bit-set characters. The only unusual character it contains is a ^H (backspace), which even on DOS impact printers will create a bolder impression. In UNIX, you can (and I do) remove it with sed 's:.^H::g'. I suppose it would make sense to include a stripped version on the next CD-ROM, like I'm planning to put an ASCII version of "The Complete FreeBSD". 3. ASCII is *terrible* to read. One of the reasons I'm still wondering whether it's worth the trouble is that it's almost illegible. So much of the information is in the fonts and the character sizes; without this information, it's often very difficult to understand. 4. It is possible to install groff on DOS. I've never done it, and I have no intention of introducing Microsoft to my workspace, but people should at least be made aware of the possibility. 5. I think HTML stinks as a documentation format. It's barely acceptable as a web format, and the attempts I've made to use it for Real Documents have been painful. Compare http://www.lemis.com/errata-2.html and ftp://ftp.lemis.com/pub/cfbsd/errata-2.ps, both of which ostensibly are the same document. About the only advantage it has is that just about everybody has a reader. BTW, can't you display .html files with Microsoft-based browsers? I've probably forgotten something here. I may follow up. Greg To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message