Skip site navigation (1)Skip section navigation (2)
Date:      Sat, 07 Jul 2018 02:30:34 +0000
From:      bugzilla-noreply@freebsd.org
To:        doc@FreeBSD.org
Subject:   [Bug 229571] lam(1) man-page doesn't document -S
Message-ID:  <bug-229571-9-UgIoKctUXT@https.bugs.freebsd.org/bugzilla/>
In-Reply-To: <bug-229571-9@https.bugs.freebsd.org/bugzilla/>
References:  <bug-229571-9@https.bugs.freebsd.org/bugzilla/>

next in thread | previous in thread | raw e-mail | index | archive | help
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D229571

--- Comment #3 from Tim Chase <freebsd@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?

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



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?bug-229571-9-UgIoKctUXT>