view doc/hg.1.txt @ 9021:2ccb527c7b1a

gendoc: fix localization of help topic

When a topic provides a callable method for its text, most likely
this text will be generated from different parts, so it does not
make sense to apply gettext on the whole result, rather the method
should provide translation by itself.

This is the case with the extensions topic, which triggers a double
gettext call, making the ASCII codec fail when it encounters 8 bit
characters, and prevents the documentation from being built.

HG(1)
=====
Matt Mackall <[e-mail]>
:man source: Mercurial
:man manual: Mercurial Manual

NAME
----
hg - Mercurial source code management system

SYNOPSIS
--------
*hg* 'command' ['option']... ['argument']...

DESCRIPTION
-----------
The *hg* command provides a command line interface to the Mercurial
system.

COMMAND ELEMENTS
----------------

files ...::
    indicates one or more filename or relative path filenames; see
    "FILE NAME PATTERNS" for information on pattern matching

path::
    indicates a path on the local machine

revision::
    indicates a changeset which can be specified as a changeset
    revision number, a tag, or a unique substring of the changeset
    hash value

repository path::
    either the pathname of a local repository or the URI of a remote
    repository.

include::hg.1.gendoc.txt[]

FILES
-----
 `.hgignore`::
    This file contains regular expressions (one per line) that
    describe file names that should be ignored by *hg*. For details,
    see *hgignore(5)*.

 `.hgtags`::
    This file contains changeset hash values and text tag names (one
    of each separated by spaces) that correspond to tagged versions of
    the repository contents.

 `/etc/mercurial/hgrc`, `$HOME/.hgrc`, `.hg/hgrc`::
    This file contains defaults and configuration. Values in `.hg/hgrc`
    override those in `$HOME/.hgrc`, and these override settings made in
    the global `/etc/mercurial/hgrc` configuration. See *hgrc(5)* for
    details of the contents and format of these files.

Some commands (e.g. revert) produce backup files ending in `.orig`, if
the `.orig` file already exists and is not tracked by Mercurial, it will
be overwritten.

BUGS
----
Probably lots, please post them to the mailing list (See Resources
below) when you find them.

SEE ALSO
--------
*hgignore(5)*, *hgrc(5)*

AUTHOR
------
Written by Matt Mackall <[e-mail]>

RESOURCES
---------
http://mercurial.selenic.com/[Main Web Site]

http://selenic.com/hg[Source code repository]

http://selenic.com/mailman/listinfo/mercurial[Mailing list]

COPYING
-------
Copyright \(C) 2005-2009 Matt Mackall.
Free use of this software is granted under the terms of the GNU General
Public License (GPL).