My first problem is why do I need to use <name>.<argument> in the auth
section. Can I select two different passwords for two different
repositories. Can I set what <name> attributes hg reads for different
Second, it would be nice to have a shorter man page which explains just the
basics and guides users better.
Third, it would be nice to have an example file.
I realize that some of my suggestions are trivial and may go outside the
specification for a man file. But the file does not seem to be written from
the perspective of someone new to version control and mercurial(me).