Fossil SCM
Further improvements to the documentation for clean to better match the implementation
Commit
dd77130500515345fa2002799c071c3934e66d24
Parent
d7955bf18c07744…
1 file changed
+18
-8
+18
-8
| --- src/checkin.c | ||
| +++ src/checkin.c | ||
| @@ -640,18 +640,28 @@ | ||
| 640 | 640 | ** Delete all "extra" files in the source tree. "Extra" files are files |
| 641 | 641 | ** that are not officially part of the checkout. If one or more PATH |
| 642 | 642 | ** arguments appear, then only the files named, or files contained with |
| 643 | 643 | ** directories named, will be removed. |
| 644 | 644 | ** |
| 645 | -** Prompts are issued to confirm the removal of each file, unless | |
| 646 | -** the --force flag is used or unless the file matches glob pattern | |
| 647 | -** specified by the --clean option. No file that matches glob patterns | |
| 648 | -** specified by --ignore or --keep will ever be deleted. The default | |
| 649 | -** values for --clean, --ignore, and --keep are determined by the | |
| 650 | -** (versionable) clean-glob, ignore-glob, and keep-glob settings. | |
| 651 | -** Files and subdirectories whose names begin with "." are automatically | |
| 652 | -** ignored unless the --dotfiles option is used. | |
| 645 | +** If the --prompt option is used, prompts are issued to confirm the | |
| 646 | +** permanent removal of each file. Otherwise, files are backed up to the | |
| 647 | +** undo buffer prior to removal, and prompts are issued only for files | |
| 648 | +** whose removal cannot be undone due to their large size or due to | |
| 649 | +** --disable-undo being used. | |
| 650 | +** | |
| 651 | +** The --force option treats all prompts as having been answered yes, | |
| 652 | +** whereas --no-prompt treats them as having been answered no. | |
| 653 | +** | |
| 654 | +** Files matching any glob pattern specified by the --clean option are | |
| 655 | +** deleted without prompting, and the removal cannot be undone. | |
| 656 | +** | |
| 657 | +** No file that matches glob patterns specified by --ignore or --keep will | |
| 658 | +** ever be deleted. Files and subdirectories whose names begin with "." | |
| 659 | +** are automatically ignored unless the --dotfiles option is used. | |
| 660 | +** | |
| 661 | +** The default values for --clean, --ignore, and --keep are determined by | |
| 662 | +** the (versionable) clean-glob, ignore-glob, and keep-glob settings. | |
| 653 | 663 | ** |
| 654 | 664 | ** The --verily option ignores the keep-glob and ignore-glob settings and |
| 655 | 665 | ** turns on --force, --emptydirs, --dotfiles, and --disable-undo. Use the |
| 656 | 666 | ** --verily option when you really want to clean up everything. Extreme |
| 657 | 667 | ** care should be exercised when using the --verily option. |
| 658 | 668 |
| --- src/checkin.c | |
| +++ src/checkin.c | |
| @@ -640,18 +640,28 @@ | |
| 640 | ** Delete all "extra" files in the source tree. "Extra" files are files |
| 641 | ** that are not officially part of the checkout. If one or more PATH |
| 642 | ** arguments appear, then only the files named, or files contained with |
| 643 | ** directories named, will be removed. |
| 644 | ** |
| 645 | ** Prompts are issued to confirm the removal of each file, unless |
| 646 | ** the --force flag is used or unless the file matches glob pattern |
| 647 | ** specified by the --clean option. No file that matches glob patterns |
| 648 | ** specified by --ignore or --keep will ever be deleted. The default |
| 649 | ** values for --clean, --ignore, and --keep are determined by the |
| 650 | ** (versionable) clean-glob, ignore-glob, and keep-glob settings. |
| 651 | ** Files and subdirectories whose names begin with "." are automatically |
| 652 | ** ignored unless the --dotfiles option is used. |
| 653 | ** |
| 654 | ** The --verily option ignores the keep-glob and ignore-glob settings and |
| 655 | ** turns on --force, --emptydirs, --dotfiles, and --disable-undo. Use the |
| 656 | ** --verily option when you really want to clean up everything. Extreme |
| 657 | ** care should be exercised when using the --verily option. |
| 658 |
| --- src/checkin.c | |
| +++ src/checkin.c | |
| @@ -640,18 +640,28 @@ | |
| 640 | ** Delete all "extra" files in the source tree. "Extra" files are files |
| 641 | ** that are not officially part of the checkout. If one or more PATH |
| 642 | ** arguments appear, then only the files named, or files contained with |
| 643 | ** directories named, will be removed. |
| 644 | ** |
| 645 | ** If the --prompt option is used, prompts are issued to confirm the |
| 646 | ** permanent removal of each file. Otherwise, files are backed up to the |
| 647 | ** undo buffer prior to removal, and prompts are issued only for files |
| 648 | ** whose removal cannot be undone due to their large size or due to |
| 649 | ** --disable-undo being used. |
| 650 | ** |
| 651 | ** The --force option treats all prompts as having been answered yes, |
| 652 | ** whereas --no-prompt treats them as having been answered no. |
| 653 | ** |
| 654 | ** Files matching any glob pattern specified by the --clean option are |
| 655 | ** deleted without prompting, and the removal cannot be undone. |
| 656 | ** |
| 657 | ** No file that matches glob patterns specified by --ignore or --keep will |
| 658 | ** ever be deleted. Files and subdirectories whose names begin with "." |
| 659 | ** are automatically ignored unless the --dotfiles option is used. |
| 660 | ** |
| 661 | ** The default values for --clean, --ignore, and --keep are determined by |
| 662 | ** the (versionable) clean-glob, ignore-glob, and keep-glob settings. |
| 663 | ** |
| 664 | ** The --verily option ignores the keep-glob and ignore-glob settings and |
| 665 | ** turns on --force, --emptydirs, --dotfiles, and --disable-undo. Use the |
| 666 | ** --verily option when you really want to clean up everything. Extreme |
| 667 | ** care should be exercised when using the --verily option. |
| 668 |