tag 298259 +upstream
thanks
On Sat, Mar 05, 2005 at 10:43:04PM -0700, Paul E Condon wrote:
> Package: base
> Severity: normal
>
> I have just noticed a problem with the man pages for hosts and resolv.conf:
> /etc/hosts, /etc/host.conf, and /etc/resolve.conf are all important in
> name resolution. All have their own man pages, which is good. But only
> the man page for /etc/host.conf mentions the other two files in the Files
> section. I think all three man pages should mention the other two files.
Same today (see below).
However, IMO, it would better suit the "SEE ALSO" section, as FILES is more
related to files applicable to that same manpage / mechanism.
man host.conf |grep -A10 FILES
FILES
/etc/host.conf
Resolver configuration file
/etc/resolv.conf
Resolver configuration file
/etc/hosts
Local hosts database
man resolv.conf |grep -A10 FILES
FILES
/etc/resolv.conf, <resolv.h>
man hosts |grep -A10 FILES
FILES
/etc/hosts
> >>From the point of view of how the resolver decision tree works, host.conf
> is must be the first file that the resolver examines, and the other two
> files are visited in the order specified there. This was something of a
> minor epiphany for me this evening, and on investigating the man pages, I
> think I have found something of an excuse for not having understood this
> years ago.
>
> In more general terms: Consideration should be given to attempting to have
> the man pages for files have a subsection under files which lists the files
> whose man pages list this file. i.e. make all Files: section references
> bi-directional.
>
> I see that this is a grubby clerical task, but once it is done for the base
> system, the symmetry of the Unix/Posix system will be much easier for a
> student to discover.
--
Simon Paillard
--
To UNSUBSCRIBE, email to [email protected]
with a subject of "unsubscribe". Trouble? Contact [email protected]
