Base: Update uniq(1) man page

This commit is contained in:
demostanis 2022-07-27 23:13:49 +02:00 committed by Sam Atkins
parent 847577bea2
commit 5ff63a9eb0
Notes: sideshowbarker 2024-07-17 07:19:44 +09:00

View file

@ -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
```