Subject: Re: New NetBSD Guide chapter: Obtaining the sources
To: John Nemeth <email@example.com>
From: Rui Paulo <rpaulo@NetBSD.org>
Date: 08/12/2005 16:46:38
Content-Type: text/plain; charset=us-ascii
On 2005.08.11 14:49:00 +0000, John Nemeth wrote:
| 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:
| } |=20
| } | > 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 expr=
| } | > 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 I=
| } | 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.
I'll do that later.
| 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.
The compression level is not really straightforward. I think that
-z6 is polite too. The text sums it up.
| 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.
Was already fixed.
| 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.
As you may have guessed, it was a typo.
| In 27.4.5. Downloading the pkgsrc-current development branch, the
| path should be
| ftp://ftp.NetBSD.org/pub/NetBSD/NetBSD-current/tar_files/pkgsrc.tar.gz .
| 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).
Admins problem, I suppose.
| 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.
-- Rui Paulo
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.1 (NetBSD)
-----END PGP SIGNATURE-----