48 result += ' %s %s\n' % (name.ljust(maxlength), desc) |
48 result += ' %s %s\n' % (name.ljust(maxlength), desc) |
49 return result |
49 return result |
50 |
50 |
51 def extshelp(): |
51 def extshelp(): |
52 doc = _(r''' |
52 doc = _(r''' |
53 Mercurial has a mechanism for adding new features through the |
53 Mercurial has the ability to add new features through the use of |
54 use of extensions. Extensions may bring new commands, or new |
54 extensions. Extensions may add new commands, add options to |
55 hooks, or change Mercurial's behavior. |
55 existing commands, change the default behavior of commands, or |
56 |
56 implement hooks. |
57 Extensions are not loaded by default for a variety of reasons, |
57 |
58 they may be meant for advanced users or provide potentially |
58 Extensions are not loaded by default for a variety of reasons: |
59 dangerous commands (e.g. mq and rebase allow history to be |
59 they can increase startup overhead; they may be meant for |
60 rewritten), they might not be ready for prime-time yet, or |
60 advanced usage only; they may provide potentially dangerous |
61 they may alter Mercurial's behavior. It is thus up to the user |
61 abilities (such as letting you destroy or modify history); they |
62 to activate extensions as desired. |
62 might not be ready for prime time; or they may alter some |
|
63 usual behaviors of stock Mercurial. It is thus up to the user to |
|
64 activate extensions as needed. |
63 |
65 |
64 To enable the "foo" extension, either shipped with Mercurial |
66 To enable the "foo" extension, either shipped with Mercurial |
65 or in the Python search path, create an entry for it in your |
67 or in the Python search path, create an entry for it in your |
66 hgrc, like this: |
68 hgrc, like this: |
67 |
69 |