Show More
@@ -12,18 +12,21 b' import extensions, revset, fileset, temp' | |||||
12 | import encoding, util, minirst |
|
12 | import encoding, util, minirst | |
13 | import cmdutil |
|
13 | import cmdutil | |
14 |
|
14 | |||
15 | def listexts(header, exts, indent=1): |
|
15 | def listexts(header, exts, indent=1, showdeprecated=False): | |
16 | '''return a text listing of the given extensions''' |
|
16 | '''return a text listing of the given extensions''' | |
17 | rst = [] |
|
17 | rst = [] | |
18 | if exts: |
|
18 | if exts: | |
19 | rst.append('\n%s\n\n' % header) |
|
19 | rst.append('\n%s\n\n' % header) | |
20 | for name, desc in sorted(exts.iteritems()): |
|
20 | for name, desc in sorted(exts.iteritems()): | |
|
21 | if '(DEPRECATED)' in desc and not showdeprecated: | |||
|
22 | continue | |||
21 | rst.append('%s:%s: %s\n' % (' ' * indent, name, desc)) |
|
23 | rst.append('%s:%s: %s\n' % (' ' * indent, name, desc)) | |
22 | return rst |
|
24 | return rst | |
23 |
|
25 | |||
24 | def extshelp(): |
|
26 | def extshelp(): | |
25 | rst = loaddoc('extensions')().splitlines(True) |
|
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 | rst.extend(listexts(_('disabled extensions:'), extensions.disabled())) |
|
30 | rst.extend(listexts(_('disabled extensions:'), extensions.disabled())) | |
28 | doc = ''.join(rst) |
|
31 | doc = ''.join(rst) | |
29 | return doc |
|
32 | return doc |
@@ -198,6 +198,89 b' Short help:' | |||||
198 | templating Template Usage |
|
198 | templating Template Usage | |
199 | urls URL Paths |
|
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 | Test short command list with verbose option |
|
284 | Test short command list with verbose option | |
202 |
|
285 | |||
203 | $ hg -v help shortlist |
|
286 | $ hg -v help shortlist |
General Comments 0
You need to be logged in to leave comments.
Login now