diff options
| author |   Ingo Schwarze <schwarze@openbsd.org> | 2014-08-30 18:08:10 +0000 |
|---|---|---|
| committer | Ingo Schwarze <schwarze@openbsd.org> | 2014-08-30 18:08:10 +0000 |
| commit | baf73424c69a2aa19a4dbd317ca8b72d21c33c1b (patch) | |
| tree | ce7e1ebfb060ce4fdca55a63bc95a4cf96935f3b /man.1 | |
| parent | 13a468c1e025f5fbb958d0b9bb9e8f3ae1e680ed (diff) | |
| download | mandoc-baf73424c69a2aa19a4dbd317ca8b72d21c33c1b.tar.gz mandoc-baf73424c69a2aa19a4dbd317ca8b72d21c33c1b.tar.zst mandoc-baf73424c69a2aa19a4dbd317ca8b72d21c33c1b.zip | |
Introduce a man(1) -l option as an alias for mandoc -a.
Basically, this does the same as man -l in Linux man-db.
The point is that now all functionality of the combined tool
is reachable from the man(1) command name:
apropos = man -k, whatis = man -f, mandoc = man -cl.
Originally suggested by Carsten dot Kunze at arcor dot de,
current maintainer of the Heirloom Documentation Tools.
While here, add various missing information to the usage()
and to the manuals.
Diffstat (limited to 'man.1')
| -rw-r--r-- | man.1 | 38 |
1 files changed, 35 insertions, 3 deletions
@@ -1,4 +1,4 @@ -.\" $Id: man.1,v 1.3 2014/08/21 02:38:24 schwarze Exp $ +.\" $Id: man.1,v 1.4 2014/08/30 18:08:10 schwarze Exp $ .\" $OpenBSD: man.1,v 1.55 2014/04/03 06:15:18 jmc Exp $ .\" .\" Copyright (c) 1989, 1990, 1993 @@ -32,7 +32,7 @@ .\" .\" @(#)man.1 8.2 (Berkeley) 1/2/94 .\" -.Dd $Mdocdate: August 21 2014 $ +.Dd $Mdocdate: August 30 2014 $ .Dt MAN 1 .Os .Sh NAME @@ -40,7 +40,7 @@ .Nd display manual pages .Sh SYNOPSIS .Nm man -.Op Fl acfhkw +.Op Fl acfhklVw .Op Fl C Ar file .Op Fl M Ar path .Op Fl m Ar path @@ -91,6 +91,11 @@ It searches for .Ar name in manual page names and displays the header lines from all matching pages. The search is case insensitive and matches whole words only. +This overrides any earlier +.Fl k +and +.Fl l +options. .It Fl h Display only the .Dq SYNOPSIS @@ -104,6 +109,31 @@ an expression can be provided using the syntax described in the .Xr apropos 1 manual. By default, it displays the header lines of all matching pages. +This overrides any earlier +.Fl f +and +.Fl l +options. +.It Fl l +A synonym for +.Xr mandoc 1 +.Fl a . +The +.Ar name +arguments are interpreted as filenames. +No search is done and +.Ar file , +.Ar path , +.Ar section , +and +.Ar subsection +are ignored. +This overrides any earlier +.Fl f , +.Fl k , +and +.Fl w +options. .It Fl M Ar path Override the list of standard directories which .Nm @@ -211,6 +241,8 @@ specifies the possible .Ar section values, and their search order. Additional sections may be specified. +.It Fl V +Print version and exit. .It Fl w List the pathnames of the manual pages which .Nm |