From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Thierry Volpiatto Newsgroups: gmane.emacs.bugs Subject: bug#9115: 24.0.50; `documentation' should not return args list for CL defun*. Date: Wed, 03 Aug 2011 07:10:04 +0200 Message-ID: <87ty9zozbn.fsf@gmail.com> References: <87zkkcktst.fsf@gmail.com> <87tyaiiz2o.fsf@gmail.com> <87ipqgv16c.fsf@gmail.com> <87bow7r440.fsf@gmail.com> <8739hjr111.fsf@gmail.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: dough.gmane.org 1312348240 8503 80.91.229.12 (3 Aug 2011 05:10:40 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Wed, 3 Aug 2011 05:10:40 +0000 (UTC) Cc: 9115@debbugs.gnu.org To: Stefan Monnier Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Aug 03 07:10:36 2011 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([140.186.70.17]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1QoTj2-0004F9-6L for geb-bug-gnu-emacs@m.gmane.org; Wed, 03 Aug 2011 07:10:36 +0200 Original-Received: from localhost ([::1]:47348 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QoTj1-0000Xs-Eb for geb-bug-gnu-emacs@m.gmane.org; Wed, 03 Aug 2011 01:10:35 -0400 Original-Received: from eggs.gnu.org ([140.186.70.92]:39540) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QoTiy-0000Xa-RG for bug-gnu-emacs@gnu.org; Wed, 03 Aug 2011 01:10:33 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1QoTix-0003Ob-Iu for bug-gnu-emacs@gnu.org; Wed, 03 Aug 2011 01:10:32 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:36140) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QoTix-0003OQ-Ch for bug-gnu-emacs@gnu.org; Wed, 03 Aug 2011 01:10:31 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1QoTjS-0007Xw-Nt; Wed, 03 Aug 2011 01:11:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Thierry Volpiatto Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Wed, 03 Aug 2011 05:11:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 9115 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 9115-submit@debbugs.gnu.org id=B9115.131234824628977 (code B ref 9115); Wed, 03 Aug 2011 05:11:02 +0000 Original-Received: (at 9115) by debbugs.gnu.org; 3 Aug 2011 05:10:46 +0000 Original-Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QoTjB-0007XJ-MC for submit@debbugs.gnu.org; Wed, 03 Aug 2011 01:10:45 -0400 Original-Received: from mail-wy0-f172.google.com ([74.125.82.172]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QoTj8-0007XA-Ko for 9115@debbugs.gnu.org; Wed, 03 Aug 2011 01:10:44 -0400 Original-Received: by wyj26 with SMTP id 26so305408wyj.3 for <9115@debbugs.gnu.org>; Tue, 02 Aug 2011 22:10:10 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version:content-type; bh=pVoecspaYu/F98+0yjjHAg3ieu5SyNc2TgECqDvC9Mg=; b=ss9Qi2WQ6cvhl7eKsIN4+4oWV5AFxaence4CWbxteB7UyLl9tTYbar//mZizItYanl FM3+cXuVZqYjsJ4D3P8hocd47e+aZWWxrG91Yp/Zaq+FZ/S9sPNBpb3IP6QvL/O9Jlxk YjwdqUh3Ub2WJnNae35tbB+8TkkV0ZUFtZHI4= Original-Received: by 10.216.162.211 with SMTP id y61mr2534730wek.19.1312348208169; Tue, 02 Aug 2011 22:10:08 -0700 (PDT) Original-Received: from thierry-MM061 (194.78.88.79.rev.sfr.net [79.88.78.194]) by mx.google.com with ESMTPS id k84sm277789weq.22.2011.08.02.22.10.06 (version=TLSv1/SSLv3 cipher=OTHER); Tue, 02 Aug 2011 22:10:07 -0700 (PDT) In-Reply-To: (Stefan Monnier's message of "Tue, 02 Aug 2011 21:16:49 -0400") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.50 (gnu/linux) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Wed, 03 Aug 2011 01:11:02 -0400 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 1) X-Received-From: 140.186.70.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:49867 Archived-At: Stefan Monnier writes: >>>>> (let ((doc (documentation bidule))) >>>>> (or (cdr (help-split-fundoc doc nil)) doc)) >>>>> I agree this is not super convenient. >>>> Yes, i think i have tried that, but it doesn't return nil for the case >>>> of CL-style functions. >>> >>> In Emacs-24, it returns nil if the function had no docstring (the CL or >>> non-CL distinction is a only indirectly linked to the problem). So the >>> above should return either: >>> - the full docstring if there's one. >>> - nil or the empty string or "Not documented" if there isn't any >>> docstring. >> No, it doesn't, it return for example for: (I use emacs24) > > Oh, you're right: > > (let* ((doc (documentation bidule)) > (split (help-split-fundoc doc nil))) > (if split (cdr split) doc)) Yes, thanks, that's usable. But it add unnecessary complications for same result, so for the moment i will use my original code that is simpler and shorter. > might work better. Still, you should be able to get the right code by > reading the docstring and trying things out. Docstring is hard to understand. The term "usage" in docstring is not understandable until trying out the function and see results after evaluation. Idem for "def" argument. Thanks for helping on that. -- A+ Thierry Get my Gnupg key: gpg --keyserver pgp.mit.edu --recv-keys 59F29997