This is an archive of the discontinued Mercurial Phabricator instance.

Differential D9284

purge: move extension into core mercurial
AbandonedPublic

Authored by valentin.gatienbaron on Nov 8 2020, 6:30 PM.

Details

Reviewers
marmoute
Group Reviewers
hg-reviewers
Summary

The motivation is simple: it's nicer to avoid gating basic
functionality.

To reduce the risk of people shooting themselves in the feet, `hg
purge` without further argument fails. Instead we add a flag -u that
means "delete unknown files", and the user must pass one of -u,
-i, or --all.

When the extension is loaded, -u is implied for compatibility, but
it can be passed explicitly, so one can call hg purge -u and have
that work regardless of whether the extension is loaded.

For review of the body of the purge command, use this instead of what
hg/phabricator will show (the block of code is modified, not just
moved):

diff -U 1000 <(hg cat -r .^ hgext/purge.py) <(cat mercurial/commands.py | grep -B 1 -A 1000 'purge|clean' | grep -B 1000 "ui.write") | colordiff | less -R

This is not exactly what was discussed at the sprint (people mentioned
an interactive prompt if some flag is not given), but this seems more
natural and as safe?

Separately, we could, in principle, prevent prefixes of hg pur and
hg cle from running purge, if people are still worried about users
typing the wrong things.

Diff Detail

Repository
rHG Mercurial
Branch
default
Lint
No Linters Available
Unit
No Unit Test Coverage

Event Timeline

joerg.sonnenberger added a subscriber: joerg.sonnenberger.Nov 8 2020, 6:55 PM

The proposal during the spring was to ask by default if it is not loaded as extension. Or to make it more explicit:
(1) Check if there is anything to do. If no, just return success.
(2) Check if the extension was enabled. If yes, remove and exit.
(3) Check if the "--confirm" (or "--force"?) flag was given. If not, ask for confirmation to remove X files.
(4) Remove files.

It would be nice to not allow abbreviations of the command name. I'd even be fully OK with only enabled the "clean" alias for BC when the extension is loaded.

mharbison72 added a subscriber: mharbison72.Nov 8 2020, 7:29 PM

Should this extension be added to mercurial.extensions._builtin like color, progress and shelve? (I see pager isn't, so I'm not clear what this list does.)

The other thought I had was should extensions.purge=! in the config disable the command (due to the potential footgun)? I thought a similar config would disable the builtin color or pager, but some experimenting seems to show that isn't the case, so IDK where I got that idea. I don't feel strongly about this, and a followup would be fine if anyone else thinks it's a safety factor with merit.

I definitely like the idea of not being interactive, so that scripts can more easily purge.

valentin.gatienbaron added a comment.Nov 8 2020, 7:43 PM

@joerg.sonnenberger are you stating what was discussed at the sprint merely for comparison, or because you'd prefer for this change to be closer to it?

@mharbison72 the extension is not listed as builtin, because there is still a purge.py

joerg.sonnenberger added a comment.Nov 8 2020, 8:08 PM

I don't think just aborting when no option is given is a good UX. That feels even worse than making it interactive by default as discussed during the sprint.

valentin.gatienbaron added a comment.Nov 12 2020, 11:16 PM

Failing is what the vast majority of commands do when not given enough arguments:

$ hg clone
hg clone: invalid arguments
...
$ hg backout
abort: please specify a revision to backout
$ hg tag
hg tag: invalid arguments
...
$ hg resolve
abort: no action specified
...
$ hg revert
abort: no files or directories specified
...

prune is probably most similar to hg resolve or hg revert, in that they could interpret no arguments in some way, but chose not to, as it can be error prone.
If one runs hg clean without further argument, I think "clean what? (ignored files, unclean files, both)" is a better response than "are you sure you want to delete these unclean files?".

durin42 added a subscriber: durin42.Nov 18 2020, 5:54 PM

I'm -0 on this, but open to persuasion: I think that an interactive mode that lists files and then says "are you sure" makes sense. eg:

