[Python-apps-team] Bug#611420: hg.1: description of backout command is confusing

[Jonathan Nieder]

Javi Merino wrote:
> On 29/01/11 05:13, Jonathan Nieder wrote:

>>  - "working directory" does not mean what 'pwd' prints but what
>>    other version control systems call a checkout or working tree.
>
> git also considers working directory to be "the directory that holds the
> current checkout of the files you are working on"
>
> [0] http://book.git-scm.com/1_git_directory_and_working_directory.html

Side note: that page is not part of the documentation distributed with
git and is IMHO misleading.  The directory holding your work is called
the work tree or working tree.

Of course that is a small detail.  The only reason I mentioned it in
connection with that manpage is to indicate

 - this is jargon-heavy
 - it is bewildering to a new reader

Don't we want mercurial to be usable by people who have never used a
version control system before?  That's why I wrote my actual
impressions --- it's not like I'm making this up...

Thanks for your work.
Jonathan