hg-allpaths: README.txt annotate

annotate README.txt @ 77:772d75b1a030

Fallback to normal Mercurial API if `mercurial_extension_utils` isn't found.

author	Ludovic Chabant <ludovic@chabant.com>
date	Sun, 20 Aug 2017 16:24:22 -0700
parents	d262139732f7
children

rev	line source
4 7591d4101b93 Added preliminary setup.py Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 3 diff changeset	1 .. -- mode: rst; compile-command: "rst2html README.txt README.html" --
0 6f92e4c814d1 Initial commit. Ludovic Chabant <ludovic@chabant.com> parents: diff changeset	2
10 62880e909417 README updates after changes Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 5 diff changeset	3 ================================================
13 8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	4 Mercurial All Paths extension
10 62880e909417 README updates after changes Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 5 diff changeset	5 ================================================
0 6f92e4c814d1 Initial commit. Ludovic Chabant <ludovic@chabant.com> parents: diff changeset	6
13 8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	7 Push or pull to many (or all) paths at once.
53 e710d5bec0b5 Badge. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 41 diff changeset	8 \|drone-badge\|
13 8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	9
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	10 .. contents::
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	11 :local:
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	12 :depth: 2
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	13
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	14 .. sectnum::
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	15
36 c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	16 Basic usage
13 8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	17 ================================================
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	18
36 c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	19 Execute::
10 62880e909417 README updates after changes Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 5 diff changeset	20
62880e909417 README updates after changes Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 5 diff changeset	21 hg pushall
0 6f92e4c814d1 Initial commit. Ludovic Chabant <ludovic@chabant.com> parents: diff changeset	22
36 c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	23 to push to all remotes which are defined for the repository. Or::
10 62880e909417 README updates after changes Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 5 diff changeset	24
62880e909417 README updates after changes Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 5 diff changeset	25 hg pullall
0 6f92e4c814d1 Initial commit. Ludovic Chabant <ludovic@chabant.com> parents: diff changeset	26
36 c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	27 to pull from all remotes in order.
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	28
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	29 There are also::
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	30
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	31 hg incomingall
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	32
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	33 hg outgoingall
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	34
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	35 Standard push/pull options can be given, for example::
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	36
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	37 hg pushall -f -B issue-13724
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	38
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	39 hg pullall -r stable --insecure
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	40
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	41 Those commands iterate over all paths returned by ``hg paths``. This
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	42 usually means iterating over paths defined in ``[paths]`` section of
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	43 ``.hg/hgrc``, but `Path Pattern`_ paths are also handled. You can
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	44 impact this behaviour by configuration, see below.
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	45
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	46
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	47 Defining path groups
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	48 ================================================
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	49
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	50 Instead of pushing/pulling everywhere, you can define and use groups::
0 6f92e4c814d1 Initial commit. Ludovic Chabant <ludovic@chabant.com> parents: diff changeset	51
10 62880e909417 README updates after changes Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 5 diff changeset	52 hg pushall -g publish
0 6f92e4c814d1 Initial commit. Ludovic Chabant <ludovic@chabant.com> parents: diff changeset	53
36 c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	54 pushes to all paths from the ``publish`` group (where ``publish`` is
41 b8a7342fbf23 outgoingall and incomingall can't handle -g as it is already taken, Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 36 diff changeset	55 symbolic name of your choosing). Or::
b8a7342fbf23 outgoingall and incomingall can't handle -g as it is already taken, Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 36 diff changeset	56
b8a7342fbf23 outgoingall and incomingall can't handle -g as it is already taken, Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 36 diff changeset	57 hg pullall -g shared
b8a7342fbf23 outgoingall and incomingall can't handle -g as it is already taken, Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 36 diff changeset	58
b8a7342fbf23 outgoingall and incomingall can't handle -g as it is already taken, Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 36 diff changeset	59 pulls from all paths in ``shared`` group.
36 c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	60
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	61 There are two ways to define such a group:
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	62
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	63 1. Define appropriate entry in ``[all_paths]`` section (either in ``.hg/hgrc``
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	64 or in your global ``~/.hgrc``). For example::
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	65
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	66 [all_paths]
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	67 group.publish = bitbucket github backup
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	68
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	69 (path aliases ``bitbucket``, ``github`` and ``backup`` must
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	70 be somehow defined).
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	71
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	72 2. (Legacy method) Put the section of the same name in ``.hg/hgrc``,
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	73 and define all paths there. For example::
0 6f92e4c814d1 Initial commit. Ludovic Chabant <ludovic@chabant.com> parents: diff changeset	74
6f92e4c814d1 Initial commit. Ludovic Chabant <ludovic@chabant.com> parents: diff changeset	75 [publish]
6f92e4c814d1 Initial commit. Ludovic Chabant <ludovic@chabant.com> parents: diff changeset	76 bitbucket = ssh://hg@bitbucket.org/ludovicchabant/piecrust
6f92e4c814d1 Initial commit. Ludovic Chabant <ludovic@chabant.com> parents: diff changeset	77 github = git+ssh://git@github.com:ludovicchabant/PieCrust.git
36 c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	78 backup = ssh://ludo@backup.local/piecrust
0 6f92e4c814d1 Initial commit. Ludovic Chabant <ludovic@chabant.com> parents: diff changeset	79
36 c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	80 The syntax is the same as in standard ``[paths]`` section, just
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	81 name the section with the name of your group.
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	82
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	83 .. note::
10 62880e909417 README updates after changes Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 5 diff changeset	84
36 c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	85 Be careful to avoid conflicts with names which mean something
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	86 to Mercurial. For example ``web`` would be a bad name as ``[web]``
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	87 section configures ``hg serve`` behaviour, and ``ui`` would be
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	88 fatal as ``[ui]`` configures various basic Mercurial settings.
0 6f92e4c814d1 Initial commit. Ludovic Chabant <ludovic@chabant.com> parents: diff changeset	89
36 c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	90 I recommend the former method as it avoids the risk of conflicts,
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	91 makes it easy to define groups globally instead of defining them for
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	92 every repository (especially handy if you use `Path Pattern`_), and is
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	93 more compact.
0 6f92e4c814d1 Initial commit. Ludovic Chabant <ludovic@chabant.com> parents: diff changeset	94
41 b8a7342fbf23 outgoingall and incomingall can't handle -g as it is already taken, Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 36 diff changeset	95 Groups are also handled for ``incomingall`` and ``outgoingall``, but
b8a7342fbf23 outgoingall and incomingall can't handle -g as it is already taken, Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 36 diff changeset	96 long ``--group`` option must be used (``-g`` is already taken by
b8a7342fbf23 outgoingall and incomingall can't handle -g as it is already taken, Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 36 diff changeset	97 standard Mercurial, means reporting in ``--git`` diff format)::
b8a7342fbf23 outgoingall and incomingall can't handle -g as it is already taken, Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 36 diff changeset	98
b8a7342fbf23 outgoingall and incomingall can't handle -g as it is already taken, Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 36 diff changeset	99 hg outgoingall --group publish
b8a7342fbf23 outgoingall and incomingall can't handle -g as it is already taken, Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 36 diff changeset	100
36 c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	101 Configuration
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	102 =======================================================
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	103
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	104 The extension can be configured using ``[all_paths]`` section of your
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	105 global (``~/.hgrc``) or repository-level (``.hg/hgrc``) config file::
10 62880e909417 README updates after changes Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 5 diff changeset	106
36 c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	107 [all_paths]
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	108 prioritize = platon department
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	109 ignore = bitbucket production
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	110 group.publish = github bitbucket
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	111 group.backup = homebackup awsbackup
10 62880e909417 README updates after changes Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 5 diff changeset	112
36 c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	113 ``prioritize`` impacts the order, defines paths which are to be
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	114 handled first (if present). This is mostly useful for ``pullall``
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	115 where pulling from local fast computer before pulling from BitBucket
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	116 server means saving some time and traffic. So::
13 8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	117
36 c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	118 prioritize = platon department
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	119
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	120 means: if path named ``platon`` is present, handle it first, then
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	121 path named ``department``, only then follow to other paths.
13 8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	122
36 c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	123 ``ignore`` lists paths which should be ignored, those remotes will
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	124 be skipped. So::
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	125
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	126 ignore = bitbucket production
13 8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	127
36 c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	128 means that ``hg pullall`` or ``hg pushall`` should not use
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	129 ``bitbucket`` path (in my case because this is HTTP remote, and I have
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	130 also preferable ``bitssh``configured), and ``production`` path (as
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	131 there I prefer to pull and push only on specific demand).
13 8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	132
36 c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	133 Both those settings impact only default commands (those run
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	134 without ``-g GROUP`` option). In case of groups items are processed
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	135 in the order they are specified in group definition.
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	136
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	137 ``group.«NAME»`` define group for ``-g «NAME»`` as described earlier.
c27e23a3509c Initial work on configuration Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 30 diff changeset	138
13 8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	139
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	140 Installation
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	141 =======================================================
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	142
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	143 From PyPi
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	144 --------------------
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	145
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	146 If you have working ``pip`` or ``easy_install``::
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	147
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	148 pip install --user mercurial_all_paths
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	149
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	150 or maybe::
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	151
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	152 sudo pip install mercurial_all_paths
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	153
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	154 Then activate by::
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	155
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	156 [extensions]
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	157 mercurial_all_paths =
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	158
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	159 To upgrade, repeat the same command with ``--upgrade`` option, for
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	160 example::
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	161
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	162 pip install --user --upgrade mercurial_all_paths
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	163
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	164 From source
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	165 -------------------------------------------------------
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	166
73 d262139732f7 Fixed to work against mercurial >= 4.1 (which requires using @command Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 53 diff changeset	167 If you don't have ``pip``, or wish to follow development more closely:
d262139732f7 Fixed to work against mercurial >= 4.1 (which requires using @command Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 53 diff changeset	168
d262139732f7 Fixed to work against mercurial >= 4.1 (which requires using @command Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 53 diff changeset	169 - clone both this repository and `mercurial_extension_utils`_ and put
d262139732f7 Fixed to work against mercurial >= 4.1 (which requires using @command Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 53 diff changeset	170 them in the same directory, for example::
13 8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	171
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	172 cd ~/sources
73 d262139732f7 Fixed to work against mercurial >= 4.1 (which requires using @command Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 53 diff changeset	173 hg clone https://bitbucket.org/Mekk/mercurial-extension_utils/
13 8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	174 hg clone https://bitbucket.org/Mekk/mercurial-all_paths/
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	175
73 d262139732f7 Fixed to work against mercurial >= 4.1 (which requires using @command Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 53 diff changeset	176 - update to newest tags,
13 8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	177
73 d262139732f7 Fixed to work against mercurial >= 4.1 (which requires using @command Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 53 diff changeset	178 - activate by::
13 8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	179
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	180 [extensions]
73 d262139732f7 Fixed to work against mercurial >= 4.1 (which requires using @command Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 53 diff changeset	181 mercurial_all_paths = ~/sources/mercurial-all_paths/mercurial_all_paths.py
13 8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	182
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	183 To upgrade, pull and update.
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	184
73 d262139732f7 Fixed to work against mercurial >= 4.1 (which requires using @command Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 53 diff changeset	185 Note that directory names matter. See `mercurial_extension_utils`_ for
d262139732f7 Fixed to work against mercurial >= 4.1 (which requires using @command Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 53 diff changeset	186 longer description of this kind of installation.
d262139732f7 Fixed to work against mercurial >= 4.1 (which requires using @command Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 53 diff changeset	187
16 a50e0e7a5195 HISTORY Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 13 diff changeset	188 History
a50e0e7a5195 HISTORY Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 13 diff changeset	189 =======================================================
a50e0e7a5195 HISTORY Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 13 diff changeset	190
a50e0e7a5195 HISTORY Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 13 diff changeset	191 See `HISTORY.txt`_
a50e0e7a5195 HISTORY Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 13 diff changeset	192
30 3f8c4b4a5cc6 README fixes after upstream merge (up-to-date info about two repos and Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 29 diff changeset	193 Development
13 8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	194 =======================================================
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	195
73 d262139732f7 Fixed to work against mercurial >= 4.1 (which requires using @command Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 53 diff changeset	196 Development is tracked on BitBucket, see
d262139732f7 Fixed to work against mercurial >= 4.1 (which requires using @command Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 53 diff changeset	197
d262139732f7 Fixed to work against mercurial >= 4.1 (which requires using @command Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 53 diff changeset	198 http://bitbucket.org/Mekk/mercurial-all_paths/
d262139732f7 Fixed to work against mercurial >= 4.1 (which requires using @command Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 53 diff changeset	199
d262139732f7 Fixed to work against mercurial >= 4.1 (which requires using @command Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 53 diff changeset	200 Original repository, maintained by Ludovic Chabant (lagging a bit at
d262139732f7 Fixed to work against mercurial >= 4.1 (which requires using @command Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 53 diff changeset	201 the moment):
30 3f8c4b4a5cc6 README fixes after upstream merge (up-to-date info about two repos and Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 29 diff changeset	202
3f8c4b4a5cc6 README fixes after upstream merge (up-to-date info about two repos and Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 29 diff changeset	203 https://bitbucket.org/ludovicchabant/allpaths
3f8c4b4a5cc6 README fixes after upstream merge (up-to-date info about two repos and Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 29 diff changeset	204
13 8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	205
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	206 Additional notes
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	207 =======================================================
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	208
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	209 Information about this extension is also available
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	210 on Mercurial Wiki: http://mercurial.selenic.com/wiki/AllPathsExtension
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	211
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 10 diff changeset	212
22 7bfb45910b19 Two more readme fixes Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 18 diff changeset	213 .. _Path Pattern: https://bitbucket.org/Mekk/mercurial-path_pattern/
7bfb45910b19 Two more readme fixes Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 18 diff changeset	214 .. _HISTORY.txt: http://bitbucket.org/Mekk/mercurial-all_paths/src/tip/HISTORY.txt
73 d262139732f7 Fixed to work against mercurial >= 4.1 (which requires using @command Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 53 diff changeset	215 .. _mercurial_extension_utils: https://bitbucket.org/Mekk/mercurial-extension_utils/
53 e710d5bec0b5 Badge. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 41 diff changeset	216
e710d5bec0b5 Badge. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 41 diff changeset	217 .. \|drone-badge\|
e710d5bec0b5 Badge. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 41 diff changeset	218 image:: https://drone.io/bitbucket.org/Mekk/mercurial-all_paths/status.png
e710d5bec0b5 Badge. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 41 diff changeset	219 :target: https://drone.io/bitbucket.org/Mekk/mercurial-all_paths/latest
e710d5bec0b5 Badge. Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl> parents: 41 diff changeset	220 :align: middle

Mercurial > hg-allpaths

annotate README.txt @ 77:772d75b1a030