Re: [PATCH] man: Rewrite NetworkManager.8 and NetworkManager.conf.5 in DocBook

[Dan Williams <dcbw redhat com>]

On Wed, 2013-04-10 at 16:32 -0400, Colin Walters wrote:
> On Wed, 2013-04-10 at 13:15 -0400, Dan Winship wrote:
> > On 04/10/2013 06:37 AM, Colin Walters wrote:
> > > DocBook is not my favorite thing in the world, but it's
> > > <lots-of-emphasis>far</lots-of-emphasis> saner than troff.  Some style
> > > parts cribbed from systemd.
> > >
> > > This is preparatory work for actually improving the content of the
> > > man pages.
> >
> > Yay. Makes sense to me. There are a few trailing-whitespace issues in
> > the XML files ("blank" lines that contain whitespace), and a few minor
> > glitches in the layout:
> >
> >            dnsmasqNetworkManager will run dnsmasq as a local caching
>
> Fixed both of those, new patch attached.
>
> > but yeah, troff sucks, and we never even bothered to figure out how to
> > do some of the layout that we really needed to be doing there. (Like,
> > the section under "dns" really ought to be another <variablelist>...)
>
> Yeah, I was just going for a "literal" translation as a starting point.
>
> > I wouldn't bother converting nmcli.1 right now, since jklimes is
> > changing the syntax around a lot.
>
> Ok.
>
> The main thing I think needs to be documented well is the semantics
> around the connection state; what's there isn't bad, but how it
> interacts with the "plugin" is not obvious to me yet.

Pushed, thanks!

Dan