components/mercurial/patches/rst.patch
author Danek Duvall <danek.duvall@oracle.com>
Mon, 22 Feb 2016 14:29:22 -0800
changeset 5481 5e30cd0645e7
parent 4263 078df530ebdb
permissions -rw-r--r--
21549200 mercurial 3.7.1 21368629 hg diff is not interruptible
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
1637
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
     1
Rewrite some sections of the documentation to match what we deliver on
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
     2
Solaris, or remove sections that are of no relevance to Solaris.
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
     3
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
     4
--- mercurial-2.7/hgext/hgk.py	Mon Aug 19 14:57:23 2013
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
     5
+++ mercurial-2.7/hgext/hgk.py	Mon Aug 19 15:04:11 2013
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
     6
@@ -13,13 +13,12 @@
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
     7
 
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
     8
 hgk consists of two parts: a Tcl script that does the displaying and
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
     9
 querying of information, and an extension to Mercurial named hgk.py,
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
    10
-which provides hooks for hgk to get information. hgk can be found in
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
    11
-the contrib directory, and the extension is shipped in the hgext
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
    12
-repository, and needs to be enabled.
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
    13
+which provides hooks for hgk to get information.
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
    14
 
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
    15
-The :hg:`view` command will launch the hgk Tcl script. For this command
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
    16
-to work, hgk must be in your search path. Alternately, you can specify
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
    17
-the path to hgk in your configuration file::
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
    18
+The :hg:`view` command will launch the hgk Tcl script. The script is
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
    19
+shipped in /usr/demo/mercurial, and hgk needs no configuration to find
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
    20
+it.  You can specify the path to an alternate hgk in your configuration
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
    21
+file::
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
    22
 
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
    23
   [hgk]
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
    24
   path=/location/of/hgk
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
    25
--- mercurial-2.7/mercurial/help/hg.1.txt	Thu Aug  1 20:37:39 2013
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
    26
+++ mercurial-2.7/mercurial/help/hg.1.txt	Mon Aug 19 15:14:00 2013
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
    27
@@ -85,6 +85,11 @@
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
    28
     repositories. The file format is the same as for ``.hgtags``, but it is
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
    29
     encoded using the local system encoding.
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
    30
 
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
    31
+``/usr/demo/mercurial``
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
    32
+    This directory contains assorted files which are part of the Mercurial
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
    33
+    distribution, but not core to its functionality.  They will generally
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
    34
+    need to be copied elsewhere to be of use.
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
    35
+
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
    36
 Some commands (e.g. revert) produce backup files ending in ``.orig``,
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
    37
 if the ``.orig`` file already exists and is not tracked by Mercurial,
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
    38
 it will be overwritten.
5481
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
    39
--- a/mercurial/help/config.txt
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
    40
+++ b/mercurial/help/config.txt
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
    41
@@ -36,10 +36,6 @@ Local configuration is put into the per-
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
    42
 
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
    43
 Global configuration like the username setting is typically put into:
1637
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
    44
 
5481
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
    45
-.. container:: windows
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
    46
-
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
    47
-  - ``%USERPROFILE%\mercurial.ini`` (on Windows)
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
    48
-
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
    49
 .. container:: unix.plan9
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
    50
 
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
    51
   - ``$HOME/.hgrc`` (on Unix, Plan9)
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
    52
@@ -52,7 +48,7 @@ ones.
1637
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
    53
 
3596
042f4e7a6dbe 20246148 mercurial 3.2.3
Danek Duvall <danek.duvall@oracle.com>
parents: 1981
diff changeset
    54
 .. container:: verbose.unix
1637
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
    55
 
3596
042f4e7a6dbe 20246148 mercurial 3.2.3
Danek Duvall <danek.duvall@oracle.com>
parents: 1981
diff changeset
    56
-  On Unix, the following files are consulted:
042f4e7a6dbe 20246148 mercurial 3.2.3
Danek Duvall <danek.duvall@oracle.com>
parents: 1981
diff changeset
    57
