Mercurial > hg > xemacs-beta
comparison man/lispref/positions.texi @ 5361:62b9ef1ed4ac
Change "special form" to "special operator" in the manuals, too
2011-03-01 Aidan Kehoe <kehoea@parhasard.net>
* lispref/commands.texi (Using Interactive):
* lispref/compile.texi (Eval During Compile):
* lispref/compile.texi (Compiled-Function Objects):
* lispref/control.texi (Sequencing):
* lispref/control.texi (Conditionals):
* lispref/control.texi (Combining Conditions):
* lispref/control.texi (Iteration):
* lispref/control.texi (Catch and Throw):
* lispref/control.texi (Handling Errors):
* lispref/control.texi (Cleanups):
* lispref/display.texi (Temporary Displays):
* lispref/eval.texi (Quoting):
* lispref/eval.texi (Multiple values):
* lispref/frames.texi (Input Focus):
* lispref/functions.texi (Argument List):
* lispref/functions.texi (Defining Functions):
* lispref/functions.texi (Anonymous Functions):
* lispref/internationalization.texi (Level 3 Primitives):
* lispref/internationalization.texi (Domain Specification):
* lispref/intro.texi (A Sample Function Description):
* lispref/intro.texi (A Sample Variable Description):
* lispref/lists.texi (Sets And Lists):
* lispref/macros.texi (Defining Macros):
* lispref/macros.texi (Backquote):
* lispref/positions.texi (Excursions):
* lispref/positions.texi (Narrowing):
* lispref/searching.texi (Saving Match Data):
* lispref/sequences.texi (Sequence Functions):
* lispref/sequences.texi (Array Functions):
* lispref/specifiers.texi (Adding Specifications):
* lispref/variables.texi (Local Variables):
* lispref/variables.texi (Defining Variables):
* lispref/variables.texi (Setting Variables):
* lispref/variables.texi (Default Value):
* lispref/windows.texi (Selecting Windows):
* lispref/windows.texi (Window Configurations):
No longer use @defspec, since we no longer use the term "special
form"; instead use @deffn {Special Operator}. Unfortunately
there's no way in texinfo to redefine @defspec in one place.
| author | Aidan Kehoe <kehoea@parhasard.net> |
|---|---|
| date | Tue, 01 Mar 2011 14:18:45 +0000 |
| parents | 755ae5b97edb |
| children | a46c5c8d6564 |
comparison
equal
deleted
inserted
replaced
| 5359:f5a5501814f5 | 5361:62b9ef1ed4ac |
|---|---|
| 764 | 764 |
| 765 The forms for saving and restoring the configuration of windows are | 765 The forms for saving and restoring the configuration of windows are |
| 766 described elsewhere (see @ref{Window Configurations} and @pxref{Frame | 766 described elsewhere (see @ref{Window Configurations} and @pxref{Frame |
| 767 Configurations}). | 767 Configurations}). |
| 768 | 768 |
| 769 @defspec save-excursion forms@dots{} | 769 @deffn {Special Operator} save-excursion forms@dots{} |
| 770 @cindex mark excursion | 770 @cindex mark excursion |
| 771 @cindex point excursion | 771 @cindex point excursion |
| 772 @cindex current buffer excursion | 772 @cindex current buffer excursion |
| 773 The @code{save-excursion} special operator saves the identity of the current | 773 The @code{save-excursion} special operator saves the identity of the current |
| 774 buffer and the values of point and the mark in it, evaluates | 774 buffer and the values of point and the mark in it, evaluates |
| 808 (set-buffer old-buf) | 808 (set-buffer old-buf) |
| 809 (goto-char old-pnt) | 809 (goto-char old-pnt) |
| 810 (set-marker (mark-marker) old-mark))) | 810 (set-marker (mark-marker) old-mark))) |
| 811 @end group | 811 @end group |
| 812 @end example | 812 @end example |
| 813 @end defspec | 813 @end deffn |
| 814 | 814 |
| 815 @defspec save-current-buffer forms@dots{} | 815 @deffn {Special Operator} save-current-buffer forms@dots{} |
| 816 This special operator is similar to @code{save-excursion} but it only | 816 This special operator is similar to @code{save-excursion} but it only |
| 817 saves and restores the current buffer. Beginning with XEmacs 20.3, | 817 saves and restores the current buffer. Beginning with XEmacs 20.3, |
| 818 @code{save-current-buffer} is a primitive. | 818 @code{save-current-buffer} is a primitive. |
| 819 @end defspec | 819 @end deffn |
| 820 | 820 |
| 821 @defspec with-current-buffer buffer forms@dots{} | 821 @deffn {Special Operator} with-current-buffer buffer forms@dots{} |
| 822 This macro evaluates @var{forms} with @var{buffer} as the current | 822 This macro evaluates @var{forms} with @var{buffer} as the current |
| 823 buffer. It returns the value of the last form. | 823 buffer. It returns the value of the last form. |
| 824 @end defspec | 824 @end deffn |
| 825 | 825 |
| 826 @defspec with-temp-file filename forms@dots{} | 826 @deffn {Special Operator} with-temp-file filename forms@dots{} |
| 827 This macro creates a new buffer, evaluates @var{forms} there, and | 827 This macro creates a new buffer, evaluates @var{forms} there, and |
| 828 writes the buffer to @var{filename}. It returns the value of the last form | 828 writes the buffer to @var{filename}. It returns the value of the last form |
| 829 evaluated. | 829 evaluated. |
| 830 @end defspec | 830 @end deffn |
| 831 | 831 |
| 832 @defspec save-selected-window forms@dots{} | 832 @deffn {Special Operator} save-selected-window forms@dots{} |
| 833 This macro is similar to @code{save-excursion} but it saves and | 833 This macro is similar to @code{save-excursion} but it saves and |
| 834 restores the selected window and nothing else. | 834 restores the selected window and nothing else. |
| 835 @end defspec | 835 @end deffn |
| 836 | 836 |
| 837 @node Narrowing | 837 @node Narrowing |
| 838 @section Narrowing | 838 @section Narrowing |
| 839 @cindex narrowing | 839 @cindex narrowing |
| 840 @cindex restriction (in a buffer) | 840 @cindex restriction (in a buffer) |
| 891 @end example | 891 @end example |
| 892 | 892 |
| 893 @var{buffer} defaults to the current buffer if omitted. | 893 @var{buffer} defaults to the current buffer if omitted. |
| 894 @end deffn | 894 @end deffn |
| 895 | 895 |
| 896 @defspec save-restriction body@dots{} | 896 @deffn {Special Operator} save-restriction body@dots{} |
| 897 This special operator saves the current bounds of the accessible portion, | 897 This special operator saves the current bounds of the accessible portion, |
| 898 evaluates the @var{body} forms, and finally restores the saved bounds, | 898 evaluates the @var{body} forms, and finally restores the saved bounds, |
| 899 thus restoring the same state of narrowing (or absence thereof) formerly | 899 thus restoring the same state of narrowing (or absence thereof) formerly |
| 900 in effect. The state of narrowing is restored even in the event of an | 900 in effect. The state of narrowing is restored even in the event of an |
| 901 abnormal exit via @code{throw} or error (@pxref{Nonlocal Exits}). | 901 abnormal exit via @code{throw} or error (@pxref{Nonlocal Exits}). |
| 970 This is the contents of bar | 970 This is the contents of bar |
| 971 This is the contents of foo@point{} | 971 This is the contents of foo@point{} |
| 972 ---------- Buffer: foo ---------- | 972 ---------- Buffer: foo ---------- |
| 973 @end group | 973 @end group |
| 974 @end example | 974 @end example |
| 975 @end defspec | 975 @end deffn |