summaryrefslogtreecommitdiffstats
path: root/apropos.1
diff options
context:
space:
mode:
authorIngo Schwarze <schwarze@openbsd.org>2017-03-17 17:24:41 +0000
committerIngo Schwarze <schwarze@openbsd.org>2017-03-17 17:24:41 +0000
commit4e452a40810358cef4533a02ac18776e562a62aa (patch)
tree7c6bf32b1aad6d2f8b2e24d344344dbd12acfead /apropos.1
parent395c0aa3514c19963ae4611cde8f518707a8bb75 (diff)
downloadmandoc-4e452a40810358cef4533a02ac18776e562a62aa.tar.gz
Document man(1) section selection priority,
and correct description of apropos(1) output search order. Suggested by tb@.
Diffstat (limited to 'apropos.1')
-rw-r--r--apropos.125
1 files changed, 23 insertions, 2 deletions
diff --git a/apropos.1 b/apropos.1
index d1c5b4ca..f23b19ea 100644
--- a/apropos.1
+++ b/apropos.1
@@ -1,7 +1,7 @@
.\" $Id$
.\"
.\" Copyright (c) 2011, 2012 Kristaps Dzonsons <kristaps@bsd.lv>
-.\" Copyright (c) 2011, 2012, 2014 Ingo Schwarze <schwarze@openbsd.org>
+.\" Copyright (c) 2011, 2012, 2014, 2017 Ingo Schwarze <schwarze@openbsd.org>
.\"
.\" Permission to use, copy, modify, and distribute this software for any
.\" purpose with or without fee is hereby granted, provided that the above
@@ -237,7 +237,28 @@ is evaluated case-insensitively.
Has no effect on substring terms.
.El
.Pp
-Results are sorted by manual sections and names, with output formatted as
+Results are sorted according to the following criteria:
+.Bl -enum
+.It
+The manpath directory tree the page is found in, according to the
+order specified with
+.Fl M ,
+.Fl m ,
+the
+.Ev MANPATH
+environment variable, the
+.Xr man.conf 5
+configuration file, or the default documented in
+.Xr man.conf 5 .
+.It
+The section number in ascending numerical order.
+.It
+The page name in ascending
+.Xr ascii 7
+alphabetical order, case-insensitive.
+.El
+.Pp
+Each output line is formatted as
.Pp
.D1 name[, name...](sec) \- description
.Pp