Re: cvs commit: doc/en/books/handbook Makefile book.sgml chapters.ent doc/en/books/handbook/advanced-networking chapter.sgml doc/en/books/handbook/basics chapter.sgml doc/en/books/handbook/config chapter.sgml doc/en/books/handbook/desktop chapter.sgml doc/en/books/handbook/disks ...

[Erik Wikström <erik-wikstrom@xxxxxxxxx>]

On 2006-07-12 06:50, Justin C. Sherrill wrote:
> On Wed, July 12, 2006 12:01 am, Justin C. Sherrill wrote:
>
> >   Log:
> >   Removed or noted ports mentions, and added pkgsrc sections.
> >
> >   Contributed by: LabThug "Adrian Michael Nida" <nida@xxxxxxxx>
> >   Additional changes from: Erik Wikstrom <erik-wikstrom@xxxxxxxxx>
>
> A freshly-built version in HTML is at:
>
> http://leaf.dragonflybsd.org/~justin/handbook/

Nice, nice. Found some things that might need a look at though (and have 
made some brave attempts too).

http://www.itstud.chalmers.se/~eriwik/pkgsrc.diff Fixes some formulation 
and changes Pentium IV to Pentium 4.

http://www.itstud.chalmers.se/~eriwik/pkgsrc-mailinglist.diff Is an 
attempt to fix the links to the pkgsrc mailing-lists (I have absolutely 
no idea how they are supposed to work but this seem to be correct) and 
removes old entries for FreeBSD ports mailing-lists.

Some other things that I don't know how to fix:

In section 4.5.2 there is a note saying: "It should be noted that 
``Extracting [the] complete dependency database'' does indeed take a 
while." Is that only the first time it's run (or after each update of 
the pkgsrc-tree)? Users might not want to use it if it takes a lot of 
time every time.

In section 4.5.2.1 references are made to the previous section which 
does not really make much sence. "As with the last section, this section 
makes an assumption that you have a working Internet connection." Does 
that refer to 4.4 or 4.5.2?

Lastly there is a lack of consistency when using the (R)-symbol after 
pkgsrc. Having looked quickly in the pkgsrc guide I've seen no usage of 
it at all, but in the DF handbook it is used sometimes, and sometimes not.

--
Erik Wikström