From owner-freebsd-doc Sun Jul 16 16: 0:17 2000 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (unknown [206.79.44.65]) by hub.freebsd.org (Postfix) with ESMTP id E5E6337BD58 for ; Sun, 16 Jul 2000 15:59:55 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) id QAA22957; Sun, 16 Jul 2000 16:27:27 GMT (envelope-from nik) Date: Sun, 16 Jul 2000 16:27:27 +0000 From: Nik Clayton To: gouders@et.bocholt.fh-gelsenkirchen.de Cc: freebsd-doc@freebsd.org Subject: Re: Why don't I get the tutorials with the DOC distribution? Message-ID: <20000716162727.A22910@kilt.nothing-going-on.org> References: <200007142142.XAA41919@musashi.et.bocholt.fh-ge.de> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i In-Reply-To: <200007142142.XAA41919@musashi.et.bocholt.fh-ge.de>; from gouders@et.bocholt.fh-gelsenkirchen.de on Fri, Jul 14, 2000 at 11:42:43PM +0200 Organization: FreeBSD Project Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Fri, Jul 14, 2000 at 11:42:43PM +0200, gouders@et.bocholt.fh-gelsenkirchen.de wrote: > I just tried to re-install the DOC distribution using > /stand/sysinstall and recognized that (for example in the English > language case) the parts I got were /usr/share/doc/en/articles and > /usr/share/doc/en/books but the one that I wanted, > /usr/share/doc/en/tutorials, was missing. articles == tutorials The top level distinction is between DocBook s and
s. Some of the books (like the FDP Primer) are also tutorials, so we've gone to a distinction that's technical, rather than relying on people's perceptions. > Well, I started to reread the HTML version of docproj-primer online > from FreeBSD.org but my eyes began to hurt and I said to myself: "Why > don't you just get the post script version, send it to the printer and > stop causing pain to your already weak eyes, anymore?"... > > Now, I am somewhat frustrated, because I haven't been successful even > with that simple task. ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/* > I would be glad if someone could explain me > the "usual" way to get the tutorials. In the articles/ directory. > I would also like know, if it > is possible to get other formats than HTML and plain text out of the > DOC distribution using /stand/sysinstall. Not at the moment. We could add PS (or PDF) to the release build, however that then means that the release machine will also need a full (and up to date) copy of teTeX and all the other bits and pieces that are required. It would also considerably bloat the size of the doc distribution on CD, which is not great. However, note that the FTP directory above also contains the documentation in FreeBSD package format, so you can use the pkg_* commands to add them, update them, and so on. Also, you're probably looking at the index.html files, right? If you look at the {book,article}.html files you'll see the documentation in one big file. You can load this into Netscape (or whatever) and print it out, instead of needing to load in all the smaller files and print them one at a time. Does that help? N -- Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. Telephone line, $24.95 a month. Software, free. USENET transmission, hundreds if not thousands of dollars. Thinking before posting, priceless. Somethings in life you can't buy. For everything else, there's MasterCard. -- Graham Reed, in the Scary Devil Monastery To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message