.TH datalad-save 1 2016\-11\-10 "datalad-save 0.4.1"
.SH SYNOPSIS
 \fBdatalad\-save\fR [--version] [-h] [-l LEVEL] [-p {condor}] [-m MESSAGE]
             [-d DATASET] [-a] [--version-tag ID] [-r]
             [--recursion-limit LEVELS] [-S]
             [FILES [FILES ...]]


.SH DESCRIPTION
Save the current state of a dataset
.br

.br
Saving the state of a dataset records all changes that have been made
.br
to it. This change record is annotated with a user\-provided description.
.br
Optionally, an additional tag, such as a version, can be assigned to the
.br
saved state. Such tag enables straightforward retrieval of past versions
.br
at a later point in time.
.br

.br

.SH OPTIONS
  FILES                 list of files to consider. If given, only changes made
                        to those files are recorded in the new state.
                        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-m\fR MESSAGE, \fB--message\fR MESSAGE
                        a message to annotate the saved state. Constraints:
                        value must be a string [Default: None]
  \fB-d\fR \fI\s-1DATASET\s0\fR, \fB--dataset\fR \fI\s-1DATASET\s0\fR
                        "specify the dataset to save. 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-a\fR, \fB--auto-add-changes\fR
                        automatically include all changes in the entire
                        dataset, independent of the current working directory.
                        [Default: False]
  \fB--version-tag\fR ID
                        an additional marker for that state. Constraints:
                        value must be a string [Default: None]
  \fB-r\fR, \fB--recursive\fR
                        if set, recurse into potential subdataset. [Default:
                        False]
  \fB--recursion-limit\fR LEVELS
                        limit recursion into subdataset to the given number of
                        levels. Constraints: value must be convertible to type
                        'int' [Default: None]
  \fB-S\fR, \fB--super-datasets\fR
                        if set, traverse and save stats corresponding to the
                        change within super-datasets. [Default: False]
.SH AUTHORS
 datalad is developed by The DataLad Team and Contributors <team@datalad.org>.