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