.TH datalad-add-sibling 1 2016\-11\-10 "datalad-add-sibling 0.4.1"
.SH SYNOPSIS
 \fBdatalad\-add\-sibling\fR [--version] [-h] [-l LEVEL] [-p {condor}]
                    [--dataset DATASET] [--pushurl PUSHURL] [-r] [--fetch]
                    [--force] [--as-common-datasrc NAME]
                    [--publish-depends SIBLINGNAME]
                    name [url]


.SH DESCRIPTION
Add a sibling to a dataset.
.SH OPTIONS
  name                  name of the sibling to be added. If RECURSIVE is set,
                        the same name will be used to address the subdatasets'
                        siblings. Constraints: value must be a string
                        [Default: None]
  url                   the URL of or path to the dataset sibling named by
                        NAME. If you want to recursively add siblings, it is
                        expected, that you pass a template for building the
                        URLs of the siblings of all (sub)datasets by using
                        placeholders. List of currently available
                        placeholders: %NAME the name of the dataset, where
                        slashes are replaced by dashes. This option is ignored
                        if there is already a configured sibling dataset under
                        the name given by NAME. Constraints: value must be a
                        string [Default: None]

  \fB--version\fR       show the program's version and license information
  \fB-h\fR, \fB--help\fR, \fB--help-np\fR
                        show this help message. --help-np forcefully disables
                        the use of a pager for displaying the help message
  \fB-l\fR LEVEL, \fB--log-level\fR LEVEL
                        set logging verbosity level. Choose among critical,
                        error, warning, info, debug. Also you can specify an
                        integer <10 to provide even more debugging information
  \fB-p\fR {condor}, \fB--pbs-runner\fR {condor}
                        execute command by scheduling it via available PBS.
                        For settings, config file will be consulted
  \fB--dataset\fR \fI\s-1DATASET\s0\fR, \fB-d\fR \fI\s-1DATASET\s0\fR
                        specify the dataset to add the sibling to. If no
                        dataset is given, an attempt is made to identify the
                        dataset based on the current working directory.
                        Constraints: Value must be a Dataset or a valid
                        identifier of a Dataset (e.g. a path) [Default: None]
  \fB--pushurl\fR \fI\s-1PUSHURL\s0\fR
                        in case the URL cannot be used to publish to the
                        dataset sibling, this option specifies a URL to be
                        used instead. If no URL is given, PUSHURL serves as
                        URL as well. This option is ignored if there is
                        already a configured sibling dataset under the name
                        given by NAME. Constraints: value must be a string
                        [Default: None]
  \fB-r\fR, \fB--recursive\fR
                        if set, recurse into potential subdataset. [Default:
                        False]
  \fB--fetch\fR         fetch the sibling after adding. [Default: False]
  \fB--force\fR, \fB-f\fR
                        if sibling NAME exists already, force to
                        (re-)configure its URLs. [Default: False]
  \fB--as-common-datasrc\fR NAME
                        configure the created sibling as a common data source
                        of the dataset that can be automatically used by all
                        consumers of the dataset (technical: git-annex auto-
                        enabled special remote). [Default: None]
  \fB--publish-depends\fR SIBLINGNAME
                        add a dependency such that the given exsiting sibling
                        is always published prior to the new sibling. This
                        equals setting a configuration item
                        'remote.SIBLINGNAME.datalad-publish-depends'. This
                        option can be given more than once to configure
                        multiple dependencies. [Default: None]
.SH AUTHORS
 datalad is developed by The DataLad Team and Contributors <team@datalad.org>.