$ hg purge --all
foo.sh
build/
junk
delete listed files/directories? [y/N]

or

$ hg purge --all
foo
bar
baz
quxx
[and 200 more files and directories]
proceed? [y/N]

That is, show a summary of the files/directories (if we're deleting an entire dir, just list that, not every file in it, ideally) to the user, brief enough it's likely to fit on their terminal, and then ask. Otherwise I really fear the "Mercurial ate my homework" complaints are inevitable.

pulkit added a subscriber: pulkit.Nov 19 2020, 8:23 AM
In D9284#140407, @durin42 wrote:

I'm -0 on this, but open to persuasion: I think that an interactive mode that lists files and then says "are you sure" makes sense. eg:

I agree that interactive mode makes sense here. Since there is no way back from purging, we need to be more careful.

$ hg purge --all
foo.sh
build/
junk
delete listed files/directories? [y/N]

or

$ hg purge --all
foo
bar
baz
quxx
[and 200 more files and directories]
proceed? [y/N]

To add we can add a --confirm flag which defaults to True and one can pass --no-confirm to not have interactive option.
(I missed the sprint discussion and hence kindly ignore me if I am saying something that's already discussed)

That is, show a summary of the files/directories (if we're deleting an entire dir, just list that, not every file in it, ideally) to the user, brief enough it's likely to fit on their terminal, and then ask. Otherwise I really fear the "Mercurial ate my homework" complaints are inevitable.

marmoute requested changes to this revision.Jan 8 2021, 2:37 PM
marmoute added a subscriber: marmoute.

If I remember the sprint discussion right, the idea was

  • add to core with a --confirm option (default to False),
  • have the extensions change --confirm default to True
This revision now requires changes to proceed.Jan 8 2021, 2:37 PM
marmoute added a comment.Jan 14 2021, 4:37 AM
In D9284#140023, @valentin.gatienbaron wrote:

Failing is what the vast majority of commands do when not given enough arguments:

$ hg clone
hg clone: invalid arguments
...
$ hg backout
abort: please specify a revision to backout
$ hg tag
hg tag: invalid arguments
...
$ hg resolve
abort: no action specified
...
$ hg revert
abort: no files or directories specified
...

prune is probably most similar to hg resolve or hg revert, in that they could interpret no arguments in some way, but chose not to, as it can be error prone.
If one runs hg clean without further argument, I think "clean what? (ignored files, unclean files, both)" is a better response than "are you sure you want to delete these unclean files?".

Having some flag to control what you delete would be great (probably --unknown, --ignored and --all), but since they are deleted for good without any backup (unlike resolve and revert), I still think having some explicite validation would be good. That validation could be something like:

$ hg clean --all
permanently delete 3 unknown file and 250 ignored files ? [yN]
(use `hg status --unknown --ignored` to list them)

Having some hint about what the command is about to do is probably enough. My main source of un-recoverable error with hg purge is when I accidentally remove an unexpected "unknown" file while trying to client the "ignored" one.

marmoute added a comment.Jan 18 2021, 4:30 AM

I gave a shot at a --confirm option. An alternative series to this one can be found in D9818 D9819 and D98120

Revision Contents
Changeset List

Diff 23436

hgext/largefiles/overrides.py

# function to take care of the rest. Make sure it doesn't do anything with # function to take care of the rest. Make sure it doesn't do anything with
# largefiles by passing a matcher that will ignore them. # largefiles by passing a matcher that will ignore them.
matcher = composenormalfilematcher(matcher, repo[None].manifest(), added) matcher = composenormalfilematcher(matcher, repo[None].manifest(), added)
return orig(repo, matcher, prefix, uipathfn, opts) return orig(repo, matcher, prefix, uipathfn, opts)
# Calling purge with --all will cause the largefiles to be deleted. # Calling purge with --all will cause the largefiles to be deleted.
# Override repo.status to prevent this from happening. # Override repo.status to prevent this from happening.
@eh.wrapcommand(b'purge', extension=b'purge') @eh.wrapcommand(b'purge')
def overridepurge(orig, ui, repo, *dirs, **opts): def overridepurge(orig, ui, repo, *dirs, **opts):
# XXX Monkey patching a repoview will not work. The assigned attribute will # XXX Monkey patching a repoview will not work. The assigned attribute will
# be set on the unfiltered repo, but we will only lookup attributes in the # be set on the unfiltered repo, but we will only lookup attributes in the
# unfiltered repo if the lookup in the repoview object itself fails. As the # unfiltered repo if the lookup in the repoview object itself fails. As the
# monkey patched method exists on the repoview class the lookup will not # monkey patched method exists on the repoview class the lookup will not
# fail. As a result, the original version will shadow the monkey patched # fail. As a result, the original version will shadow the monkey patched
# one, defeating the monkey patch. # one, defeating the monkey patch.
# #

hgext/purge.py

# This program is distributed in the hope that it will be useful, # This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of # but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details. # GNU General Public License for more details.
# #
# You should have received a copy of the GNU General Public License # You should have received a copy of the GNU General Public License
# along with this program; if not, see <http://www.gnu.org/licenses/>. # along with this program; if not, see <http://www.gnu.org/licenses/>.
'''command to delete untracked files from the working directory''' '''command to delete untracked files from the working directory (DEPRECATED)
from __future__ import absolute_import
from mercurial.i18n import _ The functionality of this extension has been included in core Mercurial since
from mercurial import ( version 5.7. Please use :hg:`purge ...` instead. However it is not exactly
cmdutil, equivalent: without the extension, one of -i, -u or --all must be specified.
merge as mergemod, With the extension, -u is assumed if none of these flags are specified.
pycompat,
registrar,
scmutil,
)
cmdtable = {}
command = registrar.command(cmdtable)
# Note for extension authors: ONLY specify testedwith = 'ships-with-hg-core' for
# extensions which SHIP WITH MERCURIAL. Non-mainline extensions should
# be specifying the version(s) of Mercurial they are tested with, or
# leave the attribute unspecified.
testedwith = b'ships-with-hg-core'
@command(
b'purge|clean',
[
(b'a', b'abort-on-err', None, _(b'abort if an error occurs')),
(b'', b'all', None, _(b'purge ignored files too')),
(b'i', b'ignored', None, _(b'purge only ignored files')),
(b'', b'dirs', None, _(b'purge empty directories')),
(b'', b'files', None, _(b'purge files')),
(b'p', b'print', None, _(b'print filenames instead of deleting them')),
(
b'0',
b'print0',
None,
_(
b'end filenames with NUL, for use with xargs'
b' (implies -p/--print)'
),
),
]
+ cmdutil.walkopts,
_(b'hg purge [OPTION]... [DIR]...'),
helpcategory=command.CATEGORY_WORKING_DIRECTORY,
)
def purge(ui, repo, *dirs, **opts):
'''removes files not tracked by Mercurial
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.
''' '''
opts = pycompat.byteskwargs(opts)
cmdutil.check_at_most_one_arg(opts, b'all', b'ignored')
act = not opts.get(b'print')
eol = b'\n'
if opts.get(b'print0'):
eol = b'\0'
act = False # --print0 implies --print
if opts.get(b'all', False):
ignored = True
unknown = True
else:
ignored = opts.get(b'ignored', False)
unknown = not ignored
removefiles = opts.get(b'files')
removedirs = opts.get(b'dirs')
if not removefiles and not removedirs:
removefiles = True
removedirs = True
match = scmutil.match(repo[None], dirs, opts)
paths = mergemod.purge(
repo,
match,
unknown=unknown,
ignored=ignored,
removeemptydirs=removedirs,
removefiles=removefiles,
abortonerror=opts.get(b'abort_on_err'),
noop=not act,
)
for path in paths: # This empty extension looks pointless, but core mercurial checks if it's loaded
if not act: # to implement the slightly different behavior documented above.
ui.write(b'%s%s' % (path, eol))

mercurial/commands.py

raise raise
finally: finally:
del repo._subtoppath del repo._subtoppath
finally: finally:
other.close() other.close()
return ret return ret
@command(
b'purge|clean',
[
(b'a', b'abort-on-err', None, _(b'abort if an error occurs')),
(b'', b'all', None, _(b'purge ignored files too')),
(b'i', b'ignored', None, _(b'purge only ignored files')),
(b'u', b'unknown', None, _(b'purge only unknown files')),
(b'', b'dirs', None, _(b'purge empty directories')),
(b'', b'files', None, _(b'purge files')),
(b'p', b'print', None, _(b'print filenames instead of deleting them')),
(
b'0',
b'print0',
None,
_(
b'end filenames with NUL, for use with xargs'
b' (implies -p/--print)'
),
),
]
+ cmdutil.walkopts,
_(b'hg purge [OPTION]... [DIR]...'),
helpcategory=command.CATEGORY_WORKING_DIRECTORY,
)
def purge(ui, repo, *dirs, **opts):
'''removes files not tracked by Mercurial
Delete files not known to Mercurial. This is useful to test local
and uncommitted changes in an otherwise-clean source tree.
purge can delete:
- Unknown files: files marked with "?" by :hg:`status`
- Ignored files
- Empty directories: in fact Mercurial ignores directories unless
they contain files under source control management
Unknown files are selected with -u, ignored files with -i, and
both with --all. At least one such flag must be provided. Empty
directories are deleted by default.
But it will leave untouched:
- Modified and unmodified tracked files
- 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.
'''
opts = pycompat.byteskwargs(opts)
cmdutil.check_at_most_one_arg(opts, b'all', b'ignored')
cmdutil.check_at_most_one_arg(opts, b'all', b'unknown')
act = not opts.get(b'print')
eol = b'\n'
if opts.get(b'print0'):
eol = b'\0'
act = False # --print0 implies --print
if opts.get(b'all', False):
ignored = True
unknown = True
else:
ignored = opts.get(b'ignored', False)
unknown = opts.get(b'unknown', False)
if not unknown and not ignored:
# If the extension is loaded, we clean unknown files for compatibility.
# If it is not loaded, we refuse to work to reduce the risk of mistakes.
try:
extensions.find(b'purge')
unknown = True
except KeyError:
raise error.Abort(_(b"please specify what to purge with -i, -u or --all"))
removefiles = opts.get(b'files')
removedirs = opts.get(b'dirs')
if not removefiles and not removedirs:
removefiles = True
removedirs = True
match = scmutil.match(repo[None], dirs, opts)
paths = mergemod.purge(
repo,
match,
unknown=unknown,
ignored=ignored,
removeemptydirs=removedirs,
removefiles=removefiles,
abortonerror=opts.get(b'abort_on_err'),
noop=not act,
)
for path in paths:
if not act:
ui.write(b'%s%s' % (path, eol))
@command( @command(
b'push', b'push',
[ [
(b'f', b'force', None, _(b'force push')), (b'f', b'force', None, _(b'force push')),
( (
b'r', b'r',
b'rev', b'rev',

relnotes/next

== New Features == == New Features ==
* The memory footprint per changeset and per file during pull/unbundle * The memory footprint per changeset and per file during pull/unbundle
operations has been significantly reduced. operations has been significantly reduced.
* `hg purge` is now a core command. See `hg help -e purge` for how it
compares to the behavior of `hg purge` when the purge extension is
loaded.
== New Experimental Features == == New Experimental Features ==
== Bug Fixes == == Bug Fixes ==

tests/test-completion.t

log log
manifest manifest
merge merge
outgoing outgoing
parents parents
paths paths
phase phase
pull pull
purge
push push
recover recover
remove remove
rename rename
resolve resolve
revert revert
rollback rollback
root root
log: follow, follow-first, date, copies, keyword, rev, line-range, removed, only-merges, user, only-branch, branch, prune, patch, git, limit, no-merges, stat, graph, style, template, include, exclude log: follow, follow-first, date, copies, keyword, rev, line-range, removed, only-merges, user, only-branch, branch, prune, patch, git, limit, no-merges, stat, graph, style, template, include, exclude
manifest: rev, all, template manifest: rev, all, template
merge: force, rev, preview, abort, tool merge: force, rev, preview, abort, tool
outgoing: force, rev, newest-first, bookmarks, branch, patch, git, limit, no-merges, stat, graph, style, template, ssh, remotecmd, insecure, subrepos outgoing: force, rev, newest-first, bookmarks, branch, patch, git, limit, no-merges, stat, graph, style, template, ssh, remotecmd, insecure, subrepos
parents: rev, style, template parents: rev, style, template
paths: template paths: template
phase: public, draft, secret, force, rev phase: public, draft, secret, force, rev
pull: update, force, confirm, rev, bookmark, branch, ssh, remotecmd, insecure pull: update, force, confirm, rev, bookmark, branch, ssh, remotecmd, insecure
purge: abort-on-err, all, ignored, unknown, dirs, files, print, print0, include, exclude
push: force, rev, bookmark, all-bookmarks, branch, new-branch, pushvars, publish, ssh, remotecmd, insecure push: force, rev, bookmark, all-bookmarks, branch, new-branch, pushvars, publish, ssh, remotecmd, insecure
recover: verify recover: verify
remove: after, force, subrepos, include, exclude, dry-run remove: after, force, subrepos, include, exclude, dry-run
rename: after, at-rev, force, include, exclude, dry-run rename: after, at-rev, force, include, exclude, dry-run
resolve: all, list, mark, unmark, no-status, re-merge, tool, include, exclude, template resolve: all, list, mark, unmark, no-status, re-merge, tool, include, exclude, template
revert: all, date, rev, no-backup, interactive, include, exclude, dry-run revert: all, date, rev, no-backup, interactive, include, exclude, dry-run
rollback: dry-run, force rollback: dry-run, force
root: template root: template

tests/test-globalopts.t

log show revision history of entire repository or files log show revision history of entire repository or files
Working directory management: Working directory management:
add add the specified files on the next commit add add the specified files on the next commit
addremove add all new files, delete all missing files addremove add all new files, delete all missing files
files list tracked files files list tracked files
forget forget the specified files on the next commit forget forget the specified files on the next commit
purge removes files not tracked by Mercurial
remove remove the specified files on the next commit remove remove the specified files on the next commit
rename rename files; equivalent of copy + remove rename rename files; equivalent of copy + remove
resolve redo merges or set/view the merge status of files resolve redo merges or set/view the merge status of files
revert restore files to their checkout state revert restore files to their checkout state
root print the root (top) of the current working directory root print the root (top) of the current working directory
shelve save and set aside changes from the working directory shelve save and set aside changes from the working directory
status show changed files in the working directory status show changed files in the working directory
summary summarize working directory state summary summarize working directory state
log show revision history of entire repository or files log show revision history of entire repository or files
Working directory management: Working directory management:
add add the specified files on the next commit add add the specified files on the next commit
addremove add all new files, delete all missing files addremove add all new files, delete all missing files
files list tracked files files list tracked files
forget forget the specified files on the next commit forget forget the specified files on the next commit
purge removes files not tracked by Mercurial
remove remove the specified files on the next commit remove remove the specified files on the next commit
rename rename files; equivalent of copy + remove rename rename files; equivalent of copy + remove
resolve redo merges or set/view the merge status of files resolve redo merges or set/view the merge status of files
revert restore files to their checkout state revert restore files to their checkout state
root print the root (top) of the current working directory root print the root (top) of the current working directory
shelve save and set aside changes from the working directory shelve save and set aside changes from the working directory
status show changed files in the working directory status show changed files in the working directory
summary summarize working directory state summary summarize working directory state

tests/test-help-hide.t

log show revision history of entire repository or files log show revision history of entire repository or files
Working directory management: Working directory management:
add add the specified files on the next commit add add the specified files on the next commit
addremove add all new files, delete all missing files addremove add all new files, delete all missing files
files list tracked files files list tracked files
forget forget the specified files on the next commit forget forget the specified files on the next commit
purge removes files not tracked by Mercurial
remove remove the specified files on the next commit remove remove the specified files on the next commit
rename rename files; equivalent of copy + remove rename rename files; equivalent of copy + remove
resolve redo merges or set/view the merge status of files resolve redo merges or set/view the merge status of files
revert restore files to their checkout state revert restore files to their checkout state
root print the root (top) of the current working directory root print the root (top) of the current working directory
shelve save and set aside changes from the working directory shelve save and set aside changes from the working directory
status show changed files in the working directory status show changed files in the working directory
summary summarize working directory state summary summarize working directory state
log show revision history of entire repository or files log show revision history of entire repository or files
Working directory management: Working directory management:
add add the specified files on the next commit add add the specified files on the next commit
addremove add all new files, delete all missing files addremove add all new files, delete all missing files
files list tracked files files list tracked files
forget forget the specified files on the next commit forget forget the specified files on the next commit
purge removes files not tracked by Mercurial
remove remove the specified files on the next commit remove remove the specified files on the next commit
rename rename files; equivalent of copy + remove rename rename files; equivalent of copy + remove
resolve redo merges or set/view the merge status of files resolve redo merges or set/view the merge status of files
revert restore files to their checkout state revert restore files to their checkout state
root print the root (top) of the current working directory root print the root (top) of the current working directory
shelve save and set aside changes from the working directory shelve save and set aside changes from the working directory
status show changed files in the working directory status show changed files in the working directory
summary summarize working directory state summary summarize working directory state

tests/test-help.t

log show revision history of entire repository or files log show revision history of entire repository or files
Working directory management: Working directory management:
add add the specified files on the next commit add add the specified files on the next commit
addremove add all new files, delete all missing files addremove add all new files, delete all missing files
files list tracked files files list tracked files
forget forget the specified files on the next commit forget forget the specified files on the next commit
purge removes files not tracked by Mercurial
remove remove the specified files on the next commit remove remove the specified files on the next commit
rename rename files; equivalent of copy + remove rename rename files; equivalent of copy + remove
resolve redo merges or set/view the merge status of files resolve redo merges or set/view the merge status of files
revert restore files to their checkout state revert restore files to their checkout state
root print the root (top) of the current working directory root print the root (top) of the current working directory
shelve save and set aside changes from the working directory shelve save and set aside changes from the working directory
status show changed files in the working directory status show changed files in the working directory
summary summarize working directory state summary summarize working directory state
log show revision history of entire repository or files log show revision history of entire repository or files
Working directory management: Working directory management:
add add the specified files on the next commit add add the specified files on the next commit
addremove add all new files, delete all missing files addremove add all new files, delete all missing files
files list tracked files files list tracked files
forget forget the specified files on the next commit forget forget the specified files on the next commit
purge removes files not tracked by Mercurial
remove remove the specified files on the next commit remove remove the specified files on the next commit
rename rename files; equivalent of copy + remove rename rename files; equivalent of copy + remove
resolve redo merges or set/view the merge status of files resolve redo merges or set/view the merge status of files
revert restore files to their checkout state revert restore files to their checkout state
root print the root (top) of the current working directory root print the root (top) of the current working directory
shelve save and set aside changes from the working directory shelve save and set aside changes from the working directory
status show changed files in the working directory status show changed files in the working directory
summary summarize working directory state summary summarize working directory state
hgk browse the repository in a graphical way hgk browse the repository in a graphical way
highlight syntax highlighting for hgweb (requires Pygments) highlight syntax highlighting for hgweb (requires Pygments)
histedit interactive history editing histedit interactive history editing
keyword expand keywords in tracked files keyword expand keywords in tracked files
largefiles track large binary files largefiles track large binary files
mq manage a stack of patches mq manage a stack of patches
notify hooks for sending email push notifications notify hooks for sending email push notifications
patchbomb command to send changesets as (a series of) patch emails patchbomb command to send changesets as (a series of) patch emails
purge command to delete untracked files from the working
directory
relink recreates hardlinks between repository clones relink recreates hardlinks between repository clones
schemes extend schemes with shortcuts to repository swarms schemes extend schemes with shortcuts to repository swarms
share share a common history between several working directories share share a common history between several working directories
strip strip changesets and their descendants from history strip strip changesets and their descendants from history
transplant command to transplant changesets from another branch transplant command to transplant changesets from another branch
win32mbcs allow the use of MBCS paths with problematic encodings win32mbcs allow the use of MBCS paths with problematic encodings
zeroconf discover and advertise repositories on the local network zeroconf discover and advertise repositories on the local network
<tr><td> <tr><td>
<a href="/help/phase"> <a href="/help/phase">
phase phase
</a> </a>
</td><td> </td><td>
set or show the current phase name set or show the current phase name
</td></tr> </td></tr>
<tr><td> <tr><td>
<a href="/help/purge">
purge
</a>
</td><td>
removes files not tracked by Mercurial
</td></tr>
<tr><td>
<a href="/help/recover"> <a href="/help/recover">
recover recover
</a> </a>
</td><td> </td><td>
roll back an interrupted transaction roll back an interrupted transaction
</td></tr> </td></tr>
<tr><td> <tr><td>
<a href="/help/rename"> <a href="/help/rename">

tests/test-hgweb-json.t

"summary": "show aliases for remote repositories", "summary": "show aliases for remote repositories",
"topic": "paths" "topic": "paths"
}, },
{ {
"summary": "set or show the current phase name", "summary": "set or show the current phase name",
"topic": "phase" "topic": "phase"
}, },
{ {
"summary": "removes files not tracked by Mercurial",
"topic": "purge"
},
{
"summary": "roll back an interrupted transaction", "summary": "roll back an interrupted transaction",
"topic": "recover" "topic": "recover"
}, },
{ {
"summary": "rename files; equivalent of copy + remove", "summary": "rename files; equivalent of copy + remove",
"topic": "rename" "topic": "rename"
}, },
{ {

tests/test-purge.t

$ cat <<EOF >> $HGRCPATH
> [extensions]
> purge =
> EOF
init init
$ hg init t $ hg init t
$ cd t $ cd t
setup setup
$ echo r1 > r1 $ echo r1 > r1
$ hg ci -qAmr1 -d'0 0' $ hg ci -qAmr1 -d'0 0'
$ mkdir directory $ mkdir directory
$ echo r2 > directory/r2 $ echo r2 > directory/r2
$ hg ci -qAmr2 -d'1 0' $ hg ci -qAmr2 -d'1 0'
$ echo 'ignored' > .hgignore $ echo 'ignored' > .hgignore
$ hg ci -qAmr3 -d'2 0' $ hg ci -qAmr3 -d'2 0'
purge without the extension
$ hg st
$ touch foo
$ hg purge
abort: please specify what to purge with -i, -u or --all
[255]
$ hg st
? foo
$ hg purge -u
$ hg st
now enabling the extension
$ cat <<EOF >> $HGRCPATH
> [extensions]
> purge =
> EOF
delete an empty directory delete an empty directory
$ mkdir empty_dir $ mkdir empty_dir
$ hg purge -p -v $ hg purge -p -v
empty_dir empty_dir
$ hg purge -v $ hg purge -v
removing directory empty_dir removing directory empty_dir
$ ls -A $ ls -A