author | Thomas Arendsen Hein <thomas@intevation.de> |
Sun, 01 Oct 2006 19:26:33 +0200 | |
changeset 3215 | 53e843840349 |
parent 2401 | dbeaa4369121 |
permissions | -rw-r--r-- |
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. |