From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: =?ISO-8859-1?Q?Andreas_R=F6hler?= Newsgroups: gmane.emacs.help Subject: Re: Wrong "Not documented" message, bug? Date: Fri, 15 Oct 2010 13:50:34 +0200 Message-ID: <4CB8400A.8070308@easy-emacs.de> References: <4CB6BDA7.7040204@easy-emacs.de> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 8bit X-Trace: dough.gmane.org 1287143515 24694 80.91.229.12 (15 Oct 2010 11:51:55 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Fri, 15 Oct 2010 11:51:55 +0000 (UTC) To: help-gnu-emacs@gnu.org Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Fri Oct 15 13:51:54 2010 Return-path: Envelope-to: geh-help-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1P6ip8-0005XJ-Va for geh-help-gnu-emacs@m.gmane.org; Fri, 15 Oct 2010 13:51:47 +0200 Original-Received: from localhost ([127.0.0.1]:42376 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1P6ip7-0006ve-T9 for geh-help-gnu-emacs@m.gmane.org; Fri, 15 Oct 2010 07:51:45 -0400 Original-Received: from [140.186.70.92] (port=60446 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1P6ioj-0006vZ-4k for help-gnu-emacs@gnu.org; Fri, 15 Oct 2010 07:51:22 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1P6ioi-0003TT-3M for help-gnu-emacs@gnu.org; Fri, 15 Oct 2010 07:51:21 -0400 Original-Received: from moutng.kundenserver.de ([212.227.17.8]:60234) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1P6ioh-0003TJ-OL for help-gnu-emacs@gnu.org; Fri, 15 Oct 2010 07:51:20 -0400 Original-Received: from noname.home (brln-4db9d919.pool.mediaWays.net [77.185.217.25]) by mrelayeu.kundenserver.de (node=mrbap2) with ESMTP (Nemesis) id 0LkjTw-1OYlZh1gWa-00awdC; Fri, 15 Oct 2010 13:51:17 +0200 User-Agent: Mozilla/5.0 (X11; U; Linux i686; de; rv:1.9.1.11) Gecko/20100711 Thunderbird/3.0.6 In-Reply-To: X-Provags-ID: V02:K0:3fp9+WnmNeq6YKeJ5+Y7f2D81IW2+DLvqOoHOt0oys7 OtRNNAe8CgzCAJ7VZsQxGsRwYeuRYXbsaDIQE4ZiJggLA0Q4nd dHLw6NJlnpxjv1wdmat+S5eh11AHtiXvRtb2DBk2Ds5BN6dfMT 4yVVPXrViQK7mBQyIDuZqeLVbndt1Hz54S7kNMBcYJ7H4Sb20p rOJPi/0U3a1JCEQz1rg1Upb+flyxWz3a3ZbF/W08CM= X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-BeenThere: help-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Users list for the GNU Emacs text editor List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Errors-To: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.help:75132 Archived-At: Am 14.10.2010 18:03, schrieb PJ Weisberg: > On Thu, Oct 14, 2010 at 8:21 AM, Andreas Röhler > wrote: >> >> Hi, >> >> M-x describe-function `py-in-string/comment' points me to the code below, >> which is correct: >> >> >> (defun py-in-string/comment () >> (interactive) >> "Returns character address of start of comment or string; nil if not in >> one. " >> (lexical-let ((erg (nth 8 (syntax-ppss)))) >> (unless erg (when (or (looking-at "\"\"\"") >> (looking-at (concat "^[ \t]*" comment-start-skip))) >> (setq erg (point)))) >> (when (interactive-p) (message "%s" erg)) >> erg)) >> >> However, it says: >> >> ,---- >> | py-in-string/comment is an interactive Lisp function in >> | `python-components-intern.el'. >> | >> | (py-in-string/comment) >> | >> | Not documented. >> `---- >> >> Something odd with doku here? A bug? > > The docstring has to be the *first* statement in the function. Not > even the (interactive) call can come before it. > > Oh yeah, thanks all.