Mercurial > hg
changeset 3829:531c116b2028
Add doc notes about revert and hg status vs diff
| author | Matt Mackall <mpm@selenic.com> |
|---|---|
| date | Fri, 08 Dec 2006 14:55:45 -0600 |
| parents | 676b75547d13 |
| children | 4e488ccc8120 |
| files | mercurial/commands.py tests/test-help.out tests/test-status.out |
| diffstat | 3 files changed, 30 insertions(+), 8 deletions(-) [+] |
line wrap: on
line diff
--- a/mercurial/commands.py Fri Dec 08 13:14:57 2006 -0600 +++ b/mercurial/commands.py Fri Dec 08 14:55:45 2006 -0600 @@ -57,7 +57,8 @@ Schedule files to be version controlled and added to the repository. - The files will be added to the repository at the next commit. + The files will be added to the repository at the next commit. To + undo an add before that, see hg revert. If no names are given, add all files in the repository. """ @@ -650,7 +651,8 @@ stand in the working directory. If invoked with --after, the operation is recorded, but no copying is performed. - This command takes effect in the next commit. + This command takes effect in the next commit. To undo a copy + before that, see hg revert. """ wlock = repo.wlock(0) errs, copied = docopy(ui, repo, pats, opts, wlock) @@ -1861,12 +1863,14 @@ Schedule the indicated files for removal from the repository. - This command schedules the files to be removed at the next commit. This only removes files from the current branch, not from the entire project history. If the files still exist in the working directory, they will be deleted from it. If invoked with --after, files that have been manually deleted are marked as removed. + This command schedules the files to be removed at the next commit. + To undo a remove before that, see hg revert. + Modified files and added files are not removed by default. To remove them, use the -f/--force option. """ @@ -1914,7 +1918,8 @@ stand in the working directory. If invoked with --after, the operation is recorded, but no copying is performed. - This command takes effect in the next commit. + This command takes effect in the next commit. To undo a rename + before that, see hg revert. """ wlock = repo.wlock(0) errs, copied = docopy(ui, repo, pats, opts, wlock) @@ -1933,8 +1938,9 @@ With no revision specified, revert the named files or directories to the contents they had in the parent of the working directory. This restores the contents of the affected files to an unmodified - state. If the working directory has two parents, you must - explicitly specify the revision to revert to. + state and unschedules adds, removes, copies, and renames. If the + working directory has two parents, you must explicitly specify the + revision to revert to. Modified files are saved with a .orig suffix before reverting. To disable these backups, use --no-backup.
--- a/tests/test-help.out Fri Dec 08 13:14:57 2006 -0600 +++ b/tests/test-help.out Fri Dec 08 14:55:45 2006 -0600 @@ -136,7 +136,8 @@ Schedule files to be version controlled and added to the repository. - The files will be added to the repository at the next commit. + The files will be added to the repository at the next commit. To + undo an add before that, see hg revert. If no names are given, add all files in the repository. @@ -152,7 +153,8 @@ Schedule files to be version controlled and added to the repository. - The files will be added to the repository at the next commit. + The files will be added to the repository at the next commit. To + undo an add before that, see hg revert. If no names are given, add all files in the repository. @@ -169,6 +171,10 @@ Differences between files are shown using the unified diff format. + NOTE: diff may generate unexpected results for merges, as it will + default to comparing against the working directory's first parent + changeset if no revisions are specified. + When two revision arguments are given, then changes are shown between those revisions. If only one revision is specified then that revision is compared to the working directory, and, when no @@ -199,6 +205,11 @@ files that match are shown. Files that are clean or ignored, are not listed unless -c (clean), -i (ignored) or -A is given. + NOTE: status may appear to disagree with diff if permissions have + changed or a merge has occurred. The standard diff format does not + report permission changes and diff only reports changes relative + to one merge parent. + If one revision is given, it is used as the base revision. If two revisions are given, the difference between them is shown.
--- a/tests/test-status.out Fri Dec 08 13:14:57 2006 -0600 +++ b/tests/test-status.out Fri Dec 08 14:55:45 2006 -0600 @@ -118,6 +118,11 @@ files that match are shown. Files that are clean or ignored, are not listed unless -c (clean), -i (ignored) or -A is given. + NOTE: status may appear to disagree with diff if permissions have + changed or a merge has occurred. The standard diff format does not + report permission changes and diff only reports changes relative + to one merge parent. + If one revision is given, it is used as the base revision. If two revisions are given, the difference between them is shown.