From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Lennart Borgman Newsgroups: gmane.emacs.devel Subject: Re: dotimes-with-progress-reporter doc string lacks SPEC Date: Sat, 08 Jul 2006 00:29:18 +0200 Message-ID: <44AEE03E.4020409@student.lu.se> References: <44AD7613.1060805@student.lu.se> NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-15; format=flowed Content-Transfer-Encoding: 7bit X-Trace: sea.gmane.org 1152311382 4435 80.91.229.2 (7 Jul 2006 22:29:42 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Fri, 7 Jul 2006 22:29:42 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Jul 08 00:29:40 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 1FyypO-0007Ua-NH for ged-emacs-devel@m.gmane.org; Sat, 08 Jul 2006 00:29:39 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1FyypO-0002YB-5q for ged-emacs-devel@m.gmane.org; Fri, 07 Jul 2006 18:29:38 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1FyypD-0002Y6-5Z for emacs-devel@gnu.org; Fri, 07 Jul 2006 18:29:27 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1Fyyp8-0002Xt-PE for emacs-devel@gnu.org; Fri, 07 Jul 2006 18:29:25 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Fyyp8-0002Xq-Iu for emacs-devel@gnu.org; Fri, 07 Jul 2006 18:29:22 -0400 Original-Received: from [81.228.11.159] (helo=pne-smtpout2-sn1.fre.skanova.net) by monty-python.gnu.org with esmtp (Exim 4.52) id 1Fyypc-0002qq-9A; Fri, 07 Jul 2006 18:29:52 -0400 Original-Received: from [192.168.123.121] (83.249.218.244) by pne-smtpout2-sn1.fre.skanova.net (7.2.075) id 44A135F100250BE4; Sat, 8 Jul 2006 00:29:19 +0200 User-Agent: Thunderbird 1.5.0.4 (Windows/20060516) Original-To: rms@gnu.org In-Reply-To: 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:56749 Archived-At: Richard Stallman wrote: > I think I can guess what the doc string for this function means, but it > would be more easy if SPEC where explicitly explained. > > The doc string explains the parts of the call in meaningful terms. > SPEC is just for internal implementation purposes; users should > not see it. What did you do to look at the doc string > which mentioned SPEC? > I looked at the sources. At least I learned something from this - I hope ;-)