bug#17872: 24.4.50; "primitive" in (elisp) `Advising Functions' and similar nodes

[Drew Adams]

Please use some other term than "primitive" for what is intended here.
The term "primitive" already has a different meaning in Emacs, which you
can find by using `i primitive RET' in the Elisp manual:

 "primitive"
     A function which is callable from Lisp but is actually written in
     C.  Primitives are also called "built-in functions", or "subrs".
     Examples include functions like `car' and `append'.  In addition,
     all special forms (see below) are also considered primitives.

     Usually, a function is implemented as a primitive because it is a
     fundamental part of Lisp (e.g., `car'), or because it provides a
     low-level interface to operating system services, or because it
     needs to run fast.  Unlike functions defined in Lisp, primitives
     can be modified or added only by changing the C sources and
     recompiling Emacs.  See *note Writing Emacs Primitives::.

The things being referred to in node `Advising Functions' and other
nodes (its children, at least) as "primitives", are NOT primitives.
They are either macros (e.g. `add-function') or ordinary Lisp functions
(e.g. `advice-add').  This confuses rather than helps Emacs users.

In GNU Emacs 24.4.50.1 (i686-pc-mingw32)
 of 2014-06-17 on ODIEONE
Bzr revision: 117359 monnier@iro.umontreal.ca-20140617193358-2t1nl1te9gc2mqrx
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
 `configure --prefix=/c/Devel/emacs/snapshot/trunk
 --enable-checking=yes,glyphs 'CFLAGS=-O0 -g3'
 LDFLAGS=-Lc:/Devel/emacs/lib 'CPPFLAGS=-DGC_MCHECK=1
 -Ic:/Devel/emacs/include''