NAME

       datalad update - update a dataset from a sibling.

SYNOPSIS

       datalad  update  [-h]  [-s  SIBLING] [--merge] [-d DATASET] [-r] [-R LEVELS] [--fetch-all]
              [--reobtain-data] [PATH [PATH ...]]

OPTIONS

       PATH   contrain to-be-updated subdatasets to  the  given  path  for  recursive  operation.
              Constraints: value must be a string

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

       -s SIBLING, -\-sibling SIBLING
              name of the sibling to update from. If  no  sibling  is  given,  updates  from  all
              siblings are obtained. Constraints: value must be a string

       -\-merge
              merge obtained changes from the given or the default sibling.

       -d DATASET, -\-dataset DATASET
              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)

       -r, -\-recursive
              if set, recurse into potential subdataset.

       -R LEVELS, -\-recursion-limit LEVELS
              limit  recursion  into subdataset to the given number of levels. Constraints: value
              must be convertible to type 'int'

       -\-fetch-all
              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.

       -\-reobtain-data
              if  enabled,  file content that was present before an update will be re-obtained in
              case a file was changed by the update.

AUTHORS

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