Bläddra i källkod

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

salaaad2 3 år sedan
förälder
incheckning
d364c8e352

+ 49 - 0
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
+
+```

+ 31 - 0
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
+```
+

+ 41 - 0
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.
+
+```
+

+ 34 - 0
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
+```