NAME

       hg remove - remove the specified files on the next commit

SYNOPSIS

       hg remove [OPTION]... FILE...

DESCRIPTION

       Schedule the indicated files for removal from the current branch.

       This  command  schedules  the  files  to  be removed at the next commit.  To undo a remove
       before that, see hg revert. To undo added files, see hg forget.

       -A/--after can be used to remove only files that have already been deleted, -f/--force can
       be  used  to  force  deletion,  and -Af can be used to remove files from the next revision
       without deleting them from the working directory.

       The following table details the behavior of remove for different file states (columns) and
       option  combinations  (rows).  The  file states are Added [A], Clean [C], Modified [M] and
       Missing [!]  (as reported by hg status). The actions are Warn, Remove  (from  branch)  and
       Delete (from disk):

                                     ┌──────────┬───┬────┬────┬───┐
                                     │opt/state │ A │ C  │ M  │ ! │
                                     ├──────────┼───┼────┼────┼───┤
                                     │none      │ W │ RD │ W  │ R │
                                     ├──────────┼───┼────┼────┼───┤
                                     │-f        │ R │ RD │ RD │ R │
                                     ├──────────┼───┼────┼────┼───┤
                                     │-A        │ W │ W  │ W  │ R │
                                     ├──────────┼───┼────┼────┼───┤
                                     │-Af       │ R │ R  │ R  │ R │
                                     └──────────┴───┴────┴────┴───┘

       Note   hg  remove never  deletes  files in Added [A] state from the working directory, not
              even if --force is specified.

       Returns 0 on success, 1 if any warnings encountered.

OPTIONS

       -A, --after
              record delete for missing files

       -f, --force
              forget added files, delete modified files

       -S, --subrepos
              recurse into subrepositories

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

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

       -n, --dry-run
              do not perform actions, just print output

              [+] marked option can be specified multiple times

ALIASES

       rm

                                                                                       HG(REMOVE)