From owner-freebsd-doc Sun Mar 15 16:28:38 1998 Return-Path: Received: (from majordom@localhost) by hub.freebsd.org (8.8.8/8.8.8) id QAA09882 for freebsd-doc-outgoing; Sun, 15 Mar 1998 16:28:38 -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 QAA09876 for ; Sun, 15 Mar 1998 16:28:34 -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 KAA06994; Mon, 16 Mar 1998 10:56:49 +1030 (CST) Received: (from grog@localhost) by freebie.lemis.com (8.8.8/8.8.7) id KAA23775; Mon, 16 Mar 1998 10:56:37 +1030 (CST) (envelope-from grog) Message-ID: <19980316105636.62142@freebie.lemis.com> Date: Mon, 16 Mar 1998 10:56:36 +1030 From: Greg Lehey To: Jeremy Lea , doc@FreeBSD.ORG Subject: Re: ps2pdf (was: newbies mailing list) References: <199803030441.VAA11558@const.> <34FBE0CB.C1697F2D@internationalschool.co.uk> <19980304102052.13296@freebie.lemis.com> <19980304131036.44077@shale.csir.co.za> <19980306191229.06394@freebie.lemis.com> <19980311182033.60785@shale.csir.co.za> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.89i In-Reply-To: <19980311182033.60785@shale.csir.co.za>; from Jeremy Lea on Wed, Mar 11, 1998 at 06:20:33PM +0200 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 Wed, 11 March 1998 at 18:20:33 +0200, Jeremy Lea wrote: > Hi... > > On Fri, Mar 06, 1998 at 07:12:29PM +1030, Greg Lehey wrote: >> Obviously the work with sed has to be >> done before making the CD. > > If it's a one line patch then shouldn't it just go into bsd.doc.mk and > happen every time? Probably. That wasn't the question I was addressing. > I've noticed that people in the US tend to think very much in terms of the > CD distribution of FreeBSD. Out in the backwaters of this virtual urban > sprawl the CD is not very easy to come by and ordering it is quite pricey. > People here tend to think a lot more in terms of FTP. There are 10 times as > many mirrors outside the US as inside... Well, I'm not exactly in the middle of Manhattan here, either, and I definitely think more in terms of CD-ROMs for the same reasons you propose for ftp. >> No problems there. My problem is that there has to be something >> better than the current html, which, as other people have observed, is >> difficult to handle. >> >> While writing my book, I spent a lot of time reading the handbook, >> initially the HTML version. It wasn't until I went to reading the >> ASCII version that I discovered a whole lot of stuff that I hadn't >> found in the HTML. This is more a problem of the handbook than the >> medium, but the medium encourages it: excellent random access and >> appalling sequential access. I'd suggest that we try to reduce the >> number of pages and increase their size (and still keep the links, of >> course). One page per chapter sounds reasonable. > > I agree... Personally I think HTML is a mess. It should never have been a > content based markup format... it should have been a platform independent > display format and left the content stuff to background SGML like docbook. > But well you can't change history. HTML and it's successors are here to > stay. > > Making the HTML pages longer is a good idea. So, I think, is making the > printable versions shorter (one section per file). But I think there is more > needed in terms of restructuring the documents, and pitching them at a > broader audience. An idea I liked was that used in the online Java book at > java.sun.com, which uses "trails", which you can follow through. Maybe > something like this would work. In the online version it would be hypertext > and in the printed version it could use small icons. There could be a "new > user", "ISP", "workstation", "Quake" :), etc. trails for the various > segments of the users to walk though, so that experienced users could skip > the hand-holding... I'd have to think the idea through a bit with a copy of > the handbook in front of me. This sounds like a very good idea. I'm also sure it's very difficult to get right. Greg To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message