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