.TH datalad 1 2016\-11\-10 "datalad 0.4.1"
.SH SYNOPSIS
 \fBdatalad\fR [-h] [-l LEVEL] [-p {condor}] [--version] [--dbg] [--idbg] [-C PATH]
        {search,aggregate-metadata,create,install,get,add,publish,uninstall,update,create-sibling,create-sibling-github,add-sibling,rewrite-urls,unlock,save,export,test,crawl,crawl-init,ls,clean,add-archive-content,download-url,create-test-dataset}
        ...


.SH DESCRIPTION
DataLad provides a unified data distribution with the convenience of git\-annex
.br
repositories as a backend.  DataLad command line tools allow to manipulate
.br
(obtain, create, update, publish, etc.) datasets and their collections.
.br

.br
*Commands for meta data handling*
.br

.br
  \- search:              Search within available in datasets' meta data
.br
  \- aggregate\-metadata:  Aggregate meta data of a dataset for later query
.br

.br
*Commands for dataset operations*
.br

.br
  \- create:              Create a new dataset from scratch
.br
  \- install:             Install a dataset from a (remote) source
.br
  \- get:                 Get any dataset content (files/directories/subdatasets)
.br
  \- add:                 Add files/directories to an existing dataset
.br
  \- publish:             Publish a dataset (e.g. to a web server)
.br
  \- uninstall:           Uninstall a dataset component or entire dataset(s)
.br
  \- update:              Update a dataset from a sibling
.br
  \- create\-sibling:      Create dataset(s)'s sibling (e.g., on a web server)
.br
  \- create\-sibling\-github: Create dataset sibling on Github
.br
  \- add\-sibling:         Add a sibling to a dataset
.br
  \- rewrite\-urls:        Rewrite the URLs of sub\-datasets of a dataset
.br
  \- unlock:              Unlock file(s) of a dataset
.br
  \- save:                Save the current state of a dataset
.br
  \- export:              Export a dataset to another representation
.br

.br
*Miscellaneous commands*
.br

.br
  \- test:                Run internal DataLad (unit)tests
.br
  \- crawl:               Crawl online resource to create or update a dataset
.br
  \- crawl\-init:          Initialize crawling configuration
.br
  \- ls:                  List summary information about URLs and dataset(s)
.br
  \- clean:               Clean up after DataLad (possible temporary files etc.)
.br
  \- add\-archive\-content: Add content of an archive under git annex control
.br
  \- download\-url:        Download content
.br
  \- create\-test\-dataset: Create test (meta\-)dataset
.br

.br
*General information*
.br

.br

.br
Detailed usage information for individual commands is available via
.br
command\-specific \-\-help, i.e.: datalad <command> \-\-help
.SH OPTIONS
  {search,aggregate-metadata,create,install,get,add,publish,uninstall,update,create-sibling,create-sibling-github,add-sibling,rewrite-urls,unlock,save,export,test,crawl,crawl-init,ls,clean,add-archive-content,download-url,create-test-dataset}

  \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
  \fB-l\fR LEVEL, \fB--log-level\fR 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
  \fB-p\fR {condor}, \fB--pbs-runner\fR {condor}
                        execute command by scheduling it via available PBS.
                        For settings, config file will be consulted
  \fB--version\fR       show the program's version and license information
  \fB--dbg\fR           enter Python debugger when uncaught exception happens
  \fB--idbg\fR          enter IPython debugger when uncaught exception happens
  \fB-C\fR PATH         run as if datalad was started in <path> instead of the
                        current working directory. When multiple -C options
                        are given, each subsequent non-absolute -C <path> is
                        interpreted relative to the preceding -C <path>. This
                        option affects the interpretations of the path names
                        in that they are made relative to the working
                        directory caused by the -C option

"Control Your Data"
.SH AUTHORS
 datalad is developed by The DataLad Team and Contributors <team@datalad.org>.