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

[Stéphane Graber]

I agree it might be confusing but it's always been like that for
ifupdown plugins, at least bridge-utils, ifenslave-2.6, wpa_supplicant
and resolvconf all document their options in their manpage and not in
ifupdown's.

On Ubuntu's side, we're making sure the change is being documented in
the Ubuntu 12.04 release notes so people know to look for resolvconf.

The ifupdown manpage mentions the fact that other packages extend the syntax:
       Additional options can be given  on  subsequent  lines  in  the  stanza.   Which
       options  are  available  depends  on  the family and method, as described below.
       Additional options can be made available by other Debian packages.  For example,
       the  wireless-tools  package  makes  available a number of options prefixed with
       "wireless-" which can be used to  configure  the  interface  using  iwconfig(8).
       (See wireless(7) for details.)

Listing them all would make it a maintenance nightmare on Debian's side
where each of these individual packages have different maintainers and
would need to ask for an ifupdown change and upload (affecting all
machines) everytime they add/remove/update an option.

-- 
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