Problem setting up wired networking

[Timothy Murphy]

On Thursday 13 November 2008 11:32:48 Ralf Corsepius wrote:
> On Wed, 2008-11-12 at 16:37 -0800, Jesse Keating wrote:
> > On Wed, 2008-11-12 at 16:21 -0800, Rick Stevens wrote:
> > > Other drawbacks: the utter and complete lack of documentation;
> >
> > $ rpm -qd NetworkManager
> > /usr/share/doc/NetworkManager-0.7.0/AUTHORS
> > /usr/share/doc/NetworkManager-0.7.0/CONTRIBUTING
> > /usr/share/doc/NetworkManager-0.7.0/COPYING
> > /usr/share/doc/NetworkManager-0.7.0/ChangeLog
> > /usr/share/doc/NetworkManager-0.7.0/NEWS
> > /usr/share/doc/NetworkManager-0.7.0/README
> > /usr/share/doc/NetworkManager-0.7.0/TODO
> > /usr/share/man/man1/nm-tool.1.gz
> > /usr/share/man/man8/NetworkManager.8.gz
>
> That is none.

I don't know if this was intended as a response
to my complaint about the lack of NM documentation,
but if so (1) the man pages mentioned are completely useless,
consisting of a bare statement that the applications exist,
(2) I don't consider a list of AUTHORS etc to be documentation.

The only item in the above list that could be considered documentation
is README, which in my view is completely inadequate,
eg it does not explain what the various "states" (1 to 9)
listed in /var/log/messages actually are,
or what the 5 "steps" that NM apparently goes through correspond to.

It doesn't say what files NM looks at,
or how one can modify NM's behaviour.