SYNOPSIS

       datalad-save  [-h] [-m MESSAGE] [-d DATASET] [-u] [-a] [--version-tag ID] [-r] [--recursion-limit LEVELS]
              [-S] [PATH [PATH ...]]

DESCRIPTION

       Save the current state of a dataset

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

OPTIONS

       PATH   path/name  of  the  dataset component to save. If given, only changes made to those components are
              recorded in the new state. Constraints: value must be a string [Default: None]

       -h, --help, --help-np
              show this help message. --help-np forcefully disables the use of a pager for displaying  the  help
              message

       -m MESSAGE, --message MESSAGE
              a  description  of the state or the changes made to a dataset. Constraints: value must be a string
              [Default: None]

       -d DATASET, --dataset DATASET
              "specify the dataset to save. If a dataset is given, but no FILES,  the  entire  dataset  will  be
              saved.  Constraints: Value must be a Dataset or a valid identifier of a Dataset (e.g. a path) [De‐
              fault: None]

       -u, --all-updated
              if no explicit paths are given, save changes of all known  components  in  a  datasets.  [Default:
              True]

       -a, --all-changes
              save  all  changes (even to not yet added files) of all components in datasets that contain any of
              the given paths [DEPRECATED!]. [Default: None]

       --version-tag ID
              an additional marker for that state. Constraints: value must be a string [Default: None]

       -r, --recursive
              if set, recurse into potential subdataset. [Default: False]

       --recursion-limit LEVELS
              limit recursion into subdataset to the given number of levels. Constraints: value must be convert‐
              ible to type 'int' [Default: None]

       -S, --super-datasets
              if set, save a change in a dataset also in its superdataset. [Default: False]

AUTHORS

        datalad is developed by The DataLad Team and Contributors <team@datalad.org>.

datalad-save 0.9.3                                 2018-04-03                                    datalad-save(1)