.TH "datalad update" "1" "2021\-02\-04" "datalad update 0.14.0"
.SH NAME
\fBdatalad update\fR \- update a dataset from a sibling.
.SH SYNOPSIS
.nh
.HP
\fBdatalad update\fR [-h] [-s\~SIBLING] [--merge [ALLOWED]] [--follow\~{sibling|parentds}] [-d\~DATASET] [-r] [-R\~LEVELS] [--fetch-all] [--reobtain-data] [PATH ...]


.hy
.SH DESCRIPTION

.SS Examples
.PP
Update from a particular sibling::
.PP
 % datalad update \-s <siblingname>
.PP
Update from a particular sibling and merge the changes from a
configured or matching branch from the sibling (see \-\-follow for details)::
.PP
 % datalad update \-\-merge \-s <siblingname>
.PP
Update from the sibling 'origin', traversing into subdatasets. For
subdatasets, merge the revision registered in the parent dataset into
the current branch::
.PP
 % datalad update \-s origin \-\-merge \-\-follow=parentds \-r

.SH OPTIONS
.TP
PATH
constrain to-be-updated subdatasets to the given path for recursive operation. Constraints: value must be a string

.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
.TP
\fB--merge\fR [ALLOWED]
merge obtained changes from the sibling. If a sibling is not explicitly given and there is only a single known sibling, that sibling is used. Otherwise, an unspecified sibling defaults to the configured remote for the current branch. By default, changes are fetched from the sibling but not merged into the current branch. With --merge or --merge=any, the changes will be merged into the current branch. A value of 'ff-only' restricts the allowed merges to fast-forwards. Constraints: value must be convertible to type bool, or value must be one of ('any', 'ff-only') [Default: False]
.TP
\fB--follow\fR {sibling|parentds}
source of updates for subdatasets. For 'sibling', the update will be done by merging in a branch from the (specified or inferred) sibling. The branch brought in will either be the current branch's configured branch, if it points to a branch that belongs to the sibling, or a sibling branch with a name that matches the current branch. For 'parentds', the revision registered in the parent dataset of the subdataset is merged in. Note that the current dataset is always updated according to 'sibling'. This option has no effect unless a merge is requested and --recursive is specified. Constraints: value must be one of ('sibling', 'parentds') [Default: 'sibling']
.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 current working directory. Constraints: Value must be a Dataset or a valid identifier of a Dataset (e.g. a path)
.TP
\fB-r\fR, \fB--recursive\fR
if set, recurse into potential subdataset.
.TP
\fB-R\fR LEVELS, \fB--recursion-limit\fR LEVELS
limit recursion into subdataset to the given number of levels. Constraints: value must be convertible to type 'int'
.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.
.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.
.SH AUTHORS
 datalad is developed by The DataLad Team and Contributors <team@datalad.org>.