Diff for "ForestExtension"

Differences between revisions 3 and 4

Forest Extension

This extension is not being distributed along with Mercurial.

It's being developed by Robin Farine and can be downloaded from its [http://www.terminus.org/hg/hgforest public development repository].

Overview

The Forest extension allows operations on trees with nested Mercurial repositories, called forests.

It provides some additional commands that apply to the forest. These commands are both standard Mercurial commands, such as 'clone' or 'status', that are applied recursively, and commands that involve a snapshot file, to represent the state of a forest at a given time.

The new commands defined by the extension are: fclone, fpull, fpush, fseed, fsnap, ftrees and fupdate

Configuration

Configure your .hgrc to enable the extension by adding following lines:

[extensions]
hgext.forest=
# or, if forest.py is not in the hgext dir:
# forest=/path/to/forest.py

Usage

To clone a forest:

hg fclone [OPTIONS] SOURCE DESTINATION

To pull/push/update all repos in the forest:

hg fpull [OPTIONS] SNAPSHOT-FILE PATH-ALIAS

hg fpush [OPTIONS] SNAPSHOT-FILE PATH-ALIAS

hg fupdate [OPTIONS] (--tip | SNAPSHOT-FILE)

To take a snapshot of a forest:

hg fsnap [OPTIONS] [SNAPSHOT-FILE]

To populate a forest according to a snapshot file:

hg fseed [OPTIONS] SNAPSHOT-FILE [PATH-ALIAS]

To display the status of the forest:

hg fstatus [OPTIONS]

To list the roots of repositories:

hg ftrees [OPTIONS]

-  ⇤ ← Revision 3 as of 2007-01-17 18:47:09 → 
  Size: 610
  Editor: RafaelVillarBurke
  Comment:
+   ← Revision 4 as of 2007-01-17 21:46:27 → ⇥
  Size: 1612
  Editor: RafaelVillarBurke
  Comment: Add additional content
-Deletions are marked like this.
+Additions are marked like this.
 Line 11:
-It provides commands that apply to the forest. These commands are both standard Mercurial commands, such as 'clone' or 'status', and commands that involve a snapshot file, to represent the state of a forest at a given time.
+It provides some additional commands that apply to the forest. These commands are both standard Mercurial commands, such as 'clone' or 'status', that are applied recursively, and commands that involve a snapshot file, to represent the state of a forest at a given time.

The new commands defined by the extension are: {{{fclone}}}, {{{fpull}}}, {{{fpush}}}, {{{fseed}}},  {{{fsnap}}}, {{{ftrees}}} and {{{fupdate}}}
-Line 14:
+Line 16:
+Configure your .hgrc to enable the extension by adding following lines:

{{{
[extensions]
hgext.forest=
# or, if forest.py is not in the hgext dir:
# forest=/path/to/forest.py
}}}

=== Usage ===

To clone a forest:

{{{hg fclone [OPTIONS] SOURCE DESTINATION}}}

To pull/push/update all repos in the forest:

{{{hg fpull [OPTIONS] SNAPSHOT-FILE PATH-ALIAS}}}

{{{hg fpush [OPTIONS] SNAPSHOT-FILE PATH-ALIAS}}}

{{{hg fupdate [OPTIONS] (--tip | SNAPSHOT-FILE)}}}

To take a snapshot of a forest:

{{{hg fsnap [OPTIONS] [SNAPSHOT-FILE]}}}

To populate a forest according to a snapshot file:

{{{hg fseed [OPTIONS] SNAPSHOT-FILE [PATH-ALIAS]}}}

To display the status of the forest:

{{{hg fstatus [OPTIONS]}}}

To list the roots of repositories:

{{{hg ftrees [OPTIONS]}}}