From 6586efe79ab12e59466b67eaf59d19002abdf268 Mon Sep 17 00:00:00 2001 From: Brian Gan Date: Thu, 25 Jun 2026 20:48:34 +0000 Subject: [PATCH] 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 Commit-Queue: Brian Gan Reviewed-by: Gavin Mak --- docs/internal-fs-layout.md | 2 +- man/repo-abandon.1 | 5 ++-- man/repo-branches.1 | 5 ++-- man/repo-checkout.1 | 5 ++-- man/repo-diff.1 | 5 ++-- man/repo-forall.1 | 17 +++++-------- man/repo-gc.1 | 5 ++-- man/repo-grep.1 | 5 ++-- man/repo-info.1 | 8 +++---- man/repo-init.1 | 49 +++++++++++++------------------------- man/repo-list.1 | 14 ++++------- man/repo-manifest.1 | 11 +++------ man/repo-prune.1 | 5 ++-- man/repo-rebase.1 | 6 ++--- man/repo-smartsync.1 | 44 +++++++++++----------------------- man/repo-start.1 | 5 ++-- man/repo-status.1 | 8 +++---- man/repo-sync.1 | 47 ++++++++++++------------------------ man/repo-upload.1 | 5 ++-- man/repo-wipe.1 | 5 ++-- man/repo.1 | 8 +++---- release/update_manpages.py | 1 + repo | 6 ++--- 23 files changed, 96 insertions(+), 175 deletions(-) diff --git a/docs/internal-fs-layout.md b/docs/internal-fs-layout.md index c0e44778f..ea0070bfb 100644 --- a/docs/internal-fs-layout.md +++ b/docs/internal-fs-layout.md @@ -182,7 +182,7 @@ User controlled settings are initialized when running `repo init`. | 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 4e1b6b3de..fc63f276f 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 @@ It is equivalent to "git branch \fB\-D\fR ". 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 5e9892d49..81d63ad67 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 @@ is shown, then the branch appears in all projects. 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 f79b83c6a..128d51c2e 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 @@ Checkout a branch for development 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 94d19c31a..63694f85e 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 @@ to the Unix 'patch' command. 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 63ba210c5..215470872 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 @@ repo forall \fB\-r\fR str1 [str2] ... \fB\-c\fR [...] 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 @@ command (and arguments) to execute 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 aadff005d..5a8ac47dc 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 @@ do everything except actually delete 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 29ef4071a..5b5c7ef4b 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 @@ Print lines matching a pattern 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 73311dc60..2fe307c53 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 @@ Get info on the manifest branch, current branch or unmerged branches 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 51be6510d..ba7b52d3f 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 repository location 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 @@ don't fetch tags in the manifest .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 @@ dissociate from reference mirrors after clone 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 2444d3e0b..baf17673f 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 @@ repo list [\-f] \fB\-r\fR str1 [str2]... 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 name of the repository 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 caa912d40..903be2534 100644 --- a/man/repo-manifest.1 +++ b/man/repo-manifest.1 @@ -21,14 +21,10 @@ save revisions as current HEAD 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 @@ format output for humans to read 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 4af775d2a..d2084829d 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 @@ Prune (delete) already merged topics 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 e4ff344ab..638e20e63 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 @@ pass \fB\-\-whitespace\fR to git rebase 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 25b85f126..ef4c112df 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 @@ Update working tree to the latest known good revision 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 @@ obsolete option (to be deleted in the future) 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 @@ password to authenticate with the manifest server 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 @@ fetch tags 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 @@ do not delete refs that no longer exist on the remote 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 f972d9573..f29cec9d1 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 @@ Start a new branch for development 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 db8723fb2..06cfae363 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 the working tree status 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 4e115e200..43d959500 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 @@ Update working tree to the latest revision 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 @@ obsolete option (to be deleted in the future) 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 @@ password to authenticate with the manifest server 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 @@ fetch tags 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 @@ do not delete refs that no longer exist on the remote 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 c0ae5816e..02de7b533 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 @@ Upload changes for code review 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 1a8f7c16e..edec88cd4 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 shared projects and uncommitted changes 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 101b8f650..8a1a00221 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 @@ control color usage: auto, always, never 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 @@ time repo command execution 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 8052c3e48..1abc94796 100644 --- a/release/update_manpages.py +++ b/release/update_manpages.py @@ -76,6 +76,7 @@ def main(argv: List[str]) -> int: # 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 4f541dc00..ed9524eb6 100755 --- a/repo +++ b/repo @@ -405,20 +405,20 @@ def InitParser(parser): "--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",