view doc/README @ 38179:6fb76897e066 stable

hghave: avoid a deadlock reading the child process's output

The output of `pylint` is voluminous enough that it fills the buffer on Windows,
and waited for the parent to read it out.  But the parent was waiting on the
child to exit.

I'm not sure what the intent of setting `ret = -1` in the exception handler just
above this was...

Mercurial's documentation is kept in reStructuredText format, which is
a simple plain text format that's easy to read and edit:

  http://docutils.sourceforge.net/rst.html

It's also convertible to a variety of other formats including standard
UNIX man page format and HTML. You'll need to install Docutils:

  http://docutils.sourceforge.net/

Use the Makefile in this directory to generate the man and HTML pages.