|
Size: 1539
Comment: add install instructions to config section
|
← Revision 15 as of 2016-10-25 15:39:56 ⇥
Size: 2275
Comment: "crecord = commit -i" is cross-platform, whereas "crecord = !$HG commit -i" depends on a Bourne-like shell (Windows would need "crecord = !%HG% commit -i" that way)
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 1: | Line 1: |
| == Crecord Extension == | #pragma section-numbers 2 = Crecord Extension = |
| Line 3: | Line 4: |
| '''This extension is not distributed with Mercurial.''' | <<TableOfContents(3)>> == Status == '''This extension has been incorporated into Mercurial''' (since v3.8.1). |
| Line 7: | Line 12: |
| Information / download site: http://www.bitbucket.org/edgimar/mercurial-crew/wiki/Home | Web page: http://www.bitbucket.org/edgimar/crecord/wiki/Home |
| Line 9: | Line 14: |
| === Overview === | Repository: https://bitbucket.org/edgimar/crecord |
| Line 11: | Line 16: |
| The crecord extension is a curses (i.e. text-based GUI) interface which provides the `crecord` and `qcrecord` commands that may be used in lieu of `commit` or `qnew -f`. These commands let you choose which parts of the changes in a working directory you'd like to commit, at the granularity of patch hunks or lines. It is similar in spirit to the [http://darcs.net/manual/node7.html#SECTION00761000000000000000 darcs record] command and the RecordExtension. | == Overview == The crecord extension is a curses (i.e. text-based GUI) interface which provides the `crecord` and `qcrecord` commands that may be used in lieu of `commit` or `qnew -f`. These commands let you choose which parts of the changes in a working directory you'd like to commit, at the granularity of patch hunks or lines. It is similar in spirit to the [[http://darcs.net/manual/node7.html#SECTION00761000000000000000|darcs record]] command and the RecordExtension. |
| Line 13: | Line 19: |
| === Features === | == Features == |
| Line 15: | Line 21: |
| Line 19: | Line 26: |
| * Final patch can be reviewed / modified in an external editor prior to committing | |
| Line 20: | Line 28: |
| === Configuration === To install the extension, first download the crecord.py file from the site above, and put it in a folder where you prefer to keep extensions (e.g. $HOME/hgext). |
== Configuration == |
| Line 23: | Line 30: |
| Configure your .hgrc file to enable the extension by adding following lines: | === For Mercurial v3.8.1 and later === Configure your `.hgrc` file to enable the extension by adding following lines: {{{ [ui] interface = curses }}} The curses interface will be used by all interactive commits, e.g. {{{ hg commit -i }}} You may add an alias to the `.hgrc` to mimic the old call to crecord: {{{ [alias] crecord = commit -i }}} === For older Mercurial versions === Users of older versions of Mercurial (< 3.8.1) can install the extension by downloading the crecord archive from the site above, and extracting it to a folder where you prefer to keep extensions (e.g. `$HOME/hgext`). Enable the extension by adding the following to your `.hgrc`: |
| Line 27: | Line 57: |
| hgext.crecord=/path/to/crecord.py | hgext.crecord=/path/to/crecord/package |
| Line 30: | Line 60: |
| (note: the package directory is the one containing the `__init__.py` file) |
|
| Line 31: | Line 63: |
| CategoryExtension | CategoryExtensionsByOthers |
Crecord Extension
Contents
1. Status
This extension has been incorporated into Mercurial (since v3.8.1).
Author: Mark Edgington
Web page: http://www.bitbucket.org/edgimar/crecord/wiki/Home
Repository: https://bitbucket.org/edgimar/crecord
2. Overview
The crecord extension is a curses (i.e. text-based GUI) interface which provides the crecord and qcrecord commands that may be used in lieu of commit or qnew -f. These commands let you choose which parts of the changes in a working directory you'd like to commit, at the granularity of patch hunks or lines. It is similar in spirit to the darcs record command and the RecordExtension.
3. Features
In addition to allowing you to choose changes to commit at a line-level granularity, crecord has the following advantages over the text-only RecordExtension:
- Ability to scroll through all changes, jumping back and forth between changes.
- Patch headers and hunks can be folded to make it easy to view only the changes you're interested in.
- Commit message can be incrementally edited as you work through the changes
- Color display of changes and trailing whitespace
- Final patch can be reviewed / modified in an external editor prior to committing
4. Configuration
4.1. For Mercurial v3.8.1 and later
Configure your .hgrc file to enable the extension by adding following lines:
[ui] interface = curses
The curses interface will be used by all interactive commits, e.g.
hg commit -i
You may add an alias to the .hgrc to mimic the old call to crecord:
[alias] crecord = commit -i
4.2. For older Mercurial versions
Users of older versions of Mercurial (< 3.8.1) can install the extension by downloading the crecord archive from the site above, and extracting it to a folder where you prefer to keep extensions (e.g. $HOME/hgext). Enable the extension by adding the following to your .hgrc:
[extensions] hgext.crecord=/path/to/crecord/package
(note: the package directory is the one containing the __init__.py file)