+  The following files are consulted:
042f4e7a6dbe 20246148 mercurial 3.2.3
Danek Duvall <danek.duvall@oracle.com>
parents: 1981
diff changeset
    58
 
042f4e7a6dbe 20246148 mercurial 3.2.3
Danek Duvall <danek.duvall@oracle.com>
parents: 1981
diff changeset
    59
   - ``<repo>/.hg/hgrc`` (per-repository)
042f4e7a6dbe 20246148 mercurial 3.2.3
Danek Duvall <danek.duvall@oracle.com>
parents: 1981
diff changeset
    60
   - ``$HOME/.hgrc`` (per-user)
5481
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
    61
@@ -62,41 +58,6 @@ ones.
3596
042f4e7a6dbe 20246148 mercurial 3.2.3
Danek Duvall <danek.duvall@oracle.com>
parents: 1981
diff changeset
    62
   - ``/etc/mercurial/hgrc.d/*.rc`` (per-system)
4263
078df530ebdb 21029166 mercurial 3.4
Danek Duvall <danek.duvall@oracle.com>
parents: 3596
diff changeset
    63
   - ``<internal>/default.d/*.rc`` (defaults)
1637
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
    64
 
3596
042f4e7a6dbe 20246148 mercurial 3.2.3
Danek Duvall <danek.duvall@oracle.com>
parents: 1981
diff changeset
    65
-.. container:: verbose.windows
4263
078df530ebdb 21029166 mercurial 3.4
Danek Duvall <danek.duvall@oracle.com>
parents: 3596
diff changeset
    66
-
3596
042f4e7a6dbe 20246148 mercurial 3.2.3
Danek Duvall <danek.duvall@oracle.com>
parents: 1981
diff changeset
    67
-  On Windows, the following files are consulted:
4263
078df530ebdb 21029166 mercurial 3.4
Danek Duvall <danek.duvall@oracle.com>
parents: 3596
diff changeset
    68
-
3596
042f4e7a6dbe 20246148 mercurial 3.2.3
Danek Duvall <danek.duvall@oracle.com>
parents: 1981
diff changeset
    69
-  - ``<repo>/.hg/hgrc`` (per-repository)
042f4e7a6dbe 20246148 mercurial 3.2.3
Danek Duvall <danek.duvall@oracle.com>
parents: 1981
diff changeset
    70
-  - ``%USERPROFILE%\.hgrc`` (per-user)
042f4e7a6dbe 20246148 mercurial 3.2.3
Danek Duvall <danek.duvall@oracle.com>
parents: 1981
diff changeset
    71
-  - ``%USERPROFILE%\Mercurial.ini`` (per-user)
042f4e7a6dbe 20246148 mercurial 3.2.3
Danek Duvall <danek.duvall@oracle.com>
parents: 1981
diff changeset
    72
-  - ``%HOME%\.hgrc`` (per-user)
042f4e7a6dbe 20246148 mercurial 3.2.3
Danek Duvall <danek.duvall@oracle.com>
parents: 1981
diff changeset
    73
-  - ``%HOME%\Mercurial.ini`` (per-user)
5481
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
    74
-  - ``HKEY_LOCAL_MACHINE\SOFTWARE\Mercurial`` (per-installation)
3596
042f4e7a6dbe 20246148 mercurial 3.2.3
Danek Duvall <danek.duvall@oracle.com>
parents: 1981
diff changeset
    75
-  - ``<install-dir>\hgrc.d\*.rc`` (per-installation)
5481
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
    76
-  - ``<install-dir>\Mercurial.ini`` (per-installation)
4263
078df530ebdb 21029166 mercurial 3.4
Danek Duvall <danek.duvall@oracle.com>
parents: 3596
diff changeset
    77
-  - ``<internal>/default.d/*.rc`` (defaults)
3596
042f4e7a6dbe 20246148 mercurial 3.2.3
Danek Duvall <danek.duvall@oracle.com>
parents: 1981
diff changeset
    78
-
042f4e7a6dbe 20246148 mercurial 3.2.3
Danek Duvall <danek.duvall@oracle.com>
parents: 1981
diff changeset
    79
-  .. note::
042f4e7a6dbe 20246148 mercurial 3.2.3
Danek Duvall <danek.duvall@oracle.com>
parents: 1981
diff changeset
    80
-
042f4e7a6dbe 20246148 mercurial 3.2.3
Danek Duvall <danek.duvall@oracle.com>
parents: 1981
diff changeset
    81
-   The registry key ``HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Mercurial``
042f4e7a6dbe 20246148 mercurial 3.2.3
Danek Duvall <danek.duvall@oracle.com>
parents: 1981
diff changeset
    82
-   is used when running 32-bit Python on 64-bit Windows.
042f4e7a6dbe 20246148 mercurial 3.2.3
Danek Duvall <danek.duvall@oracle.com>
parents: 1981
diff changeset
    83
-
5481
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
    84
-.. container:: windows
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
    85
-
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
    86
-  On Windows 9x, ``%HOME%`` is replaced by ``%APPDATA%``.
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
    87
-
3596
042f4e7a6dbe 20246148 mercurial 3.2.3
Danek Duvall <danek.duvall@oracle.com>
parents: 1981
diff changeset
    88
-.. container:: verbose.plan9
042f4e7a6dbe 20246148 mercurial 3.2.3
Danek Duvall <danek.duvall@oracle.com>
parents: 1981
diff changeset
    89
-
042f4e7a6dbe 20246148 mercurial 3.2.3
Danek Duvall <danek.duvall@oracle.com>
parents: 1981
diff changeset
    90
-  On Plan9, the following files are consulted:
1637
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
    91
-
3596
042f4e7a6dbe 20246148 mercurial 3.2.3
Danek Duvall <danek.duvall@oracle.com>
parents: 1981
diff changeset
    92
-  - ``<repo>/.hg/hgrc`` (per-repository)
042f4e7a6dbe 20246148 mercurial 3.2.3
Danek Duvall <danek.duvall@oracle.com>
parents: 1981
diff changeset
    93
-  - ``$home/lib/hgrc`` (per-user)
042f4e7a6dbe 20246148 mercurial 3.2.3
Danek Duvall <danek.duvall@oracle.com>
parents: 1981
diff changeset
    94
-  - ``<install-root>/lib/mercurial/hgrc`` (per-installation)
042f4e7a6dbe 20246148 mercurial 3.2.3
Danek Duvall <danek.duvall@oracle.com>
parents: 1981
diff changeset
    95
-  - ``<install-root>/lib/mercurial/hgrc.d/*.rc`` (per-installation)
042f4e7a6dbe 20246148 mercurial 3.2.3
Danek Duvall <danek.duvall@oracle.com>
parents: 1981
diff changeset
    96
-  - ``/lib/mercurial/hgrc`` (per-system)
042f4e7a6dbe 20246148 mercurial 3.2.3
Danek Duvall <danek.duvall@oracle.com>
parents: 1981
diff changeset
    97
-  - ``/lib/mercurial/hgrc.d/*.rc`` (per-system)
4263
078df530ebdb 21029166 mercurial 3.4
Danek Duvall <danek.duvall@oracle.com>
parents: 3596
diff changeset
    98
-  - ``<internal>/default.d/*.rc`` (defaults)
1637
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
    99
-
4263
078df530ebdb 21029166 mercurial 3.4
Danek Duvall <danek.duvall@oracle.com>
parents: 3596
diff changeset
   100
 Per-repository configuration options only apply in a
078df530ebdb 21029166 mercurial 3.4
Danek Duvall <danek.duvall@oracle.com>
parents: 3596
diff changeset
   101
 particular repository. This file is not version-controlled, and
078df530ebdb 21029166 mercurial 3.4
Danek Duvall <danek.duvall@oracle.com>
parents: 3596
diff changeset
   102
 will not get transferred during a "clone" operation. Options in
5481
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   103
@@ -104,7 +65,7 @@ this file override options in all other
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   104
 
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   105
 .. container:: unix.plan9
4263
078df530ebdb 21029166 mercurial 3.4
Danek Duvall <danek.duvall@oracle.com>
parents: 3596
diff changeset
   106
 
5481
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   107
-  On Plan 9 and Unix, most of this file will be ignored if it doesn't
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   108
+  On Unix, most of this file will be ignored if it doesn't
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   109
   belong to a trusted user or to a trusted group. See
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   110
   :hg:`help config.trusted` for more details.
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   111
 
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   112
@@ -126,10 +87,8 @@ parent directory of the **hg** executabl
4263
078df530ebdb 21029166 mercurial 3.4
Danek Duvall <danek.duvall@oracle.com>
parents: 3596
diff changeset
   113
 
078df530ebdb 21029166 mercurial 3.4
Danek Duvall <danek.duvall@oracle.com>
parents: 3596
diff changeset
   114
 Per-installation configuration files are for the system on
078df530ebdb 21029166 mercurial 3.4
Danek Duvall <danek.duvall@oracle.com>
parents: 3596
diff changeset
   115
 which Mercurial is running. Options in these files apply to all
078df530ebdb 21029166 mercurial 3.4
Danek Duvall <danek.duvall@oracle.com>
parents: 3596
diff changeset
   116
-Mercurial commands executed by any user in any directory. Registry
078df530ebdb 21029166 mercurial 3.4
Danek Duvall <danek.duvall@oracle.com>
parents: 3596
diff changeset
   117
-keys contain PATH-like strings, every part of which must reference
078df530ebdb 21029166 mercurial 3.4
Danek Duvall <danek.duvall@oracle.com>
parents: 3596
diff changeset
   118
-a ``Mercurial.ini`` file or be a directory where ``*.rc`` files will
078df530ebdb 21029166 mercurial 3.4
Danek Duvall <danek.duvall@oracle.com>
parents: 3596
diff changeset
   119
-be read.  Mercurial checks each of these locations in the specified
078df530ebdb 21029166 mercurial 3.4
Danek Duvall <danek.duvall@oracle.com>
parents: 3596
diff changeset
   120
+Mercurial commands executed by any user in any directory.
078df530ebdb 21029166 mercurial 3.4
Danek Duvall <danek.duvall@oracle.com>
parents: 3596
diff changeset
   121
+Mercurial checks each of these locations in the specified
078df530ebdb 21029166 mercurial 3.4
Danek Duvall <danek.duvall@oracle.com>
parents: 3596
diff changeset
   122
 order until one or more configuration files are detected.
078df530ebdb 21029166 mercurial 3.4
Danek Duvall <danek.duvall@oracle.com>
parents: 3596
diff changeset
   123
 
078df530ebdb 21029166 mercurial 3.4
Danek Duvall <danek.duvall@oracle.com>
parents: 3596
diff changeset
   124
 Per-system configuration files are for the system on which Mercurial
5481
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   125
@@ -535,14 +494,6 @@ filtered by the command. The string ``OU
1637
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
   126
 of an empty temporary file, where the filtered data must be written by
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
   127
 the command.
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
   128
 
5481
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   129
-.. container:: windows
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   130
-
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   131
-   .. note::
1981
66b174f4707e 19144423 mercurial 3.0.1
Danek Duvall <danek.duvall@oracle.com>
parents: 1637
diff changeset
   132
-
5481
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   133
-     The tempfile mechanism is recommended for Windows systems,
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   134
-     where the standard shell I/O redirection operators often have
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   135
-     strange effects and may corrupt the contents of your files.
1637
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
   136
-
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
   137
 This filter mechanism is used internally by the ``eol`` extension to
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
   138
 translate line ending characters between Windows (CRLF) and Unix (LF)
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
   139
 format. We suggest you use the ``eol`` extension for convenience.
5481
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   140
@@ -941,13 +892,6 @@ variables it is passed are listed with n
1637
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
   141
    Also, hooks like "commit" will be called in all contexts that
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
   142
    generate a commit (e.g. tag) and not just the commit command.
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
   143
 
1981
66b174f4707e 19144423 mercurial 3.0.1
Danek Duvall <danek.duvall@oracle.com>
parents: 1637
diff changeset
   144
-.. note::
66b174f4707e 19144423 mercurial 3.0.1
Danek Duvall <danek.duvall@oracle.com>
parents: 1637
diff changeset
   145
-
66b174f4707e 19144423 mercurial 3.0.1
Danek Duvall <danek.duvall@oracle.com>
parents: 1637
diff changeset
   146
-   Environment variables with empty values may not be passed to
1637
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
   147
-   hooks on platforms such as Windows. As an example, ``$HG_PARENT2``
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
   148
-   will have an empty value under Unix-like platforms for non-merge
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
   149
-   changesets, while it will not be available at all under Windows.
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
   150
-
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
   151
 The syntax for Python hooks is as follows::
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
   152
 
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
   153
   hookname = python:modulename.submodule.callable
5481
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   154
@@ -1046,7 +990,6 @@ Example ``~/.hgrc``::
1637
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
   155
 
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
   156
   # Define new tool
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
   157
   myHtmlTool.args = -m $local $other $base $output
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
   158
-  myHtmlTool.regkey = Software\FooSoftware\HtmlMerge
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
   159
   myHtmlTool.priority = 1
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
   160
 
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
   161
 Supported arguments:
5481
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   162
@@ -1058,11 +1001,6 @@ Supported arguments:
1637
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
   163
 ``executable``
5481
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   164
   Either just the name of the executable or its pathname.
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   165
 
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   166
-  .. container:: windows
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   167
-
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   168
-    On Windows, the path can use environment variables with ${ProgramFiles}
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   169
-    syntax.
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   170
-
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   171
   (default: the tool name)
1637
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
   172
 
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
   173
 ``args``
5481
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   174
@@ -1110,30 +1048,6 @@ Supported arguments:
1637
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
   175
 ``gui``
5481
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   176
   This tool requires a graphical interface to run. (default: False)
1637
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
   177
 
5481
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   178
-.. container:: windows
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   179
-
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   180
-  ``regkey``
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   181
-    Windows registry key which describes install location of this
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   182
-    tool. Mercurial will search for this key first under
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   183
-    ``HKEY_CURRENT_USER`` and then under ``HKEY_LOCAL_MACHINE``.
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   184
-    (default: None)
1637
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
   185
-
5481
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   186
-  ``regkeyalt``
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   187
-    An alternate Windows registry key to try if the first key is not
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   188
-    found.  The alternate key uses the same ``regname`` and ``regappend``
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   189
-    semantics of the primary key.  The most common use for this key
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   190
-    is to search for 32bit applications on 64bit operating systems.
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   191
-    (default: None)
1637
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
   192
-
5481
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   193
-  ``regname``
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   194
-    Name of value to read from specified registry key.
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   195
-    (default: the unnamed (default) value)
1637
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
   196
-
5481
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   197
-  ``regappend``
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   198
-    String to append to the value read from the registry, typically
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   199
-    the executable name of the tool.
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   200
-    (default: None)
1637
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
   201
-
5481
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   202
 
1637
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
   203
 ``patch``
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
   204
 ---------
5481
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   205
@@ -1658,10 +1572,6 @@ User interface controls.
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   206
     ``false``
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   207
       Alias for ``ignore``.
1637
54bd5ac8db85 18050227 mercurial 2.8.2
Danek Duvall <danek.duvall@oracle.com>
parents:
diff changeset
   208
 
5481
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   209
-    .. container:: windows
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   210
-
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   211
-      On Windows, this configuration option is ignored and the command aborted.
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   212
-
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   213
 ``quiet``
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   214
     Reduce the amount of output printed.
5e30cd0645e7 21549200 mercurial 3.7.1
Danek Duvall <danek.duvall@oracle.com>
parents: 4263
diff changeset
   215
     (default: False)