view doc/README @ 42478:561cd02c58ff

cat: don't prefetch files unless the output requires it

It's a waste to cache lfs blobs when cat'ing the raw data at best, but a hassle
debugging when the blob is missing.  I'm not sure if there are other commands
that have '{data}' for output, and if there's a general way to prefetch on that
keyword.

It's interesting that the verbose output seems to leak into the JSON output, but
that seems like an existing bug.

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.