#+TITLE: JUST-import-git
#+MAN_CLASS_OPTIONS: section-id=1

* NAME

just-import-git - import one git repository to a multi-repository configuration

* SYNOPSIS

just-import-deps [OPTIONS] URL [foreign repository name]

* DESCRIPTION

Extend an existing *just-mr-repository-config(5)* by adding one
git repository. In doing so, the dependencies declared in the
imported repository are added as well and ~"file"~ respositories
are transformed to ~"subdir"~ parts of the imported repository.
This solves the problem, that a repository can refer to itself only
as ~"."~ in a portable way. The importing party, however, always
knows the URL it is importing from.

The imported repositories are renamed in a way that no conflicts
with already present repositories arise. The repositories pulled in
as dependencies are named in a way to remind for which repositories
they came as a dependency. This renaming is taken into account at
all places repositories are referred to, i.e., the ~"bindings"~
field, as well as roots defined by reference to other repositories.

Only the main parts of repositories are imported (~"repository"~,
~"bindings"~, names, and roots). The ~"pragma"~ part, as well as
unknown fields are dropped.

The repository to import is specified by its URL

The resulting configuration is printed on standard output.


* OPTIONS

   *--as* NAME\\
   Specify the name the imported repository should have in the
   final configuration. If not specified, default to the name
   the repository has in the configuration file of the repository
   imported. In any case, the name is amended if it conflicts
   with an already existing name.

   *-b* BRANCH\\
   The branch in the imported repository to use; this branch is
   also recorded as the branch to follow. Defaults to ~"master"~.

   *-C* CONFIGFILE\\
   Use the specified file as the configuration to import into.
   If not specified, for a config file is searched in the same
   way, as ~just-mr~ does, when invoved with ~--norc~.

   *-h*, *--help* \\
   Output a usage message and exit.

   *--map* THEIRS OURS\\
   Map repositories from the imported configuration to already
   existing ones. Those repositories are not imported (and the
   search for their transitive dependency is ommitted) and instead
   the specified already existing repository is used. This is
   useful, if a sufficiently compatible repository already exists
   in the configuration.

   *-R* RELPATH\\
   Use the file, specified by path relative to the repository
   root, as multi-repository specification in the imported
   repository. If not specifed, for a config file is searched
   in the same way as ~just-mr~ does, when invoced with ~--no-rc~,
   however leaving out searches relative to global roots (~"home"~
   and ~"system"~). In other words, ~repos.json~ and ~etc/repos.json~
   are tried if this option is not given.


* See also

*just-mr-repository-config(5)*, *just-mr(1)*