datalad-save [-version] [-h](1)              [-l {critical,error,warning,info,debug,1,2,3,4,5,6,7,8,9}]

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 annotated with a user-provided description.
Optionally, an additional tag, such as a version, can be assigned to the
saved state. Such tag enables straightforward retrieval of past versions
at a later point in time.

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]


  --version       show the program's version and license information and
                        exit
  -h--help--help-np
                        show this help message and exit. --help-np forcefully
                        disables the use of a pager for displaying the help
                        message
  -l {critical,error,warning,info,debug,1,2,3,4,5,6,7,8,9}, --log-level {critical,error,warning,info,debug,1,2,3,4,5,6,7,8,9}
                        level of verbosity. Integers provide even more
                        debugging information
  -p {condor}, --pbs-runner {condor}
                        execute command by scheduling it via available PBS.
                        For settings, config file will be consulted
  -m MESSAGE, --message MESSAGE
                        a message to annotate the saved state. Constraints:
                        value must be a string [Default: None]
  -d DATASET--dataset DATASET
                        "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]
  -a--auto-add-changes
                        automatically include all changes in the entire
                        dataset, independent of the current working directory.
                        [Default: False]
  --version-tag ID
                        an additional marker for that state. Constraints:
                        value must be a string [Default: None]

AUTHORS


 datalad is developed by The DataLad Team and Contributors <[email protected]>.