1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
|
#+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"~ repositories
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.
The string ~-~ is treated as a request to take the config from
stdin; so a file called ~-~ has to be described as ~./-~, or similar.
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 omitted) 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 invoked 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)*
|
