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 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 61 insertions(+) create mode 100644 man/repo-wipe.1 (limited to 'man/repo-wipe.1') 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 @@ +.\" 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 -- cgit v1.2.3-54-g00ecf