From owner-freebsd-doc Thu Nov 30 5:57:58 2000 Delivered-To: freebsd-doc@freebsd.org Received: from mukappa.home.com (c576194-a.saltlk1.ut.home.com [24.20.97.5]) by hub.freebsd.org (Postfix) with ESMTP id 7E5A937B402 for ; Thu, 30 Nov 2000 05:57:55 -0800 (PST) Received: from mukappa.home.com (localhost [127.0.0.1]) by mukappa.home.com (8.11.1/8.11.1) with SMTP id eAUDvUi15581; Thu, 30 Nov 2000 06:57:30 -0700 (MST) (envelope-from mupi@mknet.org) From: Mike Porter Reply-To: mupi@mknet.org To: Christoph Sold , Rich Morin Subject: Re: documenting nonexistent files Date: Thu, 30 Nov 2000 06:57:29 -0700 X-Mailer: KMail [version 1.1.94] Content-Type: text/plain Cc: freebsd-doc@freebsd.org References: <4910.975533445@axl.fw.uunet.co.za> <3A262AF9.5020108@i-clue.de> In-Reply-To: <3A262AF9.5020108@i-clue.de> MIME-Version: 1.0 Message-Id: <00113006572909.11309@mukappa.home.com> Content-Transfer-Encoding: 8bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org -----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 On Thu, 30 Nov 2000, Christoph Sold wrote: > Great work. I like it. Wish I had such a thing when I started to stumble > around FreeBSD... Me Too! > > [snip] > > defaults / default configuration files > > Add a note not to change the files in the defaults directory, but to > create a file with the same name in the /etc directory, and to just put > the changed values into. > Although this may better belong in the handbook, where there is a little more space for a more detailed explanation, for a truly new user, they might appreciate something along the lines of: "use 'cp original_file ..' and then edit the new file (unless there ISN'T an "original" file in /etc/defaults, then you will need to copy it out of usr/share/examples/etc/defaults)" I know we want to kind of keep things simple in the README, but the copy in /etc/defaults (if it exists) (and if I am not mistaken....) should be treated as "more" canonical than /usr/share/examples/etc, especially in the case of a system that wasn't "properly" upgraded. (if they user is using CVS or whatever to update their system, /etc/defaults and /usr/share/examples/etc/defaults *should* be the same, unless I'm missing something, but if they aren't.... ) Overall, though, looks pretty good to my unpracticed eye. mike -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.0.3 (FreeBSD) Comment: For info see http://www.gnupg.org iEYEARECAAYFAjomXMoACgkQZ7GovTQbIm4f7gCeNxWVOyGWMsqzuzvDJqRs0xWS XI8An2KjfWyKLZG6uk95Qi+2yBqMsNbj =ZAba -----END PGP SIGNATURE----- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message