1
Fork 0
mirror of https://github.com/RGBCube/serenity synced 2025-05-31 14:38:11 +00:00

Base: Add ls man page documentation

This commit is contained in:
Brendan Coles 2020-11-10 04:16:18 +00:00 committed by Andreas Kling
parent 51f49ec73f
commit 0058d28a73

View file

@ -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
```