Mercurial > hg > mercurial-crew-with-dirclash
annotate contrib/purge/README @ 4168:bbfe5a3fc80c
Add a features list to branches.cache to detect caches of old hg versions.
The leading space in the written file makes sure that the feature list never
can match an existing version, even if the first feature can be read as hex.
Additionally old hg versions display the id with --debug, too.
author | Thomas Arendsen Hein <thomas@intevation.de> |
---|---|
date | Fri, 09 Mar 2007 19:12:03 +0100 |
parents | dbeaa4369121 |
children |
rev | line source |
---|---|
2364 | 1 What is "hg purge"? |
2 =================== | |
3 "purge" is a simple extension for the Mercurial source control management | |
4 system (http://www.selenic.com/mercurial). | |
5 This extension adds a "purge" command to "hg" that removes files not known | |
2368
eb1ec13e3b0d
Added a link to the home page of hg purge
demian@gaudron.lan
parents:
2367
diff
changeset
|
6 to Mercurial, this is useful to test local and uncommitted changes in the |
2364 | 7 otherwise clean source tree. |
8 | |
9 This means that Mercurial will delete: | |
10 - Unknown files: files marked with "?" by "hg status" | |
11 - Ignored files: files usually ignored by Mercurial because they match a | |
12 pattern in a ".hgignore" file | |
13 - Empty directories: infact Mercurial ignores directories unless they | |
14 contain files under source control managment | |
15 But it will leave untouched: | |
16 - Unmodified files tracked by Mercurial | |
17 - Modified files tracked by Mercurial | |
18 - New files added to the repository (with "hg add") | |
19 | |
20 Be careful with "hg purge", you could irreversibly delete some files you | |
21 forgot to add to the repository. If you only want to print the list of | |
22 files that this program would delete use: | |
2381
ab7a438294fc
Rewritten install instructions for hg-purge to match new situation, fixed typos.
Thomas Arendsen Hein <thomas@intevation.de>
parents:
2379
diff
changeset
|
23 hg purge --print |
2364 | 24 |
2368
eb1ec13e3b0d
Added a link to the home page of hg purge
demian@gaudron.lan
parents:
2367
diff
changeset
|
25 To get the most recent version of "hg purge" visit its home page: |
eb1ec13e3b0d
Added a link to the home page of hg purge
demian@gaudron.lan
parents:
2367
diff
changeset
|
26 http://www.barisione.org/apps.html#hg-purge |
eb1ec13e3b0d
Added a link to the home page of hg purge
demian@gaudron.lan
parents:
2367
diff
changeset
|
27 |
eb1ec13e3b0d
Added a link to the home page of hg purge
demian@gaudron.lan
parents:
2367
diff
changeset
|
28 This program was inspired by the "cvspurge" script contained in CVS utilities |
2367
8c893af1154a
Added a link to the page for CVS utilities
demian@gaudron.lan
parents:
2366
diff
changeset
|
29 (http://www.red-bean.com/cvsutils/). |
8c893af1154a
Added a link to the page for CVS utilities
demian@gaudron.lan
parents:
2366
diff
changeset
|
30 |
2364 | 31 |
32 How to install | |
33 ============== | |
2381
ab7a438294fc
Rewritten install instructions for hg-purge to match new situation, fixed typos.
Thomas Arendsen Hein <thomas@intevation.de>
parents:
2379
diff
changeset
|
34 The purge extension is distributed with Mercurial, to activate it you need to |
ab7a438294fc
Rewritten install instructions for hg-purge to match new situation, fixed typos.
Thomas Arendsen Hein <thomas@intevation.de>
parents:
2379
diff
changeset
|
35 put these lines in your ~/.hgrc: |
2366
f9f53c7e1875
Added some lines on the requirements for purge
demian@gaudron.lan
parents:
2365
diff
changeset
|
36 |
2365
a5d2e5490ac7
Added an explanation on how to enable the extension in "~/.hgrc"
demian@gaudron.lan
parents:
2364
diff
changeset
|
37 [extensions] |
2381
ab7a438294fc
Rewritten install instructions for hg-purge to match new situation, fixed typos.
Thomas Arendsen Hein <thomas@intevation.de>
parents:
2379
diff
changeset
|
38 hgext.purge= |
2365
a5d2e5490ac7
Added an explanation on how to enable the extension in "~/.hgrc"
demian@gaudron.lan
parents:
2364
diff
changeset
|
39 |
a5d2e5490ac7
Added an explanation on how to enable the extension in "~/.hgrc"
demian@gaudron.lan
parents:
2364
diff
changeset
|
40 For more information on the configuration files see the man page for "hgrc": |
2364 | 41 man 5 hgrc |
42 | |
43 | |
44 How to use "hg purge" | |
45 ==================== | |
46 For help on the usage of "hg purge" use: | |
47 hg help purge | |
48 | |
49 | |
50 License | |
51 ======= | |
52 Copyright (C) 2006 - Marco Barisione <marco@barisione.org> | |
53 | |
54 This program is distributed in the hope that it will be useful, | |
55 but WITHOUT ANY WARRANTY; without even the implied warranty of | |
56 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
57 GNU General Public License for more details. | |
58 | |
59 A copy of the GNU General Public License is distributed along | |
2381
ab7a438294fc
Rewritten install instructions for hg-purge to match new situation, fixed typos.
Thomas Arendsen Hein <thomas@intevation.de>
parents:
2379
diff
changeset
|
60 with Mercurial in the file COPYING. |