From owner-freebsd-doc Sun Aug 20 9:39:21 2000 Delivered-To: freebsd-doc@freebsd.org Received: from supernova.dimensional.com (supernova.dimensional.com [206.124.0.11]) by hub.freebsd.org (Postfix) with ESMTP id 4611F37B43E; Sun, 20 Aug 2000 09:39:10 -0700 (PDT) Received: from creator (0@flatland.dimensional.com [206.124.0.24]) by supernova.dimensional.com (8.9.3/8.9.3) with SMTP id KAA05789; Sun, 20 Aug 2000 10:39:08 -0600 (MDT) Message-ID: <000901c00ac5$29fa79d0$14fa90cc@intersols.com> Reply-To: "Dinesh Punjabi" From: "Dinesh Punjabi" To: "Ben Smithurst" Cc: , "Kent Stewart" References: <000701c00a52$6a793be0$14fa90cc@intersols.com> <20000820043554.Q58928@strontium.scientia.demon.co.uk> Subject: Re: 18.4.7. Update /etc (this section is very confusing) Date: Sun, 20 Aug 2000 10:39:07 -0600 MIME-Version: 1.0 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 7bit X-Priority: 3 X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook Express 5.50.4133.2400 X-MimeOLE: Produced By Microsoft MimeOLE V5.50.4133.2400 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org You are right on the money. 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. Third, there should be some comprehensive list of critical files to worry about. It would be unreasonable to worry about hundreds of files that need to be merged. For example, there are some files that it says are under /etc but not in the new release and vice versa .... Fourth, the whole idea of putting datestamps should be mentioned FIRST, then you explain the issue of doing a diff. The problem is that the same process is explained without dates, and then repeatedly explained with dates. If this is a cookbook, people who are unfamiliar will blindly follow the first explanation (like me!) and get confused when trying to understand the second explanation. In fact, try to address the key issues first and then go in detail. I hope that makes sense. I am still unclear as to what this section is doing besides telling me to merge things that I deem required. In fact, there may be device files, etc. that I have no clue as to which ones are needed. The heading says update /etc but the diff shows EVERYTHING under the sun under /. So what part is accurate and relevant ? Thanks for responding ... I am grateful to all of you folks for your hard work. I mean that and appreciate your willingness to listen. Rgds/Happiness! Dinesh ----- Original Message ----- From: "Ben Smithurst" To: "Dinesh Punjabi" Cc: Sent: Saturday, August 19, 2000 9:35 PM Subject: Re: 18.4.7. Update /etc (this section is very confusing) > Dinesh Punjabi wrote: > > > Maybe I am dumb, but this section has me in knots. > > Well, you'll need to be a bit more precise about what's confusing you if > you want it fixed. > > > It needs to be rewritten! > > Probably. I'm not sure why it doesn't mention mergemaster(8) at all. > If you just ignore that section completely, and instead just read the > manual page for "mergemaster", that may be a better option until the > handbook is updated to mention mergemaster. > > -- > 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