summaryrefslogtreecommitdiff
path: root/Base/usr/share/man/man1/cat.md
diff options
context:
space:
mode:
authorMaciej Zygmanowski <sppmacd@pm.me>2021-05-31 17:16:21 +0200
committerGunnar Beutner <gunnar@beutner.name>2021-07-03 09:08:25 +0200
commit57340dda36bf1732d94c15ef1c07ecf777b8fc6b (patch)
tree64537f09ea2647feef7b3753102558b56435e4f1 /Base/usr/share/man/man1/cat.md
parent5d8585df9718d0887699187e17320da043273b7b (diff)
downloadserenity-57340dda36bf1732d94c15ef1c07ecf777b8fc6b.zip
Base: Add more manpages for command-line utilities
Diffstat (limited to 'Base/usr/share/man/man1/cat.md')
-rw-r--r--Base/usr/share/man/man1/cat.md53
1 files changed, 53 insertions, 0 deletions
diff --git a/Base/usr/share/man/man1/cat.md b/Base/usr/share/man/man1/cat.md
new file mode 100644
index 0000000000..bb51b19aba
--- /dev/null
+++ b/Base/usr/share/man/man1/cat.md
@@ -0,0 +1,53 @@
+## Name
+
+cat - concatenate files to stdout
+
+## Synopsis
+
+```**sh
+$ cat [file...]
+```
+
+## Description
+
+This program passes contents of specified `files` to standard output, in the specified order. If no `file` is specified, or it is `-`, it defaults to standard input.
+
+## Arguments
+
+* `file`: Files to print
+
+## Examples
+
+```sh
+# Display a single file
+$ cat README.md
+# SerenityOS
+
+Graphical Unix-like operating system for x86 computers.
+...
+
+# Display standard input
+$ cat
+aaa
+aaa
+bbb
+bbb^C
+
+# Display ls output where each file is in separate line
+$ ls | cat
+Desktop
+Documents
+Downloads
+README.md
+Source
+js-tests
+tests
+web-tests
+
+# Display multiple files
+$ echo 123 > test.txt
+$ echo 456 > test2.txt
+cat test.txt test2.txt
+123
+456
+```