summaryrefslogtreecommitdiff
path: root/Base/usr/share/man/man1
diff options
context:
space:
mode:
Diffstat (limited to 'Base/usr/share/man/man1')
-rw-r--r--Base/usr/share/man/man1/cut.md49
-rw-r--r--Base/usr/share/man/man1/diff.md31
-rw-r--r--Base/usr/share/man/man1/head.md41
-rw-r--r--Base/usr/share/man/man1/rmdir.md34
4 files changed, 155 insertions, 0 deletions
diff --git a/Base/usr/share/man/man1/cut.md b/Base/usr/share/man/man1/cut.md
new file mode 100644
index 0000000000..4a4ab94350
--- /dev/null
+++ b/Base/usr/share/man/man1/cut.md
@@ -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
+
+```
diff --git a/Base/usr/share/man/man1/diff.md b/Base/usr/share/man/man1/diff.md
new file mode 100644
index 0000000000..1f63b75ff2
--- /dev/null
+++ b/Base/usr/share/man/man1/diff.md
@@ -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
+```
+
diff --git a/Base/usr/share/man/man1/head.md b/Base/usr/share/man/man1/head.md
new file mode 100644
index 0000000000..c1e5db74a0
--- /dev/null
+++ b/Base/usr/share/man/man1/head.md
@@ -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.
+
+```
+
diff --git a/Base/usr/share/man/man1/rmdir.md b/Base/usr/share/man/man1/rmdir.md
new file mode 100644
index 0000000000..6624724cf4
--- /dev/null
+++ b/Base/usr/share/man/man1/rmdir.md
@@ -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
+```