|
Size: 9911
Comment: Added casestop, makewritable and timestamp extensions
|
Size: 9921
Comment: converted to 1.6 markup
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 23: | Line 23: |
| || '''hgcia''' || HgciaExtension || Send notifications to [http://cia.navi.cx CIA] || | || '''hgcia''' || HgciaExtension || Send notifications to [[http://cia.navi.cx|CIA]] || |
| Line 69: | Line 69: |
| || '''forest''' || ForestExtension || Manage a bunch of mercurial repos as a meta repository, with snapshot support [http://www.selenic.com/pipermail/mercurial/2006-July/009336.html thread] || || '''ftp''' || ["FTPExtension"] || Manage uploaded snapshots on FTP server || |
|| '''forest''' || ForestExtension || Manage a bunch of mercurial repos as a meta repository, with snapshot support [[http://www.selenic.com/pipermail/mercurial/2006-July/009336.html|thread]] || || '''ftp''' || [[FTPExtension]] || Manage uploaded snapshots on FTP server || |
| Line 74: | Line 74: |
| || '''hgsubversion''' || HgSubversion || Use Mercurial as a [http://subversion.tigris.org/ Subversion] client || | || '''hgsubversion''' || HgSubversion || Use Mercurial as a [[http://subversion.tigris.org/|Subversion]] client || |
| Line 85: | Line 85: |
| || '''postreview''' || ReviewboardExtension || Post changesets for review to a [http://www.review-board.org/ Review Board] server || | || '''postreview''' || ReviewboardExtension || Post changesets for review to a [[http://www.review-board.org/|Review Board]] server || |
| Line 102: | Line 102: |
| To load an extension, you add it to the "extensions" section of your [http://www.selenic.com/mercurial/hgrc.5.html .hgrc] file. | To load an extension, you add it to the "extensions" section of your [[http://www.selenic.com/mercurial/hgrc.5.html|.hgrc]] file. |
Using Mercurial extensions
Mercurial features an extension mechanism for adding new commands.
Extensions allow the creation of new features and using them directly from the main hg command line as if they were builtin commands.
1. Extensions Bundled with Mercurial
Name |
Page |
Description |
acl |
Manage commit access to parts of a repo using control lists |
|
alias |
user-defined command aliases |
|
bisect |
Quickly find the revision that introduces a bug or feature bisecting the history tree (O(log(n)). Built-in since Mercurial 1.0 |
|
bookmarks |
Markers on commits that move on commit |
|
bugzilla |
Update Bugzilla entries when a bug id is referenced in a changeset |
|
children |
Display children revisions |
|
churn |
Show change statistics for mercurial operations per author |
|
convert |
Convert repositories from other SCMs into Mercurial |
|
color |
Color output for the diff, status and qseries commands |
|
extdiff |
Compare changes using external programs |
|
fetch |
Conveniently pull, merge and update in one step |
|
gpg |
Sign changesets and check signatures using GPG |
|
graphlog |
Show revision history alongside an ASCII revision graph |
|
hgcia |
Send notifications to CIA |
|
hgk |
Graphical repository and history browser based on gitk |
|
highlight |
Highlight syntax in the file revision view of hgweb |
|
imerge |
Perform interactive, interruptible merges |
|
inotify |
Use linux 2.6 inotify API for instantaneous status updates |
|
interhg |
This extension allows you to change changelog and summary text just like InterWiki way |
|
keyword |
use CVS like keyword expansion in tracked files |
|
mq |
Mercurial Patch Queues - manage changes as series of patches |
|
notify |
Send email to subscribed addresses to notify repository changes |
|
pager |
Allows you to choose a pager |
|
parentrevspec |
use foo^ to refer to the parent of revision foo |
|
patchbomb |
Send a collection of changesets as a series of patch emails |
|
purge |
Purge all files and dirs in the repository that are not being tracked by Mercurial |
|
rebase |
move revisions from a point to another |
|
record |
Select working directory changes to commit by hunk à la darcs record |
|
transplant |
Cherry-picking, rebasing and changeset rewriting |
|
win32mbcs |
Allow to use shift_jis/big5 filenames on Windows. |
|
win32text |
Manage line ending conversion for Windows repositories |
|
zeroconf |
Announce and browser respositories via zeroconf/bonjour |
2. Extensions provided by others
Name |
Page |
Description |
activity |
Create an image representing the activity of the repository |
|
attic |
Easily deal with individual patches |
|
autopager |
Invoke pager when output is longer than one screen |
|
boundmode |
Enables a bound mode (commit command auto-pushes) |
|
casestop |
Stops case-folding conflicts on commit |
|
changelog |
Auto-generate commit message from changelog entry |
|
chart |
Display activity graphs (see also ActivityExtension and ChurnExtension) |
|
commits |
Commit modified files as multiple changesets at once |
|
config |
Manage config files via command line only |
|
config |
Manage hgrc files via dialogs and command line |
|
cutehg |
A growing set of easy to install and use dialogs for mercurial commands. |
|
cvscommit |
Push changesets to CVS |
|
defpasswd |
Automatically provide credentials (username/passwords) read from a file. |
|
deps |
Create and manage versioned repository dependencies |
|
digest |
Create and use small digest files for outgoing/bundle |
|
diffstat |
Shortcut commands for displaying diffstat |
|
dotlog |
Yet Another DOT grapher |
|
easycommit |
Command-line GUI for committing changes |
|
easymerge |
Command-line GUI for merging |
|
fastimport |
Read a git "fast import" stream and turn it into changesets in a Mercurial repository |
|
fixcase |
Fix problems where an external tool has changed the case of a filename |
|
fixutf8 |
Fix problems on non-utf8 systems with filenames (Windows never supports utf8 filenames) |
|
foreign |
Interactively register or delete foreign/unknown files |
|
forest |
Manage a bunch of mercurial repos as a meta repository, with snapshot support thread |
|
ftp |
Manage uploaded snapshots on FTP server |
|
graphviz |
Generate DOT language source to visualize changeset tree |
|
group |
Allow to visually regroup a set of changesets |
|
hg-git |
Push to and pull from a Git server |
|
hgsubversion |
Use Mercurial as a Subversion client |
|
hgtrac |
Mercurial/Trac Integration Hook (pre/post hooks for Trac/Mercurial) |
|
histedit |
Edit, fold, drop changesets in the style of git rebase --interactive |
|
histpush |
Record locally which revisions have been pushed |
|
info |
Display basic information about a repository |
|
kerberos |
Kerberos Authentication over HTTP support |
|
localbranch |
Create clones inside your working directory |
|
makewritable |
Interactively removes read-only flags from files |
|
mbox |
Import patches from unix mailboxes in MQ |
|
nearest |
Display the nearest tag from a given changeset |
|
pbranch |
Collaborative and/or long-term patch development and maintenance |
|
postreview |
Post changesets for review to a Review Board server |
|
qct |
Provide access to the Qct commit tool |
|
qtimes |
Save or restore modification times of files affected by patch queue |
|
qup |
Move MQ patches to top of unapplied part of series |
|
rcpath |
Displays Mercurial configuration file paths and names |
|
rdiff |
Allow diff to work against remote repositories |
|
reposettings |
Allow repo specific configuration from central configuration files |
|
schemes |
Add shortcuts to urls as url schemes |
|
send |
Automatic send of bundle containing changesets missing on remote, like darcs send |
|
sharedrepo |
Let multiple working directories share the same repository |
|
shelve |
Interactively select changes to set aside |
|
sonichg |
Record pushlog data, web interfaces to view pushlog & shortlog with slider, advanced search for pushlog, new file log page, full side-by-side diffs, regex filter, commit syntax warning and more! |
|
tasks |
Manage tasks as collections of contiguous changesets |
|
timestamp |
Saves and restores file timestamps |
3. Enabling an extension
To load an extension, you add it to the "extensions" section of your .hgrc file.
Mercurial will scan the default python library path for a file named hgk.py if you set hgk empty:
[extensions] hgk=
Extensions are usually located in the hgext directory, and that is the recommended directory to place them. In this case you can load them like:
[extensions] hgext.hgk=
You can also specify an absolute path:
[extensions] hgk=/usr/local/lib/hgk.py
Extensions can often be configured further in an extension specific section in the same configuration file.
See CategoryExtension for a more complete list and WritingExtensions for more information about the installation and writing of new extensions.