apropos(1): Tweak the description of -1, ... -9, and -s

-s is not for compatibility only, because section names can be
anything.  E.g. we have 3lua and 9lua in base.  We have rudiments of
3f (for FORTRAN libs).  Some packages in pkgsrc also use suffixed 1
and 3 sections.
This commit is contained in:
uwe 2022-05-17 11:31:14 +00:00
parent b17b839ae3
commit 806c657e56
1 changed files with 10 additions and 8 deletions

View File

@ -1,4 +1,4 @@
.\" $NetBSD: apropos.1,v 1.21 2022/05/17 08:39:58 uwe Exp $ .\" $NetBSD: apropos.1,v 1.22 2022/05/17 11:31:14 uwe Exp $
.\" .\"
.\" Copyright (c) 2011 Abhinav Upadhyay <er.abhinav.upadhyay@gmail.com> .\" Copyright (c) 2011 Abhinav Upadhyay <er.abhinav.upadhyay@gmail.com>
.\" All rights reserved. .\" All rights reserved.
@ -63,8 +63,12 @@ Quotes are optional for specifying multiword queries.
.Pp .Pp
It supports the following options: It supports the following options:
.Bl -tag -width Fl .Bl -tag -width Fl
.It Fl [1-9] .It Fl 1 , No \&... , Fl 9
Search only within the specified section of manual pages. Limit the search to the specified section of the manual.
By default, pages from all sections are shown.
These options are abbreviations for the
.Fl s
option for single digit sections.
.It Fl C Ar path .It Fl C Ar path
Use different Use different
.Xr man 1 .Xr man 1
@ -95,12 +99,10 @@ Turn off formatting.
Limit the search to the pages for the specified machine architecture. Limit the search to the pages for the specified machine architecture.
By default pages for all architectures are shown in the search results. By default pages for all architectures are shown in the search results.
.It Fl s Ar section .It Fl s Ar section
Restrict the search to the specified section of the manual. Limit the search to the specified section of the manual.
By default, pages from all sections are shown. By default, pages from all sections are shown.
This option is for backwards compatibility with the classic version of apropos, For single digit sections you can use abbreviations:
using it is equivalent to using the .Fl 1 , No \&... , Fl 9 .
.Op 123456789
options directly.
.El .El
.Sh FILES .Sh FILES
.Bl -hang -width /etc/man.conf -compact .Bl -hang -width /etc/man.conf -compact