diff options
| author | Gavin Mak <gavinmak@google.com> | 2025-11-19 16:46:07 -0800 |
|---|---|---|
| committer | LUCI <gerrit-scoped@luci-project-accounts.iam.gserviceaccount.com> | 2025-11-21 10:48:42 -0800 |
| commit | be33106ffc516c9631a78e1c1d2ebea3a955d71a (patch) | |
| tree | 5937edf110be3065a3234522e9eb33380db19318 /man/repo-wipe.1 | |
| parent | 5998c0b50612af80c8a710b79692313e7f84c64a (diff) | |
| download | git-repo-main.tar.gz | |
wipe: Add new `repo wipe` subcommandmain
This new command allows users to delete projects from the worktree
and from the `.repo` directory. It is a destructive operation.
It handles shared projects by refusing to wipe them unless the
`--force` flag is used. It also checks for uncommitted changes
before wiping.
Bug: 393383056
Change-Id: Ia30d8ffdc781a3f179af56310ce31c9dae331bbe
Reviewed-on: https://gerrit-review.googlesource.com/c/git-repo/+/490801
Tested-by: Gavin Mak <gavinmak@google.com>
Reviewed-by: Mike Frysinger <vapier@google.com>
Commit-Queue: Gavin Mak <gavinmak@google.com>
Diffstat (limited to 'man/repo-wipe.1')
| -rw-r--r-- | man/repo-wipe.1 | 61 |
1 files changed, 61 insertions, 0 deletions
diff --git a/man/repo-wipe.1 b/man/repo-wipe.1 new file mode 100644 index 00000000..1a8f7c16 --- /dev/null +++ b/man/repo-wipe.1 | |||
| @@ -0,0 +1,61 @@ | |||
| 1 | .\" DO NOT MODIFY THIS FILE! It was generated by help2man. | ||
| 2 | .TH REPO "1" "November 2025" "repo wipe" "Repo Manual" | ||
| 3 | .SH NAME | ||
| 4 | repo \- repo wipe - manual page for repo wipe | ||
| 5 | .SH SYNOPSIS | ||
| 6 | .B repo | ||
| 7 | \fI\,wipe <project>\/\fR... | ||
| 8 | .SH DESCRIPTION | ||
| 9 | Summary | ||
| 10 | .PP | ||
| 11 | Wipe projects from the worktree | ||
| 12 | .SH OPTIONS | ||
| 13 | .TP | ||
| 14 | \fB\-h\fR, \fB\-\-help\fR | ||
| 15 | show this help message and exit | ||
| 16 | .TP | ||
| 17 | \fB\-f\fR, \fB\-\-force\fR | ||
| 18 | force wipe shared projects and uncommitted changes | ||
| 19 | .TP | ||
| 20 | \fB\-\-force\-uncommitted\fR | ||
| 21 | force wipe even if there are uncommitted changes | ||
| 22 | .TP | ||
| 23 | \fB\-\-force\-shared\fR | ||
| 24 | force wipe even if the project shares an object | ||
| 25 | directory | ||
| 26 | .SS Logging options: | ||
| 27 | .TP | ||
| 28 | \fB\-v\fR, \fB\-\-verbose\fR | ||
| 29 | show all output | ||
| 30 | .TP | ||
| 31 | \fB\-q\fR, \fB\-\-quiet\fR | ||
| 32 | only show errors | ||
| 33 | .SS Multi\-manifest options: | ||
| 34 | .TP | ||
| 35 | \fB\-\-outer\-manifest\fR | ||
| 36 | operate starting at the outermost manifest | ||
| 37 | .TP | ||
| 38 | \fB\-\-no\-outer\-manifest\fR | ||
| 39 | do not operate on outer manifests | ||
| 40 | .TP | ||
| 41 | \fB\-\-this\-manifest\-only\fR | ||
| 42 | only operate on this (sub)manifest | ||
| 43 | .TP | ||
| 44 | \fB\-\-no\-this\-manifest\-only\fR, \fB\-\-all\-manifests\fR | ||
| 45 | operate on this manifest and its submanifests | ||
| 46 | .PP | ||
| 47 | Run `repo help wipe` to view the detailed manual. | ||
| 48 | .SH DETAILS | ||
| 49 | .PP | ||
| 50 | The 'repo wipe' command removes the specified projects from the worktree (the | ||
| 51 | checked out source code) and deletes the project's git data from `.repo`. | ||
| 52 | .PP | ||
| 53 | This is a destructive operation and cannot be undone. | ||
| 54 | .PP | ||
| 55 | Projects can be specified either by name, or by a relative or absolute path to | ||
| 56 | the project's local directory. | ||
| 57 | .SH EXAMPLES | ||
| 58 | .SS # Wipe the project "platform/build" by name: | ||
| 59 | $ repo wipe platform/build | ||
| 60 | .SS # Wipe the project at the path "build/make": | ||
| 61 | $ repo wipe build/make | ||