]> code.delx.au - gnu-emacs/blobdiff - lispref/functions.texi
(quail-help): The output message is improved.
[gnu-emacs] / lispref / functions.texi
index edec40d50723dcb7d279f3de09b68fb8d3d873e2..6cdcb6bce1bb3cc83630b577dea546646e467d6a 100644 (file)
@@ -1,6 +1,7 @@
 @c -*-texinfo-*-
 @c This is part of the GNU Emacs Lisp Reference Manual.
-@c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998 Free Software Foundation, Inc. 
+@c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999
+@c   Free Software Foundation, Inc. 
 @c See the file elisp.texi for copying conditions.
 @setfilename ../info/functions
 @node Functions, Macros, Variables, Top
@@ -63,9 +64,9 @@ the editor.  See @ref{Writing Emacs Primitives}.
 @item lambda expression
 A @dfn{lambda expression} is a function written in Lisp.
 These are described in the following section.
-@ifinfo
+@ifnottex
 @xref{Lambda Expressions}.
-@end ifinfo
+@end ifnottex
 
 @item special form
 A @dfn{special form} is a primitive that is like a function but does not
@@ -111,7 +112,6 @@ byte compiler.  @xref{Byte-Code Type}.
 @end table
 
 @defun functionp object
-@tindex functionp
 This function returns @code{t} if @var{object} is any kind of function,
 or a special form or macro.
 @end defun
@@ -174,7 +174,7 @@ expression, but to be called as a function.
 @node Lambda Components
 @subsection Components of a Lambda Expression
 
-@ifinfo
+@ifnottex
 
   A function written in Lisp (a ``lambda expression'') is a list that
 looks like this:
@@ -185,7 +185,7 @@ looks like this:
   [@var{interactive-declaration}]
   @var{body-forms}@dots{})
 @end example
-@end ifinfo
+@end ifnottex
 
 @cindex lambda list
   The first element of a lambda expression is always the symbol
@@ -623,7 +623,7 @@ above, it never knows them in the first place.
 @end group
 @end example
 
-Compare these example with the examples of @code{apply}.
+Compare these examples with the examples of @code{apply}.
 @end defun
 
 @defun apply function &rest arguments
@@ -693,7 +693,9 @@ This function ignores any arguments and returns @code{nil}.
 list or other collection.  Emacs Lisp has several such functions;
 @code{mapcar} and @code{mapconcat}, which scan a list, are described
 here.  @xref{Creating Symbols}, for the function @code{mapatoms} which
-maps over the symbols in an obarray.
+maps over the symbols in an obarray.  @xref{Hash Access}, for the
+function @code{maphash} which maps over key/value associations in a
+hash table.
 
   These mapping functions do not allow char-tables because a char-table
 is a sparse array whose nominal range of indices is very large.  To map
@@ -746,6 +748,13 @@ Return the list of results."
 @end smallexample
 @end defun
 
+@defun mapc function sequence
+@tindex mapc
+@code{mapc} is like @code{mapcar} except that @var{function} is used for
+side-effects only---the values it returns are ignored, not collected
+into a list.  @code{mapc} always returns @var{sequence}.
+@end defun
+
 @defun mapconcat function sequence separator
 @code{mapconcat} applies @var{function} to each element of
 @var{sequence}: the results, which must be strings, are concatenated.