[PATCH 0 of 3] rst2man polish

[Martin Geisler]

Mads Kiilerich <mads at kiilerich.com> writes:

> a6747ba27d22 makes it more noticeable that rst2man is needed for
> generating man pages. rst2man has however not been in an official
> docutils release yet. Do we expect rst2man to have been released
> officially and included in the OS distributions before the next major
> Mercurial release?

I'm sure you know this, but just to be clear: you don't need rst2man or
any other Docutils package to use Mercurial. It is only people like you
who build packages for others that need it.

The rst2man script has now been put into Docutils proper, which means
that it's even easier to install -- you just install Docutils (from
their docutils-snapshot.tgz file, which is their recommended way of
installation) and you'll get rst2html.py and rst2man.py in your PATH.

I hope that is enough for packagers?

My opinion is that people who compile from source should not be
surprised that they have to install other pieces of software (sometimes
from source) in order to get the latest version running. If they cannot
figure out how to do this, they should contact someone who can, i.e.,
the guy who makes binary packages for their platform.

In our case we're even talking about a component which is not critical
for using Mercurial (and most of the manpages are from 'hg help') and
which is readily available online.

I don't know if that is seen as overly hostile towards our users?

-- 
Martin Geisler

VIFF (Virtual Ideal Functionality Framework) brings easy and efficient
SMPC (Secure Multiparty Computation) to Python. See: http://viff.dk/.