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 16:45:46 +0200 Message-ID: <8739hi7dut.fsf@gmail.com> References: <87zkkcktst.fsf@gmail.com> <87tyaiiz2o.fsf@gmail.com> <87ipqgv16c.fsf@gmail.com> <87bow7r440.fsf@gmail.com> <8739hjr111.fsf@gmail.com> <87ty9zozbn.fsf@gmail.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: dough.gmane.org 1312382798 16858 80.91.229.12 (3 Aug 2011 14:46:38 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Wed, 3 Aug 2011 14:46:38 +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 16:46:34 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 1QociP-0007mw-9R for geb-bug-gnu-emacs@m.gmane.org; Wed, 03 Aug 2011 16:46:33 +0200 Original-Received: from localhost ([::1]:59775 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QociO-0005Ev-Ug for geb-bug-gnu-emacs@m.gmane.org; Wed, 03 Aug 2011 10:46:32 -0400 Original-Received: from eggs.gnu.org ([140.186.70.92]:54656) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QociM-0005DO-74 for bug-gnu-emacs@gnu.org; Wed, 03 Aug 2011 10:46:31 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1QociL-00073d-3A for bug-gnu-emacs@gnu.org; Wed, 03 Aug 2011 10:46:30 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:53642) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QociL-00073U-1Y for bug-gnu-emacs@gnu.org; Wed, 03 Aug 2011 10:46:29 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1Qocis-0005tH-Iq; Wed, 03 Aug 2011 10:47: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 14:47: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.131238279222592 (code B ref 9115); Wed, 03 Aug 2011 14:47:02 +0000 Original-Received: (at 9115) by debbugs.gnu.org; 3 Aug 2011 14:46:32 +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 1QociN-0005sK-Ec for submit@debbugs.gnu.org; Wed, 03 Aug 2011 10:46:31 -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 1QociI-0005sA-1J for 9115@debbugs.gnu.org; Wed, 03 Aug 2011 10:46:27 -0400 Original-Received: by wyj26 with SMTP id 26so626060wyj.3 for <9115@debbugs.gnu.org>; Wed, 03 Aug 2011 07:45:51 -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=5MmiXsjvhXRHcKmd+7/MnrqcC9EjNRDZWiWcyVAOMtg=; b=Z4+7SIRGYTpMDuaQoZKp5sV3XG5rS0sRvxPywEFJZmylrc66FuYcGm1X12Awo7lA53 DdHoifGgih/FO6eNLUk1w1kPrJSvWYwIIQ8zktEUTxEWLQcJl+3NJ3w+xc/MInnmrvHn CP64RdCOY61258V99W1hssmoTj0AfPIa7Vb8o= Original-Received: by 10.216.173.13 with SMTP id u13mr738144wel.104.1312382751263; Wed, 03 Aug 2011 07:45:51 -0700 (PDT) Original-Received: from thierry-MM061 (211.211.85.79.rev.sfr.net [79.85.211.211]) by mx.google.com with ESMTPS id r48sm592679weq.26.2011.08.03.07.45.49 (version=TLSv1/SSLv3 cipher=OTHER); Wed, 03 Aug 2011 07:45:50 -0700 (PDT) In-Reply-To: (Stefan Monnier's message of "Wed, 03 Aug 2011 10:31:19 -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 10:47: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:49876 Archived-At: Stefan Monnier writes: > Ah, I see the problem now. Would the patch below have helped? Yes, better. Here what i have in my help buffer of help-split-fundoc: --8<---------------cut here---------------start------------->8--- USAGE= liste des arguments de la fonction. DOC= Docstring de la fonction. DEF= dans la liste des arguments (USAGE), on va avoir: "(DEF arg1 arg2 ...)" Si DEF est nil on aura: "(nil arg1 arg2...)" Autrement: "(DEF_name arg1 arg2...)" Exemples: [...] --8<---------------cut here---------------end--------------->8--- >> Idem for "def" argument. > > Not sure how I can improve this part. > > > Stefan > > > === modified file 'lisp/help-fns.el' > --- lisp/help-fns.el 2011-06-28 17:20:41 +0000 > +++ lisp/help-fns.el 2011-08-03 14:29:40 +0000 > @@ -102,7 +102,8 @@ > > (defun help-split-fundoc (docstring def) > "Split a function DOCSTRING into the actual doc and the usage info. > -Return (USAGE . DOC) or nil if there's no usage info. > +Return (USAGE . DOC) or nil if there's no usage info, where USAGE info > +is a string such as \"(apply FUNCTION &rest ARGUMENTS)\". > DEF is the function whose usage we're looking for in DOCSTRING." > ;; Functions can get the calling sequence at the end of the doc string. > ;; In cases where `function' has been fset to a subr we can't search for > -- A+ Thierry Get my Gnupg key: gpg --keyserver pgp.mit.edu --recv-keys 59F29997