Web lists-archives.com

Re: Can't find the DNS Servers




-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

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)

Cheers
- -- tomás
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.12 (GNU/Linux)

iEYEARECAAYFAlnKWbcACgkQBcgs9XrR2kbTKwCcCrVDUK3riaKtJ2vW7mTrxH2l
JZgAn1yjHGVLAtXNiHpD1Temy+QaV1dp
=LLxs
-----END PGP SIGNATURE-----