annotate README.txt @ 50:55469dbb19c4

testfixes
author Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
date Sun, 25 Sep 2016 22:02:55 +0200
parents b8a7342fbf23
children e710d5bec0b5
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
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.
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation.
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 10
diff changeset
8
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation.
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 10
diff changeset
9 .. contents::
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation.
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 10
diff changeset
10 :local:
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation.
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 10
diff changeset
11 :depth: 2
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation.
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 10
diff changeset
12
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation.
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 10
diff changeset
13 .. sectnum::
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation.
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 10
diff changeset
14
36
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
15 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
16 ================================================
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation.
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 10
diff changeset
17
36
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
18 Execute::
10
62880e909417 README updates after changes
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 5
diff changeset
19
62880e909417 README updates after changes
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 5
diff changeset
20 hg pushall
0
6f92e4c814d1 Initial commit.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
21
36
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
22 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
23
62880e909417 README updates after changes
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 5
diff changeset
24 hg pullall
0
6f92e4c814d1 Initial commit.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
25
36
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
26 to pull from all remotes in order.
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
27
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
28 There are also::
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
29
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
30 hg incomingall
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
31
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
32 hg outgoingall
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
33
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
34 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
35
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
36 hg pushall -f -B issue-13724
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
37
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
38 hg pullall -r stable --insecure
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
39
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
40 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
41 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
42 ``.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
43 impact this behaviour by configuration, see below.
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
44
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 Defining path groups
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
47 ================================================
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 Instead of pushing/pulling everywhere, you can define and use *groups*::
0
6f92e4c814d1 Initial commit.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
50
10
62880e909417 README updates after changes
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 5
diff changeset
51 hg pushall -g publish
0
6f92e4c814d1 Initial commit.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
52
36
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
53 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
54 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
55
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 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
57
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 pulls from all paths in ``shared`` group.
36
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
59
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
60 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
61
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
62 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
63 or in your global ``~/.hgrc``). For example::
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
64
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
65 [all_paths]
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
66 group.publish = bitbucket github backup
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
67
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
68 (path aliases ``bitbucket``, ``github`` and ``backup`` must
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
69 be somehow defined).
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
70
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
71 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
72 and define all paths there. For example::
0
6f92e4c814d1 Initial commit.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
73
6f92e4c814d1 Initial commit.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
74 [publish]
6f92e4c814d1 Initial commit.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
75 bitbucket = ssh://hg@bitbucket.org/ludovicchabant/piecrust
6f92e4c814d1 Initial commit.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
76 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
77 backup = ssh://ludo@backup.local/piecrust
0
6f92e4c814d1 Initial commit.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
78
36
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
79 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
80 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
81
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
82 .. note::
10
62880e909417 README updates after changes
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 5
diff changeset
83
36
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
84 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
85 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
86 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
87 fatal as ``[ui]`` configures various basic Mercurial settings.
0
6f92e4c814d1 Initial commit.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
88
36
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
89 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
90 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
91 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
92 more compact.
0
6f92e4c814d1 Initial commit.
Ludovic Chabant <ludovic@chabant.com>
parents:
diff changeset
93
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
94 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
95 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
96 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
97
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 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
99
36
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
100 Configuration
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
101 =======================================================
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 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
104 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
105
36
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
106 [all_paths]
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
107 prioritize = platon department
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
108 ignore = bitbucket production
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
109 group.publish = github bitbucket
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
110 group.backup = homebackup awsbackup
10
62880e909417 README updates after changes
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 5
diff changeset
111
36
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
112 ``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
113 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
114 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
115 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
116
36
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
117 prioritize = platon department
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
118
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
119 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
120 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
121
36
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
122 ``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
123 be skipped. So::
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
124
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
125 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
126
36
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
127 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
128 ``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
129 also preferable ``bitssh``configured), and ``production`` path (as
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
130 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
131
36
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
132 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
133 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
134 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
135
c27e23a3509c Initial work on configuration
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 30
diff changeset
136 ``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
137
13
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation.
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 10
diff changeset
138
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation.
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 10
diff changeset
139 Installation
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation.
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 10
diff changeset
140 =======================================================
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 From PyPi
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation.
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 10
diff changeset
143 --------------------
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 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
146
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation.
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 10
diff changeset
147 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
148
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation.
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 10
diff changeset
149 or maybe::
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation.
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 10
diff changeset
150
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation.
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 10
diff changeset
151 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
152
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation.
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 10
diff changeset
153 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
154
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation.
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 10
diff changeset
155 [extensions]
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation.
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 10
diff changeset
156 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
157
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation.
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 10
diff changeset
158 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
159 example::
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation.
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 10
diff changeset
160
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation.
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 10
diff changeset
161 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
162
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation.
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 10
diff changeset
163 From source
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation.
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 10
diff changeset
164 -------------------------------------------------------
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 Clone this repository::
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation.
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 10
diff changeset
167
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation.
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 10
diff changeset
168 cd ~/sources
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation.
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 10
diff changeset
169 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
170
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation.
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 10
diff changeset
171 either::
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation.
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 10
diff changeset
172
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation.
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 10
diff changeset
173 pip install --user -e 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
174
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation.
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 10
diff changeset
175 and activate as above, or just activate by full path::
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation.
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 10
diff changeset
176
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation.
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 10
diff changeset
177 [extensions]
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation.
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 10
diff changeset
178 mercurial_path_pattern = ~/sources/mercurial-path_pattern/mercurial_path_pattern.py
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 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
181
16
a50e0e7a5195 HISTORY
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 13
diff changeset
182 History
a50e0e7a5195 HISTORY
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 13
diff changeset
183 =======================================================
a50e0e7a5195 HISTORY
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 13
diff changeset
184
a50e0e7a5195 HISTORY
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 13
diff changeset
185 See `HISTORY.txt`_
a50e0e7a5195 HISTORY
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 13
diff changeset
186
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
187 Development
13
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation.
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 10
diff changeset
188 =======================================================
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation.
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 10
diff changeset
189
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
190 Main extension repository, maintained by Ludovic Chabant, is available
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
191 at:
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
192
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 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
194
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
195 Fork by Marcin Kasperski, which is usually in sync, but at times may
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
196 contain some not-yet merged changes, is available at:
13
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation.
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 10
diff changeset
197
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation.
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 10
diff changeset
198 http://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
199
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation.
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 10
diff changeset
200 Additional notes
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation.
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 10
diff changeset
201 =======================================================
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation.
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 10
diff changeset
202
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation.
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 10
diff changeset
203 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
204 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
205
8cca585b11cc Module renamed to mercurial_all_paths for possible pypi installation.
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 10
diff changeset
206
22
7bfb45910b19 Two more readme fixes
Marcin Kasperski <Marcin.Kasperski@mekk.waw.pl>
parents: 18
diff changeset
207 .. _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
208 .. _HISTORY.txt: http://bitbucket.org/Mekk/mercurial-all_paths/src/tip/HISTORY.txt