Re: Can't find the DNS Servers
- Date: Tue, 26 Sep 2017 15:44:23 +0200
- From: <tomas@xxxxxxxxxx>
- Subject: Re: Can't find the DNS Servers
-----BEGIN PGP SIGNED MESSAGE-----
On Tue, Sep 26, 2017 at 09:09:47AM -0400, Greg Wooledge wrote:
> No, you don't understand. I had no idea that man page EXISTED!
> For years, I have been searching back and forth and up and down in
> dhclient(8) and dhclient.conf(5) and finding NOTHING.
> Turns out the REASON I couldn't find anything was because some bright
> spark decided to split the documentation into multiple man pages.
To be fair, dhclient-script is figures in the output of
man -k dhclient
And is mentioned several times in the dhclient man page (in the see-also
section, among other things).
> So let's see... I'll assume dhclient(8) is the root of the search
> tree. This links to dhcpd(8), dhcrelay(8), dhclient-script(8),
> dhclient.conf(5), dhclient.leases(5), dhcp-eval(5). So now I need
> to open 6 more windows, or 7 total.
Dhclient-script is also ref'd to from dhclient-conf(5). Alas, not in
the "see-also" section (IMHO it should be).
I know this would be preaching to the choir for the ones and lost on
the others -- but do give Emacs' WoMan mode a try. It is Emacs' man
page viewer, and does a good job of making clickable links of all
those embedded refs. Hypertext! (I know, I know: another story started
like this one and isn't ending well, but... ;-)
Don't get me wrong: it happens to me all the time that it's there,
in front of my nose, and I don't see it. I take this as a chance
to ask myself: "how would I have done that, as a writer, to help
my other self? how can I, as a reader, be smarter next time?)
Doumentation Is Hard (TM)
- -- tomás
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.12 (GNU/Linux)
-----END PGP SIGNATURE-----