=================================================================== RCS file: /cvs/mandoc/apropos.1,v retrieving revision 1.6 retrieving revision 1.8 diff -u -p -r1.6 -r1.8 --- mandoc/apropos.1 2011/11/20 16:29:50 1.6 +++ mandoc/apropos.1 2011/11/23 10:09:30 1.8 @@ -1,4 +1,4 @@ -.\" $Id: apropos.1,v 1.6 2011/11/20 16:29:50 kristaps Exp $ +.\" $Id: apropos.1,v 1.8 2011/11/23 10:09:30 kristaps Exp $ .\" .\" Copyright (c) 2011 Kristaps Dzonsons .\" @@ -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: November 20 2011 $ +.Dd $Mdocdate: November 23 2011 $ .Dt APROPOS 1 .Os .Sh NAME @@ -22,6 +22,7 @@ .Nd search manual page databases .Sh SYNOPSIS .Nm +.Op Fl M Ar manpath .Op Fl m Ar manpath .Op Fl S Ar arch .Op Fl s Ar section @@ -30,14 +31,20 @@ The .Nm utility queries manual page databases generated by -.Xr mandocdb 8 , +.Xr mandocdb 8 , evaluating on .Ar expression for each file in each database. Its arguments are as follows: .Bl -tag -width Ds +.It Fl M Ar manpath +Use the colon-separated path instead of the default list of paths +searched for +.Xr mandocdb 8 +databases. +Invalid paths, or paths without manual databases, are ignored. .It Fl m Ar manpath -Append the colon-separated paths to the default list of paths searched +Append the colon-separated paths to the list of paths searched for .Xr mandocdb 8 databases. @@ -64,7 +71,6 @@ The operator has precedence over .Fl o and both are evaluated left-to-right. -.Pp .Bl -tag -width Ds .It \&( Ar expr No \&) True if the subexpression @@ -112,9 +118,10 @@ is evaluated case-insensitively. .Pp By default, .Nm -searches for a +searches for .Xr mandocdb 8 -database in the current working directory and +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 @@ -150,6 +157,8 @@ If an architecture is specified in the output, use Comma-separated paths overriding the default list of paths searched for manual databases. Invalid paths, or paths without manual databases, are ignored. +Takes precedence over +.Fl M . .El .\" .Sh FILES .Sh EXIT STATUS