Date: Sat, 18 Dec 1999 22:16:51 -0800 (PST) From: johnpipe@nwserv.com To: freebsd-gnats-submit@freebsd.org Subject: docs/15557: man page for 'man' doesn't explain syntax for accessing "SEE ALSO" numbered pages. Message-ID: <19991219061651.4F61A14CB7@hub.freebsd.org>
index | next in thread | raw e-mail
>Number: 15557
>Category: docs
>Synopsis: man page for 'man' doesn't explain syntax for accessing "SEE ALSO" numbered pages.
>Confidential: no
>Severity: non-critical
>Priority: low
>Responsible: freebsd-doc
>State: open
>Quarter:
>Keywords:
>Date-Required:
>Class: doc-bug
>Submitter-Id: current-users
>Arrival-Date: Sat Dec 18 22:20:01 PST 1999
>Closed-Date:
>Last-Modified:
>Originator: John Meshkoff
>Release: o FreeBSD 3.3-STABLE (vs. 3.3-RC) - This includes minor
>Organization:
Siva Kalpa Productions
>Environment:
FreeBSD web2.sea.nwserv.com 3.3-STABLE FreeBSD 3.3-STABLE #0: Sun Nov 21 16:12:06 GM
T 1999 dpk@web2.sea.nwserv.com:/usr/src/sys/compile/NWSERV-S i386
>Description:
As a novice user, I encountered the problem that I didn't know how to
access man pages under "SEE ALSO" where those pages were given in the
form:
"SEE ALSO
sysctl(3), uname(3), sysctl(8)"
the command 'man man' (i.e., the man page for 'man') ought to explain
and give an example of the syntax, so new users can find how to access
these pages; the syntax is not at all apparent, since parentheses are
not used in the 'man' command, and the syntax is opposite of that
implied above, i.e.,
"man 3 sysctl".
I only found out how to do this because a reply to a question posted to
best.unix (local group on best.com) included a paste-in of the
command format.
>How-To-Repeat:
>Fix:
Add command syntax explanation and example for numbered man pages to
the man page for 'man'.
>Release-Note:
>Audit-Trail:
>Unformatted:
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
help
Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?19991219061651.4F61A14CB7>