[Bug 987915] Re: Man page doesn't reflect major architectural changes w/ resolvconf

[EvanCarroll]

I can see how that's the logic but that's going to be highly confusing
for us users. If two packages use the same conf file is it right the
options be documented in two man-locations? This is a rather unique
problem that's been created. What would indicate to the user in `man
interfaces` to reference `resolvconf` for further directives?

I mean if I I saw the dns- directives in resolvconf and not working, and
undocumented in the man page for the conf file -- I'd be confused. I'd
also be highly likely to delete them or tamper with them.

I can't think of any other package the provides a conf file that another
package uses. If these are resolvconf directives, it'd have been nice to
pick something that clearly gives away the extension nature of this.
Like the HTTP convention:

x-resolvconf-dns-nameserves

or something of that ilk.

-- 
You received this bug notification because you are a member of Ubuntu
Foundations Bugs, which is subscribed to ifupdown in Ubuntu.
https://bugs.launchpad.net/bugs/987915

Title:
  Man page doesn't reflect major architectural changes w/ resolvconf

Status in “ifupdown” package in Ubuntu:
  Invalid

Bug description:
  According to the blog post linked in the change logs for 12.04:

  * http://www.stgraber.org/2012/02/24/dns-in-ubuntu-12-04/

  /etc/network/interfaces is the place to put numerous dns declarations.

  "I use static IP configuration, where should I put my DNS configuration?
  The DNS configuration for a static interface should go as “dns-nameservers”, “dns-search” and “dns-domain” entries added to the interface in /etc/network/interfaces"

  However, `man 5 interfaces` makes no mention of dns-nameservers dns-
  search or dns-domain. Perhaps this should be documented.

To manage notifications about this bug go to:
https://bugs.launchpad.net/ubuntu/+source/ifupdown/+bug/987915/+subscriptions