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",