Created attachment 194921 [details]
Document the -S option for lam(1)
The man page for lam(1) documents "-s" but not "-S" however it uses "-S" in the EXAMPLES section. The attached patch provides some documentation for "-S".
(sorry if it needs "patch -p N" for an appropriate value of N to apply in the right way)
@Tim, I'm sorry but seems that the man page describes clearly what the
-S does, as for the -F -P and -T.
The manpage says :
Normally, each option affects only the file after it. If the option
letter is capitalized it affects all subsequent files until it appears
again uncapitalized. The options are described below
I would work is more specifically, that it affects all inputs that follow, until another -s, and add the uppercase of each other option that is supported as well.
The main issue that triggered this is the common pattern of encountering an unknown option, issuing
and then doing a
to learn more about the unknown option. In the case of "-S", it pops to the EXAMPLES section but doesn't land in the DESCRIPTION section. However, for something like "-T", it's a valid option but never appears in the man-page at all. Perhaps a better solution would include the upper-case options in the text, something like
"Normally, each option affects only the file after it.
If the option letter is capitalized (-F, -P, -S, or -T) it
affects all subsequent files until it appears again uncapitalized"
to give appropriate search targets?
(In reply to Tim Chase from comment #3)
I think it makes the most sense to expand them fully, as if we were writing the man page for the first time. Have each of the uppercase options spelled out explicitly, and possibly remove the old text about uppercase (although it seems useful to reinforce the pattern)
Created attachment 194963 [details]
Document each capitalized option
(In reply to Allan Jude from comment #4)
This patch removes the top section (it was awkward to have both) and instead describes each lowercase and uppercase option individually.
A commit references this bug:
Date: Fri Jan 4 02:48:43 UTC 2019
New revision: 342754
The lam(1) man page is unclear about the uppercase versions of the flags
Submitted by: Tim Chase <email@example.com>
Can we mark this issue resolved ?
(In reply to Rodrigo Osorio from comment #7)
It looks like the patch is was accepted, so I have no objections to closing. Thanks!