.TH "datalad update" "1" "2019\-02\-08" ""datalad update 0.11.2""
.SH NAME
\fBdatalad update\fR \- update a dataset from a sibling.
.SH SYNOPSIS
.nh
.HP
\fBdatalad update\fR [-h] [-s\~SIBLING] [--merge] [-d\~DATASET] [-r] [--recursion-limit\~LEVELS] [--fetch-all] [--reobtain-data] [PATH [PATH ...]]


.hy
.SH OPTIONS
.TP
PATH
path to a dataset that shall be updated. Constraints: value must be a string [Default: None]

.TP
\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
.TP
\fB-s\fR \fI\s-1SIBLING\s0\fR, \fB--sibling\fR \fI\s-1SIBLING\s0\fR
name of the sibling to update from. If no sibling is given, updates from all siblings are obtained. Constraints: value must be a string [Default: None]
.TP
\fB--merge\fR
merge obtained changes from the given or the default sibling. [Default: False]
.TP
\fB-d\fR \fI\s-1DATASET\s0\fR, \fB--dataset\fR \fI\s-1DATASET\s0\fR
"specify the dataset to update. If no dataset is given, an attempt is made to identify the dataset based on the input and/or the current working directory. Constraints: Value must be a Dataset or a valid identifier of a Dataset (e.g. a path) [Default: None]
.TP
\fB-r\fR, \fB--recursive\fR
if set, recurse into potential subdataset. [Default: False]
.TP
\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]
.TP
\fB--fetch-all\fR
this option has no effect and will be removed in a future version. When no siblings are given, an all-sibling update will be performed. [Default: None]
.TP
\fB--reobtain-data\fR
if enabled, file content that was present before an update will be re-obtained in case a file was changed by the update. [Default: False]
.SH AUTHORS
 datalad is developed by The DataLad Team and Contributors <team@datalad.org>.