From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Robert J. Chassell" Newsgroups: gmane.emacs.devel Subject: Re: Optional third argument - name not mentioned in docstring Date: Tue, 10 Jan 2006 18:53:07 +0000 (UTC) Message-ID: References: <43C3DDAD.4030600@student.lu.se> Reply-To: bob@rattlesnake.com NNTP-Posting-Host: main.gmane.org X-Trace: sea.gmane.org 1136919955 13011 80.91.229.2 (10 Jan 2006 19:05:55 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Tue, 10 Jan 2006 19:05:55 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Jan 10 20:05:52 2006 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1EwOnw-0005nC-9w for ged-emacs-devel@m.gmane.org; Tue, 10 Jan 2006 20:05:12 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1EwOpv-0005ij-Nm for ged-emacs-devel@m.gmane.org; Tue, 10 Jan 2006 14:07:15 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1EwOeL-00027l-7p for emacs-devel@gnu.org; Tue, 10 Jan 2006 13:55:17 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1EwOeJ-00025U-8C for emacs-devel@gnu.org; Tue, 10 Jan 2006 13:55:16 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1EwOeJ-00025E-0o for emacs-devel@gnu.org; Tue, 10 Jan 2006 13:55:15 -0500 Original-Received: from [69.168.108.225] (helo=rattlesnake.com) by monty-python.gnu.org with esmtp (Exim 4.34) id 1EwOgn-0002bQ-Sz for emacs-devel@gnu.org; Tue, 10 Jan 2006 13:57:50 -0500 Original-Received: by rattlesnake.com via sendmail from stdin id (Debian Smail3.2.0.115) Tue, 10 Jan 2006 18:53:07 +0000 (UTC) Original-To: Lennart Borgman In-reply-to: <43C3DDAD.4030600@student.lu.se> (message from Lennart Borgman on Tue, 10 Jan 2006 17:15:41 +0100) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:48916 Archived-At: In the doc strings for `search-forward' and `search-backward' the argument names "bound" etc are not mentioned. Instead the doc strings just says: Optional third argument, if t, ... Should not the names be mentioned? No, I just read the doc string from describe-function and it says An optional second argument bounds the search; it is a buffer position. which is entirely clear. Indeed, I find the rest of the documentation clear, too: Optional third argument, if t, means if fail just return nil (no error). If not nil and not t, move to limit of search and return nil. Optional fourth argument is repeat count--search for successive occurrences. -- Robert J. Chassell bob@rattlesnake.com GnuPG Key ID: 004B4AC8 http://www.rattlesnake.com http://www.teak.cc