Subject: Re: New NetBSD Guide chapter: Obtaining the sources
To: Rui Paulo <rpaulo@NetBSD.org>
From: John Nemeth <firstname.lastname@example.org>
Date: 08/11/2005 14:49:00
On Dec 27, 9:17am, Rui Paulo wrote:
} On 2005.08.06 15:17:11 +0000, Pavel Cahyna wrote:
} | On Sat, 06 Aug 2005 11:59:59 +0100, Rui Paulo wrote:
} | > As some of you already know, a new chapter was added to the NetBSD
} | > guide to replace the old "Fetching the sources by CVS".
} | > I would like, if possible, that you could read the chapter and express
} | > your opinion on it since, after all, that chapter is will be mostly
} | > read by new users. Typos count too!
} | Also, shouldn't the "Downloading tarballs" be listed as first? It is
} | probably much faster and friendlier to the mirrors, so it should be IMHO
} | preferred.
} What's the point ? The information is there. I supose anyone who wants
} to read that chapter will take a look at the TOC fist.
The point is that people tend to do things in the order that the
information is presented to them, and not jump ahead to see if they
should do something else first. The information really should be
presented in the order that it should be used.
In 27.1. Preparing directories, you should mention creating
/usr/xsrc if people are going to be downloading xsrc so that they don't
get caught by a missing directory when they reach 27.3.2 and not have
the correct permissions to create it.
In 27.3. Fetching by CVS, you should emphasize that people really
shouldn't be going above -z3 in order to be polite and not put
excessive load on the servers.
In 27.4. Downloading tarballs, "It sometimes faster download"
should be "It is sometimes to download". Also, it is probably almost
always faster to start by downloading a tarball and it would certainly
put much less load on the servers.
In 27.4.1. Downloading a NetBSD release, it should be noted that
the path, /pub/NetBSD/NetBSD-RELEASE-NUMBER/tar_files/src, is for
development branches, and that the sources for actual releases are
located at /pub/NetBSD/NetBSD-RELEASE-NUMBER/source/sets. Actually,
the first path should probably read,
/pub/NetBSD/NetBSD-BRANCH/tar_files/src. It is somewhat confusing in
that the text gives one path and the example shows a different path.
In 27.4.5. Downloading the pkgsrc-current development branch, the
path should be
At this moment, the one at this path is dated Aug. 6th, and the one at
ftp://ftp.NetBSD.org/pub/pkgsrc/current/pkgsrc.tar.gz is dated July 1st
(not exactly current).
In 27.5. Sources on CD (ISO), the tar command should be
'tar xvzf $file -C /' or 'tar xzf $file -C /' to be consistent with the
other examples. Leaving out the 'z' would, of course, cause the
operation to fail since the files are compressed.
}-- End of excerpt from Rui Paulo