oracular (1) repo-gitc-init.1.gz

NAME

       repo - repo gitc-init - manual page for repo gitc-init

SYNOPSIS

       repo gitc-init [options] [client name]

DESCRIPTION

       Summary

       Initialize a GITC Client.

OPTIONS

       -h, --help
              show this help message and exit

   Logging options:
       -v, --verbose
              show all output

       -q, --quiet
              only show errors

   Manifest options:
       -u URL, --manifest-url=URL
              manifest repository location

       -b REVISION, --manifest-branch=REVISION
              manifest branch or revision (use HEAD for default)

       -m NAME.xml, --manifest-name=NAME.xml
              initial manifest file

       -g GROUP, --groups=GROUP
              restrict manifest projects to ones with specified group(s) [default|all|G1,G2,G3|G4,-G5,-G6]

       -p PLATFORM, --platform=PLATFORM
              restrict     manifest     projects     to     ones     with    a    specified    platform    group
              [auto|all|none|linux|darwin|...]

       --submodules
              sync any submodules associated with the manifest repo

       --standalone-manifest
              download the manifest as a static file rather then create a git checkout of the manifest repo

       --manifest-depth=DEPTH
              create a shallow clone of the manifest repo with given depth (0 for full  clone);  see  git  clone
              (default: 0)

   Manifest (only) checkout options:
       --current-branch
              fetch only current manifest branch from server (default)

       --no-current-branch
              fetch all manifest branches from server

       --tags fetch tags in the manifest

       --no-tags
              don't fetch tags in the manifest

   Checkout modes:
       --mirror
              create a replica of the remote repositories rather than a client working directory

       --archive
              checkout an archive instead of a git repository for each project. See git archive.

       --worktree
              use git-worktree to manage projects

   Project checkout optimizations:
       --reference=DIR
              location of mirror directory

       --dissociate
              dissociate from reference mirrors after clone

       --depth=DEPTH
              create a shallow clone with given depth; see git clone

       --partial-clone
              perform partial clone (https://gitscm.com/docs/gitrepositorylayout#_code_partialclone_code)

       --no-partial-clone
              disable use of partial clone (https://gitscm.com/docs/gitrepositorylayout#_code_partialclone_code)

       --partial-clone-exclude=PARTIAL_CLONE_EXCLUDE
              exclude   the   specified   projects   (a   comma-delimited  project  names)  from  partial  clone
              (https://gitscm.com/docs/gitrepositorylayout#_code_partialclone_code)

       --clone-filter=CLONE_FILTER
              filter for use with --partial-clone [default: blob:none]

       --use-superproject
              use the manifest superproject to sync projects; implies -c

       --no-use-superproject
              disable use of manifest superprojects

       --clone-bundle
              enable use of /clone.bundle on HTTP/HTTPS (default if not --partial-clone)

       --no-clone-bundle
              disable use of /clone.bundle on HTTP/HTTPS (default if --partial-clone)

       --git-lfs
              enable Git LFS support

       --no-git-lfs
              disable Git LFS support

   repo Version options:
       --repo-url=URL
              repo repository location ($REPO_URL)

       --repo-rev=REV
              repo branch or revision ($REPO_REV)

       --no-repo-verify
              do not verify repo source code

   Other options:
       --config-name
              Always prompt for name/e-mail

   GITC options:
       -f MANIFEST_FILE, --manifest-file=MANIFEST_FILE
              Optional manifest file to use for this GITC client.

       -c GITC_CLIENT, --gitc-client=GITC_CLIENT
              Name of the gitc_client instance to create or modify.

   Multi-manifest:
       --outer-manifest
              operate starting at the outermost manifest

       --no-outer-manifest
              do not operate on outer manifests

       --this-manifest-only
              only operate on this (sub)manifest

       --no-this-manifest-only, --all-manifests
              operate on this manifest and its submanifests

       Run `repo help gitc-init` to view the detailed manual.

DETAILS

       The 'repo gitc-init' command is ran to initialize a new GITC client for use with the GITC file system.

       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.

       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.

       The -c argument is required to specify the GITC client name.

       The optional -f argument can be used to specify the manifest file to use for this GITC client.