diff man/lispref/specifiers.texi @ 412:697ef44129c6 r21-2-14

Import from CVS: tag r21-2-14
author cvs
date Mon, 13 Aug 2007 11:20:41 +0200
parents 501cfd01ee6d
children
line wrap: on
line diff
--- a/man/lispref/specifiers.texi	Mon Aug 13 11:19:22 2007 +0200
+++ b/man/lispref/specifiers.texi	Mon Aug 13 11:20:41 2007 +0200
@@ -22,27 +22,27 @@
 @end defun
 
 @menu
-* Introduction to Specifiers::  Specifiers provide a clean way for
-                                display and other properties to vary
-                                (under user control) in a wide variety
-                                of contexts.
-* Specifiers In-Depth::         Gory details about specifier innards.
-* Specifier Instancing::        Instancing means obtaining the ``value'' of
-                                a specifier in a particular context.
-* Specifier Types::             Specifiers come in different flavors.
-* Adding Specifications::       Specifications control a specifier's ``value''
-                                by giving conditions under which a
-                                particular value is valid.
-* Retrieving Specifications::   Querying a specifier's specifications.
-* Specifier Tag Functions::     Working with specifier tags.
+* Introduction to Specifiers::	Specifiers provide a clean way for
+				display and other properties to vary
+				(under user control) in a wide variety
+				of contexts.
+* Specifiers In-Depth::		Gory details about specifier innards.
+* Specifier Instancing::	Instancing means obtaining the ``value'' of
+				a specifier in a particular context.
+* Specifier Types::		Specifiers come in different flavors.
+* Adding Specifications::	Specifications control a specifier's ``value''
+				by giving conditions under which a
+				particular value is valid.
+* Retrieving Specifications::	Querying a specifier's specifications.
+* Specifier Tag Functions::	Working with specifier tags.
 * Specifier Instancing Functions::
-                                Functions to instance a specifier.
-* Specifier Example::           Making all this stuff clearer.
-* Creating Specifiers::         Creating specifiers for your own use.
+				Functions to instance a specifier.
+* Specifier Example::		Making all this stuff clearer.
+* Creating Specifiers::		Creating specifiers for your own use.
 * Specifier Validation Functions::
-                                Validating the components of a specifier.
+				Validating the components of a specifier.
 * Other Specification Functions::
-                                Other ways of working with specifications.
+				Other ways of working with specifications.
 @end menu
 
 @node Introduction to Specifiers
@@ -169,7 +169,7 @@
 User-defined tags may be defined, with an optional predicate specified.
 An application can create its own tag, use it to mark all its
 instantiators, and be fairly confident that it will not interfere with
-other applications that modify the same specifier---Functions that add
+other applications that modify the same specifier -- Functions that add
 a specification to a specifier usually only overwrite existing
 inst-pairs with the same tag set as was given, and a particular tag or
 tag set can be specified when removing instantiators.
@@ -196,7 +196,7 @@
 different font names, with possibly different foundries, widths, etc.,
 on different devices), the extra properties of that font on that
 device, etc.  Furthermore, this conversion (called @dfn{instantiation})
-might fail---a font or color might not exist on a particular device,
+might fail -- a font or color might not exist on a particular device,
 for example.
 
 @node Specifier Instancing
@@ -703,7 +703,7 @@
 particular device class or device type and/or to mark instantiators
 added by a particular package so that they can be later removed.
 
-A specifier tag set consists of a list of zero or more specifier tags,
+A specifier tag set consists of a list of zero of more specifier tags,
 each of which is a symbol that is recognized by XEmacs as a tag.  (The
 valid device types and device classes are always tags, as are any tags
 defined by @code{define-specifier-tag}.) It is called a ``tag set'' (as
@@ -861,9 +861,9 @@
     @result{}   ((#<buffer "device.c"> (nil . "forest green"))
                  (#<window on "Makefile" 0x8a2b> (nil . "hot pink"))
                  (#<x-frame "emacs" 0x4ac> (nil . "puke orange")
-                                           (nil . "moccasin"))
+					   (nil . "moccasin"))
                  (#<x-frame "VM" 0x4ac> (nil . "magenta"))
-                 (global ((tty) . "cyan") (nil . "white"))
+		 (global ((tty) . "cyan") (nil . "white"))
                 )
 @end example
 
@@ -890,7 +890,7 @@
 @enumerate
 @item
 First, we look for a specification matching the buffer displayed in the
-window, i.e. @samp{*scratch*}.  There are none, so we proceed.
+window, i.e. @samp{*scratch}.  There are none, so we proceed.
 @item
 Then, we look for a specification matching the window itself.  Again, there
 are none.
@@ -934,11 +934,11 @@
 @code{face-boolean}, or @code{toolbar}.
 
 For more information on particular types of specifiers, see the
-functions @code{make-generic-specifier}, @code{make-integer-specifier},
-@code{make-natnum-specifier}, @code{make-boolean-specifier},
-@code{make-color-specifier}, @code{make-font-specifier},
-@code{make-image-specifier}, @code{make-face-boolean-specifier}, and
-@code{make-toolbar-specifier}.
+functions @code{generic-specifier-p}, @code{integer-specifier-p},
+@code{natnum-specifier-p}, @code{boolean-specifier-p},
+@code{color-specifier-p}, @code{font-specifier-p},
+@code{image-specifier-p}, @code{face-boolean-specifier-p}, and
+@code{toolbar-specifier-p}.
 @end defun
 
 @defun make-specifier-and-init type spec-list &optional dont-canonicalize
@@ -954,59 +954,6 @@
 be in full form.  See @code{canonicalize-spec-list}.
 @end defun
 
-@defun make-integer-specifier spec-list
-
-Return a new @code{integer} specifier object with the given
-specification list.  @var{spec-list} can be a list of specifications
-(each of which is a cons of a locale and a list of instantiators), a
-single instantiator, or a list of instantiators.
-
-Valid instantiators for integer specifiers are integers.
-@end defun
-
-@defun make-boolean-specifier spec-list
-
-Return a new @code{boolean} specifier object with the given
-specification list.  @var{spec-list} can be a list of specifications
-(each of which is a cons of a locale and a list of instantiators), a
-single instantiator, or a list of instantiators.
-
-Valid instantiators for boolean specifiers are @code{t} and @code{nil}.
-@end defun
-
-@defun make-natnum-specifier spec-list
-
-Return a new @code{natnum} specifier object with the given specification
-list.  @var{spec-list} can be a list of specifications (each of which is
-a cons of a locale and a list of instantiators), a single instantiator,
-or a list of instantiators.
-
-Valid instantiators for natnum specifiers are non-negative integers.
-@end defun
-
-@defun make-generic-specifier spec-list
-
-Return a new @code{generic} specifier object with the given
-specification list.  @var{spec-list} can be a list of specifications
-(each of which is a cons of a locale and a list of instantiators), a
-single instantiator, or a list of instantiators.
-
-Valid instantiators for generic specifiers are all Lisp values.  They
-are returned back unchanged when a specifier is instantiated.
-@end defun
-
-@defun make-display-table-specifier spec-list
-
-Return a new @code{display-table} specifier object with the given spec
-list.  @var{spec-list} can be a list of specifications (each of which is
-a cons of a locale and a list of instantiators), a single instantiator,
-or a list of instantiators.
-
-Valid instantiators for display-table specifiers are described in detail
-in the doc string for @code{current-display-table} (@pxref{Active
-Display Table}).
-@end defun
-
 @node Specifier Validation Functions
 @section Functions for Checking the Validity of Specifier Components