From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: PJ Weisberg Newsgroups: gmane.emacs.help Subject: Re: Wrong "Not documented" message, bug? Date: Thu, 14 Oct 2010 16:03:31 +0000 Message-ID: References: <4CB6BDA7.7040204@easy-emacs.de> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable X-Trace: dough.gmane.org 1287072345 2708 80.91.229.12 (14 Oct 2010 16:05:45 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Thu, 14 Oct 2010 16:05:45 +0000 (UTC) To: help-gnu-emacs@gnu.org Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Thu Oct 14 18:05:44 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 1P6QJE-0006dX-UG for geh-help-gnu-emacs@m.gmane.org; Thu, 14 Oct 2010 18:05:40 +0200 Original-Received: from localhost ([127.0.0.1]:57417 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1P6QIs-00025s-CX for geh-help-gnu-emacs@m.gmane.org; Thu, 14 Oct 2010 12:05:14 -0400 Original-Received: from [140.186.70.92] (port=49709 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1P6QHT-0001mL-RD for help-gnu-emacs@gnu.org; Thu, 14 Oct 2010 12:04:01 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1P6QHJ-0003jC-RQ for help-gnu-emacs@gnu.org; Thu, 14 Oct 2010 12:03:38 -0400 Original-Received: from p3plsmtpa01-10.prod.phx3.secureserver.net ([72.167.82.90]:36731) by eggs.gnu.org with smtp (Exim 4.71) (envelope-from ) id 1P6QHJ-0003iu-Iq for help-gnu-emacs@gnu.org; Thu, 14 Oct 2010 12:03:37 -0400 Original-Received: (qmail 31879 invoked from network); 14 Oct 2010 16:03:34 -0000 Original-Received: from unknown (209.85.213.41) by p3plsmtpa01-10.prod.phx3.secureserver.net (72.167.82.90) with ESMTP; 14 Oct 2010 16:03:34 -0000 Original-Received: by ywh1 with SMTP id 1so108998ywh.0 for ; Thu, 14 Oct 2010 09:03:33 -0700 (PDT) Original-Received: by 10.42.166.8 with SMTP id m8mr614984icy.207.1287072211717; Thu, 14 Oct 2010 09:03:31 -0700 (PDT) Original-Received: by 10.42.5.138 with HTTP; Thu, 14 Oct 2010 09:03:31 -0700 (PDT) In-Reply-To: <4CB6BDA7.7040204@easy-emacs.de> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) 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:75122 Archived-At: On Thu, Oct 14, 2010 at 8:21 AM, Andreas R=F6hler wrote: > > Hi, > > M-x describe-function `py-in-string/comment' points me to the code below, > which is correct: > > > (defun py-in-string/comment () > =A0(interactive) > =A0"Returns character address of start of comment or string; nil if not i= n > one. " > =A0(lexical-let ((erg (nth 8 (syntax-ppss)))) > =A0 =A0(unless erg (when (or (looking-at "\"\"\"") > =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0(looking-at (concat "^= [ \t]*" comment-start-skip))) > =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0(setq erg (point)))) > =A0 =A0(when (interactive-p) (message "%s" erg)) > =A0 =A0erg)) > > 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.