Scroll to navigation

datalad-save(1) General Commands Manual datalad-save(1)

SYNOPSIS

datalad-save [--version] [-h] [-l LEVEL] [-p {condor}] [-m MESSAGE] [-d DATASET] [-a] [--version-tag ID] [-r] [--recursion-limit LEVELS] [-S] [FILES [FILES ...]]

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 -h, --help, --help-np show this help message. --help-np forcefully disables the use of a pager for displaying the help message -l LEVEL, --log-level 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 -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] -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 convertible to type 'int' [Default: None] -S, --super-datasets if set, traverse and save stats corresponding to the change within super-datasets. [Default: False]

AUTHORS

datalad is developed by The DataLad Team and Contributors <team@datalad.org>.
2016-11-10 datalad-save 0.4.1