Name

bif-clone - import an organisation or project from a hub

Version

0.1.5_8 (yyyy-mm-dd)

Synopsis

bif clone SOURCE [OPTIONS...]

Description

The bif-clone command imports data from a remote bif repository (usually referred to as a hub). The first use for bif-clone is typically to import an organisation and its list of projects:

$ bif init  # if the repository doesn't already exist
$ bif clone ssh://bif@bifax.org

By default the first clone of a hub is "shallow" meaning that only the organisation (top-level) project is marked as "local" and has all of its topics copied. Non-local projects are indicated by a "*" in certain columns of the bif-list-projects command output and are ignored by bif-sync.

$ bif list projects

The second use for bif-clone is to mark individual projects as local and copy their topics to the local repository.

$ bif clone bif/doc

Note that bif-clone is actually just a wrapper around the bif-clone-org and bif-clone-project commands.

Arguments & Options

SOURCE: A remote hub URL or a project PATH known to the current repository. Required.
--shallow, -s: Normally all of an organisations projects and sub-projects and topics are cloned recursively. This option limits the clone to the actual node requested.

Author

Mark Lawrence <nomad@null.net>

Copyright And License

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.