diff --git a/Base/usr/share/man/man1/ls.md b/Base/usr/share/man/man1/ls.md new file mode 100644 index 0000000000..762dff0044 --- /dev/null +++ b/Base/usr/share/man/man1/ls.md @@ -0,0 +1,47 @@ +## Name + +ls - list directory contents + +## Synopsis + +```**sh +$ ls [options...] [path...] +``` + +## Description + +`ls` lists directory contents and attributes. + +If no *path* argument is provided the current working directory is used. + +## Options + +* `--help`: Display this message +* `-a`, `--all`: Show dotfiles +* `-A`: Do not list implied . and .. directories +* `-l`, `--long`: Display long info +* `-t`: Sort files by timestamp +* `-r`, `--reverse`: Reverse sort order +* `-G`: Use pretty colors +* `-i`, `--inode`: Show inode ids +* `-n`, `--numeric-uid-gid`: In long format, display numeric UID/GID +* `-h`, `--human-readable`: Print human-readable sizes +* `-K`, `--no-hyperlinks`: Disable hyperlinks + +## Arguments + +* path: Directory to list + +## Examples + +```sh +# List contents of working directory +$ ls +# List contents of working directory including hidden dot files +$ ls -la +# List contents of /etc/ directory +$ ls /etc +# List contents of /etc/ directory including hidden dot files +$ ls -la /etc +``` +