From 88f15230be7f66fcbb0009b5e966bad9b4f425c9 Mon Sep 17 00:00:00 2001
From: Kristaps Dzonsons <kristaps@bsd.lv>
Date: Sat, 24 Mar 2012 01:46:25 +0000
Subject: Be insane.  Make apropos(1) subsume man(1).

---
 apropos.1 | 40 ++++++++++++++++++++++++++++------------
 1 file changed, 28 insertions(+), 12 deletions(-)

(limited to 'apropos.1')

diff --git a/apropos.1 b/apropos.1
index f2e0171a..7dea132a 100644
--- a/apropos.1
+++ b/apropos.1
@@ -1,6 +1,6 @@
-.\"	$Id: apropos.1,v 1.16 2011/12/25 19:35:44 kristaps Exp $
+.\"	$Id: apropos.1,v 1.17 2012/03/24 01:46:25 kristaps Exp $
 .\"
-.\" Copyright (c) 2011 Kristaps Dzonsons <kristaps@bsd.lv>
+.\" Copyright (c) 2011, 2012 Kristaps Dzonsons <kristaps@bsd.lv>
 .\"
 .\" Permission to use, copy, modify, and distribute this software for any
 .\" purpose with or without fee is hereby granted, provided that the above
@@ -14,7 +14,7 @@
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
-.Dd $Mdocdate: December 25 2011 $
+.Dd $Mdocdate: March 24 2012 $
 .Dt APROPOS 1
 .Os
 .Sh NAME
@@ -44,11 +44,11 @@ searches for
 databases in the default paths stipulated by
 .Xr man 1 ,
 parses terms as case-sensitive regular expressions
-.Pq the Li \&~ operator
-over manual names and descriptions
-.Pq the Li \&Nm No and Li \&Nd No macro keys .
+over manual names and descriptions.
 Multiple terms imply pairwise
 .Fl o .
+If standard output is a TTY, a result may be selected from a list and
+its manual displayed with the pager.
 .Pp
 Its arguments are as follows:
 .Bl -tag -width Ds
@@ -156,13 +156,21 @@ If an architecture is specified for the manual, it is displayed as
 .Pp
 .D1 title(cat/arch) \- description
 .Pp
-Resulting manuals may be accessed as
+If on a TTY, results are prefixed with a numeric identifier.
 .Pp
-.Dl $ man \-s sec title
+.D1 [index] title(cat) \- description
 .Pp
-If an architecture is specified in the output, use
-.Pp
-.Dl $ man \-s sec \-S arch title
+One may choose a manual be entering the index at the prompt.
+Valid choices are displayed using
+.Ev MANPAGER ,
+or failing that ,
+.Ev PAGER
+or just
+.Xr more 1 .
+Source pages are formatted with
+.Xr mandoc 1 ;
+preformatted pages with
+.Xr cat 1 .
 .Ss Macro Keys
 Queries evaluate over a subset of
 .Xr mdoc 7
@@ -240,6 +248,14 @@ Text production:
 .El
 .Sh ENVIRONMENT
 .Bl -tag -width Ds
+.It Ev MANPAGER
+Default pager for manuals.
+If this is unset, falls back to
+.Ev Pager .
+.It Ev PAGER
+The second choice for a manual pager.
+If this is unset, use
+.Xr more 1 .
 .It Ev MANPATH
 Colon-separated paths modifying the default list of paths searched for
 manual databases.
@@ -301,7 +317,7 @@ as variable names in the library category:
 .Pp
 .Dl $ apropos \-s 3 Va~^optind \-a Va~^optarg$
 .Sh SEE ALSO
-.Xr man 1 ,
+.Xr more 1
 .Xr re_format 7 ,
 .Xr mandocdb 8
 .Sh AUTHORS
-- 
cgit v1.2.3