.TH datalad-publish 1 2016\-11\-10 "datalad-publish 0.4.1"
.SH SYNOPSIS
 \fBdatalad\-publish\fR [--version] [-h] [-l LEVEL] [-p {condor}] [-d DATASET]
                [--to DEST] [-r] [--since SINCE] [--skip-failing]
                [--annex-copy-opts OPT_STR]
                [PATH [PATH ...]]


.SH DESCRIPTION
Publish a dataset (e.g. to a web server)
.br

.br
This makes the current state of a dataset available to a sibling of the
.br
dataset. That sibling needs to be known to the dataset before.
.br
CREATE_PUBLICATION_TARGET commands are meant to set up such a sibling, but
.br
generally you can publish to any sibling added to a dataset.
.br
Publishing may or may not include subdatasets.
.br
By default file handles are published without their actual content,
.br
but they can be published including the content, of course.
.SH OPTIONS
  PATH                  path(s), that may point to file handle(s) to publish
                        including their actual content or to subdataset(s) to
                        be published. If a file handle is published with its
                        data, this implicitly means to also publish the
                        (sub)dataset it belongs to. '.' as a path is treated
                        in a special way in the sense, that it is passed to
                        subdatasets in case RECURSIVE is also given.
                        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-d\fR DATASET, \fB--dataset\fR DATASET
                        specify the dataset to publish. 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--to\fR DEST       sibling name identifying the publication target. If no
                        destination is given an attempt is made to identify
                        the target based on the dataset's configuration.
                        Constraints: value must be a string [Default: None]
  \fB-r\fR, \fB--recursive\fR
                        recursively publish all subdatasets of the dataset. In
                        order to recursively publish with all data, use '.' as
                        PATH in combination with RECURSIVE. [Default: False]
  \fB--since\fR \fI\s-1SINCE\s0\fR
                        When publishing dataset(s), specifies commit (treeish,
                        tag, etc) from which to look for changes to decide
                        either updated publishing is necessary for this and
                        which children. If empty argument is provided, then we
                        will always run publish command. By default, would
                        take from the previously published to that
                        remote/sibling state (for the current branch).
                        Constraints: value must be a string [Default: None]
  \fB--skip-failing\fR  skip failing sub-datasets (incombination with
                        RECURSIVE) instead of failing altogether. [Default:
                        False]
  \fB--annex-copy-opts\fR OPT_STR
                        options passed to 'annex copy'. Constraints: value
                        must be a string [Default: None]
.SH AUTHORS
 datalad is developed by The DataLad Team and Contributors <team@datalad.org>.