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

[Dan Williams <dcbw redhat com>]

On Wed, 2013-04-10 at 12:23 -0500, Dan Williams 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
> >
> > 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>...)
> >
> > I wouldn't bother converting nmcli.1 right now, since jklimes is
> > changing the syntax around a lot.
>
> I skimmed the patch too and it looks good, can merge at any time.

Though now that I look again, where does docbook.xsl come from, and is
that going to be available when there's no network?  Does xsltproc look
in some local cache before hitting a network for the .xsl?

Dan