##// END OF EJS Templates
help: call out specific replacement configuration settings...
Matt Harbison -
r32140:40785cca stable
parent child Browse files
Show More
@@ -1,111 +1,111 b''
1 1 HG
2 2 Path to the 'hg' executable, automatically passed when running
3 3 hooks, extensions or external tools. If unset or empty, this is
4 4 the hg executable's name if it's frozen, or an executable named
5 5 'hg' (with %PATHEXT% [defaulting to COM/EXE/BAT/CMD] extensions on
6 6 Windows) is searched.
7 7
8 8 HGEDITOR
9 9 This is the name of the editor to run when committing. See EDITOR.
10 10
11 (deprecated, use configuration file)
11 (deprecated, see :hg:`help config.ui.editor`)
12 12
13 13 HGENCODING
14 14 This overrides the default locale setting detected by Mercurial.
15 15 This setting is used to convert data including usernames,
16 16 changeset descriptions, tag names, and branches. This setting can
17 17 be overridden with the --encoding command-line option.
18 18
19 19 HGENCODINGMODE
20 20 This sets Mercurial's behavior for handling unknown characters
21 21 while transcoding user input. The default is "strict", which
22 22 causes Mercurial to abort if it can't map a character. Other
23 23 settings include "replace", which replaces unknown characters, and
24 24 "ignore", which drops them. This setting can be overridden with
25 25 the --encodingmode command-line option.
26 26
27 27 HGENCODINGAMBIGUOUS
28 28 This sets Mercurial's behavior for handling characters with
29 29 "ambiguous" widths like accented Latin characters with East Asian
30 30 fonts. By default, Mercurial assumes ambiguous characters are
31 31 narrow, set this variable to "wide" if such characters cause
32 32 formatting problems.
33 33
34 34 HGMERGE
35 35 An executable to use for resolving merge conflicts. The program
36 36 will be executed with three arguments: local file, remote file,
37 37 ancestor file.
38 38
39 (deprecated, use configuration file)
39 (deprecated, see :hg:`help config.ui.merge`)
40 40
41 41 HGRCPATH
42 42 A list of files or directories to search for configuration
43 43 files. Item separator is ":" on Unix, ";" on Windows. If HGRCPATH
44 44 is not set, platform default search path is used. If empty, only
45 45 the .hg/hgrc from the current repository is read.
46 46
47 47 For each element in HGRCPATH:
48 48
49 49 - if it's a directory, all files ending with .rc are added
50 50 - otherwise, the file itself will be added
51 51
52 52 HGPLAIN
53 53 When set, this disables any configuration settings that might
54 54 change Mercurial's default output. This includes encoding,
55 55 defaults, verbose mode, debug mode, quiet mode, tracebacks, and
56 56 localization. This can be useful when scripting against Mercurial
57 57 in the face of existing user configuration.
58 58
59 59 Equivalent options set via command line flags or environment
60 60 variables are not overridden.
61 61
62 62 HGPLAINEXCEPT
63 63 This is a comma-separated list of features to preserve when
64 64 HGPLAIN is enabled. Currently the following values are supported:
65 65
66 66 ``alias``
67 67 Don't remove aliases.
68 68 ``i18n``
69 69 Preserve internationalization.
70 70 ``revsetalias``
71 71 Don't remove revset aliases.
72 72 ``templatealias``
73 73 Don't remove template aliases.
74 74 ``progress``
75 75 Don't hide progress output.
76 76
77 77 Setting HGPLAINEXCEPT to anything (even an empty string) will
78 78 enable plain mode.
79 79
80 80 HGUSER
81 81 This is the string used as the author of a commit. If not set,
82 82 available values will be considered in this order:
83 83
84 84 - HGUSER (deprecated)
85 85 - configuration files from the HGRCPATH
86 86 - EMAIL
87 87 - interactive prompt
88 88 - LOGNAME (with ``@hostname`` appended)
89 89
90 (deprecated, use configuration file)
90 (deprecated, see :hg:`help config.ui.username`)
91 91
92 92 EMAIL
93 93 May be used as the author of a commit; see HGUSER.
94 94
95 95 LOGNAME
96 96 May be used as the author of a commit; see HGUSER.
97 97
98 98 VISUAL
99 99 This is the name of the editor to use when committing. See EDITOR.
100 100
101 101 EDITOR
102 102 Sometimes Mercurial needs to open a text file in an editor for a
103 103 user to modify, for example when writing commit messages. The
104 104 editor it uses is determined by looking at the environment
105 105 variables HGEDITOR, VISUAL and EDITOR, in that order. The first
106 106 non-empty one is chosen. If all of them are empty, the editor
107 107 defaults to 'vi'.
108 108
109 109 PYTHONPATH
110 110 This is used by Python to find imported modules and may need to be
111 111 set appropriately if this Mercurial is not installed system-wide.
General Comments 0
You need to be logged in to leave comments. Login now