From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#21754: 25.0.50; doc of `grep' - no description of how to call it: COMMAND-ARGS undefined Date: Sun, 25 Oct 2015 08:35:00 -0700 (PDT) Message-ID: <0ed13600-cfc4-42f8-8808-fe0c5e84500c@default> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1445787384 19734 80.91.229.3 (25 Oct 2015 15:36:24 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 25 Oct 2015 15:36:24 +0000 (UTC) To: 21754@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Oct 25 16:36:10 2015 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1ZqNL8-0000ir-Gt for geb-bug-gnu-emacs@m.gmane.org; Sun, 25 Oct 2015 16:36:10 +0100 Original-Received: from localhost ([::1]:48433 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZqNL7-0001iv-H8 for geb-bug-gnu-emacs@m.gmane.org; Sun, 25 Oct 2015 11:36:09 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:34976) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZqNL3-0001ie-BD for bug-gnu-emacs@gnu.org; Sun, 25 Oct 2015 11:36:06 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ZqNL0-0001ft-43 for bug-gnu-emacs@gnu.org; Sun, 25 Oct 2015 11:36:05 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:47388) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZqNL0-0001fn-0c for bug-gnu-emacs@gnu.org; Sun, 25 Oct 2015 11:36:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.80) (envelope-from ) id 1ZqNKz-00050j-O6 for bug-gnu-emacs@gnu.org; Sun, 25 Oct 2015 11:36:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 25 Oct 2015 15:36:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 21754 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.144578732919188 (code B ref -1); Sun, 25 Oct 2015 15:36:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 25 Oct 2015 15:35:29 +0000 Original-Received: from localhost ([127.0.0.1]:38096 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZqNKS-0004zQ-OL for submit@debbugs.gnu.org; Sun, 25 Oct 2015 11:35:29 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:53013) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1ZqNK8-0004yd-IG for submit@debbugs.gnu.org; Sun, 25 Oct 2015 11:35:27 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ZqNK6-0001Yq-36 for submit@debbugs.gnu.org; Sun, 25 Oct 2015 11:35:06 -0400 Original-Received: from lists.gnu.org ([2001:4830:134:3::11]:39451) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZqNK6-0001Yl-0f for submit@debbugs.gnu.org; Sun, 25 Oct 2015 11:35:06 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:34780) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZqNK5-0001cf-6v for bug-gnu-emacs@gnu.org; Sun, 25 Oct 2015 11:35:05 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ZqNK2-0001Uw-0L for bug-gnu-emacs@gnu.org; Sun, 25 Oct 2015 11:35:05 -0400 Original-Received: from aserp1040.oracle.com ([141.146.126.69]:45423) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZqNK1-0001U6-R0 for bug-gnu-emacs@gnu.org; Sun, 25 Oct 2015 11:35:01 -0400 Original-Received: from userv0021.oracle.com (userv0021.oracle.com [156.151.31.71]) by aserp1040.oracle.com (Sentrion-MTA-4.3.2/Sentrion-MTA-4.3.2) with ESMTP id t9PFZ0pl017763 (version=TLSv1 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Sun, 25 Oct 2015 15:35:01 GMT Original-Received: from aserv0122.oracle.com (aserv0122.oracle.com [141.146.126.236]) by userv0021.oracle.com (8.13.8/8.13.8) with ESMTP id t9PFZ05F014504 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=FAIL) for ; Sun, 25 Oct 2015 15:35:00 GMT Original-Received: from abhmp0005.oracle.com (abhmp0005.oracle.com [141.146.116.11]) by aserv0122.oracle.com (8.13.8/8.13.8) with ESMTP id t9PFZ0Pb020512 for ; Sun, 25 Oct 2015 15:35:00 GMT X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9 (901082) [OL 12.0.6691.5000 (x86)] X-Source-IP: userv0021.oracle.com [156.151.31.71] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 208.118.235.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:108018 Archived-At: Here is the entire doc string: (grep COMMAND-ARGS) Run grep, with user-specified args, and collect output in a buffer. While grep runs asynchronously, you can use C-x ` (M-x next-error), or RET in the *grep* buffer, to go to the lines where grep found matches. To kill the grep job before it finishes, type C-c C-k. For doing a recursive 'grep', see the 'rgrep' command. For running 'grep' in a specific directory, see 'lgrep'. This command uses a special history list for its COMMAND-ARGS, so you can easily repeat a grep command. A prefix argument says to default the argument based upon the current tag the cursor is over, substituting it into the last grep command in the grep command history (or into 'grep-command' if that history list is empty). There is _zero_ information here about parameter COMMAND-ARGS. The Emacs and Elisp manuals offer no more help. How is a user expected to call this function from Lisp? Doc strings should _fully specify_ a function's parameters. In GNU Emacs 25.0.50.1 (i686-pc-mingw32) of 2015-10-09 Bzr revision: af45926d66d303fdc4c2c3ebbc820b4a54d9e4a0 Windowing system distributor `Microsoft Corp.', version 6.1.7601 Configured using: `configure --host=3Di686-pc-mingw32 --enable-checking=3Dyes,glyphs'