man: disable line wrapping When help2man runs the repo script to generate man pages, the argparse module relies on the COLUMNS environment variable to wrap help text. This wrapping can cause URLs and descriptions to be awkwardly broken across lines. Setting COLUMNS="10000" prevents argparse from wrapping the output, keeping URLs intact in the generated man pages. Additionally, this fixes a broken git documentation URL fragment for --partial-clone in the repo script. Bug: 295374161 Change-Id: I0c79f37fbfe2bebe71ff90585f2e5e1f88ea33cb Reviewed-on: https://gerrit-review.googlesource.com/c/git-repo/+/601482 Tested-by: Brian Gan <brgan@google.com> Commit-Queue: Brian Gan <brgan@google.com> Reviewed-by: Gavin Mak <gavinmak@google.com>
diff --git a/docs/internal-fs-layout.md b/docs/internal-fs-layout.md index c0e4477..ea0070b 100644 --- a/docs/internal-fs-layout.md +++ b/docs/internal-fs-layout.md
@@ -182,7 +182,7 @@ | user.email | `--config-name` | User's e-mail address; Copied into `.git/config` when checking out a new project | | user.name | `--config-name` | User's name; Copied into `.git/config` when checking out a new project | -[partial git clones]: https://git-scm.com/docs/gitrepository-layout#_code_partialclone_code +[partial git clones]: https://git-scm.com/docs/partial-clone [superproject]: https://en.wikibooks.org/wiki/Git/Submodules_and_Superprojects ### Repo hooks settings
diff --git a/man/repo-abandon.1 b/man/repo-abandon.1 index 4e1b6b3..fc63f27 100644 --- a/man/repo-abandon.1 +++ b/man/repo-abandon.1
@@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man. -.TH REPO "1" "July 2022" "repo abandon" "Repo Manual" +.TH REPO "1" "June 2026" "repo abandon" "Repo Manual" .SH NAME repo \- repo abandon - manual page for repo abandon .SH SYNOPSIS @@ -20,8 +20,7 @@ show this help message and exit .TP \fB\-j\fR JOBS, \fB\-\-jobs\fR=\fI\,JOBS\/\fR -number of jobs to run in parallel (default: based on -number of CPU cores) +number of jobs to run in parallel (default: based on number of CPU cores) .TP \fB\-\-all\fR delete all branches in all projects
diff --git a/man/repo-branches.1 b/man/repo-branches.1 index 5e9892d..81d63ad 100644 --- a/man/repo-branches.1 +++ b/man/repo-branches.1
@@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man. -.TH REPO "1" "July 2022" "repo branches" "Repo Manual" +.TH REPO "1" "June 2026" "repo branches" "Repo Manual" .SH NAME repo \- repo branches - manual page for repo branches .SH SYNOPSIS @@ -46,8 +46,7 @@ show this help message and exit .TP \fB\-j\fR JOBS, \fB\-\-jobs\fR=\fI\,JOBS\/\fR -number of jobs to run in parallel (default: based on -number of CPU cores) +number of jobs to run in parallel (default: based on number of CPU cores) .SS Logging options: .TP \fB\-v\fR, \fB\-\-verbose\fR
diff --git a/man/repo-checkout.1 b/man/repo-checkout.1 index f79b83c..128d51c 100644 --- a/man/repo-checkout.1 +++ b/man/repo-checkout.1
@@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man. -.TH REPO "1" "July 2022" "repo checkout" "Repo Manual" +.TH REPO "1" "June 2026" "repo checkout" "Repo Manual" .SH NAME repo \- repo checkout - manual page for repo checkout .SH SYNOPSIS @@ -15,8 +15,7 @@ show this help message and exit .TP \fB\-j\fR JOBS, \fB\-\-jobs\fR=\fI\,JOBS\/\fR -number of jobs to run in parallel (default: based on -number of CPU cores) +number of jobs to run in parallel (default: based on number of CPU cores) .SS Logging options: .TP \fB\-v\fR, \fB\-\-verbose\fR
diff --git a/man/repo-diff.1 b/man/repo-diff.1 index 94d19c3..63694f8 100644 --- a/man/repo-diff.1 +++ b/man/repo-diff.1
@@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man. -.TH REPO "1" "July 2022" "repo diff" "Repo Manual" +.TH REPO "1" "June 2026" "repo diff" "Repo Manual" .SH NAME repo \- repo diff - manual page for repo diff .SH SYNOPSIS @@ -19,8 +19,7 @@ show this help message and exit .TP \fB\-j\fR JOBS, \fB\-\-jobs\fR=\fI\,JOBS\/\fR -number of jobs to run in parallel (default: based on -number of CPU cores) +number of jobs to run in parallel (default: based on number of CPU cores) .TP \fB\-u\fR, \fB\-\-absolute\fR paths are relative to the repository root
diff --git a/man/repo-forall.1 b/man/repo-forall.1 index 63ba210..2154708 100644 --- a/man/repo-forall.1 +++ b/man/repo-forall.1
@@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man. -.TH REPO "1" "May 2026" "repo forall" "Repo Manual" +.TH REPO "1" "June 2026" "repo forall" "Repo Manual" .SH NAME repo \- repo forall - manual page for repo forall .SH SYNOPSIS @@ -17,20 +17,16 @@ show this help message and exit .TP \fB\-j\fR JOBS, \fB\-\-jobs\fR=\fI\,JOBS\/\fR -number of jobs to run in parallel (default: based on -number of CPU cores) +number of jobs to run in parallel (default: based on number of CPU cores) .TP \fB\-r\fR, \fB\-\-regex\fR -execute the command only on projects matching regex or -wildcard expression +execute the command only on projects matching regex or wildcard expression .TP \fB\-i\fR, \fB\-\-inverse\-regex\fR -execute the command only on projects not matching -regex or wildcard expression +execute the command only on projects not matching regex or wildcard expression .TP \fB\-g\fR GROUPS, \fB\-\-groups\fR=\fI\,GROUPS\/\fR -execute the command only on projects matching the -specified groups +execute the command only on projects matching the specified groups .TP \fB\-c\fR, \fB\-\-command\fR command (and arguments) to execute @@ -39,8 +35,7 @@ abort if a command exits unsuccessfully .TP \fB\-\-ignore\-missing\fR -silently skip & do not exit non\-zero due missing -checkouts +silently skip & do not exit non\-zero due missing checkouts .TP \fB\-\-interactive\fR force interactive usage
diff --git a/man/repo-gc.1 b/man/repo-gc.1 index aadff00..5a8ac47 100644 --- a/man/repo-gc.1 +++ b/man/repo-gc.1
@@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man. -.TH REPO "1" "April 2025" "repo gc" "Repo Manual" +.TH REPO "1" "June 2026" "repo gc" "Repo Manual" .SH NAME repo \- repo gc - manual page for repo gc .SH SYNOPSIS @@ -21,8 +21,7 @@ answer yes to all safe prompts .TP \fB\-\-repack\fR -repack all projects that use partial clone with -filter=blob:none +repack all projects that use partial clone with filter=blob:none .SS Logging options: .TP \fB\-v\fR, \fB\-\-verbose\fR
diff --git a/man/repo-grep.1 b/man/repo-grep.1 index 29ef407..5b5c7ef 100644 --- a/man/repo-grep.1 +++ b/man/repo-grep.1
@@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man. -.TH REPO "1" "July 2022" "repo grep" "Repo Manual" +.TH REPO "1" "June 2026" "repo grep" "Repo Manual" .SH NAME repo \- repo grep - manual page for repo grep .SH SYNOPSIS @@ -15,8 +15,7 @@ show this help message and exit .TP \fB\-j\fR JOBS, \fB\-\-jobs\fR=\fI\,JOBS\/\fR -number of jobs to run in parallel (default: based on -number of CPU cores) +number of jobs to run in parallel (default: based on number of CPU cores) .SS Logging options: .TP \fB\-\-verbose\fR
diff --git a/man/repo-info.1 b/man/repo-info.1 index 73311dc..2fe307c 100644 --- a/man/repo-info.1 +++ b/man/repo-info.1
@@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man. -.TH REPO "1" "May 2026" "repo info" "Repo Manual" +.TH REPO "1" "June 2026" "repo info" "Repo Manual" .SH NAME repo \- repo info - manual page for repo info .SH SYNOPSIS @@ -15,12 +15,10 @@ show this help message and exit .TP \fB\-j\fR JOBS, \fB\-\-jobs\fR=\fI\,JOBS\/\fR -number of jobs to run in parallel (default: based on -number of CPU cores) +number of jobs to run in parallel (default: based on number of CPU cores) .TP \fB\-d\fR, \fB\-\-diff\fR -show full info and commit diff including remote -branches +show full info and commit diff including remote branches .TP \fB\-o\fR, \fB\-\-overview\fR show overview of all local commits
diff --git a/man/repo-init.1 b/man/repo-init.1 index 51be651..ba7b52d 100644 --- a/man/repo-init.1 +++ b/man/repo-init.1
@@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man. -.TH REPO "1" "April 2026" "repo init" "Repo Manual" +.TH REPO "1" "June 2026" "repo init" "Repo Manual" .SH NAME repo \- repo init - manual page for repo init .SH SYNOPSIS @@ -29,36 +29,29 @@ manifest branch or revision (use HEAD for default) .TP \fB\-\-manifest\-upstream\-branch\fR=\fI\,BRANCH\/\fR -when a commit is provided to \fB\-\-manifest\-branch\fR, this -is the name of the git ref in which the commit can be -found +when a commit is provided to \fB\-\-manifest\-branch\fR, this is the name of the git ref in which the commit can be found .TP \fB\-m\fR NAME.xml, \fB\-\-manifest\-name\fR=\fI\,NAME\/\fR.xml initial manifest file .TP \fB\-g\fR GROUP, \fB\-\-groups\fR=\fI\,GROUP\/\fR -restrict manifest projects to ones with specified -group(s) [default|all|G1,G2,G3|G4,\-G5,\-G6] +restrict manifest projects to ones with specified group(s) [default|all|G1,G2,G3|G4,\-G5,\-G6] .TP \fB\-p\fR PLATFORM, \fB\-\-platform\fR=\fI\,PLATFORM\/\fR -restrict manifest projects to ones with a specified -platform group [auto|all|none|linux|darwin|...] +restrict manifest projects to ones with a specified platform group [auto|all|none|linux|darwin|...] .TP \fB\-\-submodules\fR sync any submodules associated with the manifest repo .TP \fB\-\-standalone\-manifest\fR -download the manifest as a static file rather then -create a git checkout of the manifest repo +download the manifest as a static file rather then create a git checkout of the manifest repo .TP \fB\-\-manifest\-depth\fR=\fI\,DEPTH\/\fR -create a shallow clone of the manifest repo with given -depth (0 for full clone); see git clone (default: 0) +create a shallow clone of the manifest repo with given depth (0 for full clone); see git clone (default: 0) .SS Manifest (only) checkout options: .TP \fB\-c\fR, \fB\-\-current\-branch\fR -fetch only current manifest branch from server -(default) +fetch only current manifest branch from server (default) .TP \fB\-\-no\-current\-branch\fR fetch all manifest branches from server @@ -71,19 +64,16 @@ .SS Checkout modes: .TP \fB\-\-mirror\fR -create a replica of the remote repositories rather -than a client working directory +create a replica of the remote repositories rather than a client working directory .TP \fB\-\-archive\fR -checkout an archive instead of a git repository for -each project. See git archive. +checkout an archive instead of a git repository for each project. See git archive. .TP \fB\-\-worktree\fR use git\-worktree to manage projects .TP \fB\-\-use\-local\-gitdirs\fR -bypass .repo/projects/ and use standard Git layout in -working tree +bypass .repo/projects/ and use standard Git layout in working tree .SS Project checkout optimizations: .TP \fB\-\-reference\fR=\fI\,DIR\/\fR @@ -96,33 +86,28 @@ create a shallow clone with given depth; see git clone .TP \fB\-\-partial\-clone\fR -perform partial clone (https://gitscm.com/docs/gitrepositorylayout#_code_partialclone_code) +perform partial clone (https://git\-scm.com/docs/partial\-clone) .TP \fB\-\-no\-partial\-clone\fR -disable use of partial clone (https://gitscm.com/docs/gitrepositorylayout#_code_partialclone_code) +disable use of partial clone (https://git\-scm.com/docs/partial\-clone) .TP \fB\-\-partial\-clone\-exclude\fR=\fI\,PARTIAL_CLONE_EXCLUDE\/\fR -exclude the specified projects (a comma\-delimited -project names) from partial clone (https://gitscm.com/docs/gitrepositorylayout#_code_partialclone_code) +exclude the specified projects (a comma\-delimited project names) from partial clone (https://git\-scm.com/docs/partial\-clone) .TP \fB\-\-clone\-filter\fR=\fI\,CLONE_FILTER\/\fR -filter for use with \fB\-\-partial\-clone\fR [default: -blob:none] +filter for use with \fB\-\-partial\-clone\fR [default: blob:none] .TP \fB\-\-use\-superproject\fR -use the manifest superproject to sync projects; -implies \fB\-c\fR +use the manifest superproject to sync projects; implies \fB\-c\fR .TP \fB\-\-no\-use\-superproject\fR disable use of manifest superprojects .TP \fB\-\-clone\-bundle\fR -enable use of \fI\,/clone.bundle\/\fP on HTTP/HTTPS (default if -not \fB\-\-partial\-clone\fR) +enable use of \fI\,/clone.bundle\/\fP on HTTP/HTTPS (default if not \fB\-\-partial\-clone\fR) .TP \fB\-\-no\-clone\-bundle\fR -disable use of \fI\,/clone.bundle\/\fP on HTTP/HTTPS (default if -\fB\-\-partial\-clone\fR) +disable use of \fI\,/clone.bundle\/\fP on HTTP/HTTPS (default if \fB\-\-partial\-clone\fR) .TP \fB\-\-git\-lfs\fR enable Git LFS support
diff --git a/man/repo-list.1 b/man/repo-list.1 index 2444d3e..baf1767 100644 --- a/man/repo-list.1 +++ b/man/repo-list.1
@@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man. -.TH REPO "1" "July 2022" "repo list" "Repo Manual" +.TH REPO "1" "June 2026" "repo list" "Repo Manual" .SH NAME repo \- repo list - manual page for repo list .SH SYNOPSIS @@ -17,12 +17,10 @@ show this help message and exit .TP \fB\-r\fR, \fB\-\-regex\fR -filter the project list based on regex or wildcard -matching of strings +filter the project list based on regex or wildcard matching of strings .TP \fB\-g\fR GROUPS, \fB\-\-groups\fR=\fI\,GROUPS\/\fR -filter the project list based on the groups the -project is in +filter the project list based on the groups the project is in .TP \fB\-a\fR, \fB\-\-all\fR show projects regardless of checkout state @@ -34,12 +32,10 @@ display only the path of the repository .TP \fB\-f\fR, \fB\-\-fullpath\fR -display the full work tree path instead of the -relative path +display the full work tree path instead of the relative path .TP \fB\-\-relative\-to\fR=\fI\,PATH\/\fR -display paths relative to this one (default: top of -repo client checkout) +display paths relative to this one (default: top of repo client checkout) .SS Logging options: .TP \fB\-v\fR, \fB\-\-verbose\fR
diff --git a/man/repo-manifest.1 b/man/repo-manifest.1 index caa912d..903be25 100644 --- a/man/repo-manifest.1 +++ b/man/repo-manifest.1
@@ -21,14 +21,10 @@ temporary manifest to use for this sync .TP \fB\-\-suppress\-upstream\-revision\fR -if in \fB\-r\fR mode, do not write the upstream field (only -of use if the branch names for a sha1 manifest are -sensitive) +if in \fB\-r\fR mode, do not write the upstream field (only of use if the branch names for a sha1 manifest are sensitive) .TP \fB\-\-suppress\-dest\-branch\fR -if in \fB\-r\fR mode, do not write the dest\-branch field -(only of use if the branch names for a sha1 manifest -are sensitive) +if in \fB\-r\fR mode, do not write the dest\-branch field (only of use if the branch names for a sha1 manifest are sensitive) .TP \fB\-\-format\fR=\fI\,FORMAT\/\fR output format: xml, json (default: xml) @@ -40,8 +36,7 @@ ignore local manifests .TP \fB\-o\fR \-|NAME.xml, \fB\-\-output\-file\fR=\fI\,\-\/\fR|NAME.xml -file to save the manifest to. (Filename prefix for -multi\-tree.) +file to save the manifest to. (Filename prefix for multi\-tree.) .SS Logging options: .TP \fB\-v\fR, \fB\-\-verbose\fR
diff --git a/man/repo-prune.1 b/man/repo-prune.1 index 4af775d..d208482 100644 --- a/man/repo-prune.1 +++ b/man/repo-prune.1
@@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man. -.TH REPO "1" "July 2022" "repo prune" "Repo Manual" +.TH REPO "1" "June 2026" "repo prune" "Repo Manual" .SH NAME repo \- repo prune - manual page for repo prune .SH SYNOPSIS @@ -15,8 +15,7 @@ show this help message and exit .TP \fB\-j\fR JOBS, \fB\-\-jobs\fR=\fI\,JOBS\/\fR -number of jobs to run in parallel (default: based on -number of CPU cores) +number of jobs to run in parallel (default: based on number of CPU cores) .SS Logging options: .TP \fB\-v\fR, \fB\-\-verbose\fR
diff --git a/man/repo-rebase.1 b/man/repo-rebase.1 index e4ff344..638e20e 100644 --- a/man/repo-rebase.1 +++ b/man/repo-rebase.1
@@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man. -.TH REPO "1" "July 2022" "repo rebase" "Repo Manual" +.TH REPO "1" "June 2026" "repo rebase" "Repo Manual" .SH NAME repo \- repo rebase - manual page for repo rebase .SH SYNOPSIS @@ -33,9 +33,7 @@ stash local modifications before starting .TP \fB\-m\fR, \fB\-\-onto\-manifest\fR -rebase onto the manifest version instead of upstream -HEAD (this helps to make sure the local tree stays -consistent if you previously synced to a manifest) +rebase onto the manifest version instead of upstream HEAD (this helps to make sure the local tree stays consistent if you previously synced to a manifest) .SS Logging options: .TP \fB\-v\fR, \fB\-\-verbose\fR
diff --git a/man/repo-smartsync.1 b/man/repo-smartsync.1 index 25b85f1..ef4c112 100644 --- a/man/repo-smartsync.1 +++ b/man/repo-smartsync.1
@@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man. -.TH REPO "1" "May 2026" "repo smartsync" "Repo Manual" +.TH REPO "1" "June 2026" "repo smartsync" "Repo Manual" .SH NAME repo \- repo smartsync - manual page for repo smartsync .SH SYNOPSIS @@ -15,16 +15,13 @@ show this help message and exit .TP \fB\-j\fR JOBS, \fB\-\-jobs\fR=\fI\,JOBS\/\fR -number of jobs to run in parallel (default: based on -number of CPU cores) +number of jobs to run in parallel (default: based on number of CPU cores) .TP \fB\-\-jobs\-network\fR=\fI\,JOBS\/\fR -number of network jobs to run in parallel (defaults to -\fB\-\-jobs\fR or 1). Ignored unless \fB\-\-no\-interleaved\fR is set +number of network jobs to run in parallel (defaults to \fB\-\-jobs\fR or 1). Ignored unless \fB\-\-no\-interleaved\fR is set .TP \fB\-\-jobs\-checkout\fR=\fI\,JOBS\/\fR -number of local checkout jobs to run in parallel -(defaults to \fB\-\-jobs\fR or 8). Ignored unless \fB\-\-nointerleaved\fR is set +number of local checkout jobs to run in parallel (defaults to \fB\-\-jobs\fR or 8). Ignored unless \fB\-\-no\-interleaved\fR is set .TP \fB\-f\fR, \fB\-\-force\-broken\fR obsolete option (to be deleted in the future) @@ -33,30 +30,22 @@ stop syncing after first error is hit .TP \fB\-\-force\-sync\fR -overwrite an existing git directory if it needs to -point to a different object directory. WARNING: this -may cause loss of data +overwrite an existing git directory if it needs to point to a different object directory. WARNING: this may cause loss of data .TP \fB\-\-force\-checkout\fR -force checkout even if it results in throwing away -uncommitted modifications. WARNING: this may cause -loss of data +force checkout even if it results in throwing away uncommitted modifications. WARNING: this may cause loss of data .TP \fB\-\-force\-remove\-dirty\fR -force remove projects with uncommitted modifications -if projects no longer exist in the manifest. WARNING: -this may cause loss of data +force remove projects with uncommitted modifications if projects no longer exist in the manifest. WARNING: this may cause loss of data .TP \fB\-\-rebase\fR -rebase local commits regardless of whether they are -published +rebase local commits regardless of whether they are published .TP \fB\-l\fR, \fB\-\-local\-only\fR only update working tree, don't fetch .TP \fB\-\-no\-manifest\-update\fR, \fB\-\-nmu\fR -use the existing manifest checkout as\-is. (do not -update to the latest revision) +use the existing manifest checkout as\-is. (do not update to the latest revision) .TP \fB\-\-interleaved\fR fetch and checkout projects in parallel (default) @@ -95,15 +84,13 @@ fetch submodules from server .TP \fB\-\-use\-superproject\fR -use the manifest superproject to sync projects; -implies \fB\-c\fR +use the manifest superproject to sync projects; implies \fB\-c\fR .TP \fB\-\-no\-use\-superproject\fR disable use of manifest superprojects .TP \fB\-\-superproject\-revision\fR=\fI\,SUPERPROJECT_REVISION\/\fR -sync to superproject revision (applies to outer -manifest) +sync to superproject revision (applies to outer manifest) .TP \fB\-\-tags\fR fetch tags @@ -112,15 +99,13 @@ don't fetch tags (default) .TP \fB\-\-optimized\-fetch\fR -only fetch projects fixed to sha1 if revision does not -exist locally +only fetch projects fixed to sha1 if revision does not exist locally .TP \fB\-\-retry\-fetches\fR=\fI\,RETRY_FETCHES\/\fR number of times to retry fetches on transient errors .TP \fB\-\-prune\fR -delete refs that no longer exist on the remote -(default) +delete refs that no longer exist on the remote (default) .TP \fB\-\-no\-prune\fR do not delete refs that no longer exist on the remote @@ -129,8 +114,7 @@ run garbage collection on all synced projects .TP \fB\-\-no\-auto\-gc\fR -do not run garbage collection on any projects -(default) +do not run garbage collection on any projects (default) .SS Logging options: .TP \fB\-v\fR, \fB\-\-verbose\fR
diff --git a/man/repo-start.1 b/man/repo-start.1 index f972d95..f29cec9 100644 --- a/man/repo-start.1 +++ b/man/repo-start.1
@@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man. -.TH REPO "1" "July 2022" "repo start" "Repo Manual" +.TH REPO "1" "June 2026" "repo start" "Repo Manual" .SH NAME repo \- repo start - manual page for repo start .SH SYNOPSIS @@ -15,8 +15,7 @@ show this help message and exit .TP \fB\-j\fR JOBS, \fB\-\-jobs\fR=\fI\,JOBS\/\fR -number of jobs to run in parallel (default: based on -number of CPU cores) +number of jobs to run in parallel (default: based on number of CPU cores) .TP \fB\-\-all\fR begin branch in all projects
diff --git a/man/repo-status.1 b/man/repo-status.1 index db8723f..06cfae3 100644 --- a/man/repo-status.1 +++ b/man/repo-status.1
@@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man. -.TH REPO "1" "July 2022" "repo status" "Repo Manual" +.TH REPO "1" "June 2026" "repo status" "Repo Manual" .SH NAME repo \- repo status - manual page for repo status .SH SYNOPSIS @@ -15,12 +15,10 @@ show this help message and exit .TP \fB\-j\fR JOBS, \fB\-\-jobs\fR=\fI\,JOBS\/\fR -number of jobs to run in parallel (default: based on -number of CPU cores) +number of jobs to run in parallel (default: based on number of CPU cores) .TP \fB\-o\fR, \fB\-\-orphans\fR -include objects in working directory outside of repo -projects +include objects in working directory outside of repo projects .SS Logging options: .TP \fB\-v\fR, \fB\-\-verbose\fR
diff --git a/man/repo-sync.1 b/man/repo-sync.1 index 4e115e2..43d9595 100644 --- a/man/repo-sync.1 +++ b/man/repo-sync.1
@@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man. -.TH REPO "1" "May 2026" "repo sync" "Repo Manual" +.TH REPO "1" "June 2026" "repo sync" "Repo Manual" .SH NAME repo \- repo sync - manual page for repo sync .SH SYNOPSIS @@ -15,16 +15,13 @@ show this help message and exit .TP \fB\-j\fR JOBS, \fB\-\-jobs\fR=\fI\,JOBS\/\fR -number of jobs to run in parallel (default: based on -number of CPU cores) +number of jobs to run in parallel (default: based on number of CPU cores) .TP \fB\-\-jobs\-network\fR=\fI\,JOBS\/\fR -number of network jobs to run in parallel (defaults to -\fB\-\-jobs\fR or 1). Ignored unless \fB\-\-no\-interleaved\fR is set +number of network jobs to run in parallel (defaults to \fB\-\-jobs\fR or 1). Ignored unless \fB\-\-no\-interleaved\fR is set .TP \fB\-\-jobs\-checkout\fR=\fI\,JOBS\/\fR -number of local checkout jobs to run in parallel -(defaults to \fB\-\-jobs\fR or 8). Ignored unless \fB\-\-nointerleaved\fR is set +number of local checkout jobs to run in parallel (defaults to \fB\-\-jobs\fR or 8). Ignored unless \fB\-\-no\-interleaved\fR is set .TP \fB\-f\fR, \fB\-\-force\-broken\fR obsolete option (to be deleted in the future) @@ -33,30 +30,22 @@ stop syncing after first error is hit .TP \fB\-\-force\-sync\fR -overwrite an existing git directory if it needs to -point to a different object directory. WARNING: this -may cause loss of data +overwrite an existing git directory if it needs to point to a different object directory. WARNING: this may cause loss of data .TP \fB\-\-force\-checkout\fR -force checkout even if it results in throwing away -uncommitted modifications. WARNING: this may cause -loss of data +force checkout even if it results in throwing away uncommitted modifications. WARNING: this may cause loss of data .TP \fB\-\-force\-remove\-dirty\fR -force remove projects with uncommitted modifications -if projects no longer exist in the manifest. WARNING: -this may cause loss of data +force remove projects with uncommitted modifications if projects no longer exist in the manifest. WARNING: this may cause loss of data .TP \fB\-\-rebase\fR -rebase local commits regardless of whether they are -published +rebase local commits regardless of whether they are published .TP \fB\-l\fR, \fB\-\-local\-only\fR only update working tree, don't fetch .TP \fB\-\-no\-manifest\-update\fR, \fB\-\-nmu\fR -use the existing manifest checkout as\-is. (do not -update to the latest revision) +use the existing manifest checkout as\-is. (do not update to the latest revision) .TP \fB\-\-interleaved\fR fetch and checkout projects in parallel (default) @@ -95,15 +84,13 @@ fetch submodules from server .TP \fB\-\-use\-superproject\fR -use the manifest superproject to sync projects; -implies \fB\-c\fR +use the manifest superproject to sync projects; implies \fB\-c\fR .TP \fB\-\-no\-use\-superproject\fR disable use of manifest superprojects .TP \fB\-\-superproject\-revision\fR=\fI\,SUPERPROJECT_REVISION\/\fR -sync to superproject revision (applies to outer -manifest) +sync to superproject revision (applies to outer manifest) .TP \fB\-\-tags\fR fetch tags @@ -112,15 +99,13 @@ don't fetch tags (default) .TP \fB\-\-optimized\-fetch\fR -only fetch projects fixed to sha1 if revision does not -exist locally +only fetch projects fixed to sha1 if revision does not exist locally .TP \fB\-\-retry\-fetches\fR=\fI\,RETRY_FETCHES\/\fR number of times to retry fetches on transient errors .TP \fB\-\-prune\fR -delete refs that no longer exist on the remote -(default) +delete refs that no longer exist on the remote (default) .TP \fB\-\-no\-prune\fR do not delete refs that no longer exist on the remote @@ -129,12 +114,10 @@ run garbage collection on all synced projects .TP \fB\-\-no\-auto\-gc\fR -do not run garbage collection on any projects -(default) +do not run garbage collection on any projects (default) .TP \fB\-s\fR, \fB\-\-smart\-sync\fR -smart sync using manifest from the latest known good -build +smart sync using manifest from the latest known good build .TP \fB\-t\fR SMART_TAG, \fB\-\-smart\-tag\fR=\fI\,SMART_TAG\/\fR smart sync using manifest from a known tag
diff --git a/man/repo-upload.1 b/man/repo-upload.1 index c0ae581..02de7b5 100644 --- a/man/repo-upload.1 +++ b/man/repo-upload.1
@@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man. -.TH REPO "1" "June 2024" "repo upload" "Repo Manual" +.TH REPO "1" "June 2026" "repo upload" "Repo Manual" .SH NAME repo \- repo upload - manual page for repo upload .SH SYNOPSIS @@ -15,8 +15,7 @@ show this help message and exit .TP \fB\-j\fR JOBS, \fB\-\-jobs\fR=\fI\,JOBS\/\fR -number of jobs to run in parallel (default: based on -number of CPU cores) +number of jobs to run in parallel (default: based on number of CPU cores) .TP \fB\-t\fR, \fB\-\-topic\-branch\fR set the topic to the local branch name
diff --git a/man/repo-wipe.1 b/man/repo-wipe.1 index 1a8f7c1..edec88c 100644 --- a/man/repo-wipe.1 +++ b/man/repo-wipe.1
@@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man. -.TH REPO "1" "November 2025" "repo wipe" "Repo Manual" +.TH REPO "1" "June 2026" "repo wipe" "Repo Manual" .SH NAME repo \- repo wipe - manual page for repo wipe .SH SYNOPSIS @@ -21,8 +21,7 @@ force wipe even if there are uncommitted changes .TP \fB\-\-force\-shared\fR -force wipe even if the project shares an object -directory +force wipe even if the project shares an object directory .SS Logging options: .TP \fB\-v\fR, \fB\-\-verbose\fR
diff --git a/man/repo.1 b/man/repo.1 index 101b8f6..8a1a002 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" "November 2025" "repo" "Repo Manual" +.TH REPO "1" "June 2026" "repo" "Repo Manual" .SH NAME repo \- repository management tool built on top of git .SH SYNOPSIS @@ -26,8 +26,7 @@ trace git command execution (REPO_TRACE=1) .TP \fB\-\-trace\-to\-stderr\fR -trace outputs go to stderr in addition to -\&.repo/TRACE_FILE +trace outputs go to stderr in addition to .repo/TRACE_FILE .TP \fB\-\-trace\-python\fR trace python command execution @@ -39,8 +38,7 @@ display this version of repo .TP \fB\-\-show\-toplevel\fR -display the path of the top\-level directory of the -repo client checkout +display the path of the top\-level directory of the repo client checkout .TP \fB\-\-event\-log\fR=\fI\,EVENT_LOG\/\fR filename of event log to append timeline to
diff --git a/release/update_manpages.py b/release/update_manpages.py index 8052c3e..1abc947 100644 --- a/release/update_manpages.py +++ b/release/update_manpages.py
@@ -76,6 +76,7 @@ # behavior (like probing active number of CPUs). We use a weird name & # value to make it less likely for users to set this var themselves. os.environ["_REPO_GENERATE_MANPAGES_"] = " indeed! " + os.environ["COLUMNS"] = "10000" # "repo branch" is an alias for "repo branches". del subcmds.all_commands["branch"]
diff --git a/repo b/repo index 4f541dc..ed9524e 100755 --- a/repo +++ b/repo
@@ -405,20 +405,20 @@ "--partial-clone", action="store_true", help="perform partial clone (https://git-scm.com/" - "docs/gitrepository-layout#_code_partialclone_code)", + "docs/partial-clone)", ) group.add_option( "--no-partial-clone", action="store_false", help="disable use of partial clone (https://git-scm.com/" - "docs/gitrepository-layout#_code_partialclone_code)", + "docs/partial-clone)", ) group.add_option( "--partial-clone-exclude", action="store", help="exclude the specified projects (a comma-delimited " "project names) from partial clone (https://git-scm.com" - "/docs/gitrepository-layout#_code_partialclone_code)", + "/docs/partial-clone)", ) group.add_option( "--clone-filter",