view doc/README @ 41555:ba7eaff26474

check-py3-compat: manually format and print warnings

The warnings mechanism may print to stderr on Python 3. Independent buffering
of stdout and stderr can lead to warnings output not being printed properly.

This commit traps warnings when executing individual files and prints
warnings to stdout so output is deterministic.

Differential Revision: https://phab.mercurial-scm.org/D5845

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.