On Wed, Feb 16, 2011 at 01:57:18AM +0100, Ingo Schwarze wrote: > Hi Pascal, > > Pascal Stumpf wrote on Tue, Feb 15, 2011 at 11:58:17PM +0100: > > > dunno if you???re already aware of this, but it seems pretty much all of > > the manpages in net/samba are somewhat broken. Each one of them starts > > with three blank pages, so one has to hit space three times for the > > actual text to appear. Is that reproducable for anyone? > > Oh well, here we go, DocBook once again. > > Among the various man(7) code generators out there, > in my experience, DocBook tends to be the one generating > the crappiest and least portable output. Often, DocBook > output portability is so bad that it doesn't even work well > with groff. On top of that, I have seen DocBook bugs > leading to completely garbled syntax of the generated code. > > When writing documentation and having a choice, avoid > DocBook completely. Instead, use mdoc(7) directly.
That's really funny, considering who is responsible both for docbook parsers and groff...