From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Kevin Ryde Newsgroups: gmane.emacs.bugs Subject: bug#3717: M-x man completion Date: Thu, 17 Dec 2009 08:40:17 +1100 Message-ID: <87pr6ebnsu.fsf@blah.blah> References: <87bpo6p3de.fsf@turtle.gmx.de> <87ab3pfqj0.fsf@jidanni.org> <87ocmsqa7z.fsf@mail.jurta.org> <877htetd2g.fsf@blah.blah> <87my2956sr.fsf@blah.blah> Reply-To: Kevin Ryde , 3717@emacsbugs.donarmstrong.com NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: ger.gmane.org 1261001274 15055 80.91.229.12 (16 Dec 2009 22:07:54 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 16 Dec 2009 22:07:54 +0000 (UTC) Cc: jidanni@jidanni.org To: 3717@emacsbugs.donarmstrong.com Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Dec 16 23:07:46 2009 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1NL224-0001YD-Gj for geb-bug-gnu-emacs@m.gmane.org; Wed, 16 Dec 2009 23:07:44 +0100 Original-Received: from localhost ([127.0.0.1]:54489 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1NL224-00019T-64 for geb-bug-gnu-emacs@m.gmane.org; Wed, 16 Dec 2009 17:07:44 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1NL21y-000188-BM for bug-gnu-emacs@gnu.org; Wed, 16 Dec 2009 17:07:38 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1NL21u-000172-13 for bug-gnu-emacs@gnu.org; Wed, 16 Dec 2009 17:07:38 -0500 Original-Received: from [199.232.76.173] (port=58865 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1NL21t-00016y-Rg for bug-gnu-emacs@gnu.org; Wed, 16 Dec 2009 17:07:33 -0500 Original-Received: from rzlab.ucr.edu ([138.23.92.77]:51909) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1NL21t-0006sj-8V for bug-gnu-emacs@gnu.org; Wed, 16 Dec 2009 17:07:33 -0500 Original-Received: from rzlab.ucr.edu (rzlab.ucr.edu [127.0.0.1]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id nBGM7Ujl026787; Wed, 16 Dec 2009 14:07:31 -0800 Original-Received: (from debbugs@localhost) by rzlab.ucr.edu (8.14.3/8.14.3/Submit) id nBGLo50t024166; Wed, 16 Dec 2009 13:50:05 -0800 Resent-Date: Wed, 16 Dec 2009 13:50:05 -0800 X-Loop: owner@emacsbugs.donarmstrong.com Resent-From: Kevin Ryde Resent-To: bug-submit-list@donarmstrong.com Resent-CC: Emacs Bugs 2Resent-Date: Wed, 16 Dec 2009 21:50:04 +0000 Resent-Message-ID: Resent-Sender: owner@emacsbugs.donarmstrong.com X-Emacs-PR-Message: followup 3717 X-Emacs-PR-Package: emacs X-Emacs-PR-Keywords: Original-Received: via spool by 3717-submit@emacsbugs.donarmstrong.com id=B3717.126099971023547 (code B ref 3717); Wed, 16 Dec 2009 21:50:04 +0000 Original-Received: (at 3717) by emacsbugs.donarmstrong.com; 16 Dec 2009 21:41:50 +0000 X-Spam-Bayes: score:0.5 Bayes not run. spammytokens:Tokens not available. hammytokens:Tokens not available. Original-Received: from mailout2.pacific.net.au (mailout2-6.pacific.net.au [61.8.2.229]) by rzlab.ucr.edu (8.14.3/8.14.3/Debian-5) with ESMTP id nBGLfmFx023543 for <3717@emacsbugs.donarmstrong.com>; Wed, 16 Dec 2009 13:41:49 -0800 Original-Received: from mailproxy2.pacific.net.au (mailproxy2.pacific.net.au [61.8.2.163]) by mailout2.pacific.net.au (Postfix) with ESMTP id 82972193B18; Thu, 17 Dec 2009 08:41:45 +1100 (EST) Original-Received: from blah.blah (ppp2FAB.dyn.pacific.net.au [61.8.47.171]) by mailproxy2.pacific.net.au (Postfix) with ESMTP id E5A632742E; Thu, 17 Dec 2009 08:41:39 +1100 (EST) Original-Received: from gg by blah.blah with local (Exim 4.69) (envelope-from ) id 1NL1bW-0001zm-39; Thu, 17 Dec 2009 08:40:18 +1100 In-Reply-To: <87my2956sr.fsf@blah.blah> (Kevin Ryde's message of "Fri, 27 Nov 2009 08:12:52 +1100") User-Agent: Gnus/5.110011 (No Gnus v0.11) Emacs/23.1 (gnu/linux) X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 2) Resent-Date: Wed, 16 Dec 2009 17:07:38 -0500 X-BeenThere: bug-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:33645 Archived-At: On the subject of M-x man "-k foo" being kept secret, I thought to revise the docstring a bit per below (formatted for reading). I think samples of what can be entered are easier to read than words, especially if skimming. The "-a" bit is per man-db, but it's not posix, so I wonder if it varies on other mans. Did for instance BSD from years ago have the equivalent of -a as its default anyway? 2009-12-16 Kevin Ryde * man.el (man): Revise docstring to show -k and -l examples, and mention -a in the "all sections" bit. Get a Un*x manual page and put it in a buffer. This command is the top-level command in the man package. It runs a Un*x command to retrieve and clean a manpage in the background and places the results in a `Man-mode' browsing buffer. See variable `Man-notify-method' for what happens when the buffer is ready. If a buffer already exists for this man page, it will display immediately. For a manpage from a certain section, use either of the following forms. "cat(1)" is how cross-references appear and is passed to man as "1 cat". cat(1) 1 cat To see manpages from all sections related to a subject, put an "all pages" option into `Man-switches', usually "-a", then step through with `Man-next-manpage' (M-n) etc. An explicit filename can be given. Use -l if it might otherwise look like a page name. /my/file/name.1.gz -l somefile.1 An "apropos" query with -k gives a buffer of matching page names or descriptions. The pattern argument is usually an "egrep" style regexp. -k pattern