bug#8690: 24.0.50; `declare' doc; conflict with cl-macs.el

[Drew Adams]

Emacs has added `declare', choosing to use the same name as the Common
Lisp form.
 
If cl has been loaded, then `C-h f declare' says this:
 
 declare is a Lisp macro in `cl-macs.el'.
 
 (declare &rest SPECS)
 
 Not documented.
 
If cl has not been loaded, then it says this:
 
 declare is a Lisp macro in `subr.el'.
 
 (declare &rest SPECS)
 
 Do not evaluate any arguments and return nil.
 Treated as a declaration when used at the right place in a
 `defmacro' form.  (See Info anchor `(elisp)Definition of declare'.)
 
Something should be done about this.  Perhaps rename the cl form to
avoid the conflict?  Dunno.  But we shouldn't be getting into this kind
of conflict/confusion.  Unless the two are truly compatible, in which
case we should add the same doc string to the macro in cl-macs.el.
 

In GNU Emacs 24.0.50.1 (i386-mingw-nt5.1.2600)
 of 2011-05-16 on 3249CTO
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (4.5) --no-opt --cflags
-Ic:/build/include'