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 -- Mailing list: https://launchpad.net/~desktop-packages Post to : desktop-packages@lists.launchpad.net Unsubscribe : https://launchpad.net/~desktop-packages More help : https://help.launchpad.net/ListHelp