From be33106ffc516c9631a78e1c1d2ebea3a955d71a Mon Sep 17 00:00:00 2001 From: Gavin Mak Date: Wed, 19 Nov 2025 16:46:07 -0800 Subject: wipe: Add new `repo wipe` subcommand 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 Reviewed-by: Mike Frysinger Commit-Queue: Gavin Mak --- man/repo-wipe.1 | 61 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++ man/repo.1 | 5 ++++- 2 files changed, 65 insertions(+), 1 deletion(-) create mode 100644 man/repo-wipe.1 (limited to 'man') diff --git a/man/repo-wipe.1 b/man/repo-wipe.1 new file mode 100644 index 000000000..1a8f7c16e --- /dev/null +++ b/man/repo-wipe.1 @@ -0,0 +1,61 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man. +.TH REPO "1" "November 2025" "repo wipe" "Repo Manual" +.SH NAME +repo \- repo wipe - manual page for repo wipe +.SH SYNOPSIS +.B repo +\fI\,wipe \/\fR... +.SH DESCRIPTION +Summary +.PP +Wipe projects from the worktree +.SH OPTIONS +.TP +\fB\-h\fR, \fB\-\-help\fR +show this help message and exit +.TP +\fB\-f\fR, \fB\-\-force\fR +force wipe shared projects and uncommitted changes +.TP +\fB\-\-force\-uncommitted\fR +force wipe even if there are uncommitted changes +.TP +\fB\-\-force\-shared\fR +force wipe even if the project shares an object +directory +.SS Logging options: +.TP +\fB\-v\fR, \fB\-\-verbose\fR +show all output +.TP +\fB\-q\fR, \fB\-\-quiet\fR +only show errors +.SS Multi\-manifest options: +.TP +\fB\-\-outer\-manifest\fR +operate starting at the outermost manifest +.TP +\fB\-\-no\-outer\-manifest\fR +do not operate on outer manifests +.TP +\fB\-\-this\-manifest\-only\fR +only operate on this (sub)manifest +.TP +\fB\-\-no\-this\-manifest\-only\fR, \fB\-\-all\-manifests\fR +operate on this manifest and its submanifests +.PP +Run `repo help wipe` to view the detailed manual. +.SH DETAILS +.PP +The 'repo wipe' command removes the specified projects from the worktree (the +checked out source code) and deletes the project's git data from `.repo`. +.PP +This is a destructive operation and cannot be undone. +.PP +Projects can be specified either by name, or by a relative or absolute path to +the project's local directory. +.SH EXAMPLES +.SS # Wipe the project "platform/build" by name: +$ repo wipe platform/build +.SS # Wipe the project at the path "build/make": +$ repo wipe build/make diff --git a/man/repo.1 b/man/repo.1 index 6c0e02558..101b8f650 100644 --- a/man/repo.1 +++ b/man/repo.1 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man. -.TH REPO "1" "April 2025" "repo" "Repo Manual" +.TH REPO "1" "November 2025" "repo" "Repo Manual" .SH NAME repo \- repository management tool built on top of git .SH SYNOPSIS @@ -132,6 +132,9 @@ Upload changes for code review .TP version Display the version of repo +.TP +wipe +Wipe projects from the worktree .PP See 'repo help ' for more information on a specific command. Bug reports: https://issues.gerritcodereview.com/issues/new?component=1370071 -- cgit v1.2.3-54-g00ecf