[Xcb] XCB documentation effort status update

[Josh Triplett]

On Mon, Nov 28, 2011 at 03:59:06PM -0800, Bart Massey wrote:
> Ooh, I've got an idea! Let's add a layer of indirection, so that we
> end up with a tool that builds automakefiles!
> 
> /me can't believe he said that out loud...
> 
> More seriously, the problem with using less-well-known tools, as we've
> discovered repeatedly with XCB, is that many developers will walk away
> from a project whose tools they aren't comfortable with. Kind of sad,
> I think, but there you go.
> 
> I guess I'd actually suggest just giving up on the list-of-manpages
> being built by/for autotools, and either maintain it manually or build
> it with a shell script in a post-step as the manpages are installed.
> Or am I missing something obvious?

We can do slightly better than that.  For instance, the configure script
or makefile could check that the included list of manpages matches the
generated one, and stop if not.

- Josh Triplett