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:
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