git.md

XModule Reference: git

Create local git repository from remote git URLS with git

Main target rules

• xrepo
  Construct an XREPO Repository target from the gir url.

  This tool will attempt to create a shallow clone when possible. Use a <xgit-clone>no-shallow property to disable shallow clone. Shallow clone is only possible for the HEAD revision, tags, and branch references. Unfortunately any SHA reference will force a non-shallow clone.

Features

Git

• <xurl> git-url
  Alternative method for specifying a URL source.

• <xgit-ref> HEAD | SHA | revision:SHA | branch:name | tag:name
  Indicate which revision to clone.
  Default is HEAD.

• <xgit-clone> option
  git clone tool receives option arguments when executing clone on XGIT (url) source.
  Special option no-shallow makes git clone actions to not attempt to perform a shallow clone of the remote repository. This option is not passed on to git clone.

XModule

• <xworkspace> and related features
  By default, the workspace for a git clone target is invariant.
  It has an implicit <xinvariant>.* property.

• <xpatch> patch-file

• <xaction> @rule-or-action

Notes

--xrepo-reset

If a commandline argument --xrepo-reset is specified, all git repositories managed by this XModule tool will be hard reset to their original cloned state.

Logs

• workspace/log/git-clone.log
• workspace/log/git-reset.log

Src Hash

git is also used to construct an XSRCHASH for sources.
This is used to track potential changes in external sources.

Boost.Build Type Reference

Type	Base Type	Infer from source	Generate from
XGIT		*.git, URL/*.git
XREPO	XMODULE		XGIT