Add man page description for version and help
ClosedPublic
Actions

Authored by thj on May 26 2022, 1:42 PM.

Details

Reviewers

Group Reviewers

manpages
Klara

Commits

rG26b5deef22ae: diff3: Add man page description for version and help

Diff Detail

Repository

rG FreeBSD src repository

Lint

Lint Not Applicable

Unit

Tests Not Applicable

Event Timeline

thj created this revision.May 26 2022, 1:42 PM

Herald added a subscriber: imp. · View Herald TranscriptMay 26 2022, 1:42 PM

thj requested review of this revision.May 26 2022, 1:42 PM

Harbormaster completed remote builds in B45721: Diff 106388.May 26 2022, 1:42 PM

Is it worth saying whether diff3 --help and diff3 --version output to stdout or stderr?

GNU diff3 has -v as a --version alias. Does the replacement want/have that? If so, should be added to the manual page.

usr.bin/diff3/diff3.1
40	You should be able to use .Nm only after the first time. This is in fact recommended. https://docs.freebsd.org/en/books/fdp-primer/manual-pages/#manual-pages-sample-structures.
48

This revision now requires changes to proceed.May 26 2022, 11:58 PM

In D35325#800913, @pauamma_gundo.com wrote:

Is it worth saying whether diff3 --help and diff3 --version output to stdout or stderr?

GNU diff3 has -v as a --version alias. Does the replacement want/have that? If so, should be added to the manual page.

I'm not adding short flags for these. They are requested so build systems can integrate and the long option isn't a cost there.