mirror of
https://gerrit.googlesource.com/git-repo
synced 2024-12-21 07:16:21 +00:00
b750b48f50
People rarely care about the history of the manifest repo. Add a parameter to specify depth for the manifest. For now, make the default behavior the same as the current behavior. At a future date, the default will be changed to 1. People who need the full history should begin passing --manifest-depth=0 to preserve the behavior when the default changes. We can't reuse the existing --depth option because that applies to all projects we clone, not just the manifest repo. Bug: https://crbug.com/gerrit/16193, https://crbug.com/gerrit/16358 Change-Id: I9130fed3eaed656435c778a85cfe9d04e3a4a6a0 Reviewed-on: https://gerrit-review.googlesource.com/c/git-repo/+/349814 Tested-by: LaMont Jones <lamontjones@google.com> Reviewed-by: Xin Li <delphij@google.com>
176 lines
5.0 KiB
Groff
176 lines
5.0 KiB
Groff
.\" DO NOT MODIFY THIS FILE! It was generated by help2man.
|
|
.TH REPO "1" "October 2022" "repo gitc-init" "Repo Manual"
|
|
.SH NAME
|
|
repo \- repo gitc-init - manual page for repo gitc-init
|
|
.SH SYNOPSIS
|
|
.B repo
|
|
\fI\,gitc-init \/\fR[\fI\,options\/\fR] [\fI\,client name\/\fR]
|
|
.SH DESCRIPTION
|
|
Summary
|
|
.PP
|
|
Initialize a GITC Client.
|
|
.SH OPTIONS
|
|
.TP
|
|
\fB\-h\fR, \fB\-\-help\fR
|
|
show this help message and exit
|
|
.SS Logging options:
|
|
.TP
|
|
\fB\-v\fR, \fB\-\-verbose\fR
|
|
show all output
|
|
.TP
|
|
\fB\-q\fR, \fB\-\-quiet\fR
|
|
only show errors
|
|
.SS Manifest options:
|
|
.TP
|
|
\fB\-u\fR URL, \fB\-\-manifest\-url\fR=\fI\,URL\/\fR
|
|
manifest repository location
|
|
.TP
|
|
\fB\-b\fR REVISION, \fB\-\-manifest\-branch\fR=\fI\,REVISION\/\fR
|
|
manifest branch or revision (use HEAD for default)
|
|
.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]
|
|
.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|...]
|
|
.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
|
|
.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)
|
|
.SS Manifest (only) checkout options:
|
|
.TP
|
|
\fB\-\-current\-branch\fR
|
|
fetch only current manifest branch from server
|
|
(default)
|
|
.TP
|
|
\fB\-\-no\-current\-branch\fR
|
|
fetch all manifest branches from server
|
|
.TP
|
|
\fB\-\-tags\fR
|
|
fetch tags in the manifest
|
|
.TP
|
|
\fB\-\-no\-tags\fR
|
|
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
|
|
.TP
|
|
\fB\-\-archive\fR
|
|
checkout an archive instead of a git repository for
|
|
each project. See git archive.
|
|
.TP
|
|
\fB\-\-worktree\fR
|
|
use git\-worktree to manage projects
|
|
.SS Project checkout optimizations:
|
|
.TP
|
|
\fB\-\-reference\fR=\fI\,DIR\/\fR
|
|
location of mirror directory
|
|
.TP
|
|
\fB\-\-dissociate\fR
|
|
dissociate from reference mirrors after clone
|
|
.TP
|
|
\fB\-\-depth\fR=\fI\,DEPTH\/\fR
|
|
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)
|
|
.TP
|
|
\fB\-\-no\-partial\-clone\fR
|
|
disable use of partial clone (https://gitscm.com/docs/gitrepositorylayout#_code_partialclone_code)
|
|
.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)
|
|
.TP
|
|
\fB\-\-clone\-filter\fR=\fI\,CLONE_FILTER\/\fR
|
|
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
|
|
.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)
|
|
.TP
|
|
\fB\-\-no\-clone\-bundle\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
|
|
.TP
|
|
\fB\-\-no\-git\-lfs\fR
|
|
disable Git LFS support
|
|
.SS repo Version options:
|
|
.TP
|
|
\fB\-\-repo\-url\fR=\fI\,URL\/\fR
|
|
repo repository location ($REPO_URL)
|
|
.TP
|
|
\fB\-\-repo\-rev\fR=\fI\,REV\/\fR
|
|
repo branch or revision ($REPO_REV)
|
|
.TP
|
|
\fB\-\-no\-repo\-verify\fR
|
|
do not verify repo source code
|
|
.SS Other options:
|
|
.TP
|
|
\fB\-\-config\-name\fR
|
|
Always prompt for name/e\-mail
|
|
.SS GITC options:
|
|
.TP
|
|
\fB\-f\fR MANIFEST_FILE, \fB\-\-manifest\-file\fR=\fI\,MANIFEST_FILE\/\fR
|
|
Optional manifest file to use for this GITC client.
|
|
.TP
|
|
\fB\-c\fR GITC_CLIENT, \fB\-\-gitc\-client\fR=\fI\,GITC_CLIENT\/\fR
|
|
Name of the gitc_client instance to create or modify.
|
|
.SS Multi\-manifest:
|
|
.TP
|
|
\fB\-\-outer\-manifest\fR
|
|
operate starting at the outermost manifest
|
|
.TP
|
|
\fB\-\-no\-outer\-manifest\fR
|
|
do not operate on outer manifests
|
|
.TP
|
|
\fB\-\-this\-manifest\-only\fR
|
|
only operate on this (sub)manifest
|
|
.TP
|
|
\fB\-\-no\-this\-manifest\-only\fR, \fB\-\-all\-manifests\fR
|
|
operate on this manifest and its submanifests
|
|
.PP
|
|
Run `repo help gitc\-init` to view the detailed manual.
|
|
.SH DETAILS
|
|
.PP
|
|
The 'repo gitc\-init' command is ran to initialize a new GITC client for use with
|
|
the GITC file system.
|
|
.PP
|
|
This command will setup the client directory, initialize repo, just like repo
|
|
init does, and then downloads the manifest collection and installs it in the
|
|
\&.repo/directory of the GITC client.
|
|
.PP
|
|
Once this is done, a GITC manifest is generated by pulling the HEAD SHA for each
|
|
project and generates the properly formatted XML file and installs it as
|
|
\&.manifest in the GITC client directory.
|
|
.PP
|
|
The \fB\-c\fR argument is required to specify the GITC client name.
|
|
.PP
|
|
The optional \fB\-f\fR argument can be used to specify the manifest file to use for
|
|
this GITC client.
|