From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from scc-mailout.scc.kit.edu (scc-mailout.scc.kit.edu [129.13.185.201]) by krisdoz.my.domain (8.14.3/8.14.3) with ESMTP id p98ETS14012105 for ; Sat, 8 Oct 2011 10:29:30 -0400 (EDT) Received: from hekate.usta.de (asta-nat.asta.uni-karlsruhe.de [172.22.63.82]) by scc-mailout-01.scc.kit.edu with esmtp (Exim 4.72 #1) id 1RCXu2-0000AT-5t; Sat, 08 Oct 2011 16:29:26 +0200 Received: from donnerwolke.usta.de ([172.24.96.3]) by hekate.usta.de with esmtp (Exim 4.72) (envelope-from ) id 1RCXu2-0002om-3O; Sat, 08 Oct 2011 16:29:26 +0200 Received: from iris.usta.de ([172.24.96.5] helo=usta.de) by donnerwolke.usta.de with esmtp (Exim 4.72) (envelope-from ) id 1RCXu2-0001Ei-18; Sat, 08 Oct 2011 16:29:26 +0200 Received: from schwarze by usta.de with local (Exim 4.72) (envelope-from ) id 1RCXu1-0004Jp-KI; Sat, 08 Oct 2011 16:29:25 +0200 Date: Sat, 8 Oct 2011 16:29:25 +0200 From: Ingo Schwarze To: tech@mdocml.bsd.lv Cc: jmc@openbsd.org Subject: apropos(1) option naming Message-ID: <20111008142925.GB28339@iris.usta.de> X-Mailinglist: mdocml-tech Reply-To: tech@mdocml.bsd.lv MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.5.21 (2010-09-15) Hi, i have done some research regarding apropos(1) option naming, but i'm out of time for drawing conclusions right now. Yours, Ingo Except that maybe, i still hope for something like apropos -s 3 -Q Xr open and Er ENOENT apropos -s 4 -Q An Gray or An Reyk ----- 8< ----- schnipp ----- >8 ----- 8< ----- schnapp ----- >8 ----- Options, arguments, and environment of the following utilities: man(1) apropos(1) whatis(1) whereis(1) which(1) OVERVIEW ======== general agreement: -a all -B binary search path -b search for binaries -C config file -c copy to stdout -d debug -k keyword search like apropos(1) -M override MANPATH -n use nroff (historic) -P pager -T output device (historic) -t use troff (historic) agreement for individual programs: -f find like whatis(1) (man) -f end of search path (whereis) -m search for manual pages (whereis) -S subsection (man apropos) -S search path for sources (whereis) -s section (man apropos) -s search for sources (whereis) -u update cache (man) (Linux only) -u search for unusual (whereis) -w where (man) important clashes: -h SYNOPSIS only (4.3BSD-Net/2 NetBSD OpenBSD) -h help (FreeBSD Linux) -m prepend to MANPATH (man apropos whatis 4.3BSD-Reno NetBSD OpenBSD) -m override MACHINE_ARCH (man FreeBSD) -m another operating system (man apropos whatis Linux) unimportant clashes: -e -l -p -r used by a single system: -D -E -H -I -i -K -L -o -q -R -V -v -W -X -x -Z completely free: -A -F -G -g -J -j -N -O -Q -U -Y -y -z DETAILED LISTING: ================= -7 [Linux man] display as pure US-ASCII -a [OpenBSD man whereis which] display all matching pages app: 4.3BSD-Tahoe man app: OpenBSD 2.3 whereis which [NetBSD man which] [FreeBSD man whereis which] [Linux man which] -a [Linux apropos] logical "and" of keywords -B path [FreeBSD whereis] path to search for binaries app: 2BSD whereis [Linux whereis] -b [FreeBSD whereis] search for binaries app: 2BSD whereis [Linux whereis] -C file [OpenBSD man apropos whatis] alternate configuration file [man.conf(5)] app: NetBSD 1.0 man apropos whatis [NetBSD man apropos whatis] [Linux man catman apropos whatis] -c [OpenBSD man] copy to standard output app: 4.3BSD-Reno man [NetBSD man] [Linux man] internal option to be used by catman(1) only -D [Linux man] reset options to the defaults -d [FreeBSD man apropos whatis] print debugging information [Linux man catman whatis] -E encoding [Linux man] generate specific output character encoding -e [Version 7 AT&T UNIX man] proprocess by eqn(7) -e [Linux man] select subsystem (e.g. tcl manuals) -e [Linux apropos] use exact matches only -f command [OpenBSD man] synonym for whatis(1) app: 4BSD man [FreeBSD man] [Linux man] -f [FreeBSD whereis] delimit list of directories after -BMS app: 2BSD whereis [Linux whereis] -H browser [Linux man] produce HTML output -h [OpenBSD man] display only the SYNOPSIS app: 4.3BSD-Net/2 man [NetBSD man] [FreeBSD man] display short help message [Linux man catman apropos whatis] like FreeBSD -I [Linux man] match case when searching for manual pages -i [Linux man] ignore case when searching for manuals (the default) -K [Linux man] full text grep over all manuals -k keyword [POSIX OpenBSD man] synonym for apropos(1) app: 4BSD man [NetBSD man] [FreeBSD man] [Linux man] -L [Linux man apropos whatis] force a specific locale -l [Linux man] local files only, no MANPATH -l [Linux apropos whatis] do not trim output to terminal width -M path [OpenBSD man apropos whatis] override MANPATH app: 4.3BSD man app: 4.3BSD-Tahoe whatis app: 4.3BSD-Reno apropos [NetBSD man apropos whatis] [Linux man catman apropos whatis] [FreeBSD man whereis] app: 2BSD whereis [Linux whereis] -m path [OpenBSD man apropos whatis] prepend to MANPATH app: 4.3BSD-Reno man apropos whatis [NetBSD man apropos whatis] [FreeBSD man] override MACHINE_ARCH and MACHINE -m [FreeBSD whereis] search for manual pages app: 2BSD whereis [Linux whereis] -m system [Linux man apropos whatis] display pages of another operating system -n [Version 7 AT&T UNIX man] invoke nroff for display on standard output -o [FreeBSD man] forced use of non-localized pages -p [NetBSD man] print MANPATH -p [NetBSD whereis] use PATH -p [FreeBSD man] use roff preprocessor, override MANROFFSEQ -p string [Linux man] use specified roff preprocessor -P [FreeBSD man] override PAGER [more -s] [Linux man] -q [FreeBSD whereis] quiet -R [Linux man] recode -r [Linux man] change less(1) prompt -r [Linux apropos whatis] use regular expression matching -S subsection [OpenBSD man apropos] restrict to architecture app: OpenBSD 2.3 man app: OpenBSD 4.5 apropos [NetBSD man apropos] [FreeBSD man] restrict to section list, override MANSECT [Linux man] like FreeBSD -S path [FreeBSD whereis] path to search for sources app: 2BSD whereis [Linux whereis] -s section [OpenBSD man apropos] restrict to section app: OpenBSD 2.3 man app: OpenBSD 4.5 apropos [NetBSD man apropos] [Linux apropos whatis] -s [FreeBSD whereis] search for source files app: 2BSD whereis [Linux whereis] -s [FreeBSD which] silent -T device [Linux man] app: somewhere before 4.4 BSD (not sure, would need to check) -t [FreeBSD man] invoke troff for phototypesetting app: Version 7 AT&T UNIX man [Linux man] -u [FreeBSD whereis] search for unusual entries app: 2BSD whereis -u [Linux man] update cache (requires SUID) -V [Linux man catman apropos whatis] display version information -v [Linux apropos whatis] verbose warnings -W [Linux man] list the pathnames of matching formatted pages -w [OpenBSD man] list the pathnames of the matching pages app: Version 7 AT&T UNIX man [NetBSD man] [FreeBSD man] [Linux man] -w [Linux apropos whatis] use shell wildcard matching -X [Linux man] display using gxditview(1) -x [FreeBSD whereis] do not use expensive search tools -Z [Linux man] use a roff postprocessor keywords ... [OpenBSD apropos] ignoring case, considering parts of words app: 2BSD apropos [NetBSD apropos] [FreeBSD apropos] [Linux apropos] name ... [OpenBSD man whatis whereis which] display pages entitled name ... app: Version 3 AT&T UNIX man: restricted to one name app: Version 4 AT&T UNIX man: allowing more than one name app: 2BSD whatis whereis app: 3BSD which [NetBSD man whatis whereis which] [FreeBSD man whatis whereis which] [Linux man whatis whereis which] MACHINE [OpenBSD man] restrict to architecture [NetBSD man] [FreeBSD man] MANPAGER [OpenBSD man] alternative manual pagination program [more(1)] MANPATH [OpenBSD man apropos whatis] manual search path [NetBSD man apropos whatis] [FreeBSD man apropos whatis] PAGER [OpenBSD man] alternative pagination program [more(1)] [NetBSD man] PATH [OpenBSD which] command search path [FreeBSD apropos whatis] whatis.db [OpenBSD apropos whatis] apropos database file [NetBSD apropos whatis] /etc/man.conf [OpenBSD man apropos whatis] default man(1) configuration file [NetBSD man apropos whatis] [FreeBSD man] -- To unsubscribe send an email to tech+unsubscribe@mdocml.bsd.lv