Commit
74d28e77366dba1eefbfa2beeda34bcaa835dc58, while modifying the
default behaviour for 'bup ls', introduced a new option to obtain the
old default behaviour.
Reflect this change in the bup-ls man page.
Signed-off-by: Gabriel Filion <lelutin@gmail.com>
+bup ls [-s] [-a] <paths...>
using the same directory hierarchy as they would have with
`bup-fuse`(1).
using the same directory hierarchy as they would have with
`bup-fuse`(1).
-The top level directory is the branch (corresponding to
+The top level directory contains the branch (corresponding to
the `-n` option in `bup save`), the next level is the date
of the backup, and subsequent levels correspond to files in
the backup.
the `-n` option in `bup save`), the next level is the date
of the backup, and subsequent levels correspond to files in
the backup.
+Note that `bup ls` doesn't show hidden files by default and one needs to use
+the `-a` option to show them. Files are hidden when their name begins with a
+dot. For example, on the topmost level, the special directories named `.commit`
+and `.tag` are hidden directories.
+
Once you have identified the file you want using `bup ls`,
you can view its contents using `bup join` or `git show`.
Once you have identified the file you want using `bup ls`,
you can view its contents using `bup join` or `git show`.
-s, --hash
: show hash for each file/directory.
-s, --hash
: show hash for each file/directory.
+-a, --all
+: show hidden files.
# EXAMPLE
bup ls /myserver/latest/etc/profile
# EXAMPLE
bup ls /myserver/latest/etc/profile
# SEE ALSO
`bup-join`(1), `bup-fuse`(1), `bup-ftp`(1), `bup-save`(1), `git-show`(1)
# SEE ALSO
`bup-join`(1), `bup-fuse`(1), `bup-ftp`(1), `bup-save`(1), `git-show`(1)