desktop-packages team mailing list archive

[Bryon Roche <891272@xxxxxxxxxxxxxxxxxx>]

Public bug reported:

The only sort of documention included in the network-manager package is
the DBus developer documentation.  From a system integrator or builder
or configurator standpoint, this falls far short of the classic Linux or
Debian standard.

At the least, some documentation re what files on disk NetworkManager
uses and how to configure them should be included, preferably as an
infodoc or manpages.  Considering that documentation for this has been
written already, the lack of inclusion of docs in this package is sort
of shocking.

As a start, even a static render and dump of the docs at
http://live.gnome.org/NetworkManager/SystemSettings, and maybe something
reflecting the information described at
http://www.arachnoid.com/linux/NetworkManager/ would be a significant
enhancement of the docs.

Yes, there are dev apis, and you can drive most of NetworkManager via
DBUS, and you can always apt-get source, or whatnot.  None of those
should be necessary for seeing how NetworkManager drives your system.

** Affects: network-manager (Ubuntu)
     Importance: Undecided
         Status: New

-- 
You received this bug notification because you are a member of Desktop
Packages, which is subscribed to network-manager in Ubuntu.
https://bugs.launchpad.net/bugs/891272

Title:
  No useful documentation included with network-manager (the package)

Status in “network-manager” package in Ubuntu:
  New

Bug description:
  The only sort of documention included in the network-manager package
  is the DBus developer documentation.  From a system integrator or
  builder or configurator standpoint, this falls far short of the
  classic Linux or Debian standard.

  At the least, some documentation re what files on disk NetworkManager
  uses and how to configure them should be included, preferably as an
  infodoc or manpages.  Considering that documentation for this has been
  written already, the lack of inclusion of docs in this package is sort
  of shocking.

  As a start, even a static render and dump of the docs at
  http://live.gnome.org/NetworkManager/SystemSettings, and maybe
  something reflecting the information described at
  http://www.arachnoid.com/linux/NetworkManager/ would be a significant
  enhancement of the docs.

  Yes, there are dev apis, and you can drive most of NetworkManager via
  DBUS, and you can always apt-get source, or whatnot.  None of those
  should be necessary for seeing how NetworkManager drives your system.

To manage notifications about this bug go to:
https://bugs.launchpad.net/ubuntu/+source/network-manager/+bug/891272/+subscriptions