From owner-freebsd-doc Sun Aug 20 12:36: 9 2000 Delivered-To: freebsd-doc@freebsd.org Received: from scientia.demon.co.uk (scientia.demon.co.uk [212.228.14.13]) by hub.freebsd.org (Postfix) with ESMTP id 2EC4937B443 for ; Sun, 20 Aug 2000 12:35:44 -0700 (PDT) Received: from strontium.scientia.demon.co.uk ([192.168.91.36] ident=root) by scientia.demon.co.uk with esmtp (Exim 3.16 #1) id 13QaJe-000DhP-00; Sun, 20 Aug 2000 19:59:31 +0100 Received: (from ben@localhost) by strontium.scientia.demon.co.uk (8.9.3/8.9.3) id TAA80697; Sun, 20 Aug 2000 19:59:30 +0100 (BST) (envelope-from ben) Date: Sun, 20 Aug 2000 19:59:30 +0100 From: Ben Smithurst To: Dinesh Punjabi Cc: doc@FreeBSD.org, Kent Stewart Subject: Re: 18.4.7. Update /etc (this section is very confusing) Message-ID: <20000820195929.X58928@strontium.scientia.demon.co.uk> References: <000701c00a52$6a793be0$14fa90cc@intersols.com> <20000820043554.Q58928@strontium.scientia.demon.co.uk> <000901c00ac5$29fa79d0$14fa90cc@intersols.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i In-Reply-To: <000901c00ac5$29fa79d0$14fa90cc@intersols.com> Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org Dinesh Punjabi wrote: > It talks about updating /etc as the heading, yet it says > that /usr and /var may also need to be updated. > So change the heading to reflect this. > > Secondly, mention mergemaster as a way to merge things. Well, I might commit this diff (unless anyone has a good reason why not). It doesn't completely clear it up, but it mentions mergemaster at least, and then once people know about that they can ignore the rest of the section. Perhaps the section can be cleaned up a bit more when someone does it, or I have a bit more time to do it myself. Index: cutting-edge/chapter.sgml =================================================================== RCS file: /usr/cvs/doc/en_US.ISO_8859-1/books/handbook/cutting-edge/chapter.sgml,v retrieving revision 1.53 diff -u -r1.53 chapter.sgml --- chapter.sgml 2000/07/23 16:24:48 1.53 +++ chapter.sgml 2000/08/20 18:44:47 @@ -873,15 +873,24 @@ - Update <filename>/etc</filename> + Update files not updated by + <command>make world</command> Remaking the world will not update certain directories (in particular, /etc, /var and - /usr) with new or changed configuration files. - This is something you have to do by hand, eyeball, and judicious use - of &man.diff.1;. - - You cannot just copy over the files from + /usr) with new or changed configuration files. + + The simplest way to update these files is to use + &man.mergemaster.8;, though it is possible to do it manually + if you would prefer to do that. We strongly recommend you + use &man.mergemaster.8;, however, and if you do then you + can skip forward to the next + section, since &man.mergemaster.8; is very simple to use. + You should read the manual page first, and make a backup of + /etc in case anything goes wrong. + + If you wish to do the update manually, + you cannot just copy over the files from /usr/src/etc to /etc and have it work. Some of these files must be installed first. This is because the /usr/src/etc @@ -889,8 +898,8 @@ /etc directory should look like. In addition, there are files that should be in /etc that are not in /usr/src/etc. - - The simplest way to do this is to install the files into a new + + The simplest way to do this by hand is to install the files into a new directory, and then work through them looking for differences. @@ -923,14 +932,12 @@ The simplest way to do this is to: &prompt.root; cd /var/tmp/root -&prompt.root; find -d . -type d | /usr/bin/perl -lne \ - 'opendir(D,$_);@f=readdir(D);rmdir if $#f == 1;closedir(D);' +&prompt.root; find . -type d | xargs rmdir 2>/dev/null - This does a depth first search, examines each directory, and if - the number of files in that directory is 2 ( - + This will remove all empty directories. (Standard error is + redirected to /dev/null to prevent the warnings + about the directories are not empty. + /var/tmp/root now contains all the files that should be placed in appropriate locations below /. You now have to go through each of these @@ -1035,7 +1042,7 @@ - + Update <filename>/dev</filename> @@ -1052,6 +1059,12 @@ /dev. &prompt.root; cp /var/tmp/root/dev/MAKEDEV /dev + + If you used &man.mergemaster.8; to + update /etc, then your + MAKEDEV script should have been updated + already, though it can't hurt to check (with &man.diff.1;) + and copy it manually if necessary. -- Ben Smithurst / ben@FreeBSD.org / PGP: 0x99392F7D FreeBSD Documentation Project / To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message