mirror of
https://github.com/RGBCube/serenity
synced 2025-07-25 06:47:35 +00:00
Base: Add manpages for cut, diff, head & rmdir command line utilities
This commit is contained in:
parent
87068896d0
commit
d364c8e352
4 changed files with 155 additions and 0 deletions
49
Base/usr/share/man/man1/cut.md
Normal file
49
Base/usr/share/man/man1/cut.md
Normal 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
|
||||||
|
|
||||||
|
```
|
31
Base/usr/share/man/man1/diff.md
Normal file
31
Base/usr/share/man/man1/diff.md
Normal 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
|
||||||
|
```
|
||||||
|
|
41
Base/usr/share/man/man1/head.md
Normal file
41
Base/usr/share/man/man1/head.md
Normal 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.
|
||||||
|
|
||||||
|
```
|
||||||
|
|
34
Base/usr/share/man/man1/rmdir.md
Normal file
34
Base/usr/share/man/man1/rmdir.md
Normal 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
|
||||||
|
```
|
Loading…
Add table
Add a link
Reference in a new issue