From owner-freebsd-doc Fri Dec 7 14: 8:54 2001 Delivered-To: freebsd-doc@freebsd.org Received: from mailsrv.otenet.gr (mailsrv.otenet.gr [195.170.0.5]) by hub.freebsd.org (Postfix) with ESMTP id 4D85037B416 for ; Fri, 7 Dec 2001 14:08:32 -0800 (PST) Received: from hades.hell.gr (patr530-a128.otenet.gr [212.205.215.128]) by mailsrv.otenet.gr (8.11.5/8.11.5) with ESMTP id fB7M8PG18041; Sat, 8 Dec 2001 00:08:26 +0200 (EET) Received: (from charon@localhost) by hades.hell.gr (8.11.6/8.11.6) id fB7M8OV14045; Sat, 8 Dec 2001 00:08:24 +0200 (EET) (envelope-from charon@labs.gr) Date: Sat, 8 Dec 2001 00:08:24 +0200 From: Giorgos Keramidas To: "Gary W. Swearingen" Cc: doc@FreeBSD.ORG Subject: Re: host.conf.5 manpage Message-ID: <20011207220824.GA13959@hades.hell.gr> References: <20011206200746.GA2127@hades.hell.gr> <0wn10whqrd.10w@localhost.localdomain> <20011206233654.GA4218@hades.hell.gr> <1rd71riwtr.71r@localhost.localdomain> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <1rd71riwtr.71r@localhost.localdomain> User-Agent: Mutt/1.3.23.2i Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org On 2001-12-06 18:32:48, Gary W. Swearingen wrote: > Giorgos Keramidas writes: > > On 2001-12-06 15:29:10, Gary W. Swearingen wrote: > > > > > .Nm host.conf > > > -.Nd format of resolver services configuration file > > > +.Nd DNS resolver services configuration file > > > > I deliberately tried to avoid using DNS here since it's not DNS only > > that can be configured as a 'service' :-) > > Two points: 1) host.conf is a file, not a format. No disagreement here. Actually the below commands show that both kinds of descriptions are being used in section 5 manpages :-/ $ cd /usr/src/share/man/man5 $ grep '^.Nd ' * | grep format | wc -l 13 $ grep '^.Nd ' * | grep -v format | wc -l 30 Since the section is called "FreeBSD File Formats Manual" I'm not in favor of either one or the other. Changing this to read: .Nd resolver services configuration file seems the best thing right now. It's a tiny description after all, a hint for `man -k' users. The rest of the manpage is the real thing. > I won't complain again if you want to leave DNS out. Yes, I do. Name lookups are, well, not DNS specific, although the vast majority of them are done using DNS. It's probably better to keep the description to be as generic as possible. > > Hmmm, seems nicer, yes. I'm not sure about the `ignored' part, but I > > like the spelled out delimiters. Thanks. > > I'm not sure what you're not sure about, but I often silently gripe > about man pages which don't explicitly say whether comment lines may > have whitespace before the "#". (They may not in host.conf.) True. That is clearer after reading the entire manpage and not the just the diffs. > So I think it's enough to say that the resolver uses one or more NIS > servers. I just thought that it should refer to "server(s)" > somehow, ... That's ok :) YP/NIS is a big black box to me, so anything that makes the way it works more clear is much appreciated. > Just some thoughts; it's your page. I'd like to think of it as "our" page, this was team work, and thank you for your constructive comments :-) Nobody else has commented on this, so I'm going to wait for another day or two and then add this to -STABLE. The up-to-date source, with your changes mixed in can be found now at: http://people.freebsd.org/~keramida/host.conf.5.txt -giorgos To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message