From e92c24d49dbde6bba88973727cc44e222afb8334 Mon Sep 17 00:00:00 2001
From: Emily Grace Seville <emilyseville7cf@gmail.com>
Date: Sat, 14 May 2022 04:29:53 +1000
Subject: [PATCH] tac: refresh page (#8057)

* More general descriptions and better title

* Don't use `print` word

* More specific verb in first sample description:

- `display` -> `concatenate`

* Add `-b`/`-r`/`-s` examples

* Duplicate `tac` to `linux/`

* Highlight first option chars

* Add `See also` reference
---
 pages/common/tac.md | 23 ++++++++++++++++-------
 pages/linux/tac.md  | 25 +++++++++++++++++++++++++
 2 files changed, 41 insertions(+), 7 deletions(-)
 create mode 100644 pages/linux/tac.md

diff --git a/pages/common/tac.md b/pages/common/tac.md
index 85804e5f5..cfa316dad 100644
--- a/pages/common/tac.md
+++ b/pages/common/tac.md
@@ -1,16 +1,25 @@
 # tac
 
-> Print and concatenate files in reverse (last line first).
+> Display and concatenate files with lines in reversed order.
+> See also: `cat`.
 > More information: <https://www.gnu.org/software/coreutils/tac>.
 
-- Print the contents of *file1* reversed to the standard output:
+- Concatenate specific files in reversed order:
 
-`tac {{file1}}`
+`tac {{path/to/file1 path/to/file2 ...}}`
 
-- Print the contents of the standard input reversed to the standard output:
+- Display `stdin` in reversed order:
 
-`{{command}} | tac`
+`{{cat path/to/file}} | tac`
 
-- Concatenate several files reversed into the target file:
+- Use a specific [s]eparator:
 
-`tac {{file1}} {{file2}} > {{target_file}}`
+`tac -s {{separator}} {{path/to/file1 path/to/file2 ...}}`
+
+- Use a specific [r]egex as a [s]eparator:
+
+`tac -r -s {{separator}} {{path/to/file1 path/to/file2 ...}}`
+
+- Use a separator [b]efore each file:
+
+`tac -b {{path/to/file1 path/to/file2 ...}}`
diff --git a/pages/linux/tac.md b/pages/linux/tac.md
new file mode 100644
index 000000000..77244838a
--- /dev/null
+++ b/pages/linux/tac.md
@@ -0,0 +1,25 @@
+# tac
+
+> Display and concatenate files with lines in reversed order.
+> See also: `cat`.
+> More information: <https://www.gnu.org/software/coreutils/tac>.
+
+- Concatenate specific files in reversed order:
+
+`tac {{path/to/file1 path/to/file2 ...}}`
+
+- Display `stdin` in reversed order:
+
+`{{cat path/to/file}} | tac`
+
+- Use a specific separator:
+
+`tac --separator {{,}} {{path/to/file1 path/to/file2 ...}}`
+
+- Use a specific regex as a separator:
+
+`tac --regex --separator {{[,;]}} {{path/to/file1 path/to/file2 ...}}`
+
+- Use a separator before each file:
+
+`tac --before {{path/to/file1 path/to/file2 ...}}`