From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Juanma Barranquero Newsgroups: gmane.emacs.devel Subject: Re: with-timeout, docstring does not explain LIST arg Date: Sun, 3 Jul 2005 17:46:15 +0200 Message-ID: References: <42C7CD98.8000505@student.lu.se> Reply-To: Juanma Barranquero NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable X-Trace: sea.gmane.org 1120407060 9450 80.91.229.2 (3 Jul 2005 16:11:00 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sun, 3 Jul 2005 16:11:00 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Jul 03 18:10:47 2005 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1Dp71Z-00035H-5A for ged-emacs-devel@m.gmane.org; Sun, 03 Jul 2005 18:08:53 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Dp72j-0001cf-Ax for ged-emacs-devel@m.gmane.org; Sun, 03 Jul 2005 12:10:05 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1Dp6vD-0006Wp-NQ for emacs-devel@gnu.org; Sun, 03 Jul 2005 12:02:21 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1Dp6v5-0006UE-9U for emacs-devel@gnu.org; Sun, 03 Jul 2005 12:02:11 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Dp6v4-0006AL-9j for emacs-devel@gnu.org; Sun, 03 Jul 2005 12:02:10 -0400 Original-Received: from [64.233.182.192] (helo=nproxy.gmail.com) by monty-python.gnu.org with esmtp (Exim 4.34) id 1Dp6lH-0007h4-BC for emacs-devel@gnu.org; Sun, 03 Jul 2005 11:52:03 -0400 Original-Received: by nproxy.gmail.com with SMTP id i2so124112nfe for ; Sun, 03 Jul 2005 08:46:15 -0700 (PDT) DomainKey-Signature: a=rsa-sha1; q=dns; c=nofws; s=beta; d=gmail.com; h=received:message-id:date:from:reply-to:to:subject:cc:in-reply-to:mime-version:content-type:content-transfer-encoding:content-disposition:references; b=OXaSZuZo+7fGvh3QQPLKsnmxRhyHGGZM338Yd29NbfbdZD/jxKCA71BkKqvWd8ygY7MEhEF+MJ64d8GgsH4kAxtw4wN77wzUMvrcfOrLkpbV4WFhigCkMBVNzjYWArR9OoZOi6iw3Hs8WEOrB/hxHyJFXF/RBF1O7yZrA101alk= Original-Received: by 10.48.244.19 with SMTP id r19mr84768nfh; Sun, 03 Jul 2005 08:46:15 -0700 (PDT) Original-Received: by 10.48.250.5 with HTTP; Sun, 3 Jul 2005 08:46:15 -0700 (PDT) Original-To: Lennart Borgman In-Reply-To: <42C7CD98.8000505@student.lu.se> Content-Disposition: inline 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:40224 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:40224 On 7/3/05, Lennart Borgman wrote: > The docstring does not explicitly explain the LIST argument. The docstring should look like this. --=20 /L/e/k/t/u Index: lisp/emacs-lisp/timer.el =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D RCS file: /cvsroot/emacs/emacs/lisp/emacs-lisp/timer.el,v retrieving revision 1.5 diff -u -2 -r1.5 timer.el --- lisp/emacs-lisp/timer.el=099 Feb 2005 15:50:40 -0000=091.5 +++ lisp/emacs-lisp/timer.el=093 Jul 2005 15:44:23 -0000 @@ -409,10 +409,9 @@ "Run BODY, but if it doesn't finish in SECONDS seconds, give up. If we give up, we run the TIMEOUT-FORMS and return the value of the last o= ne. -The call should look like: - (with-timeout (SECONDS TIMEOUT-FORMS...) BODY...) The timeout is checked whenever Emacs waits for some kind of external -event \(such as keyboard input, input from subprocesses, or a certain time= ); +event (such as keyboard input, input from subprocesses, or a certain time)= ; if the program loops without waiting in any way, the timeout will not -be detected." +be detected. +\n(fn (SECONDS TIMEOUT-FORMS...) BODY)" (let ((seconds (car list)) =09(timeout-forms (cdr list)))