[PATCH 1 of 3] doc: document the ui.patch option

Jordi GutiƩrrez Hermoso jordigh at octave.org
Tue Jun 23 12:59:23 CDT 2015

# HG changeset patch
# User Jordi GutiƩrrez Hermoso <jordigh at octave.org>
# Date 1435081662 14400
#      Tue Jun 23 13:47:42 2015 -0400
# Node ID 452d3c9b0041c5a44efbb8327863599b6da27342
# Parent  7fdd1782fc4ee9da87d8af13e806dc9055db2c38
doc: document the ui.patch option

This option has been undocumented since e56c7e05c7e6 (July 2007).

diff --git a/mercurial/help/config.txt b/mercurial/help/config.txt
--- a/mercurial/help/config.txt
+++ b/mercurial/help/config.txt
@@ -1451,6 +1451,19 @@ User interface controls.
     markers is different from the encoding of the merged files,
     serious problems may occur.
+    An optional external tool that ``hg import`` and some extensions
+    will use for applying patches. By default Mercurial uses an
+    internal patch utility. The external tool must work as the common
+    Unix ``patch`` program. In particular, it must accept a ``-p``
+    argument to strip patch headers, a ``-d`` argument to specify the
+    current directory, a file name to patch, and a patch file to take
+    from stdin.
+    It is possible to specify a patch tool together with extra
+    arguments. For example, setting this option to ``patch --merge``
+    will use the ``patch`` program with its 2-way merge option.
     Check for portable filenames. Can be ``warn``, ``ignore`` or ``abort``.
     Default is ``warn``.

More information about the Mercurial-devel mailing list