##// END OF EJS Templates
help: mention alias and revsetalias in description of HGPLAINEXCEPT
Yuya Nishihara -
r26827:a9ed5a8f stable
parent child Browse files
Show More
@@ -1,101 +1,107 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, use configuration file)
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, use configuration file)
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 only value supported is "i18n",
64 HGPLAIN is enabled. Currently the following values are supported:
65 which preserves internationalization in plain mode.
65
66 ``alias``
67 Don't remove aliases.
68 ``i18n``
69 Preserve internationalization.
70 ``revsetalias``
71 Don't remove revset aliases.
66
72
67 Setting HGPLAINEXCEPT to anything (even an empty string) will
73 Setting HGPLAINEXCEPT to anything (even an empty string) will
68 enable plain mode.
74 enable plain mode.
69
75
70 HGUSER
76 HGUSER
71 This is the string used as the author of a commit. If not set,
77 This is the string used as the author of a commit. If not set,
72 available values will be considered in this order:
78 available values will be considered in this order:
73
79
74 - HGUSER (deprecated)
80 - HGUSER (deprecated)
75 - configuration files from the HGRCPATH
81 - configuration files from the HGRCPATH
76 - EMAIL
82 - EMAIL
77 - interactive prompt
83 - interactive prompt
78 - LOGNAME (with ``@hostname`` appended)
84 - LOGNAME (with ``@hostname`` appended)
79
85
80 (deprecated, use configuration file)
86 (deprecated, use configuration file)
81
87
82 EMAIL
88 EMAIL
83 May be used as the author of a commit; see HGUSER.
89 May be used as the author of a commit; see HGUSER.
84
90
85 LOGNAME
91 LOGNAME
86 May be used as the author of a commit; see HGUSER.
92 May be used as the author of a commit; see HGUSER.
87
93
88 VISUAL
94 VISUAL
89 This is the name of the editor to use when committing. See EDITOR.
95 This is the name of the editor to use when committing. See EDITOR.
90
96
91 EDITOR
97 EDITOR
92 Sometimes Mercurial needs to open a text file in an editor for a
98 Sometimes Mercurial needs to open a text file in an editor for a
93 user to modify, for example when writing commit messages. The
99 user to modify, for example when writing commit messages. The
94 editor it uses is determined by looking at the environment
100 editor it uses is determined by looking at the environment
95 variables HGEDITOR, VISUAL and EDITOR, in that order. The first
101 variables HGEDITOR, VISUAL and EDITOR, in that order. The first
96 non-empty one is chosen. If all of them are empty, the editor
102 non-empty one is chosen. If all of them are empty, the editor
97 defaults to 'vi'.
103 defaults to 'vi'.
98
104
99 PYTHONPATH
105 PYTHONPATH
100 This is used by Python to find imported modules and may need to be
106 This is used by Python to find imported modules and may need to be
101 set appropriately if this Mercurial is not installed system-wide.
107 set appropriately if this Mercurial is not installed system-wide.
General Comments 0
You need to be logged in to leave comments. Login now