comm(1): Add EXAMPLES section

[fernape]

Summary

Two very simple examples for this utility, but I honestly thing it is better
than not having examples at all :-)

Test Plan

• mandoc -Tlint clean
• igor clean
• aspell happy
• man ./comm.1 renders the page properly

[fernape]

Use \e instead of manually escaping characters

[fernape]

Properly updating review.

Using \e instead of manually escaping characters

[gbe]

usr.bin/comm/comm.1

113 ↗

(On Diff #73509)

When I try the example, I got a different output. See below,

$ echo -e "B\nc" | comm ~/tmp/example.txt -
a
b
	B
		c
d

[fernape]

usr.bin/comm/comm.1

113 ↗

(On Diff #73509)

Sorry for the delay, I took some days off and went AFK :-)

Strange, I get this:

[fernape@vm-current ~]$ cat example.txt
a
b
c
d
[fernape@vm-current ~]$ echo -e "B\nc" | comm example.txt -
        B
a
b
                c
d
[fernape@vm-current ~]$ uname -a
FreeBSD vm-current 13.0-CURRENT FreeBSD 13.0-CURRENT #0 r362494: Mon Jun 22 20:26:42 CEST 2020     root@vm-current:/usr/obj/usr/src/amd64.amd64/sys/GENERIC  amd64

and exactly the same output in 12.1-RELEASE.

I suspect it might be the environment. In my case, the variables that affect the behavior of comm(1) are cleared:

$ echo $LANG $LC_ALL $LC_COLLATE $LC_CTYPE
$

[fernape]

This is the output from freefall

[fernape@freefall ~]$ echo -e "B\nc" | comm example.txt -
        B
a
b
                c
d
[fernape@freefall ~]$ uname -a
FreeBSD freefall.freebsd.org 13.0-CURRENT FreeBSD 13.0-CURRENT #0 r360534: Fri May  1 17:50:03 UTC 2020     [e-mail]:/usr/obj/usr/src/sys/CLUSTER13  amd64

[gbe]

In D25344#572178, @fernape wrote:

This is the output from freefall

[fernape@freefall ~]$ echo -e "B\nc" | comm example.txt -
        B
a
b
                c
d
[fernape@freefall ~]$ uname -a
FreeBSD freefall.freebsd.org 13.0-CURRENT FreeBSD 13.0-CURRENT #0 r360534: Fri May  1 17:50:03 UTC 2020     [e-mail]:/usr/obj/usr/src/sys/CLUSTER13  amd64

I have some language settings for german umlauts active, but I didn't remember which ones. So I would think that this differential is fine.

[fernape]

In D25344#572188, @gbe wrote:

In D25344#572178, @fernape wrote:

This is the output from freefall

[fernape@freefall ~]$ echo -e "B\nc" | comm example.txt -
        B
a
b
                c
d
[fernape@freefall ~]$ uname -a
FreeBSD freefall.freebsd.org 13.0-CURRENT FreeBSD 13.0-CURRENT #0 r360534: Fri May  1 17:50:03 UTC 2020     [e-mail]:/usr/obj/usr/src/sys/CLUSTER13  amd64

I have some language settings for german umlauts active, but I didn't remember which ones. So I would think that this differential is fine.

Thanks for reviewing this!