Differences between revisions 37 and 38
Revision 37 as of 2013-05-03 22:49:31
Size: 2032
Editor: rcl
Comment: add TOC and link to Talk page
Revision 38 as of 2013-08-26 19:50:29
Size: 271
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
#pragma section-numbers 2
= Record Extension =
'''This extension is distributed with Mercurial.'''

''Author: Bryan O'Sullivan''

<<TableOfContents()>>

== Overview ==
The record extension provides the `record` command, which may be used in lieu of `commit`. This command lets you choose which parts of the changes in a working directory you'd like to commit, at the granularity of patch hunks. It is similar in spirit to the [[http://darcs.net/manual/Darcs_commands.html#SECTION00661000000000000000|darcs record]] command.

The record extension also provides the `qrecord` command, if MqExtension is enabled.

== Configuration ==
Configure your ''`.hgrc`'' to enable the extension by adding following lines:

{{{
[extensions]
record=
}}}

== Usage ==
{{{hg record [OPTION]... [FILE]...}}}

The option to examine changes is offered for each one of the selected files (or all the modified files if none is provided):

{{{
$ hg record my_dir/my_file.ext
examine changes to 'my_dir/my_file.ext'? [Ynsfdaq?]
}}}
where the following responses are possible:

{{{
    y - record this change
    n - skip this change

    s - skip remaining changes to this file
    f - record remaining changes to this file

    d - done, skip remaining changes and files
    a - record all changes to all remaining files
    q - quit, recording no changes

    ? - display help
}}}
If `y` is selected, then each of the patch hunks for the file are offered for acceptance or rejection:

{{{
@@ -164,5 +164,5 @@
                                     #nice comment
                                     ])
     elif options.action:
- print >>sys.stderr, "wrong action"
+ print >>sys.stderr, ";wrong action"
     else:
record this change to 'my_dir/my_file.ext'? [Ynsfdaq?]
}}}
where the previous options can be used with the same meaning.

After file and hunk selection is finished, a normal commit is recorded.

== See also ==
 * [[/Talk|Talk]] page
----
CategoryBundledExtension
Santa Cruz-born Zenia Murphy is undeniably addicted to [[http://italiasocial.altervista.org/index.php?do=/blog/45791/stress-free-travel-yes-its-possible/|Costa Blanca weather,]] rc airplanes and running. Lastly she is enthralled by spending time with her close friends.

Santa Cruz-born Zenia Murphy is undeniably addicted to Costa Blanca weather, rc airplanes and running. Lastly she is enthralled by spending time with her close friends.

RecordExtension (last edited 2016-03-28 19:59:08 by Pierre-YvesDavid)