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

rS FreeBSD src repository - subversion

Lint

Lint Errors

Severity	Location	Code	Message
Error	usr.bin/diff3/diff3.1:176	MERGECONFLICT1	Unresolved merge conflict

Unit

No Test Coverage

Build Status

Buildable 45766
Build 42654: arc lint + arc unit

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.