Date: Sat, 8 Dec 2001 00:08:24 +0200 From: Giorgos Keramidas <charon@labs.gr> To: "Gary W. Swearingen" <swear@blarg.net> Cc: doc@FreeBSD.ORG Subject: Re: host.conf.5 manpage Message-ID: <20011207220824.GA13959@hades.hell.gr> In-Reply-To: <1rd71riwtr.71r@localhost.localdomain> References: <20011206200746.GA2127@hades.hell.gr> <0wn10whqrd.10w@localhost.localdomain> <20011206233654.GA4218@hades.hell.gr> <1rd71riwtr.71r@localhost.localdomain>
next in thread | previous in thread | raw e-mail | index | archive | help
On 2001-12-06 18:32:48, Gary W. Swearingen wrote:
> Giorgos Keramidas <charon@labs.gr> 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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20011207220824.GA13959>