Subject: Re: New NetBSD Guide chapter: Obtaining the sources
To: John Nemeth <>
From: Rui Paulo <>
List: netbsd-users
Date: 08/12/2005 16:46:38
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

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!
| }=20
| } | 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.
| }=20
| } 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
| .
| At this moment, the one at this path is dated Aug. 6th, and the one at
| 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.

Another typo.


		-- Rui Paulo

Content-Type: application/pgp-signature
Content-Disposition: inline

Version: GnuPG v1.4.1 (NetBSD)