* mdocml: Document man(1) section selection priority, and correct
@ 2017-03-17 17:25 schwarze
0 siblings, 0 replies; only message in thread
From: schwarze @ 2017-03-17 17:25 UTC (permalink / raw)
To: source
Log Message:
-----------
Document man(1) section selection priority,
and correct description of apropos(1) output search order.
Suggested by tb@.
Modified Files:
--------------
mdocml:
apropos.1
man.1
Revision Data
-------------
Index: man.1
===================================================================
RCS file: /home/cvs/mdocml/mdocml/man.1,v
retrieving revision 1.21
retrieving revision 1.22
diff -Lman.1 -Lman.1 -u -p -r1.21 -r1.22
--- man.1
+++ man.1
@@ -3,7 +3,7 @@
.\" Copyright (c) 1989, 1990, 1993
.\" The Regents of the University of California. All rights reserved.
.\" Copyright (c) 2003, 2007, 2008, 2014 Jason McIntyre <jmc@openbsd.org>
-.\" Copyright (c) 2010, 2011, 2014, 2015 Ingo Schwarze <schwarze@openbsd.org>
+.\" Copyright (c) 2010, 2011, 2014-2017 Ingo Schwarze <schwarze@openbsd.org>
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
@@ -234,6 +234,10 @@ System maintenance and operation command
.It 9
Kernel internals.
.El
+.Pp
+If not specified and a match is found in more than one section,
+the first match is selected from the following list:
+1, 8, 6, 2, 3, 5, 7, 4, 9, 3p.
.It Fl T Ar output
Select the output format.
The default is
Index: apropos.1
===================================================================
RCS file: /home/cvs/mdocml/mdocml/apropos.1,v
retrieving revision 1.40
retrieving revision 1.41
diff -Lapropos.1 -Lapropos.1 -u -p -r1.40 -r1.41
--- apropos.1
+++ 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
--
To unsubscribe send an email to source+unsubscribe@mdocml.bsd.lv
^ permalink raw reply [flat|nested] only message in thread
only message in thread, other threads:[~2017-03-17 17:25 UTC | newest]
Thread overview: (only message) (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2017-03-17 17:25 mdocml: Document man(1) section selection priority, and correct schwarze
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).