NAME

       hg purge - removes files not tracked by Mercurial

SYNOPSIS

       hg purge [OPTION]... [DIR]...

DESCRIPTION

       Delete  files  not  known  to  Mercurial.  This  is  useful  to  test local and uncommitted changes in an
       otherwise-clean source tree.

       This means that purge will delete the following by default:

       • Unknown files: files marked with "?" by hg status

       • Empty directories: in fact Mercurial ignores directories unless they contain files under source control
         management

         But it will leave untouched:

       • Modified and unmodified tracked files

       • Ignored files (unless -i or --all is specified)

       • New files added to the repository (with hg add)

         The --files and --dirs options can be used to direct purge to delete only files, only  directories,  or
         both. If neither option is given, both will be deleted.

         If directories are given on the command line, only files in these directories are considered.

         Be careful with purge, as 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 the --print option.

OPTIONS

       -a, --abort-on-err
              abort if an error occurs

       --all  purge ignored files too

       -i, --ignored
              purge only ignored files

       --dirs purge empty directories

       --files
              purge files

       -p, --print
              print filenames instead of deleting them

       -0, --print0
              end filenames with NUL, for use with xargs (implies -p/--print)

       --confirm
              ask before permanently deleting files

       -I,--include <PATTERN[+]>
              include names matching the given patterns

       -X,--exclude <PATTERN[+]>
              exclude names matching the given patterns

              [+] marked option can be specified multiple times

ALIASES

       clean

                                                                                                       HG(PURGE)