~sircmpwn/ctools

35f0a1788e9df8ff77445083b1de753ceb63faa3 — Drew DeVault 1 year, 2 months ago daf56a7
comm: add man page
2 files changed, 40 insertions(+), 0 deletions(-)

A doc/comm.1.scd
M doc/meson.build
A doc/comm.1.scd => doc/comm.1.scd +39 -0
@@ 0,0 1,39 @@
comm(1) "ctools"

# NAME

comm - compare two sorted files

# SYNOPSIS

*comm* [-123] _file1_ _file2_

# DESCRIPTION

*comm* will compare two sorted text files line-by-line, and print each line
with respect to its uniqueness between the two files. Lines unique to _file1_
will be printed with no indentation, lines unique to _file2_ will be printed
with a leading tab character, and lines common to both files will be printed
with two leading tab characters.

All lines in both files must be pre-sorted character-wise.

# OPTIONS

*-1*
	Suppress the output of lines unique to _file1_ and remove one leading
	tab character from the output of other lines.

*-2*
	Suppress the output of lines unique to _file2_ and remove one leading
	tab character from the output of common lines.

*-3*
	Suppress the output of lines common to both files.

# DISCLAIMER

This command is part of ctools and is compatible with POSIX-1.2017, and may
optionally support XSI extensions. This man page is not intended to be a
complete reference, and where it disagrees with the specification, the
specification takes precedence.

M doc/meson.build => doc/meson.build +1 -0
@@ 10,6 10,7 @@ man_files = [
	'chmod.1',
	'cksum.1',
	'cmp.1',
	'comm.1',
	'false.1',
	'true.1',
]