# OPTIONS
--r, --remote=*host*:*path*
-: Retrieves objects from the given remote repository
- instead of the local one. *path* may be blank, in which
- case the default remote repository is used. The connection to the
- remote server is made with SSH. If you'd like to specify which port, user
- or private key to use for the SSH connection, we recommend you use the
- `~/.ssh/config` file.
-
-
-# EXAMPLE
-
+-r, \--remote=*host*:*path*
+: Retrieves objects from the given remote repository instead of the
+ local one. *path* may be blank, in which case the default remote
+ repository is used. The connection to the remote server is made
+ with SSH. If you'd like to specify which port, user or private
+ key to use for the SSH connection, we recommend you use the
+ `~/.ssh/config` file. Even though the data source is remote, a
+ local bup repository is still required.
+
+# EXAMPLES
# split and then rejoin a file using its tree id
TREE=$(tar -cvf - /etc | bup split -t)
bup join $TREE | tar -tf -
# SEE ALSO
-`bup-split`(1), `bup-save`(1), `ssh_config`(5)
+`bup-split`(1), `bup-save`(1), `bup-cat-file`, `ssh_config`(5)
# BUP