new file mode 100644
--- /dev/null
+++ b/doc/hgrc.5.txt
@@ -0,0 +1,128 @@
+HGRC(5)
+=======
+Bryan O'Sullivan <bos@serpentine.com>
+
+NAME
+----
+hgrc - configuration files for Mercurial
+
+SYNOPSIS
+--------
+
+The Mercurial system uses a set of configuration files to control
+aspects of its behaviour.
+
+FILES
+-----
+
+Mercurial reads configuration data from two files:
+
+$HOME/.hgrc::
+    Global configuration options that apply to all Mercurial commands,
+    no matter where they are run.
+
+<repo>/.hg/hgrc::
+    Per-repository configuration options that only apply in a
+    particular repository.  This file is not version-controlled, and
+    will not get transferred during a "clone" operation.  Values in
+    this file override global values.
+
+SYNTAX
+------
+
+A configuration file consists of sections, led by a "[section]" header
+and followed by "name: value" entries; "name=value" is also accepted.
+
+    [spam]
+    eggs=ham
+    green=
+       eggs
+
+Each line contains one entry.  If the lines that follow are indented,
+they are treated as continuations of that entry.
+
+Leading whitespace is removed from values.  Empty lines are skipped.
+
+The optional values can contain format strings which refer to other
+values in the same section, or values in a special DEFAULT section.
+
+Lines beginning with "#" or ";" are ignored and may be used to provide
+comments.
+
+SECTIONS
+--------
+
+This section describes the different sections that may appear in a
+Mercurial "hgrc" file, the purpose of each section, its possible
+keys, and their possible values.
+
+hooks::
+  Commands that get automatically executed by various actions such as
+  starting or finishing a commit.
+  precommit;;
+    Run before starting a commit.  Exit status 0 allows the commit to
+    proceed.  Non-zero status will cause the commit to fail.
+  commit;;
+    Run after a changeset has been created. Passed the ID of the newly
+    created changeset.
+
+http_proxy::
+  Used to access web-based Mercurial repositories through a HTTP
+  proxy.
+  host;;
+    Host name and (optional) port of the proxy server, for example
+    "myproxy:8000".
+  user;;
+    Optional.  User name to authenticate with at the proxy server.
+  passwd;;
+    Optional.  Password to authenticate with at the proxy server.
+  no;;
+    Optional.  Comma-separated list of host names that should bypass
+    the proxy.
+
+paths::
+  Assigns symbolic names to repositories.  The left side is the
+  symbolic name, and the right gives the directory or URL that is the
+  location of the repository.
+
+tags::
+  Tags that are local to a repository and not distributed or version
+  controlled.  The left side is the tag name, and the right is the
+  ID of the changeset to identify.
+
+ui::
+  User interface controls.
+  debug;;
+    Print debugging information.  True or False.  Default is True.
+  editor;;
+    The editor to use during a commit.  Default is "vi".
+  merge;;
+    The conflict resolution program to use during a manual merge.
+    Default is "hgeditor".
+  quiet;;
+    Reduce the amount of output printed.  True or False.  Default is
+    False.
+  username;;
+    The committer of a changeset created when running "commit".
+    Typically a person's name and email address, e.g. "Fred Widget
+    <fred@example.com>".  Default is username@hostname.
+  verbose;;
+    Increase the amount of output printed.  True or False.  Default is
+    False.
+
+AUTHOR
+------
+Bryan O'Sullivan <bos@serpentine.com>.
+
+Mercurial was written by Matt Mackall <mpm@selenic.com>.
+
+SEE ALSO
+--------
+hg(1)
+
+COPYING
+-------
+This manual page is copyright 2005 Bryan O'Sullivan.
+Mercurial is copyright 2005 Matt Mackall.
+Free use of this software is granted under the terms of the GNU General
+Public License (GPL).