all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
* Manual for `cl' package is out of date
@ 2007-10-23 12:22 Gareth Rees
  2007-10-23 12:41 ` Andreas Schwab
  0 siblings, 1 reply; 3+ messages in thread
From: Gareth Rees @ 2007-10-23 12:22 UTC (permalink / raw)
  To: bug-gnu-emacs; +Cc: Gareth Rees

The manual for the `cl' package is out of date in a couple places.

Node "(cl)Porting Common Lisp" says:

   * Reader macros.  Common Lisp includes a second type of macro that
     works at the level of individual characters.  For example, Common
     Lisp implements the quote notation by a reader macro called `'',
     whereas Emacs Lisp's parser just treats quote as a special case.
     Some Lisp packages use reader macros to create special syntaxes
     for themselves, which the Emacs parser is incapable of reading.

     The lack of reader macros, incidentally, is the reason behind
     Emacs Lisp's unusual backquote syntax.  Since backquotes are
     implemented as a Lisp package and not built-in to the Emacs
     parser, they are forced to use a regular macro named ``' which is
     used with the standard function/macro call notation.

This has become a bit misleading: it's still true that Emacs Lisp lacks
reader macros but Emacs Lisp's backquote syntax is no longer "unusual"
because backquote is now handled in the reader.  Maybe just delete the
second paragraph?

Further down in "(cl)Porting Common Lisp":

   * Characters are distinct from integers in Common Lisp.  The
     notation for character constants is also different:  `#\A' instead
     of `?A'.

`?A' is now supported in Emacs.

Node "(cl)Top" offers this menu item:

   * Lists::                `cadr', `sublis', `member*', `assoc*', etc.

The function `cadr' is no longer described in this node.  The menu item
should mention `caddr' instead.

-- 
Gareth Rees




^ permalink raw reply	[flat|nested] 3+ messages in thread

* Re: Manual for `cl' package is out of date
  2007-10-23 12:22 Manual for `cl' package is out of date Gareth Rees
@ 2007-10-23 12:41 ` Andreas Schwab
  2007-10-23 23:17   ` Gareth Rees
  0 siblings, 1 reply; 3+ messages in thread
From: Andreas Schwab @ 2007-10-23 12:41 UTC (permalink / raw)
  To: Gareth Rees; +Cc: bug-gnu-emacs

Gareth Rees <gareth.rees@pobox.com> writes:

> Further down in "(cl)Porting Common Lisp":
>
>   * Characters are distinct from integers in Common Lisp.  The
>     notation for character constants is also different:  `#\A' instead
>     of `?A'.
>
> `?A' is now supported in Emacs.

I think you misunderstood: ?A has always been the syntax for character
constants as used by Emacs.  The notation used by Common Lisp is #\A,
which is _not_ supported.

Andreas.

-- 
Andreas Schwab, SuSE Labs, schwab@suse.de
SuSE Linux Products GmbH, Maxfeldstraße 5, 90409 Nürnberg, Germany
PGP key fingerprint = 58CA 54C7 6D53 942B 1756  01D3 44D5 214B 8276 4ED5
"And now for something completely different."




^ permalink raw reply	[flat|nested] 3+ messages in thread

* Re: Manual for `cl' package is out of date
  2007-10-23 12:41 ` Andreas Schwab
@ 2007-10-23 23:17   ` Gareth Rees
  0 siblings, 0 replies; 3+ messages in thread
From: Gareth Rees @ 2007-10-23 23:17 UTC (permalink / raw)
  To: Andreas Schwab; +Cc: bug-gnu-emacs

On 2007-10-23, at 13:41, Andreas Schwab wrote:
> I think you misunderstood: ?A has always been the syntax for character
> constants as used by Emacs.  The notation used by Common Lisp is #\A,
> which is _not_ supported.

Yes, I read it completely backwards. My apologies.

-- 
Gareth Rees




^ permalink raw reply	[flat|nested] 3+ messages in thread

end of thread, other threads:[~2007-10-23 23:17 UTC | newest]

Thread overview: 3+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2007-10-23 12:22 Manual for `cl' package is out of date Gareth Rees
2007-10-23 12:41 ` Andreas Schwab
2007-10-23 23:17   ` Gareth Rees

Code repositories for project(s) associated with this external index

	https://git.savannah.gnu.org/cgit/emacs.git
	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.