Mercurial > hg
comparison doc/hgrc.5.txt @ 11221:e655b378ce73 stable
doc: clarify that sections can be split
author | Angel Ezquerra |
---|---|
date | Tue, 25 May 2010 18:19:40 +0200 |
parents | 157f9de9ad2a |
children | e7adcef1504b |
comparison
equal
deleted
inserted
replaced
11220:157f9de9ad2a | 11221:e655b378ce73 |
---|---|
110 eggs=large | 110 eggs=large |
111 ham=serrano | 111 ham=serrano |
112 eggs=small | 112 eggs=small |
113 | 113 |
114 This would set the configuration key named ``eggs`` to ``small``. | 114 This would set the configuration key named ``eggs`` to ``small``. |
115 | |
116 It is also possible to define a section multiple times. A section can | |
117 be redefined on the same and/or on different hgrc files. For example:: | |
118 | |
119 [foo] | |
120 eggs=large | |
121 ham=serrano | |
122 eggs=small | |
123 | |
124 [bar] | |
125 eggs=ham | |
126 green= | |
127 eggs | |
128 | |
129 [foo] | |
130 ham=prosciutto | |
131 eggs=medium | |
132 bread=toasted | |
133 | |
134 This would set the ``eggs``, ``ham``, and ``bread`` configuration keys | |
135 of the ``foo`` section to ``medium``, ``prosciutto``, and ``toasted``, | |
136 respectively. As you can see there only thing that matters is the last | |
137 value that was set for each of the configuration keys. | |
138 | |
139 If a configuration key is set multiple times in different | |
140 configuration files the final value will depend on the order in which | |
141 the different configuration files are read, with settings from earlier | |
142 paths overriding later ones as described on the ``Files`` section | |
143 above. | |
115 | 144 |
116 A line of the form ``%include file`` will include ``file`` into the | 145 A line of the form ``%include file`` will include ``file`` into the |
117 current configuration file. The inclusion is recursive, which means | 146 current configuration file. The inclusion is recursive, which means |
118 that included files can include other files. Filenames are relative to | 147 that included files can include other files. Filenames are relative to |
119 the configuration file in which the ``%include`` directive is found. | 148 the configuration file in which the ``%include`` directive is found. |