[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

bug#10724: 24.0.93; doc of `typecase'

From: Drew Adams
Subject: bug#10724: 24.0.93; doc of `typecase'
Date: Sat, 4 Feb 2012 10:00:59 -0800

The doc string does not meet Emacs standards.  The arguments are not
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
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 (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/gnutls-3.0.9/include --ldflags

reply via email to

[Prev in Thread] Current Thread [Next in Thread]