From 5ff63a9eb044f9a9d7aa2b4355a92b979b3325e5 Mon Sep 17 00:00:00 2001
From: demostanis <demostanis@protonmail.com>
Date: Wed, 27 Jul 2022 23:13:49 +0200
Subject: [PATCH] Base: Update uniq(1) man page

---
 Base/usr/share/man/man1/uniq.md | 35 ++++++++++++++++++++++++++-------
 1 file changed, 28 insertions(+), 7 deletions(-)

diff --git a/Base/usr/share/man/man1/uniq.md b/Base/usr/share/man/man1/uniq.md
index f58bdaad871..775749503d2 100644
--- a/Base/usr/share/man/man1/uniq.md
+++ b/Base/usr/share/man/man1/uniq.md
@@ -1,28 +1,49 @@
 ## Name
 
-uniq - filter out repeated lines
+uniq - filter out repeated adjacent lines
 
 ## Synopsis
 
 ```**sh
-$ uniq [--version] [INPUT] [OUTPUT]
+$ uniq [-c] [-d|-u] [-f skip-fields] [-s skip-chars] [--version] [INPUT] [OUTPUT]
 ```
 
 ## Description
 
-Filter out repeated lines from INPUT (or standard input) and write to OUTPUT (or standard output).
+Filter out repeated adjacent lines from INPUT (or standard input) and write to OUTPUT (or standard output). It is recommended to sort out the input using [`sort(1)`](help://man/1/sort) beforehand.
 
 ## Options
 
-* `--help`: Display help message and exit
-* `--version`: Print version
+* `-c`, `--count`: Precede each line with its number of occurrences.
+* `-d`, `--repeated`: Only print repeated lines.
+* `-u`, `--unique`: Only print unique lines (default).
+* `-f N`, `--skip-fields N`: Skip first N fields of each line before comparing.
+* `-c N`, `--skip-chars N`: Skip first N chars of each line before comparing.
+* `--help`: Display help message and exit.
+* `--version`: Print version.
 
 ## Examples
 
+Filter out repeated lines from README.md and write to standard output:
 ```sh
-# Filter out repeated lines from README.md and write to standard output
 $ uniq README.md
+```
 
-# Filter out repeated lines from README.md and write to UNIQUE.md
+Filter out repeated lines from README.md and write to UNIQUE.md:
+```sh
 $ uniq README.md UNIQUE.md
 ```
+
+Filter out repeated lines from standard input with their occurrence count:
+```sh
+$ echo "Well\nWell\nWell\nHello Friends!" | uniq -c
+3 Well
+1 Hello Friends!
+```
+
+Filter out repeated lines, ignoring the first field ("XXXX" and "ZZZZ") and the four chars after it (" ABC" and " BCA", thus comparing only the "D"s — which are equal indeed):
+```sh
+$ echo "XXXX ABCD\nZZZZ BCAD" | uniq -f1 -s4
+ZZZZ BCAD
+```
+