[zeromq-dev] Documentation converted to AsciiDoc

[Martin Lucina]

All,

in commit r354efc5 I have converted all the existing manual pages to
AsciiDoc[1].

This allows us to generate nicer documentation in more formats, so e.g. we
can distribute HTML documentation for Windows users. This will be included
in the next release.

It also gives us a much nicer syntax for the documentation source.

I've tried to do this in a way that doesn't force people to install the
entire AsciiDoc toolchain if they just want to build 0MQ. So:

1) Future release tarballs will include prebuilt manual pages and HTML from
the AsciiDoc source. This is done during "make dist" from git. Therefore,
you do *not* need AsciiDoc to build 0MQ from a release tarball.

If, however, you modify any of the AsciiDoc source files then "make" will
probably try to rebuild things, which will break unless you do have
AsciiDoc.

2) If you are building from git, configure will check for the presence of
asciidoc and xmlto on your system and if these are not found, manual pages
or HTML will *NOT* be built.

Maintainer notes:

- "make clean" or "make distclean" do not remove built .html or man files.
- "make maintainer-clean" does, should you want to do that.
- "make dist" will include HTML and manpages in the released tarball

If this breaks anything for distribution packagers, please speak up now!

Cheers,

-mato

[1] http://www.methods.co.nz/asciidoc/.
    To install on Debian "apt-get install asciidoc xmlto" should be
    sufficient.