From unknown Sat Jun 14 18:58:21 2025 X-Loop: help-debbugs@gnu.org Subject: bug#9115: 24.0.50; `documentation' should not return args list for CL defun*. 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: Mon, 18 Jul 2011 06:06:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 9115 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 9115@debbugs.gnu.org X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.13109691594117 (code B ref -1); Mon, 18 Jul 2011 06:06:02 +0000 Received: (at submit) by debbugs.gnu.org; 18 Jul 2011 06:05:59 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Qigxn-00014J-Hw for submit@debbugs.gnu.org; Mon, 18 Jul 2011 02:05:59 -0400 Received: from eggs.gnu.org ([140.186.70.92]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Qigxh-000140-Oa for submit@debbugs.gnu.org; Mon, 18 Jul 2011 02:05:53 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1QigxY-0000Pb-8w for submit@debbugs.gnu.org; Mon, 18 Jul 2011 02:05:44 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-2.6 required=5.0 tests=BAYES_00,FREEMAIL_FROM, RCVD_IN_DNSWL_LOW, T_DKIM_INVALID, T_TO_NO_BRKTS_FREEMAIL autolearn=unavailable version=3.3.1 Received: from lists.gnu.org ([140.186.70.17]:41075) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QigxY-0000PV-2N for submit@debbugs.gnu.org; Mon, 18 Jul 2011 02:05:40 -0400 Received: from eggs.gnu.org ([140.186.70.92]:56462) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QigxS-0003Uo-SJ for bug-gnu-emacs@gnu.org; Mon, 18 Jul 2011 02:05:39 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1QigxN-0000Ou-V1 for bug-gnu-emacs@gnu.org; Mon, 18 Jul 2011 02:05:34 -0400 Received: from mail-ww0-f49.google.com ([74.125.82.49]:36385) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QigxN-0000Oj-DE for bug-gnu-emacs@gnu.org; Mon, 18 Jul 2011 02:05:29 -0400 Received: by wwf22 with SMTP id 22so2227406wwf.30 for ; Sun, 17 Jul 2011 23:05:28 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=from:to:subject:date:message-id:user-agent:mime-version :content-type; bh=7R2iLUAYROSeJim6QRu7XdH85vADT2hQpn13JpeAvHU=; b=PWIWP9U8CDpNVmz/D7RxdQyFFY2Htp48F/BXBt45dALIcYEo0FmiY6A1antRDMH5ye Q8KKb20N81uY9cp2ZRH8pHzVg01446JYlpwTmxLVxxo7sb9amf8xzLVFeDRUf4+K+4uE 8Ql1SeoY6O5265rtZPT0+ftv3NMVFzblpJRlo= Received: by 10.216.175.202 with SMTP id z52mr2022168wel.17.1310969127836; Sun, 17 Jul 2011 23:05:27 -0700 (PDT) Received: from thierry-MM061 (43.77.197.77.rev.sfr.net [77.197.77.43]) by mx.google.com with ESMTPS id fx12sm3158144wbb.42.2011.07.17.23.05.24 (version=TLSv1/SSLv3 cipher=OTHER); Sun, 17 Jul 2011 23:05:26 -0700 (PDT) From: Thierry Volpiatto Date: Mon, 18 Jul 2011 08:05:22 +0200 Message-ID: <87zkkcktst.fsf@gmail.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 140.186.70.17 X-Spam-Score: -5.2 (-----) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -5.2 (-----) Hi, documentation return the list of arg for the defun*'s:(choose a short one) --8<---------------cut here---------------start------------->8--- (documentation 'ert--remove*) "Does not support all the keywords of remove*. (fn X LIST &key KEY TEST)" --8<---------------cut here---------------end--------------->8--- It's annoying for function not documented because it return only list of args instead or returning nil. In GNU Emacs 24.0.50.1 (i686-pc-linux-gnu, GTK+ Version 2.24.4) of 2011-07-16 on thierry-MM061 Windowing system distributor `The X.Org Foundation', version 11.0.11001000 Important settings: value of $LC_ALL: nil value of $LC_COLLATE: nil value of $LC_CTYPE: nil value of $LC_MESSAGES: nil value of $LC_MONETARY: nil value of $LC_NUMERIC: nil value of $LC_TIME: nil value of $LANG: fr_FR.utf8 value of $XMODIFIERS: nil locale-coding-system: utf-8-unix default enable-multibyte-characters: t Major mode: Emacs-Lisp Minor modes in effect: TeX-PDF-mode: t minibuffer-depth-indicate-mode: t auto-image-file-mode: t eldoc-mode: t show-paren-mode: t display-time-mode: t diff-auto-refine-mode: t recentf-mode: t savehist-mode: t shell-dirtrack-mode: t anything-dired-mode: t tooltip-mode: t mouse-wheel-mode: t file-name-shadow-mode: t global-font-lock-mode: t font-lock-mode: t auto-composition-mode: t auto-encryption-mode: t auto-compression-mode: t column-number-mode: t line-number-mode: t transient-mark-mode: t Recent input: SPC d o c C-M-x C-z C-g ; C-M-x C-z C-z C-z C-z C-z C-z C-z C-z C-z C-z C-z C-z C-g C-x C-s M-x r e p o r t Recent messages: anything-c-get-first-line-documentation Quit anything-c-get-first-line-documentation Quit Auto-saving...done Saving file /home/thierry/labo/anything-config-qp/anything-config.el... Wrote /home/thierry/labo/anything-config-qp/anything-config.el Load-path shadows: None found. Features: (shadow emacsbug flow-fill mailalias smtpmail epa-mail smiley gnus-cite mail-extr gnus-async gnus-bcklg qp gnus-ml nndraft nnmh nndoc utf-7 nnimap utf7 nnml nnfolder rot13 netrc network-stream starttls tls gnus-agent gnus-srvr gnus-score score-mode nnvirtual gnus-msg nntp gnus-cache gnus-dired find-func help-mode view cal-iso preview prv-emacs tex-buf reftex-vcr reftex-dcr reftex-auc reftex reftex-vars font-latex latex tex-style tex latexenc imenu rst sh-script vc-rcs vc-git xgit-dvc xgit xgit-annotate dvc-annotate xgit-log conf-mode xhg-dvc xhg xhg-annotate xhg-mq xhg-log bzr-core xdarcs-core xgit-core xhg-core xmtn-minimal tla smerge-mode newcomment dvc-state dvc-config dvc-diff dvc-fileinfo diff sendmail dvc-cmenu dvc-about dvc-version dvc-revlist uniquify em-unix em-script em-prompt em-ls em-hist em-pred em-glob em-dirs em-cmpl em-basic esh-opt em-banner em-alias esh-var esh-io esh-cmd esh-ext esh-proc esh-groups eshell esh-module esh-mode align-let server googlecl google-maps google-maps-static google-maps-geocode google-maps-base json simple-call-tree el-expectations el-mock csv2org iedit zop-to-char mule-util elscreen smallurl mm-url xml-weather rectangle-utils tv-utils pcvs pcvs-parse pcvs-info pcvs-defs auto-document autodoc mb-depth ioccur moz cl-info slime-xref-browser slime-banner slime-tramp slime-asdf slime-fancy slime-fontifying-fu slime-package-fu slime-references slime-scratch slime-presentations slime-fuzzy slime-fancy-inspector slime-c-p-c slime-editing-commands slime-autodoc slime-parse slime-repl slime hideshow hyperspec slime-autoloads boxquote rect image-file newsticker newst-treeview newst-plainview newst-reader newst-ticker newst-backend ledger-config ledger esh-arg esh-util lpr woman man two-column em-term term ehelp electric esh-toggle em-xtra flymake pdbtrack eldoc-eval eldoc no-word regex-tool whitespace paren time dired-tar dired-extension image-dired yaoddmuse skeleton sgml-mode emms-mplayer-config emms-playlist-limit emms-volume emms-volume-amixer emms-i18n emms-history emms-score emms-stream-info emms-metaplaylist-mode emms-bookmarks emms-lastfm-client parse-time emms-cue emms-mode-line-icon emms-browser sort emms-playlist-sort emms-last-played emms-player-xine emms-player-mpd tq emms-playing-time emms-lyrics emms-url hl-line emms-tag-editor emms-mark emms-mode-line emms-cache emms-info-ogginfo emms-info-mp3info emms-playlist-mode emms-player-vlc emms-player-mplayer emms-info emms-streams later-do emms-source-playlist emms-source-file emms-player-simple emms-setup emms emms-compat winner dvc-init bzr-gnus tla-gnus xgit-gnus xhg-gnus gnus-art mm-uu mml2015 mm-view mml-smime smime dig nnir gnus-sum nnoo gnus-group gnus-undo nnmail mail-source gnus-start gnus-spec gnus-int gnus-range gnus-win gnus gnus-ems nnheader dvc-gnus tla-core tla-autoconf tla-defs dvc-log vc vc-dispatcher dvc-unified dvc-tips dired-x ediff-merg ediff-diff ediff-wind ediff-help ediff-util ediff-mult ediff-init ediff dvc-autoloads dvc-core dvc-lisp dvc-buffers dvc-ui dvc-register dvc-utils dvc-emacs ewoc dvc-defs dvc-site psvn log-edit pcvs-util add-log diff-mode htmlize-hack htmlize muse-colors muse-docbook muse-texinfo texnfo-upd texinfo muse-latex muse-html muse-xml-common muse-wiki cus-edit cus-start cus-load muse-publish muse-project muse-protocols muse-regexps muse muse-nested-tags muse-mode muse-autoloads org-config-thierry org-crypt cal-china lunar solar cal-dst cal-bahai cal-islam cal-hebrew holidays hol-loaddefs vc-hg org-wl org-w3m org-vm org-rmail org-mhe org-mew org-irc org-jsinfo org-infojs org-html org-exp ob-exp org-exp-blocks org-info org-gnus org-docview org-bibtex org-bbdb org-agenda appt diary-lib diary-loaddefs org-annotation-helper org-capture org-mks remember org-remember org-datetree config-w3m mime-w3m w3m doc-view jka-compr image-mode timezone w3m-hist w3m-fb w3m-ems w3m-ccl ccl w3m-favicon w3m-image w3m-proc w3m-util mime eword-decode mel path-util mime-parse std11 luna mime-def alist mcharset mcs-20 mcs-e20 pces pces-e20 pces-20 broken pcustom poe pym static apel-ver product w3m-load addressbook-bookmark message rfc822 mml mml-sec mm-decode mm-bodies mm-encode mail-parse rfc2231 rfc2047 rfc2045 ietf-drums mailabbrev mail-utils gmm-utils mailheader firefox-protocol bookmark-uzbl-handler bookmark-firefox-handler bookmark-extensions org ob-emacs-lisp ob-tangle ob-ref ob-lob ob-table org-footnote org-src ob-comint ob-keys ob ob-eval org-complete org-list org-faces org-compat org-entities org-macs noutline outline cal-menu calendar cal-loaddefs bookmark pp recentf tree-widget wid-edit savehist init-anything-thierry descbinds-anything anything-ipython ipython python-mode info-look ansi-color executable shell pcomplete shell-history anything-complete anything-show-completion anything-obsolete anything-match-plugin anything-delicious anything-mercurial anything-stgit anything-config browse-url rx xml url url-proxy url-privacy url-expand url-methods url-history url-cookie url-util url-parse url-vars mailcap grep compile comint ring tramp tramp-compat format-spec tramp-loaddefs dired-aux ffap thingatpt anything warnings epa-file epa derived epg epg-config auth-source eieio byte-opt bytecomp byte-compile cconv macroexp assoc gnus-util time-date mm-util mail-prsvr password-cache dired regexp-opt usage-memo punycode idna naquadah-theme eev-thierry edmacro kmacro iterator eev-all eev-mini-steps eev-browse-url eev-langs eev-compose eev-glyphs disp-table eev-insert eev-steps eev-bounded eev easy-mmode advice help-fns advice-preload w3m-wget preview-latex tex-site auto-loads info easymenu cl tooltip ediff-hook vc-hooks lisp-float-type mwheel x-win x-dnd tool-bar dnd fontset image fringe lisp-mode register page menu-bar rfn-eshadow timer select scroll-bar mouse jit-lock font-lock syntax facemenu font-core frame cham georgian utf-8-lang misc-lang vietnamese tibetan thai tai-viet lao korean japanese hebrew greek romanian slovak czech european ethiopic indian cyrillic chinese case-table epa-hook jka-cmpr-hook help simple abbrev minibuffer loaddefs button faces cus-face files text-properties overlay sha1 md5 base64 format env code-pages mule custom widget hashtable-print-readable backquote make-network-process dbusbind dynamic-setting system-font-setting font-render-setting move-toolbar gtk x-toolkit x multi-tty emacs) -- A+ Thierry Get my Gnupg key: gpg --keyserver pgp.mit.edu --recv-keys 59F29997 From unknown Sat Jun 14 18:58:21 2025 X-Loop: help-debbugs@gnu.org Subject: bug#9115: 24.0.50; `documentation' should not return args list for CL defun*. Resent-From: Leo Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 18 Jul 2011 06:25: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: To: Thierry Volpiatto Cc: 9115@debbugs.gnu.org Reply-To: 9115@debbugs.gnu.org Received: via spool by 9115-submit@debbugs.gnu.org id=B9115.13109702755707 (code B ref 9115); Mon, 18 Jul 2011 06:25:02 +0000 Received: (at 9115) by debbugs.gnu.org; 18 Jul 2011 06:24:35 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QihFr-0001U0-JK for submit@debbugs.gnu.org; Mon, 18 Jul 2011 02:24:35 -0400 Received: from mail-iw0-f172.google.com ([209.85.214.172]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QihFp-0001Tm-9q for 9115@debbugs.gnu.org; Mon, 18 Jul 2011 02:24:34 -0400 Received: by iwn39 with SMTP id 39so2656071iwn.3 for <9115@debbugs.gnu.org>; Sun, 17 Jul 2011 23:24:27 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=from:to:cc:subject:references:reply-to:date:in-reply-to:message-id :user-agent:mime-version:content-type; bh=tXDhVVrygUDNuagfnSiQgfQOHL04JsO0+0rd/Gh9SWI=; b=qVFCUzbScSsjz8Xmf7FlhB+i+VHtao0ezUS1W0O7JsaLvXpJPM4riu1nesRr6HqVHE 15zzQEuzuF5CTEQnK/NN+cv1Xiea+kUFHB7FaMmKyNoFjAEm1mFlhrv1ybsp0rsuDfUT uKwavV3324UeUxFYu946NQF6XiWM44/w7U0Io= Received: by 10.42.162.194 with SMTP id z2mr6839559icx.79.1310970267589; Sun, 17 Jul 2011 23:24:27 -0700 (PDT) Received: from localhost ([114.247.10.75]) by mx.google.com with ESMTPS id hq1sm4553287icc.2.2011.07.17.23.24.24 (version=TLSv1/SSLv3 cipher=OTHER); Sun, 17 Jul 2011 23:24:27 -0700 (PDT) From: Leo References: <87zkkcktst.fsf@gmail.com> Date: Mon, 18 Jul 2011 14:24:19 +0800 In-Reply-To: <87zkkcktst.fsf@gmail.com> (Thierry Volpiatto's message of "Mon, 18 Jul 2011 08:05:22 +0200") Message-ID: User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.3.50 (Mac OS X 10.6.8) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -3.9 (---) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -3.9 (---) On 2011-07-18 14:05 +0800, Thierry Volpiatto wrote: > documentation return the list of arg for the defun*'s:(choose a short one) > > (documentation 'ert--remove*) > "Does not support all the keywords of remove*. > > (fn X LIST &key KEY TEST)" > > It's annoying for function not documented because it return only list of > args instead or returning nil. Check the expansion of defun*; it always has a doc-string. Leo From unknown Sat Jun 14 18:58:21 2025 X-Loop: help-debbugs@gnu.org Subject: bug#9115: 24.0.50; `documentation' should not return args list for CL defun*. 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: Mon, 18 Jul 2011 07:19:01 +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: To: 9115@debbugs.gnu.org Received: via spool by 9115-submit@debbugs.gnu.org id=B9115.131097351710270 (code B ref 9115); Mon, 18 Jul 2011 07:19:01 +0000 Received: (at 9115) by debbugs.gnu.org; 18 Jul 2011 07:18:37 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Qii68-0002fa-E9 for submit@debbugs.gnu.org; Mon, 18 Jul 2011 03:18:36 -0400 Received: from mail-ww0-f46.google.com ([74.125.82.46]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Qii65-0002fO-Nv for 9115@debbugs.gnu.org; Mon, 18 Jul 2011 03:18:34 -0400 Received: by wwf25 with SMTP id 25so2717984wwf.15 for <9115@debbugs.gnu.org>; Mon, 18 Jul 2011 00:18:28 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=from:to:subject:references:date:in-reply-to:message-id:user-agent :mime-version:content-type; bh=KaXG/yOIuy4osiPbYBm9i/Ktj3FP3MQWnjsCu7BGWQA=; b=JED4V1iubG+W5q15mSlD7cicE+NAsYL0PsvcmYYCTxDtsvVx3RC42skMXauzqrcdCO 1lPJFQGlIeLMrHNJqFlF2hdVM+KJA/8ColgBhypC+wliWlXTYGaWqYlRf3Snq7cw4iOe BoqI1O3PTbMTyHYaPXZ3bvphX/NKS585CXnAc= Received: by 10.227.2.199 with SMTP id 7mr5278451wbk.88.1310973507869; Mon, 18 Jul 2011 00:18:27 -0700 (PDT) Received: from thierry-MM061 (43.77.197.77.rev.sfr.net [77.197.77.43]) by mx.google.com with ESMTPS id ff6sm3199207wbb.32.2011.07.18.00.18.25 (version=TLSv1/SSLv3 cipher=OTHER); Mon, 18 Jul 2011 00:18:26 -0700 (PDT) From: Thierry Volpiatto References: <87zkkcktst.fsf@gmail.com> Date: Mon, 18 Jul 2011 09:18:23 +0200 In-Reply-To: (Leo's message of "Mon, 18 Jul 2011 14:24:19 +0800") Message-ID: <87hb6k12gw.fsf@gmail.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -4.1 (----) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -4.1 (----) Leo writes: > On 2011-07-18 14:05 +0800, Thierry Volpiatto wrote: >> documentation return the list of arg for the defun*'s:(choose a short one) >> >> (documentation 'ert--remove*) >> "Does not support all the keywords of remove*. >> >> (fn X LIST &key KEY TEST)" >> >> It's annoying for function not documented because it return only list of >> args instead or returning nil. > > Check the expansion of defun*; it always has a doc-string. What expansion? if you have: --8<---------------cut here---------------start------------->8--- (defun* foo (&rest args) nil) (documentation 'foo) Give ==> " (fn &rest ARGS)" --8<---------------cut here---------------end--------------->8--- which is wrong. --8<---------------cut here---------------start------------->8--- (defun bar (&rest args) nil) (documentation 'bar) Give ==>nil --8<---------------cut here---------------end--------------->8--- Which is correct. -- A+ Thierry Get my Gnupg key: gpg --keyserver pgp.mit.edu --recv-keys 59F29997 From unknown Sat Jun 14 18:58:21 2025 X-Loop: help-debbugs@gnu.org Subject: bug#9115: 24.0.50; `documentation' should not return args list for CL defun*. Resent-From: Leo Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 18 Jul 2011 08:27: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: To: Thierry Volpiatto Cc: 9115@debbugs.gnu.org Reply-To: 9115@debbugs.gnu.org Received: via spool by 9115-submit@debbugs.gnu.org id=B9115.131097761815881 (code B ref 9115); Mon, 18 Jul 2011 08:27:02 +0000 Received: (at 9115) by debbugs.gnu.org; 18 Jul 2011 08:26:58 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QijAG-000486-Vc for submit@debbugs.gnu.org; Mon, 18 Jul 2011 04:26:57 -0400 Received: from mail-iy0-f172.google.com ([209.85.210.172]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QijAF-00047u-8b for 9115@debbugs.gnu.org; Mon, 18 Jul 2011 04:26:56 -0400 Received: by iye7 with SMTP id 7so2738821iye.3 for <9115@debbugs.gnu.org>; Mon, 18 Jul 2011 01:26:49 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=from:to:cc:subject:references:reply-to:date:in-reply-to:message-id :user-agent:mime-version:content-type; bh=bz1A5Im/5Z7mPWPGtE/LNUOLpJyF6Kqbn3Z0Ow+jSEU=; b=ujuXkbHogLLJvL1pcPF1b4WBFG0nrvea8LVc3tKaIr1V+mxX0RKYL8B4gr01C+15qS +JpFUvUjlkmFLNqvDoMii/xipxSpUdN9qrvCDFaVyJu0johtYOgmO5XdGsKcq9AKAGZE RuLbl18zJXWtH9p9J3NbOjivH+j3QP4h36zB0= Received: by 10.231.17.200 with SMTP id t8mr5593366iba.190.1310977609384; Mon, 18 Jul 2011 01:26:49 -0700 (PDT) Received: from localhost ([114.247.10.75]) by mx.google.com with ESMTPS id y3sm2763396ibc.3.2011.07.18.01.26.45 (version=TLSv1/SSLv3 cipher=OTHER); Mon, 18 Jul 2011 01:26:48 -0700 (PDT) From: Leo References: <87zkkcktst.fsf@gmail.com> <87hb6k12gw.fsf@gmail.com> Date: Mon, 18 Jul 2011 16:26:40 +0800 In-Reply-To: <87hb6k12gw.fsf@gmail.com> (Thierry Volpiatto's message of "Mon, 18 Jul 2011 09:18:23 +0200") Message-ID: User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.3.50 (Mac OS X 10.6.8) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -3.9 (---) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -3.9 (---) On 2011-07-18 15:18 +0800, Thierry Volpiatto wrote: > (defun* foo (&rest args) nil) > (documentation 'foo) > Give ==> > " > > (fn &rest ARGS)" (defun* foo (&rest args) nil) is equivalent to (defun foo (&rest args) "Not documented\n\n(fn &rest ARGS)" (let* nil (block foo nil))) Leo From unknown Sat Jun 14 18:58:21 2025 X-Loop: help-debbugs@gnu.org Subject: bug#9115: 24.0.50; `documentation' should not return args list for CL defun*. 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: Mon, 18 Jul 2011 08:35:01 +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: To: 9115@debbugs.gnu.org Received: via spool by 9115-submit@debbugs.gnu.org id=B9115.131097809716581 (code B ref 9115); Mon, 18 Jul 2011 08:35:01 +0000 Received: (at 9115) by debbugs.gnu.org; 18 Jul 2011 08:34:57 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QijI0-0004JN-EU for submit@debbugs.gnu.org; Mon, 18 Jul 2011 04:34:56 -0400 Received: from mail-wy0-f172.google.com ([74.125.82.172]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QijHy-0004JB-A4 for 9115@debbugs.gnu.org; Mon, 18 Jul 2011 04:34:55 -0400 Received: by wyj26 with SMTP id 26so1956013wyj.3 for <9115@debbugs.gnu.org>; Mon, 18 Jul 2011 01:34:48 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=from:to:subject:references:date:in-reply-to:message-id:user-agent :mime-version:content-type; bh=h9TjYwnQiFnIKqdvT2FSqoxKBekYNB4sgHzsr5GYdUw=; b=JPCXINLUfu59zyR/0B0250tAoUrmS2VguB3uuH7bNXRv41M7/caDUQPHGroja18Lct plBtifg9iyIiUUkxrcEcXcCkDIpLzQd2cJkQICexVwXihpWPhjQtK4pUq9CRNt7K3SNF 3S8gzuvBcrH12QqPizHlrPSK7LjvCATXdNs+U= Received: by 10.216.8.204 with SMTP id 54mr5009357wer.92.1310978087819; Mon, 18 Jul 2011 01:34:47 -0700 (PDT) Received: from thierry-MM061 (43.77.197.77.rev.sfr.net [77.197.77.43]) by mx.google.com with ESMTPS id q20sm2173421wec.17.2011.07.18.01.34.46 (version=TLSv1/SSLv3 cipher=OTHER); Mon, 18 Jul 2011 01:34:47 -0700 (PDT) From: Thierry Volpiatto References: <87zkkcktst.fsf@gmail.com> <87hb6k12gw.fsf@gmail.com> Date: Mon, 18 Jul 2011 10:34:44 +0200 In-Reply-To: (Leo's message of "Mon, 18 Jul 2011 16:26:40 +0800") Message-ID: <87d3h80yxn.fsf@gmail.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -4.1 (----) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -4.1 (----) Leo writes: > On 2011-07-18 15:18 +0800, Thierry Volpiatto wrote: >> (defun* foo (&rest args) nil) >> (documentation 'foo) >> Give ==> >> " >> >> (fn &rest ARGS)" > > (defun* foo (&rest args) nil) is equivalent to > > (defun foo > (&rest args) > "Not documented\n\n(fn &rest ARGS)" > (let* nil > (block foo nil))) So it should return: "Not documented (fn &rest ARGS)" -- A+ Thierry Get my Gnupg key: gpg --keyserver pgp.mit.edu --recv-keys 59F29997 From unknown Sat Jun 14 18:58:21 2025 X-Loop: help-debbugs@gnu.org Subject: bug#9115: 24.0.50; `documentation' should not return args list for CL defun*. Resent-From: Stefan Monnier Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 18 Jul 2011 16:03: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: To: Thierry Volpiatto Cc: 9115@debbugs.gnu.org Received: via spool by 9115-submit@debbugs.gnu.org id=B9115.131100495626139 (code B ref 9115); Mon, 18 Jul 2011 16:03:02 +0000 Received: (at 9115) by debbugs.gnu.org; 18 Jul 2011 16:02:36 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QiqHD-0006nY-Cl for submit@debbugs.gnu.org; Mon, 18 Jul 2011 12:02:35 -0400 Received: from ironport2-out.teksavvy.com ([206.248.154.181] helo=ironport2-out.pppoe.ca) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QiqHB-0006nL-Bv for 9115@debbugs.gnu.org; Mon, 18 Jul 2011 12:02:34 -0400 X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: Av0EAChYJE5MCqt8/2dsb2JhbABUp3d4iHzCZ4Y8BJ8nhDA X-IronPort-AV: E=Sophos;i="4.67,223,1309752000"; d="scan'208";a="126533519" Received: from 76-10-171-124.dsl.teksavvy.com (HELO ceviche.home) ([76.10.171.124]) by ironport2-out.pppoe.ca with ESMTP/TLS/ADH-AES256-SHA; 18 Jul 2011 12:02:27 -0400 Received: by ceviche.home (Postfix, from userid 20848) id 6667C6660D; Mon, 18 Jul 2011 12:02:26 -0400 (EDT) From: Stefan Monnier Message-ID: References: <87zkkcktst.fsf@gmail.com> Date: Mon, 18 Jul 2011 12:02:26 -0400 In-Reply-To: <87zkkcktst.fsf@gmail.com> (Thierry Volpiatto's message of "Mon, 18 Jul 2011 08:05:22 +0200") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -2.1 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.1 (--) > documentation return the list of arg for the defun*'s:(choose a short one) > --8<---------------cut here---------------start------------->8--- > (documentation 'ert--remove*) > "Does not support all the keywords of remove*. > (fn X LIST &key KEY TEST)" > --8<---------------cut here---------------end--------------->8--- > It's annoying for function not documented because it return only list of > args instead or returning nil. Yes, it's a bit inconvenient. But if you don't want the arglist, you should pass the output of documentation through help-split-fundoc. That should then return you the nil you're looking for. Stefan From unknown Sat Jun 14 18:58:21 2025 X-Loop: help-debbugs@gnu.org Subject: bug#9115: 24.0.50; `documentation' should not return args list for CL defun*. Resent-From: Andreas Schwab Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 18 Jul 2011 17:52:01 +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: To: Thierry Volpiatto Cc: 9115@debbugs.gnu.org Received: via spool by 9115-submit@debbugs.gnu.org id=B9115.13110115093399 (code B ref 9115); Mon, 18 Jul 2011 17:52:01 +0000 Received: (at 9115) by debbugs.gnu.org; 18 Jul 2011 17:51:49 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Qiryu-0000sl-DZ for submit@debbugs.gnu.org; Mon, 18 Jul 2011 13:51:48 -0400 Received: from mail-out.m-online.net ([212.18.0.9]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Qiryr-0000sV-Hp for 9115@debbugs.gnu.org; Mon, 18 Jul 2011 13:51:46 -0400 Received: from frontend1.mail.m-online.net (unknown [192.168.8.180]) by mail-out.m-online.net (Postfix) with ESMTP id DC89B1C01DBC; Mon, 18 Jul 2011 19:51:39 +0200 (CEST) Received: from localhost (dynscan1.mnet-online.de [192.168.8.164]) by mail.m-online.net (Postfix) with ESMTP id D2DE51C0008D; Mon, 18 Jul 2011 19:51:39 +0200 (CEST) X-Virus-Scanned: amavisd-new at mnet-online.de Received: from mail.mnet-online.de ([192.168.8.180]) by localhost (dynscan1.mail.m-online.net [192.168.8.164]) (amavisd-new, port 10024) with ESMTP id 1nH0awNvzPNB; Mon, 18 Jul 2011 19:51:39 +0200 (CEST) Received: from igel.home (ppp-88-217-110-34.dynamic.mnet-online.de [88.217.110.34]) by mail.mnet-online.de (Postfix) with ESMTP; Mon, 18 Jul 2011 19:51:39 +0200 (CEST) Received: by igel.home (Postfix, from userid 501) id 337F2CA293; Mon, 18 Jul 2011 19:51:39 +0200 (CEST) From: Andreas Schwab References: <87zkkcktst.fsf@gmail.com> <87hb6k12gw.fsf@gmail.com> X-Yow: .. hubub, hubub, HUBUB, hubub, hubub, hubub, HUBUB, hubub, hubub, hubub. Date: Mon, 18 Jul 2011 19:51:39 +0200 In-Reply-To: <87hb6k12gw.fsf@gmail.com> (Thierry Volpiatto's message of "Mon, 18 Jul 2011 09:18:23 +0200") Message-ID: User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.3 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Spam-Score: -2.6 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.6 (--) Thierry Volpiatto writes: > (defun* foo (&rest args) nil) > (documentation 'foo) > Give ==> > " > > (fn &rest ARGS)" > > which is wrong. Why is that wrong? You need the signature to properly display the original argument list. Andreas. -- Andreas Schwab, schwab@linux-m68k.org GPG Key fingerprint = 58CA 54C7 6D53 942B 1756 01D3 44D5 214B 8276 4ED5 "And now for something completely different." From unknown Sat Jun 14 18:58:21 2025 X-Loop: help-debbugs@gnu.org Subject: bug#9115: 24.0.50; `documentation' should not return args list for CL defun*. 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: Tue, 19 Jul 2011 06:07: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: To: Stefan Monnier Cc: 9115@debbugs.gnu.org Received: via spool by 9115-submit@debbugs.gnu.org id=B9115.13110556134353 (code B ref 9115); Tue, 19 Jul 2011 06:07:02 +0000 Received: (at 9115) by debbugs.gnu.org; 19 Jul 2011 06:06:53 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Qj3SG-00018A-LV for submit@debbugs.gnu.org; Tue, 19 Jul 2011 02:06:53 -0400 Received: from mail-wy0-f172.google.com ([74.125.82.172]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Qj3SE-00017v-Dy for 9115@debbugs.gnu.org; Tue, 19 Jul 2011 02:06:51 -0400 Received: by wyj26 with SMTP id 26so2586792wyj.3 for <9115@debbugs.gnu.org>; Mon, 18 Jul 2011 23:06:44 -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=br6GCQMETTA3XkKboLLcjSF2QpEpkKONQ2vJ9O/0g90=; b=mMZFqKOXwYswT2ssxoHDPqDbAROila/ywjZbcLtdm53WeVrGwWuJem67oL/aekog5V 4C1AX6h4cTGmhHTOaarPUxwg47kFN1qwlA/WF1I2HW0wOIePcJ2TCbPeWuqIpq8wHV4I 8WQtMqTxxc/HblafzG4G7zPZVGSUQecajXSXw= Received: by 10.227.55.67 with SMTP id t3mr6133889wbg.90.1311055604541; Mon, 18 Jul 2011 23:06:44 -0700 (PDT) Received: from thierry-MM061 (43.77.197.77.rev.sfr.net [77.197.77.43]) by mx.google.com with ESMTPS id fx12sm4053109wbb.25.2011.07.18.23.06.41 (version=TLSv1/SSLv3 cipher=OTHER); Mon, 18 Jul 2011 23:06:42 -0700 (PDT) From: Thierry Volpiatto References: <87zkkcktst.fsf@gmail.com> Date: Tue, 19 Jul 2011 08:06:39 +0200 In-Reply-To: (Stefan Monnier's message of "Mon, 18 Jul 2011 12:02:26 -0400") Message-ID: <87tyaiiz2o.fsf@gmail.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -4.1 (----) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -4.1 (----) Hello, Stefan Monnier writes: >> documentation return the list of arg for the defun*'s:(choose a short one) > >> --8<---------------cut here---------------start------------->8--- >> (documentation 'ert--remove*) >> "Does not support all the keywords of remove*. > >> (fn X LIST &key KEY TEST)" >> --8<---------------cut here---------------end--------------->8--- > >> It's annoying for function not documented because it return only list of >> args instead or returning nil. > > Yes, it's a bit inconvenient. But if you don't want the arglist, you > should pass the output of documentation through help-split-fundoc. > That should then return you the nil you're looking for. The cdr of help-split-fundoc return nil as expected for functions, CL-style function, but always nil for macros even if they are documented. Thus the docstring seem wrong, as it say it return nil if not documented, which is wrong because it return a one arg list in this case. I had expected documentation has the same behavior for functions, CL-style functions, and macros. And it seem describe-function-1 is a long function that have to deal with these inconveniences. -- A+ Thierry Get my Gnupg key: gpg --keyserver pgp.mit.edu --recv-keys 59F29997 From unknown Sat Jun 14 18:58:21 2025 X-Loop: help-debbugs@gnu.org Subject: bug#9115: 24.0.50; `documentation' should not return args list for CL defun*. Resent-From: Stefan Monnier Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 01 Aug 2011 21:34: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: To: Thierry Volpiatto Cc: 9115@debbugs.gnu.org Received: via spool by 9115-submit@debbugs.gnu.org id=B9115.131223442430387 (code B ref 9115); Mon, 01 Aug 2011 21:34:02 +0000 Received: (at 9115) by debbugs.gnu.org; 1 Aug 2011 21:33:44 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Qo07M-0007u3-GM for submit@debbugs.gnu.org; Mon, 01 Aug 2011 17:33:44 -0400 Received: from relais.videotron.ca ([24.201.245.36]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Qo07K-0007tw-G2 for 9115@debbugs.gnu.org; Mon, 01 Aug 2011 17:33:43 -0400 MIME-version: 1.0 Content-transfer-encoding: 7BIT Content-type: text/plain; CHARSET=US-ASCII Received: from ceviche.home ([96.22.109.87]) by vl-mo-mrz23.ip.videotron.ca (Sun Java(tm) System Messaging Server 6.3-8.01 (built Dec 16 2008; 32bit)) with ESMTP id <0LP9002D8QI0O751@vl-mo-mrz23.ip.videotron.ca> for 9115@debbugs.gnu.org; Mon, 01 Aug 2011 17:32:24 -0400 (EDT) Received: by ceviche.home (Postfix, from userid 20848) id 4C512660CF; Mon, 01 Aug 2011 17:33:17 -0400 (EDT) From: Stefan Monnier Message-id: References: <87zkkcktst.fsf@gmail.com> <87tyaiiz2o.fsf@gmail.com> Date: Mon, 01 Aug 2011 17:33:17 -0400 In-reply-to: <87tyaiiz2o.fsf@gmail.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.50 (gnu/linux) X-Spam-Score: -2.8 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.7 (--) >> Yes, it's a bit inconvenient. But if you don't want the arglist, you >> should pass the output of documentation through help-split-fundoc. >> That should then return you the nil you're looking for. > The cdr of help-split-fundoc return nil as expected for functions, CL-style > function, but always nil for macros even if they are documented. Hmm... I don't understand: help-split-fundoc doesn't care if the docstring comes from a function, a macro, or a mushroom. Or maybe I don't understand what you're saying. Can you show some detail of what you do? Stefan From unknown Sat Jun 14 18:58:21 2025 X-Loop: help-debbugs@gnu.org Subject: bug#9115: 24.0.50; `documentation' should not return args list for CL defun*. 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: Tue, 02 Aug 2011 05:22: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: To: Stefan Monnier Cc: 9115@debbugs.gnu.org Received: via spool by 9115-submit@debbugs.gnu.org id=B9115.131226250911865 (code B ref 9115); Tue, 02 Aug 2011 05:22:02 +0000 Received: (at 9115) by debbugs.gnu.org; 2 Aug 2011 05:21:49 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Qo7QL-00035K-0h for submit@debbugs.gnu.org; Tue, 02 Aug 2011 01:21:49 -0400 Received: from mail-wy0-f172.google.com ([74.125.82.172]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Qo7QI-00035C-Og for 9115@debbugs.gnu.org; Tue, 02 Aug 2011 01:21:47 -0400 Received: by wyj26 with SMTP id 26so2080749wyj.3 for <9115@debbugs.gnu.org>; Mon, 01 Aug 2011 22:21:20 -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=jrsZbKTz07n00NWQ3lbOCzB5tYk3965372nzhiUhiqo=; b=RqhuZuW2YBmDIuz3Cv12W9H4dmgHlhQvOOkVodez2gHLpMgmHjmMR5FLubWmEEy1SC LtppbvSQa+BMKkrPNbgp3uGWh1jPmhUUszDAdyPRTQK+NxXmY9zhYLDOwsTuqiyymDFA zVBD0jKIX02eXnSLp6Cmdp3+NOC9uWeSgo+zw= Received: by 10.227.151.196 with SMTP id d4mr7134122wbw.102.1312262479958; Mon, 01 Aug 2011 22:21:19 -0700 (PDT) Received: from thierry-MM061 (82.211.85.79.rev.sfr.net [79.85.211.82]) by mx.google.com with ESMTPS id fn12sm4716612wbb.4.2011.08.01.22.21.17 (version=TLSv1/SSLv3 cipher=OTHER); Mon, 01 Aug 2011 22:21:18 -0700 (PDT) From: Thierry Volpiatto References: <87zkkcktst.fsf@gmail.com> <87tyaiiz2o.fsf@gmail.com> Date: Tue, 02 Aug 2011 07:21:15 +0200 In-Reply-To: (Stefan Monnier's message of "Mon, 01 Aug 2011 17:33:17 -0400") Message-ID: <87ipqgv16c.fsf@gmail.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -4.3 (----) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -4.3 (----) Stefan Monnier writes: >>> Yes, it's a bit inconvenient. But if you don't want the arglist, you >>> should pass the output of documentation through help-split-fundoc. >>> That should then return you the nil you're looking for. >> The cdr of help-split-fundoc return nil as expected for functions, CL-style >> function, but always nil for macros even if they are documented. > > Hmm... I don't understand: help-split-fundoc doesn't care if the > docstring comes from a function, a macro, or a mushroom. Or maybe > I don't understand what you're saying. Can you show some detail of what > you do? --8<---------------cut here---------------start------------->8--- (defun* foo (&rest args) nil) (help-split-fundoc (documentation 'foo) nil) =>("(nil &rest ARGS)") (defun bar (&rest args) nil) (help-split-fundoc (documentation 'bar) nil) =>nil (defmacro foo-1 (&rest args) "some doc." nil) (help-split-fundoc (documentation 'foo-1) nil) nil --8<---------------cut here---------------end--------------->8--- But same here, it's ok i finally parse myself th output of documentation to extract the first line, it works fine.(so i don't use help-split-fundoc) -- A+ Thierry Get my Gnupg key: gpg --keyserver pgp.mit.edu --recv-keys 59F29997 From unknown Sat Jun 14 18:58:21 2025 X-Loop: help-debbugs@gnu.org Subject: bug#9115: 24.0.50; `documentation' should not return args list for CL defun*. Resent-From: Stefan Monnier Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 02 Aug 2011 19:17:01 +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: To: Thierry Volpiatto Cc: 9115@debbugs.gnu.org Received: via spool by 9115-submit@debbugs.gnu.org id=B9115.13123126115839 (code B ref 9115); Tue, 02 Aug 2011 19:17:01 +0000 Received: (at 9115) by debbugs.gnu.org; 2 Aug 2011 19:16:51 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QoKSR-0001W8-IX for submit@debbugs.gnu.org; Tue, 02 Aug 2011 15:16:51 -0400 Received: from relais.videotron.ca ([24.201.245.36]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QoKSP-0001W1-Ta for 9115@debbugs.gnu.org; Tue, 02 Aug 2011 15:16:50 -0400 MIME-version: 1.0 Content-transfer-encoding: 7BIT Content-type: text/plain; CHARSET=US-ASCII Received: from ceviche.home ([70.80.89.35]) by vl-mo-mrz23.ip.videotron.ca (Sun Java(tm) System Messaging Server 6.3-8.01 (built Dec 16 2008; 32bit)) with ESMTP id <0LPB0086JETPET00@vl-mo-mrz23.ip.videotron.ca> for 9115@debbugs.gnu.org; Tue, 02 Aug 2011 15:15:25 -0400 (EDT) Received: by ceviche.home (Postfix, from userid 20848) id CF069660CF; Tue, 02 Aug 2011 15:16:19 -0400 (EDT) From: Stefan Monnier Message-id: References: <87zkkcktst.fsf@gmail.com> <87tyaiiz2o.fsf@gmail.com> <87ipqgv16c.fsf@gmail.com> Date: Tue, 02 Aug 2011 15:16:19 -0400 In-reply-to: <87ipqgv16c.fsf@gmail.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.50 (gnu/linux) X-Spam-Score: -2.0 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.0 (--) > (defun* foo (&rest args) nil) > (help-split-fundoc (documentation 'foo) nil) > =>("(nil &rest ARGS)") > (defun bar (&rest args) nil) > (help-split-fundoc (documentation 'bar) nil) > =>nil > (defmacro foo-1 (&rest args) "some doc." nil) > (help-split-fundoc (documentation 'foo-1) nil) > nil Right, as explained in help-split-fundoc's docstring: Return (USAGE . DOC) or nil if there's no usage info. So if you just want the docstring, you'll need something like (let ((doc (documentation bidule))) (or (cdr (help-split-fundoc doc nil)) doc)) I agree this is not super convenient. Stefan From unknown Sat Jun 14 18:58:21 2025 X-Loop: help-debbugs@gnu.org Subject: bug#9115: 24.0.50; `documentation' should not return args list for CL defun*. 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: Tue, 02 Aug 2011 19:45: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: To: Stefan Monnier Cc: 9115@debbugs.gnu.org Received: via spool by 9115-submit@debbugs.gnu.org id=B9115.13123142688334 (code B ref 9115); Tue, 02 Aug 2011 19:45:02 +0000 Received: (at 9115) by debbugs.gnu.org; 2 Aug 2011 19:44:28 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QoKtA-0002AM-9I for submit@debbugs.gnu.org; Tue, 02 Aug 2011 15:44:28 -0400 Received: from mail-ww0-f46.google.com ([74.125.82.46]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QoKt7-0002AD-1V for 9115@debbugs.gnu.org; Tue, 02 Aug 2011 15:44:26 -0400 Received: by wwf25 with SMTP id 25so122512wwf.15 for <9115@debbugs.gnu.org>; Tue, 02 Aug 2011 12:43:54 -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=0+x2kx2Uo9hEJ6u+WrvQW6GD5evt7+po1UoObNgARRs=; b=cHN8nxnlPVdKab9Iu0j7ntPkNBWjJQL7G91nOE7/WAO6GrJ/fYLkAKt0HZ/3heYWyY 8mcRH7zzrlVM1csJzWUmrMvXiM8Ddj5UP+YBUaYVadNkNJ7VMswjsVtIDT9lsBBnWZcG 1Gnm1vOgjk+fzJrebMZI4Z7rmA41gl0Sz43Ok= Received: by 10.227.12.18 with SMTP id v18mr7548861wbv.89.1312314234718; Tue, 02 Aug 2011 12:43:54 -0700 (PDT) Received: from thierry-MM061 (194.78.88.79.rev.sfr.net [79.88.78.194]) by mx.google.com with ESMTPS id o19sm65563wbh.43.2011.08.02.12.43.50 (version=TLSv1/SSLv3 cipher=OTHER); Tue, 02 Aug 2011 12:43:51 -0700 (PDT) From: Thierry Volpiatto References: <87zkkcktst.fsf@gmail.com> <87tyaiiz2o.fsf@gmail.com> <87ipqgv16c.fsf@gmail.com> Date: Tue, 02 Aug 2011 21:43:43 +0200 In-Reply-To: (Stefan Monnier's message of "Tue, 02 Aug 2011 15:16:19 -0400") Message-ID: <87bow7r440.fsf@gmail.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -4.1 (----) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -4.0 (----) Stefan Monnier writes: >> (defun* foo (&rest args) nil) >> (help-split-fundoc (documentation 'foo) nil) >> =>("(nil &rest ARGS)") > >> (defun bar (&rest args) nil) >> (help-split-fundoc (documentation 'bar) nil) >> =>nil > >> (defmacro foo-1 (&rest args) "some doc." nil) >> (help-split-fundoc (documentation 'foo-1) nil) >> nil > > Right, as explained in help-split-fundoc's docstring: > > Return (USAGE . DOC) or nil if there's no usage info. > > So if you just want the docstring, you'll need something like > > (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. What i wanted was return only the first line of docstring or nil or "not documented" if no docstring. (to display in mode-line when completing lisp symbols) Here what i use finally: #+BEGIN_SRC lisp (defun anything-c-get-first-line-documentation (sym) "Return first line documentation of symbol SYM. If SYM is not documented, return \"Not documented\"." (let ((doc (cond ((fboundp sym) (documentation sym t)) ((boundp sym) (documentation-property sym 'variable-documentation t)) ((facep sym) (face-documentation sym)) (t nil)))) (if (and doc (not (string= doc "")) ;; `documentation' return "\n\n(args...)" ;; for CL-style functions. (not (string-match-p "^\n\n" doc))) (car (split-string doc "\n")) "Not documented"))) #+END_SRC -- A+ Thierry Get my Gnupg key: gpg --keyserver pgp.mit.edu --recv-keys 59F29997 From unknown Sat Jun 14 18:58:21 2025 X-Loop: help-debbugs@gnu.org Subject: bug#9115: 24.0.50; `documentation' should not return args list for CL defun*. Resent-From: Stefan Monnier Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 02 Aug 2011 20:33:01 +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: To: Thierry Volpiatto Cc: 9115@debbugs.gnu.org Received: via spool by 9115-submit@debbugs.gnu.org id=B9115.131231715216170 (code B ref 9115); Tue, 02 Aug 2011 20:33:01 +0000 Received: (at 9115) by debbugs.gnu.org; 2 Aug 2011 20:32:32 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QoLdf-0004Cl-Kg for submit@debbugs.gnu.org; Tue, 02 Aug 2011 16:32:31 -0400 Received: from ironport2-out.teksavvy.com ([206.248.154.183] helo=ironport2-out.pppoe.ca) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QoLde-0004Ce-28 for 9115@debbugs.gnu.org; Tue, 02 Aug 2011 16:32:30 -0400 X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: Av0EAG1eOE5FxKfe/2dsb2JhbABCp2d4gUABAQVWIxALNBIUGA0kyBWGQgSfSoQx X-IronPort-AV: E=Sophos;i="4.67,307,1309752000"; d="scan'208";a="128462879" Received: from 69-196-167-222.dsl.teksavvy.com (HELO ceviche.home) ([69.196.167.222]) by ironport2-out.pppoe.ca with ESMTP/TLS/ADH-AES256-SHA; 02 Aug 2011 16:31:59 -0400 Received: by ceviche.home (Postfix, from userid 20848) id 41605660CF; Tue, 2 Aug 2011 16:31:59 -0400 (EDT) From: Stefan Monnier Message-ID: References: <87zkkcktst.fsf@gmail.com> <87tyaiiz2o.fsf@gmail.com> <87ipqgv16c.fsf@gmail.com> <87bow7r440.fsf@gmail.com> Date: Tue, 02 Aug 2011 16:31:59 -0400 In-Reply-To: <87bow7r440.fsf@gmail.com> (Thierry Volpiatto's message of "Tue, 02 Aug 2011 21:43:43 +0200") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -2.1 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.1 (--) >> (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. So if you want the first line, just extract it from the output when it's not nil. Stefan From unknown Sat Jun 14 18:58:21 2025 X-Loop: help-debbugs@gnu.org Subject: bug#9115: 24.0.50; `documentation' should not return args list for CL defun*. 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: Tue, 02 Aug 2011 20:51:01 +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: To: Stefan Monnier Cc: 9115@debbugs.gnu.org Received: via spool by 9115-submit@debbugs.gnu.org id=B9115.131231825617944 (code B ref 9115); Tue, 02 Aug 2011 20:51:01 +0000 Received: (at 9115) by debbugs.gnu.org; 2 Aug 2011 20:50:56 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QoLvT-0004fN-Nm for submit@debbugs.gnu.org; Tue, 02 Aug 2011 16:50:56 -0400 Received: from mail-wy0-f172.google.com ([74.125.82.172]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QoLvR-0004fF-BH for 9115@debbugs.gnu.org; Tue, 02 Aug 2011 16:50:54 -0400 Received: by wyj26 with SMTP id 26so130793wyj.3 for <9115@debbugs.gnu.org>; Tue, 02 Aug 2011 13:50:22 -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=vsX9lM1rVzz5m9vcazzEPK4t2sl4l3Auou/KydleHDI=; b=dh/ed0II+Crum8JJEGzBeSCzPyqLWYGaIIOEmrqOSY1e1zaiXtb9eoMJwbL6rMhplj iU/sbFgCL2JM6gbs2gXEWz6FPDP8v7a0zIjclG0lFKb+ywFvM8Ppuxbp23ldo+bqoSlO G/2gqSh1AKQWeM2b/Fxp4GJh938wpMsjcg+iw= Received: by 10.216.82.146 with SMTP id o18mr2240404wee.7.1312318222756; Tue, 02 Aug 2011 13:50:22 -0700 (PDT) Received: from thierry-MM061 (194.78.88.79.rev.sfr.net [79.88.78.194]) by mx.google.com with ESMTPS id j54sm88930wed.47.2011.08.02.13.50.20 (version=TLSv1/SSLv3 cipher=OTHER); Tue, 02 Aug 2011 13:50:21 -0700 (PDT) From: Thierry Volpiatto References: <87zkkcktst.fsf@gmail.com> <87tyaiiz2o.fsf@gmail.com> <87ipqgv16c.fsf@gmail.com> <87bow7r440.fsf@gmail.com> Date: Tue, 02 Aug 2011 22:50:18 +0200 In-Reply-To: (Stefan Monnier's message of "Tue, 02 Aug 2011 16:31:59 -0400") Message-ID: <8739hjr111.fsf@gmail.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -4.0 (----) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -4.0 (----) 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) (defun* foo (&rest args) nil) => "nil (&rest args)" and for most not documented CL-style functions: => "\n\n (args...)" But neither nil, empty string or "not documented". See comment in function i sent. > So if you want the first line, just extract it from the output when it's > not nil. Problem it's not non--nil.(except for elisp function of course) -- A+ Thierry Get my Gnupg key: gpg --keyserver pgp.mit.edu --recv-keys 59F29997 From unknown Sat Jun 14 18:58:21 2025 X-Loop: help-debbugs@gnu.org Subject: bug#9115: 24.0.50; `documentation' should not return args list for CL defun*. Resent-From: Stefan Monnier 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 01:18: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: To: Thierry Volpiatto Cc: 9115@debbugs.gnu.org Received: via spool by 9115-submit@debbugs.gnu.org id=B9115.13123342438592 (code B ref 9115); Wed, 03 Aug 2011 01:18:02 +0000 Received: (at 9115) by debbugs.gnu.org; 3 Aug 2011 01:17:23 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QoQ5L-0002EW-Fn for submit@debbugs.gnu.org; Tue, 02 Aug 2011 21:17:23 -0400 Received: from ironport2-out.teksavvy.com ([206.248.154.183] helo=ironport2-out.pppoe.ca) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QoQ5J-0002EP-5T for 9115@debbugs.gnu.org; Tue, 02 Aug 2011 21:17:21 -0400 X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: Av0EADuhOE5FxKfe/2dsb2JhbABCp1l4gUABAQVWIxALNBIUGA0kxkiGQgSfSoQx X-IronPort-AV: E=Sophos;i="4.67,307,1309752000"; d="scan'208";a="128495921" Received: from 69-196-167-222.dsl.teksavvy.com (HELO ceviche.home) ([69.196.167.222]) by ironport2-out.pppoe.ca with ESMTP/TLS/ADH-AES256-SHA; 02 Aug 2011 21:16:49 -0400 Received: by ceviche.home (Postfix, from userid 20848) id 5EC8F660CF; Tue, 2 Aug 2011 21:16:49 -0400 (EDT) From: Stefan Monnier Message-ID: References: <87zkkcktst.fsf@gmail.com> <87tyaiiz2o.fsf@gmail.com> <87ipqgv16c.fsf@gmail.com> <87bow7r440.fsf@gmail.com> <8739hjr111.fsf@gmail.com> Date: Tue, 02 Aug 2011 21:16:49 -0400 In-Reply-To: <8739hjr111.fsf@gmail.com> (Thierry Volpiatto's message of "Tue, 02 Aug 2011 22:50:18 +0200") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -2.1 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.1 (--) >>>> (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)) might work better. Still, you should be able to get the right code by reading the docstring and trying things out. -- Stefan From unknown Sat Jun 14 18:58:21 2025 X-Loop: help-debbugs@gnu.org Subject: bug#9115: 24.0.50; `documentation' should not return args list for CL defun*. 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: To: Stefan Monnier Cc: 9115@debbugs.gnu.org Received: via spool by 9115-submit@debbugs.gnu.org id=B9115.131234824628977 (code B ref 9115); Wed, 03 Aug 2011 05:11:02 +0000 Received: (at 9115) by debbugs.gnu.org; 3 Aug 2011 05:10:46 +0000 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 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 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= Received: by 10.216.162.211 with SMTP id y61mr2534730wek.19.1312348208169; Tue, 02 Aug 2011 22:10:08 -0700 (PDT) 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) From: Thierry Volpiatto References: <87zkkcktst.fsf@gmail.com> <87tyaiiz2o.fsf@gmail.com> <87ipqgv16c.fsf@gmail.com> <87bow7r440.fsf@gmail.com> <8739hjr111.fsf@gmail.com> Date: Wed, 03 Aug 2011 07:10:04 +0200 In-Reply-To: (Stefan Monnier's message of "Tue, 02 Aug 2011 21:16:49 -0400") Message-ID: <87ty9zozbn.fsf@gmail.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -4.0 (----) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -3.9 (---) 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 From unknown Sat Jun 14 18:58:21 2025 X-Loop: help-debbugs@gnu.org Subject: bug#9115: 24.0.50; `documentation' should not return args list for CL defun*. Resent-From: Stefan Monnier 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:32:01 +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: To: Thierry Volpiatto Cc: 9115@debbugs.gnu.org Received: via spool by 9115-submit@debbugs.gnu.org id=B9115.131238191718016 (code B ref 9115); Wed, 03 Aug 2011 14:32:01 +0000 Received: (at 9115) by debbugs.gnu.org; 3 Aug 2011 14:31:57 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QocUG-0004gW-N4 for submit@debbugs.gnu.org; Wed, 03 Aug 2011 10:31:56 -0400 Received: from ironport2-out.teksavvy.com ([206.248.154.183] helo=ironport2-out.pppoe.ca) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QocUE-0004gK-Bu; Wed, 03 Aug 2011 10:31:54 -0400 X-IronPort-Anti-Spam-Filtered: true X-IronPort-Anti-Spam-Result: Av0EAI1bOU5FxKfe/2dsb2JhbABCp194gUABAQQBViMFCws0EhQYDSSHf8EIhkIEn0qEMQ X-IronPort-AV: E=Sophos;i="4.67,310,1309752000"; d="scan'208";a="128535224" Received: from 69-196-167-222.dsl.teksavvy.com (HELO ceviche.home) ([69.196.167.222]) by ironport2-out.pppoe.ca with ESMTP/TLS/ADH-AES256-SHA; 03 Aug 2011 10:31:19 -0400 Received: by ceviche.home (Postfix, from userid 20848) id 3072D660CF; Wed, 3 Aug 2011 10:31:19 -0400 (EDT) From: Stefan Monnier Message-ID: 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> Date: Wed, 03 Aug 2011 10:31:19 -0400 In-Reply-To: <87ty9zozbn.fsf@gmail.com> (Thierry Volpiatto's message of "Wed, 03 Aug 2011 07:10:04 +0200") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -2.1 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.1 (--) severity 9115 wishlist retitle 9115 `documentation' should let you choose whether to include `usage' thanks >> (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. Yes, as mentioned earlier, I'm not particularly proud of the gymnastic you have to go through to get what you want. >> 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. Ah, I see the problem now. Would the patch below have helped? > 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 From unknown Sat Jun 14 18:58:21 2025 X-Loop: help-debbugs@gnu.org Subject: bug#9115: 24.0.50; `documentation' should not return args list for CL defun*. 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: To: Stefan Monnier Cc: 9115@debbugs.gnu.org Received: via spool by 9115-submit@debbugs.gnu.org id=B9115.131238279222592 (code B ref 9115); Wed, 03 Aug 2011 14:47:02 +0000 Received: (at 9115) by debbugs.gnu.org; 3 Aug 2011 14:46:32 +0000 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 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 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= Received: by 10.216.173.13 with SMTP id u13mr738144wel.104.1312382751263; Wed, 03 Aug 2011 07:45:51 -0700 (PDT) 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) From: Thierry Volpiatto 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> Date: Wed, 03 Aug 2011 16:45:46 +0200 In-Reply-To: (Stefan Monnier's message of "Wed, 03 Aug 2011 10:31:19 -0400") Message-ID: <8739hi7dut.fsf@gmail.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -4.3 (----) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -4.3 (----) 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 From unknown Sat Jun 14 18:58:21 2025 X-Loop: help-debbugs@gnu.org Subject: bug#9115: 24.0.50; `documentation' should not return args list for CL defun*. Resent-From: Lars Ingebrigtsen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 12 Oct 2019 05:03: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: To: Thierry Volpiatto Cc: Stefan Monnier , 9115@debbugs.gnu.org Received: via spool by 9115-submit@debbugs.gnu.org id=B9115.15708565517407 (code B ref 9115); Sat, 12 Oct 2019 05:03:02 +0000 Received: (at 9115) by debbugs.gnu.org; 12 Oct 2019 05:02:31 +0000 Received: from localhost ([127.0.0.1]:60570 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iJ9Xy-0001vP-WB for submit@debbugs.gnu.org; Sat, 12 Oct 2019 01:02:31 -0400 Received: from quimby.gnus.org ([80.91.231.51]:51790) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iJ9Xx-0001vF-Tc for 9115@debbugs.gnu.org; Sat, 12 Oct 2019 01:02:30 -0400 Received: from cm-84.212.202.86.getinternet.no ([84.212.202.86] helo=marnie) by quimby.gnus.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1iJ9Xt-0007D6-Aw; Sat, 12 Oct 2019 07:02:27 +0200 From: Lars Ingebrigtsen 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> <8739hi7dut.fsf@gmail.com> Date: Sat, 12 Oct 2019 07:02:24 +0200 In-Reply-To: <8739hi7dut.fsf@gmail.com> (Thierry Volpiatto's message of "Wed, 03 Aug 2011 16:45:46 +0200") Message-ID: <87r23imu8v.fsf@gnus.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: Thierry Volpiatto writes: >> Ah, I see the problem now. Would the patch below have helped? > Yes, better. I think the conclusion here was that nothing further seemed likely to be done here with this issue, so I'm closing this bug report now. Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: 0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Thierry Volpiatto writes: >> Ah, I see the problem now. Would the patch below have helped? > Yes, better. I think the conclusion here was that nothing further seemed likely to be done here with this issue, so I'm closing this bug report now. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog: http://lars.ingebrigtsen.no From debbugs-submit-bounces@debbugs.gnu.org Sat Oct 12 01:02:35 2019 Received: (at control) by debbugs.gnu.org; 12 Oct 2019 05:02:35 +0000 Received: from localhost ([127.0.0.1]:60573 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iJ9Y3-0001vh-B8 for submit@debbugs.gnu.org; Sat, 12 Oct 2019 01:02:35 -0400 Received: from quimby.gnus.org ([80.91.231.51]:51806) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1iJ9Y1-0001vY-KK for control@debbugs.gnu.org; Sat, 12 Oct 2019 01:02:33 -0400 Received: from cm-84.212.202.86.getinternet.no ([84.212.202.86] helo=marnie) by quimby.gnus.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1iJ9Xy-0007DE-Vm for control@debbugs.gnu.org; Sat, 12 Oct 2019 07:02:32 +0200 Date: Sat, 12 Oct 2019 07:02:30 +0200 Message-Id: <87pnj2mu8p.fsf@gnus.org> To: control@debbugs.gnu.org From: Lars Ingebrigtsen Subject: control message for bug #9115 X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see @@CONTACT_ADDRESS@@ for details. Content preview: close 9115 quit Content analysis details: (-2.9 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -1.0 ALL_TRUSTED Passed through trusted hosts only via SMTP -1.9 BAYES_00 BODY: Bayes spam probability is 0 to 1% [score: 0.0000] X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) close 9115 quit