annotate doc/README @ 44820:f71c8eea7161 stable

bash_completion: do not use aliased hg if it sources a script (issue6308)

I have an alias that sources a script around hg. Mercurial's bash_completion
script tries to use this as its main hg binary. But sourcing a wrapper breaks
Bash's completion. So this patch disables using the alias as the hg binary if
it starts with "source ".

Alias resolution was introduced in rev 191ab08e7099 for users with
"alias hg='hg --some_opts'".

See https://www.mercurial-scm.org/repo/hg/rev/191ab08e7099

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.