README
author demian@gaudron.lan
Sat, 13 May 2006 14:12:13 +0200
changeset 2365 a5d2e5490ac7
parent 2364 f368a1c302d5
child 2366 f9f53c7e1875
permissions -rw-r--r--
Added an explanation on how to enable the extension in "~/.hgrc"

What is "hg purge"?
===================
"purge" is a simple extension for the Mercurial source control management
system (http://www.selenic.com/mercurial).
This extension adds a "purge" command to "hg" that removes files not known
to mercurial, this is useful to test local and uncommitted changes in the
otherwise clean source tree.

This means that Mercurial will delete:
 - Unknown files: files marked with "?" by "hg status"
 - Ignored files: files usually ignored by Mercurial because they match a
   pattern in a ".hgignore" file
 - Empty directories: infact Mercurial ignores directories unless they
   contain files under source control managment
But it will leave untouched:
 - Unmodified files tracked by Mercurial
 - Modified files tracked by Mercurial
 - New files added to the repository (with "hg add")

Be careful with "hg purge", you could irreversibly delete some files you
forgot to add to the repository. If you only want to print the list of
files that this program would delete use:
  hg purge -vn


How to install
==============
Put the "purge.py" file in a directory of your choice. Enable the extension
inserting an instruction like "purge=/path/you/choose/purge.py" in the
"[extensions]" section of a configuration file read by "hg".

For instance if you installed the script in "/home/USER/hg-purge/", you
can create a file named  ".hgrc" in your home directory with the following
content:
  [extensions]
  purge=/home/USER/hg-purge/purge.py
Note that using "~/USER/hg-purge/purge.py" does not work with hg 0.9.

For more information on the configuration files see the man page for "hgrc":
  man 5 hgrc


How to use "hg purge"
====================
For help on the usage of "hg purge" use:
  hg help purge


License
=======
Copyright (C) 2006 - Marco Barisione <marco@barisione.org>

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

A copy of the GNU General Public License is distributed along
with this program in the file COPYING.GPL.