[Bug 229571] lam(1) man-page doesn't document -S

[bugzilla-noreply at freebsd.org]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=229571

--- Comment #3 from Tim Chase <freebsd at tim.thechases.com> ---
The main issue that triggered this is the common pattern of encountering an
unknown option, issuing

  man lam

and then doing a

  /-S

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?

-- 
You are receiving this mail because:
You are on the CC list for the bug.