From c70bae523e29127cdae01185345e89747c3f3ba6 Mon Sep 17 00:00:00 2001
From: pixel <pixel+github@chrissx.de>
Date: Wed, 21 Dec 2022 04:18:13 +0100
Subject: [PATCH] cat: split POSIX, BSD and GNU and add 2 examples (#9623)

Co-authored-by: Emily Grace Seville <EmilySeville7cfg@gmail.com>
---
 pages/common/cat.md | 14 +++++++-------
 pages/linux/cat.md  | 32 ++++++++++++++++++++++++++++++++
 pages/osx/cat.md    | 32 ++++++++++++++++++++++++++++++++
 3 files changed, 71 insertions(+), 7 deletions(-)
 create mode 100644 pages/linux/cat.md
 create mode 100644 pages/osx/cat.md

diff --git a/pages/common/cat.md b/pages/common/cat.md
index 569684a3a5..a60d4175bc 100644
--- a/pages/common/cat.md
+++ b/pages/common/cat.md
@@ -9,16 +9,16 @@
 
 - Concatenate several files into an output file:
 
-`cat {{path/to/file1}} {{path/to/file2}} > {{path/to/output_file}}`
+`cat {{path/to/file1 path/to/file2 ...}} > {{path/to/output_file}}`
 
-- Append several files into an output file:
+- Append several files to an output file:
 
-`cat {{path/to/file1}} {{path/to/file2}} >> {{path/to/output_file}}`
+`cat {{path/to/file1 path/to/file2 ...}} >> {{path/to/output_file}}`
 
-- Number all output lines:
+- Copy the contents of a file into an output file without buffering:
 
-`cat -n {{path/to/file}}`
+`cat -u {{/dev/tty12}} > {{/dev/tty13}}`
 
-- Display non-printable and whitespace characters (with `M-` prefix if non-ASCII):
+- Write `stdin` to a file:
 
-`cat -v -t -e {{path/to/file}}`
+`cat - > {{path/to/file}}`
diff --git a/pages/linux/cat.md b/pages/linux/cat.md
new file mode 100644
index 0000000000..b7de6331b5
--- /dev/null
+++ b/pages/linux/cat.md
@@ -0,0 +1,32 @@
+# cat
+
+> Print and concatenate files.
+> More information: <https://www.gnu.org/software/coreutils/cat>.
+
+- Print the contents of a file to the standard output:
+
+`cat {{path/to/file}}`
+
+- Concatenate several files into an output file:
+
+`cat {{path/to/file1 path/to/file2 ...}} > {{path/to/output_file}}`
+
+- Append several files to an output file:
+
+`cat {{path/to/file1 path/to/file2 ...}} >> {{path/to/output_file}}`
+
+- Copy the contents of a file into an output file in [u]nbuffered mode:
+
+`cat -u {{/dev/tty12}} > {{/dev/tty13}}`
+
+- Write `stdin` to a file:
+
+`cat - > {{path/to/file}}`
+
+- [n]umber all output lines:
+
+`cat -n {{path/to/file}}`
+
+- Display non-printable and whitespace characters (with `M-` prefix if non-ASCII):
+
+`cat -v -t -e {{path/to/file}}`
diff --git a/pages/osx/cat.md b/pages/osx/cat.md
new file mode 100644
index 0000000000..0997f178bb
--- /dev/null
+++ b/pages/osx/cat.md
@@ -0,0 +1,32 @@
+# cat
+
+> Print and concatenate files.
+> More information: <https://keith.github.io/xcode-man-pages/cat.1.html>.
+
+- Print the contents of a file to the standard output:
+
+`cat {{path/to/file}}`
+
+- Concatenate several files into an output file:
+
+`cat {{path/to/file1 path/to/file2 ...}} > {{path/to/output_file}}`
+
+- Append several files to an output file:
+
+`cat {{path/to/file1 path/to/file2 ...}} >> {{path/to/output_file}}`
+
+- Copy the contents of a file into an output file without buffering:
+
+`cat -u {{/dev/tty12}} > {{/dev/tty13}}`
+
+- Write `stdin` to a file:
+
+`cat - > {{path/to/file}}`
+
+- Number all output lines:
+
+`cat -n {{path/to/file}}`
+
+- Display non-printable and whitespace characters (with `M-` prefix if non-ASCII):
+
+`cat -v -t -e {{path/to/file}}`