Skip site navigation (1)Skip section navigation (2)
Date:      Sun, 16 Jul 2000 16:27:27 +0000
From:      Nik Clayton <nik@freebsd.org>
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>
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 %2B0200
References:  <200007142142.XAA41919@musashi.et.bocholt.fh-ge.de>

next in thread | previous in thread | raw e-mail | index | archive | help
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 <book>s and <article>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




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20000716162727.A22910>