Show More
@@ -12,18 +12,21 b' import extensions, revset, fileset, temp' | |||
|
12 | 12 | import encoding, util, minirst |
|
13 | 13 | import cmdutil |
|
14 | 14 | |
|
15 | def listexts(header, exts, indent=1): | |
|
15 | def listexts(header, exts, indent=1, showdeprecated=False): | |
|
16 | 16 | '''return a text listing of the given extensions''' |
|
17 | 17 | rst = [] |
|
18 | 18 | if exts: |
|
19 | 19 | rst.append('\n%s\n\n' % header) |
|
20 | 20 | for name, desc in sorted(exts.iteritems()): |
|
21 | if '(DEPRECATED)' in desc and not showdeprecated: | |
|
22 | continue | |
|
21 | 23 | rst.append('%s:%s: %s\n' % (' ' * indent, name, desc)) |
|
22 | 24 | return rst |
|
23 | 25 | |
|
24 | 26 | def extshelp(): |
|
25 | 27 | rst = loaddoc('extensions')().splitlines(True) |
|
26 | rst.extend(listexts(_('enabled extensions:'), extensions.enabled())) | |
|
28 | rst.extend(listexts( | |
|
29 | _('enabled extensions:'), extensions.enabled(), showdeprecated=True)) | |
|
27 | 30 | rst.extend(listexts(_('disabled extensions:'), extensions.disabled())) |
|
28 | 31 | doc = ''.join(rst) |
|
29 | 32 | return doc |
@@ -198,6 +198,89 b' Short help:' | |||
|
198 | 198 | templating Template Usage |
|
199 | 199 | urls URL Paths |
|
200 | 200 | |
|
201 | Test extension help: | |
|
202 | $ hg help extensions --config extensions.rebase= --config extensions.children= | |
|
203 | Using Additional Features | |
|
204 | """"""""""""""""""""""""" | |
|
205 | ||
|
206 | Mercurial has the ability to add new features through the use of | |
|
207 | extensions. Extensions may add new commands, add options to existing | |
|
208 | commands, change the default behavior of commands, or implement hooks. | |
|
209 | ||
|
210 | To enable the "foo" extension, either shipped with Mercurial or in the | |
|
211 | Python search path, create an entry for it in your configuration file, | |
|
212 | like this: | |
|
213 | ||
|
214 | [extensions] | |
|
215 | foo = | |
|
216 | ||
|
217 | You may also specify the full path to an extension: | |
|
218 | ||
|
219 | [extensions] | |
|
220 | myfeature = ~/.hgext/myfeature.py | |
|
221 | ||
|
222 | See "hg help config" for more information on configuration files. | |
|
223 | ||
|
224 | Extensions are not loaded by default for a variety of reasons: they can | |
|
225 | increase startup overhead; they may be meant for advanced usage only; they | |
|
226 | may provide potentially dangerous abilities (such as letting you destroy | |
|
227 | or modify history); they might not be ready for prime time; or they may | |
|
228 | alter some usual behaviors of stock Mercurial. It is thus up to the user | |
|
229 | to activate extensions as needed. | |
|
230 | ||
|
231 | To explicitly disable an extension enabled in a configuration file of | |
|
232 | broader scope, prepend its path with !: | |
|
233 | ||
|
234 | [extensions] | |
|
235 | # disabling extension bar residing in /path/to/extension/bar.py | |
|
236 | bar = !/path/to/extension/bar.py | |
|
237 | # ditto, but no path was supplied for extension baz | |
|
238 | baz = ! | |
|
239 | ||
|
240 | enabled extensions: | |
|
241 | ||
|
242 | children command to display child changesets (DEPRECATED) | |
|
243 | rebase command to move sets of revisions to a different ancestor | |
|
244 | ||
|
245 | disabled extensions: | |
|
246 | ||
|
247 | acl hooks for controlling repository access | |
|
248 | blackbox log repository events to a blackbox for debugging | |
|
249 | bugzilla hooks for integrating with the Bugzilla bug tracker | |
|
250 | churn command to display statistics about repository history | |
|
251 | color colorize output from some commands | |
|
252 | convert import revisions from foreign VCS repositories into | |
|
253 | Mercurial | |
|
254 | eol automatically manage newlines in repository files | |
|
255 | extdiff command to allow external programs to compare revisions | |
|
256 | factotum http authentication with factotum | |
|
257 | gpg commands to sign and verify changesets | |
|
258 | hgcia hooks for integrating with the CIA.vc notification service | |
|
259 | hgk browse the repository in a graphical way | |
|
260 | highlight syntax highlighting for hgweb (requires Pygments) | |
|
261 | histedit interactive history editing | |
|
262 | inotify accelerate status report using Linux's inotify service | |
|
263 | interhg expand expressions into changelog and summaries | |
|
264 | keyword expand keywords in tracked files | |
|
265 | largefiles track large binary files | |
|
266 | mq manage a stack of patches | |
|
267 | notify hooks for sending email push notifications | |
|
268 | pager browse command output with an external pager | |
|
269 | patchbomb command to send changesets as (a series of) patch emails | |
|
270 | progress show progress bars for some actions | |
|
271 | purge command to delete untracked files from the working | |
|
272 | directory | |
|
273 | record commands to interactively select changes for | |
|
274 | commit/qrefresh | |
|
275 | relink recreates hardlinks between repository clones | |
|
276 | schemes extend schemes with shortcuts to repository swarms | |
|
277 | share share a common history between several working directories | |
|
278 | shelve save and restore changes to the working directory | |
|
279 | strip strip changesets and their descendents from history | |
|
280 | transplant command to transplant changesets from another branch | |
|
281 | win32mbcs allow the use of MBCS paths with problematic encodings | |
|
282 | win32text perform automatic newline conversion | |
|
283 | zeroconf discover and advertise repositories on the local network | |
|
201 | 284 | Test short command list with verbose option |
|
202 | 285 | |
|
203 | 286 | $ hg -v help shortlist |
General Comments 0
You need to be logged in to leave comments.
Login now