2018-01-06 17:00:20 +00:00
|
|
|
package lshelp
|
|
|
|
|
|
|
|
|
|
// Help describes the common help for all the list commands
|
|
|
|
|
var Help = `
|
2019-04-30 12:06:24 +00:00
|
|
|
Any of the filtering options can be applied to this command.
|
2018-01-06 17:00:20 +00:00
|
|
|
|
|
|
|
|
There are several related list commands
|
|
|
|
|
|
|
|
|
|
* ` + "`ls`" + ` to list size and path of objects only
|
|
|
|
|
* ` + "`lsl`" + ` to list modification time, size and path of objects only
|
|
|
|
|
* ` + "`lsd`" + ` to list directories only
|
|
|
|
|
* ` + "`lsf`" + ` to list objects and directories in easy to parse format
|
|
|
|
|
* ` + "`lsjson`" + ` to list objects and directories in JSON format
|
|
|
|
|
|
|
|
|
|
` + "`ls`,`lsl`,`lsd`" + ` are designed to be human readable.
|
|
|
|
|
` + "`lsf`" + ` is designed to be human and machine readable.
|
|
|
|
|
` + "`lsjson`" + ` is designed to be machine readable.
|
|
|
|
|
|
2018-04-25 20:06:42 +00:00
|
|
|
Note that ` + "`ls` and `lsl`" + ` recurse by default - use "--max-depth 1" to stop the recursion.
|
2018-01-06 17:00:20 +00:00
|
|
|
|
2018-04-25 20:06:42 +00:00
|
|
|
The other list commands ` + "`lsd`,`lsf`,`lsjson`" + ` do not recurse by default - use "-R" to make them recurse.
|
2018-04-20 22:06:51 +00:00
|
|
|
|
|
|
|
|
Listing a non existent directory will produce an error except for
|
2020-10-13 22:03:04 +00:00
|
|
|
remotes which can't have empty directories (e.g. s3, swift, or gcs -
|
2018-04-20 22:06:51 +00:00
|
|
|
the bucket based remotes).
|
2018-01-06 17:00:20 +00:00
|
|
|
`
|
