1
Fork 0
mirror of https://github.com/RGBCube/serenity synced 2025-05-31 21:58:12 +00:00

Base: Add manpages for cut, diff, head & rmdir command line utilities

This commit is contained in:
salaaad2 2021-12-28 00:36:00 +01:00 committed by Brian Gianforcaro
parent 87068896d0
commit d364c8e352
4 changed files with 155 additions and 0 deletions

View file

@ -0,0 +1,49 @@
## Name
cut - remove sections from each line of files
## Synopsis
```**sh
$ cut option... [file...]
```
## Description
Print selected parts of lines from each FILE to standard output.
With no FILE, or when FILE is -, read standard input.
## Arguments
* `file`: File(s) to cut
## Options
* `-b` `--bytes=list`: Select only these bytes
* `-f` `--fields=list`: select only these fields; also print any line that contains no delimiter character
* `-d` `--delimiter=delim`: use `delim` instead of `tab` for field delimiter
## Examples
```sh
$ cat example.txt
245:789 4567 M:4540 Admin 01:10:1980
535:763 4987 M:3476 Sales 11:04:1978
# Display first and third fields from file example.txt
$ cut example.txt -f 1,3
245:789 M:4540
535:763 M:3476
# Display first and third fields using `:` as a delimiter
$ cut example.txt -d ':' -f 1,3
245:4540 Admin 01
535:3476 Sales 11
# Display bytes at given position
$ echo "serenity is cool" | cut -b 5
n
```

View file

@ -0,0 +1,31 @@
## Name
diff - compare files line by line
## Synopsis
```**sh
$ diff [files...]
```
## Description
Compare `files` line by line.
## Arguments
* `files`: files to compare ex: `file1 file2`
## Examples
```sh
# View differences in two files
$ echo 123 > file1
$ echo 456 > file2
$ diff file1 file2
1c1
< 123
---
> 456
```

View file

@ -0,0 +1,41 @@
## Name
head - output the first part of files
## Synopsis
```**sh
$ head [option...] [file...]
```
## Description
Print the first 10 lines of each `file` to standard output. With more than one `file`,
precede each with a header giving the file name.
With no `file`, or when `file` is `-`, read standard input.
## Arguments
* `file`: File to process
## Options
* `-n` `--number=NUM`: Number of lines to print (default 10)
* `-b` `--bytes=NUM`: Number of bytes to print
* `-q` `--quiet`: Never print filenames
* `-v` `--verbose`: Always print filenames
## Examples
```sh
# Print the first four lines from README.md and precede it with a filename header
$ head -v -n 4 README.md
==> README.md <==
# SerenityOS
Graphical Unix-like operating system for x86 computers.
```

View file

@ -0,0 +1,34 @@
## Name
rmdir - remove empty directories
## Synopsis
```**sh
$ rmdir `[directory...]`
```
## Description
Remove given `directory(ies)`, if they are empty
## Arguments
* `directory`: directory(ies) to remove
## Examples
```sh
# Try to remove non-empty directory
$ mkdir serenity ; echo cool > serenity/cool.txt
$ rmdir serenity
rmdir: Directory not empty
# Remove empty directory
$ mkdir example
$ ls -a example
. ..
$ rmdir example
$ ls -a example
example: No such file or directory
```