From unknown Mon Jun 23 13:13:21 2025 X-Loop: help-debbugs@gnu.org Subject: bug#10724: 24.0.93; doc of `typecase' Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 04 Feb 2012 18:02:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 10724 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 10724@debbugs.gnu.org X-Debbugs-Original-To: Received: via spool by submit@debbugs.gnu.org id=B.132837852022031 (code B ref -1); Sat, 04 Feb 2012 18:02:01 +0000 Received: (at submit) by debbugs.gnu.org; 4 Feb 2012 18:02:00 +0000 Received: from localhost ([127.0.0.1]:54509 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Rtjvz-0005jH-OB for submit@debbugs.gnu.org; Sat, 04 Feb 2012 13:02:00 -0500 Received: from eggs.gnu.org ([140.186.70.92]:46896) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Rtjvw-0005j4-Lp for submit@debbugs.gnu.org; Sat, 04 Feb 2012 13:01:57 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RtjvD-0003MM-8s for submit@debbugs.gnu.org; Sat, 04 Feb 2012 13:01:12 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-6.9 required=5.0 tests=BAYES_00,RCVD_IN_DNSWL_HI, T_RP_MATCHES_RCVD, UNPARSEABLE_RELAY autolearn=unavailable version=3.3.2 Received: from lists.gnu.org ([140.186.70.17]:35765) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RtjvD-0003MI-7Q for submit@debbugs.gnu.org; Sat, 04 Feb 2012 13:01:11 -0500 Received: from eggs.gnu.org ([140.186.70.92]:55858) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RtjvC-0002S5-1r for bug-gnu-emacs@gnu.org; Sat, 04 Feb 2012 13:01:11 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RtjvA-0003M7-PD for bug-gnu-emacs@gnu.org; Sat, 04 Feb 2012 13:01:09 -0500 Received: from acsinet15.oracle.com ([141.146.126.227]:31751) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RtjvA-0003Lz-K8 for bug-gnu-emacs@gnu.org; Sat, 04 Feb 2012 13:01:08 -0500 Received: from acsinet22.oracle.com (acsinet22.oracle.com [141.146.126.238]) by acsinet15.oracle.com (Switch-3.4.4/Switch-3.4.4) with ESMTP id q14I164O031398 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Sat, 4 Feb 2012 18:01:07 GMT Received: from acsmt357.oracle.com (acsmt357.oracle.com [141.146.40.157]) by acsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id q14I15pa005718 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Sat, 4 Feb 2012 18:01:06 GMT Received: from abhmt113.oracle.com (abhmt113.oracle.com [141.146.116.65]) by acsmt357.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id q14I15Cq019743 for ; Sat, 4 Feb 2012 12:01:05 -0600 Received: from dradamslap1 (/10.159.50.114) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sat, 04 Feb 2012 10:01:05 -0800 From: "Drew Adams" Date: Sat, 4 Feb 2012 10:00:59 -0800 Message-ID: <8F862DB597B0405F8F3682B583864BFB@us.oracle.com> MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 Thread-Index: AczjZvM1bcg4zm7FSOyCkRbHZQUoMw== X-Source-IP: acsinet22.oracle.com [141.146.126.238] X-Auth-Type: Internal IP X-CT-RefId: str=0001.0A090201.4F2D7263.0024,ss=1,re=0.000,fgs=0 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 1) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 140.186.70.17 X-Spam-Score: -4.2 (----) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 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.2 (----) The doc string does not meet Emacs standards. The arguments are not described. Nothing is said about what EXPR, TYPE or BODY can be. BODY is excusable; the others are not. We must state that EXPR is any Emacs-Lisp sexp (if that is the case). And we must state that TYPE is an emacs-lisp type name, as a symbol (if that is the case). But that's not sufficient, since there is not just a single list of such type names. There are at least the following that a reader might understand for TYPE when reading this doc: 1. the simple-type names for Customize 2. type predicates 3. programming types ((elisp) Programming Types) 4. editing types ((elisp) Editing Types) For the last two (#3 and #4), which are probably what is meant here, what symbols (is TYPE a symbol?) are recognized for those types by `typecase'? You cannot program using `typecase' without knowing this stuff. And though Emacs Lisp's `typecase' presumably corresponds somewhat to Common Lisp's, it is not at all obvious just what values of TYPE are supported by Emacs Lisp. In GNU Emacs 24.0.93.1 (i386-mingw-nt5.1.2600) of 2012-01-29 on MARVIN Windowing system distributor `Microsoft Corp.', version 5.1.2600 Configured using: `configure --with-gcc (4.6) --no-opt --cflags -ID:/devel/emacs/libs/libXpm-3.5.8/include -ID:/devel/emacs/libs/libXpm-3.5.8/src -ID:/devel/emacs/libs/libpng-dev_1.4.3-1/include -ID:/devel/emacs/libs/zlib-dev_1.2.5-2/include -ID:/devel/emacs/libs/giflib-4.1.4-1/include -ID:/devel/emacs/libs/jpeg-6b-4/include -ID:/devel/emacs/libs/tiff-3.8.2-1/include -ID:/devel/emacs/libs/gnutls-3.0.9/include --ldflags -LD:/devel/emacs/libs/gnutls-3.0.9/lib' From unknown Mon Jun 23 13:13:21 2025 X-Loop: help-debbugs@gnu.org Subject: bug#10724: 24.0.93; doc of `typecase' Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 17 Sep 2012 00:18:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 10724 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: <10724@debbugs.gnu.org> Received: via spool by 10724-submit@debbugs.gnu.org id=B10724.134784107325451 (code B ref 10724); Mon, 17 Sep 2012 00:18:02 +0000 Received: (at 10724) by debbugs.gnu.org; 17 Sep 2012 00:17:53 +0000 Received: from localhost ([127.0.0.1]:37902 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TDP28-0006cR-PE for submit@debbugs.gnu.org; Sun, 16 Sep 2012 20:17:53 -0400 Received: from acsinet15.oracle.com ([141.146.126.227]:38535) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TDP27-0006cL-I8 for 10724@debbugs.gnu.org; Sun, 16 Sep 2012 20:17:52 -0400 Received: from ucsinet22.oracle.com (ucsinet22.oracle.com [156.151.31.94]) by acsinet15.oracle.com (Sentrion-MTA-4.2.2/Sentrion-MTA-4.2.2) with ESMTP id q8H0Gcr9005803 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for <10724@debbugs.gnu.org>; Mon, 17 Sep 2012 00:16:38 GMT Received: from acsmt358.oracle.com (acsmt358.oracle.com [141.146.40.158]) by ucsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id q8H0Gb2T017591 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for <10724@debbugs.gnu.org>; Mon, 17 Sep 2012 00:16:37 GMT Received: from abhmt113.oracle.com (abhmt113.oracle.com [141.146.116.65]) by acsmt358.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id q8H0GbkR025676 for <10724@debbugs.gnu.org>; Sun, 16 Sep 2012 19:16:37 -0500 Received: from dradamslap1 (/10.159.170.142) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sun, 16 Sep 2012 17:16:36 -0700 From: "Drew Adams" References: <8F862DB597B0405F8F3682B583864BFB@us.oracle.com> Date: Sun, 16 Sep 2012 17:16:26 -0700 Message-ID: <1E2422A9ED80456E9EF3F4112F4E65E3@us.oracle.com> MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 In-Reply-To: <8F862DB597B0405F8F3682B583864BFB@us.oracle.com> Thread-Index: AczjZvM1bcg4zm7FSOyCkRbHZQUoMyxArVpQ X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 X-Source-IP: ucsinet22.oracle.com [156.151.31.94] X-Spam-Score: -7.4 (-------) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 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: -7.4 (-------) ping From unknown Mon Jun 23 13:13:21 2025 X-Loop: help-debbugs@gnu.org Subject: bug#10724: 24.0.93; doc of `typecase' Resent-From: Lars Ingebrigtsen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 09 Feb 2014 05:17:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 10724 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: "Drew Adams" Cc: 10724@debbugs.gnu.org Received: via spool by 10724-submit@debbugs.gnu.org id=B10724.139192297728493 (code B ref 10724); Sun, 09 Feb 2014 05:17:02 +0000 Received: (at 10724) by debbugs.gnu.org; 9 Feb 2014 05:16:17 +0000 Received: from localhost ([127.0.0.1]:58941 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WCMkb-0007PU-8m for submit@debbugs.gnu.org; Sun, 09 Feb 2014 00:16:17 -0500 Received: from hermes.netfonds.no ([80.91.224.195]:54473) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WCMkY-0007PG-QM for 10724@debbugs.gnu.org; Sun, 09 Feb 2014 00:16:15 -0500 Received: from [204.14.154.233] (helo=building.gnus.org) by hermes.netfonds.no with esmtpsa (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.72) (envelope-from ) id 1WCMkK-0005sb-8L; Sun, 09 Feb 2014 06:16:00 +0100 From: Lars Ingebrigtsen References: <8F862DB597B0405F8F3682B583864BFB@us.oracle.com> Date: Sat, 08 Feb 2014 21:14:48 -0800 In-Reply-To: <8F862DB597B0405F8F3682B583864BFB@us.oracle.com> (Drew Adams's message of "Sat, 4 Feb 2012 10:00:59 -0800") Message-ID: <87eh3cc1fb.fsf@building.gnus.org> User-Agent: Gnus/5.13001 (Ma Gnus v0.10) Emacs/24.3.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-MailScanner-ID: 1WCMkK-0005sb-8L X-Netfonds-MailScanner: Found to be clean X-Netfonds-MailScanner-From: larsi@gnus.org MailScanner-NULL-Check: 1392527761.41618@OP5Ih/HSWTbCS9jSj1ss4Q X-Spam-Status: No X-Spam-Score: 0.0 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 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: 0.0 (/) "Drew Adams" writes: > The doc string does not meet Emacs standards. The arguments are not > described. > > Nothing is said about what EXPR, TYPE or BODY can be. BODY is > excusable; the others are not. This seems to be another report about not putting the entirety of the Common Lisp standard into the doc strings of the cl-* functions. Closing. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog http://lars.ingebrigtsen.no/ From debbugs-submit-bounces@debbugs.gnu.org Sun Feb 09 00:16:31 2014 Received: (at control) by debbugs.gnu.org; 9 Feb 2014 05:16:31 +0000 Received: from localhost ([127.0.0.1]:58944 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WCMko-0007Pw-PU for submit@debbugs.gnu.org; Sun, 09 Feb 2014 00:16:30 -0500 Received: from hermes.netfonds.no ([80.91.224.195]:54479) by debbugs.gnu.org with esmtp (Exim 4.80) (envelope-from ) id 1WCMkm-0007Po-J1 for control@debbugs.gnu.org; Sun, 09 Feb 2014 00:16:29 -0500 Received: from [204.14.154.233] (helo=building.gnus.org) by hermes.netfonds.no with esmtpsa (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.72) (envelope-from ) id 1WCMkW-0005ss-CN for control@debbugs.gnu.org; Sun, 09 Feb 2014 06:16:12 +0100 Date: Sat, 08 Feb 2014 21:14:58 -0800 Message-Id: <87d2iwc1f1.fsf@building.gnus.org> To: control@debbugs.gnu.org From: Lars Ingebrigtsen Subject: control message for bug #10724 X-MailScanner-ID: 1WCMkW-0005ss-CN X-Netfonds-MailScanner: Found to be clean X-Netfonds-MailScanner-From: larsi@gnus.org MailScanner-NULL-Check: 1392527773.8131@LocAJzODhZhWvKo3UM6wNg X-Spam-Status: No X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.15 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: 0.0 (/) tags 10724 wontfix close 10724