diff options
| author | Karoly Lorentey | 2005-01-06 15:00:09 +0000 |
|---|---|---|
| committer | Karoly Lorentey | 2005-01-06 15:00:09 +0000 |
| commit | 0feecea9fb7079a2c1fbfee32a992449a22cf478 (patch) | |
| tree | 0826d68e3dc2ce370c7bd4dae7db3cffc3568321 /lispref | |
| parent | 17d51b68fb4e7da4f18eff72c589b7ffc4f9c22c (diff) | |
| parent | 1a63439b34c3455a317feda5c271dfdb7af0296b (diff) | |
| download | emacs-0feecea9fb7079a2c1fbfee32a992449a22cf478.tar.gz emacs-0feecea9fb7079a2c1fbfee32a992449a22cf478.zip | |
Merged in changes from CVS trunk.
Patches applied:
* miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-747
Update from CVS
* miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-748
Update from CVS
* miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-749
Update from CVS
* miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-750
Merge from gnus--rel--5.10
* miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-751
Update from CVS
* miles@gnu.org--gnu-2004/emacs--cvs-trunk--0--patch-752
Update from CVS
* miles@gnu.org--gnu-2004/gnus--rel--5.10--patch-78
Merge from emacs--cvs-trunk--0
* miles@gnu.org--gnu-2004/gnus--rel--5.10--patch-79
Update from CVS
* miles@gnu.org--gnu-2004/gnus--rel--5.10--patch-80
Update from CVS
git-archimport-id: lorentey@elte.hu--2004/emacs--multi-tty--0--patch-278
Diffstat (limited to 'lispref')
| -rw-r--r-- | lispref/ChangeLog | 15 | ||||
| -rw-r--r-- | lispref/Makefile.in | 2 | ||||
| -rw-r--r-- | lispref/buffers.texi | 7 | ||||
| -rw-r--r-- | lispref/display.texi | 56 | ||||
| -rw-r--r-- | lispref/elisp.texi | 8 | ||||
| -rw-r--r-- | lispref/loading.texi | 109 | ||||
| -rw-r--r-- | lispref/modes.texi | 4 |
7 files changed, 127 insertions, 74 deletions
diff --git a/lispref/ChangeLog b/lispref/ChangeLog index 247309624de..8ebb1b239b9 100644 --- a/lispref/ChangeLog +++ b/lispref/ChangeLog | |||
| @@ -1,3 +1,18 @@ | |||
| 1 | 2004-12-27 Richard M. Stallman <rms@gnu.org> | ||
| 2 | |||
| 3 | * Makefile.in (MAKEINFO): Specify --force. | ||
| 4 | |||
| 5 | * buffers.texi (Killing Buffers): Add buffer-save-without-query. | ||
| 6 | |||
| 7 | * modes.texi (Emulating Mode Line): Document format's BUFFER arg. | ||
| 8 | |||
| 9 | * display.texi (Line Height): Further clarify. | ||
| 10 | |||
| 11 | * elisp.texi (Top): Update Loading submenu. | ||
| 12 | |||
| 13 | * loading.texi (Where Defined): New node. | ||
| 14 | (Unloading): load-history moved to Where Defined. | ||
| 15 | |||
| 1 | 2004-12-21 Richard M. Stallman <rms@gnu.org> | 16 | 2004-12-21 Richard M. Stallman <rms@gnu.org> |
| 2 | 17 | ||
| 3 | * commands.texi (Event Input Misc): Add while-no-input. | 18 | * commands.texi (Event Input Misc): Add while-no-input. |
diff --git a/lispref/Makefile.in b/lispref/Makefile.in index c0e3b54c952..770ffd5769a 100644 --- a/lispref/Makefile.in +++ b/lispref/Makefile.in | |||
| @@ -31,7 +31,7 @@ infodir = $(srcdir)/../info | |||
| 31 | TEXI2DVI = texi2dvi | 31 | TEXI2DVI = texi2dvi |
| 32 | SHELL = /bin/sh | 32 | SHELL = /bin/sh |
| 33 | INSTALL_INFO = install-info | 33 | INSTALL_INFO = install-info |
| 34 | MAKEINFO = makeinfo | 34 | MAKEINFO = makeinfo --force |
| 35 | 35 | ||
| 36 | # The name of the manual: | 36 | # The name of the manual: |
| 37 | VERSION=2.9 | 37 | VERSION=2.9 |
diff --git a/lispref/buffers.texi b/lispref/buffers.texi index d39a0746fe1..42131766ec7 100644 --- a/lispref/buffers.texi +++ b/lispref/buffers.texi | |||
| @@ -1041,6 +1041,13 @@ save that buffer, just as they offer to save file-visiting buffers. | |||
| 1041 | for any reason. @xref{Buffer-Local Variables}. | 1041 | for any reason. @xref{Buffer-Local Variables}. |
| 1042 | @end defvar | 1042 | @end defvar |
| 1043 | 1043 | ||
| 1044 | @defvar buffer-save-without-query | ||
| 1045 | This variable, if non-@code{nil} in a particular buffer, tells | ||
| 1046 | @code{save-buffers-kill-emacs} and @code{save-some-buffers} to save | ||
| 1047 | this buffer (if it's modified) without asking the user. The variable | ||
| 1048 | automatically becomes buffer-local when set for any reason. | ||
| 1049 | @end defvar | ||
| 1050 | |||
| 1044 | @defun buffer-live-p object | 1051 | @defun buffer-live-p object |
| 1045 | This function returns @code{t} if @var{object} is a buffer which has | 1052 | This function returns @code{t} if @var{object} is a buffer which has |
| 1046 | not been killed, @code{nil} otherwise. | 1053 | not been killed, @code{nil} otherwise. |
diff --git a/lispref/display.texi b/lispref/display.texi index 04d478b9b2a..95cce29d0c1 100644 --- a/lispref/display.texi +++ b/lispref/display.texi | |||
| @@ -1533,23 +1533,26 @@ or by adding additional vertical space below one or all lines. | |||
| 1533 | A newline can have a @code{line-height} text or overlay property | 1533 | A newline can have a @code{line-height} text or overlay property |
| 1534 | that controls the total height of the display line ending in that | 1534 | that controls the total height of the display line ending in that |
| 1535 | newline. If the property value is zero, the displayed height of the | 1535 | newline. If the property value is zero, the displayed height of the |
| 1536 | line is exactly what its contents need; no line-spacing is added. | 1536 | line is exactly what its contents demand; no line-spacing is added. |
| 1537 | This case is useful for tiling small images or image slices without | 1537 | This case is useful for tiling small images or image slices without |
| 1538 | adding blank areas between the images. | 1538 | adding blank areas between the images. |
| 1539 | 1539 | ||
| 1540 | If the property value is not zero, it specifies a desired height, | 1540 | If the property value is not zero, it is a height spec. A height |
| 1541 | @var{line-height}. There are several ways it can do this: | 1541 | spec stands for a numeric height value; this heigh spec specifies the |
| 1542 | actual line height, @var{line-height}. There are several ways to | ||
| 1543 | write a height spec; here's how each of them translates into a numeric | ||
| 1544 | height: | ||
| 1542 | 1545 | ||
| 1543 | @table @code | 1546 | @table @code |
| 1544 | @item @var{integer} | 1547 | @item @var{integer} |
| 1545 | If the property is a positive integer, @var{line-height} is that integer. | 1548 | If the height spec is a positive integer, the height value is that integer. |
| 1546 | @item @var{float} | 1549 | @item @var{float} |
| 1547 | If the property is a float, @var{float}, @var{line-height} is @var{float} | 1550 | If the height spec is a float, @var{float}, the numeric height value |
| 1548 | times the frame's default line height. | 1551 | is @var{float} times the frame's default line height. |
| 1549 | @item (@var{ratio} . @var{face}) | 1552 | @item (@var{ratio} . @var{face}) |
| 1550 | If the property is a cons of the format shown, @var{line-height} is | 1553 | If the height spec is a cons of the format shown, the numeric height |
| 1551 | @var{ratio} times the height of face @var{face}. @var{ratio} can be | 1554 | is @var{ratio} times the height of face @var{face}. @var{ratio} can |
| 1552 | any type of number. If @var{face} is @code{t}, it refers to the | 1555 | be any type of number. If @var{face} is @code{t}, it refers to the |
| 1553 | current face. | 1556 | current face. |
| 1554 | @end table | 1557 | @end table |
| 1555 | 1558 | ||
| @@ -1561,6 +1564,8 @@ the line to achieve the total height @var{line-height}. Otherwise, | |||
| 1561 | 1564 | ||
| 1562 | If you don't specify the @code{line-height} propery, the line's | 1565 | If you don't specify the @code{line-height} propery, the line's |
| 1563 | height consists of the contents' height plus the line spacing. | 1566 | height consists of the contents' height plus the line spacing. |
| 1567 | There are several ways to specify the line spacing for different | ||
| 1568 | parts of Emacs text. | ||
| 1564 | 1569 | ||
| 1565 | @vindex default-line-spacing | 1570 | @vindex default-line-spacing |
| 1566 | You can specify the line spacing for all lines in a frame with the | 1571 | You can specify the line spacing for all lines in a frame with the |
| @@ -1584,24 +1589,23 @@ property that controls the height of the display line ending with that | |||
| 1584 | newline. The property value overrides the default frame line spacing | 1589 | newline. The property value overrides the default frame line spacing |
| 1585 | and the buffer local @code{line-spacing} variable. | 1590 | and the buffer local @code{line-spacing} variable. |
| 1586 | 1591 | ||
| 1587 | One way or another, these mechanisms specify a line spacing for each | 1592 | One way or another, these mechanisms specify a Lisp value for the |
| 1588 | line. Let's call the value @var{line-spacing}. | 1593 | spacing of each line. The value is a height spec, and it translates |
| 1589 | 1594 | into a Lisp value as described above. However, in this case the | |
| 1590 | If the @var{line-spacing} value is a positive integer, it specifies | 1595 | numeric height value specifies the line spacing, rather than the line |
| 1591 | the number of pixels of additional vertical space. This space appears | 1596 | height. |
| 1592 | below the display line contents. | ||
| 1593 | |||
| 1594 | If the @var{line-spacing} value is a floating point number or cons, | ||
| 1595 | the additional vertical space is @var{line-spacing} times the frame | ||
| 1596 | default line height. | ||
| 1597 | 1597 | ||
| 1598 | @ignore @c I think we may want to delete this, so don't document it -- rms. | 1598 | There is one exception, however: if the @var{line-spacing} value is |
| 1599 | If the @var{line-spacing} value is a cons @code{(total . @var{spacing})} | 1599 | a cons @code{(total . @var{spacing})}, then @var{spacing} itself is |
| 1600 | where @var{spacing} is any of the forms described above, the value of | 1600 | treated as a heigh spec, and specifies the total displayed height of |
| 1601 | @var{spacing} specifies the total displayed height of the line, | 1601 | the line, so the line spacing equals the specified amount minus the |
| 1602 | regardless of the height of the characters in it. This is equivalent | 1602 | line height. This differs from using the @code{line-height} property |
| 1603 | to using the @code{line-height} property. | 1603 | because it adds space at the bottom of the line instead of the top. |
| 1604 | @end ignore | 1604 | |
| 1605 | If you specify both @code{line-spacing} using @code{total} and | ||
| 1606 | @code{line-height}, they are not redundant. First @code{line-height} | ||
| 1607 | goes to work, adding space above the line contents. Then | ||
| 1608 | @code{line-spacing} goes to work, adding space below the contents. | ||
| 1605 | 1609 | ||
| 1606 | @node Faces | 1610 | @node Faces |
| 1607 | @section Faces | 1611 | @section Faces |
diff --git a/lispref/elisp.texi b/lispref/elisp.texi index c8672f4d9ce..666659d15b3 100644 --- a/lispref/elisp.texi +++ b/lispref/elisp.texi | |||
| @@ -420,9 +420,15 @@ Macros | |||
| 420 | Loading | 420 | Loading |
| 421 | 421 | ||
| 422 | * How Programs Do Loading:: The @code{load} function and others. | 422 | * How Programs Do Loading:: The @code{load} function and others. |
| 423 | * Library Search:: Finding a library to load. | ||
| 424 | * Loading Non-ASCII:: Non-@acronym{ASCII} characters in Emacs Lisp files. | ||
| 423 | * Autoload:: Setting up a function to autoload. | 425 | * Autoload:: Setting up a function to autoload. |
| 424 | * Named Features:: Loading a library if it isn't already loaded. | ||
| 425 | * Repeated Loading:: Precautions about loading a file twice. | 426 | * Repeated Loading:: Precautions about loading a file twice. |
| 427 | * Named Features:: Loading a library if it isn't already loaded. | ||
| 428 | * Where Defined:: Finding which file defined a certain symbol. | ||
| 429 | * Unloading:: to ``unload'' a library that was loaded. | ||
| 430 | * Hooks for Loading:: Providing code to be run when | ||
| 431 | particular libraries are loaded. | ||
| 426 | 432 | ||
| 427 | Byte Compilation | 433 | Byte Compilation |
| 428 | 434 | ||
diff --git a/lispref/loading.texi b/lispref/loading.texi index 1b90ef5f2dd..221376f017a 100644 --- a/lispref/loading.texi +++ b/lispref/loading.texi | |||
| @@ -36,15 +36,16 @@ Similarly, a ``Lisp library directory'' is a directory of files | |||
| 36 | containing Lisp code. | 36 | containing Lisp code. |
| 37 | 37 | ||
| 38 | @menu | 38 | @menu |
| 39 | * How Programs Do Loading:: The @code{load} function and others. | 39 | * How Programs Do Loading:: The @code{load} function and others. |
| 40 | * Library Search:: Finding a library to load. | 40 | * Library Search:: Finding a library to load. |
| 41 | * Loading Non-ASCII:: Non-@acronym{ASCII} characters in Emacs Lisp files. | 41 | * Loading Non-ASCII:: Non-@acronym{ASCII} characters in Emacs Lisp files. |
| 42 | * Autoload:: Setting up a function to autoload. | 42 | * Autoload:: Setting up a function to autoload. |
| 43 | * Repeated Loading:: Precautions about loading a file twice. | 43 | * Repeated Loading:: Precautions about loading a file twice. |
| 44 | * Named Features:: Loading a library if it isn't already loaded. | 44 | * Named Features:: Loading a library if it isn't already loaded. |
| 45 | * Unloading:: How to ``unload'' a library that was loaded. | 45 | * Where Defined:: Finding which file defined a certain symbol. |
| 46 | * Hooks for Loading:: Providing code to be run when | 46 | * Unloading:: to ``unload'' a library that was loaded. |
| 47 | particular libraries are loaded. | 47 | * Hooks for Loading:: Providing code to be run when |
| 48 | particular libraries are loaded. | ||
| 48 | @end menu | 49 | @end menu |
| 49 | 50 | ||
| 50 | @node How Programs Do Loading | 51 | @node How Programs Do Loading |
| @@ -714,6 +715,60 @@ with a call to @code{provide}. The order of the elements in the | |||
| 714 | @code{features} list is not significant. | 715 | @code{features} list is not significant. |
| 715 | @end defvar | 716 | @end defvar |
| 716 | 717 | ||
| 718 | @node Where Defined | ||
| 719 | @section Which File Defined a Certain Symbol | ||
| 720 | |||
| 721 | @defun symbol-file symbol &optional type | ||
| 722 | This function returns the name of the file that defined @var{symbol}. | ||
| 723 | If @var{type} is @code{nil}, then any kind of definition is | ||
| 724 | acceptable. If @var{type} is @code{defun} or @code{defvar}, that | ||
| 725 | specifies function definition only or variable definition only. | ||
| 726 | |||
| 727 | The value is the file name as it was specified to @code{load}: | ||
| 728 | either an absolute file name, or a library name | ||
| 729 | (with no directory name and no @samp{.el} or @samp{.elc} at the end). | ||
| 730 | It can also be @code{nil}, if the definition is not associated with any file. | ||
| 731 | @end defun | ||
| 732 | |||
| 733 | The basis for @code{symbol-file} is the data in the variable | ||
| 734 | @code{load-history}. | ||
| 735 | |||
| 736 | @defvar load-history | ||
| 737 | This variable's value is an alist connecting library names with the | ||
| 738 | names of functions and variables they define, the features they provide, | ||
| 739 | and the features they require. | ||
| 740 | |||
| 741 | Each element is a list and describes one library. The @sc{car} of the | ||
| 742 | list is the name of the library, as a string. The rest of the list | ||
| 743 | elements have these forms: | ||
| 744 | |||
| 745 | @table @code | ||
| 746 | @item @var{var} | ||
| 747 | The symbol @var{var} was defined as a variable. | ||
| 748 | @item (defun . @var{fun}) | ||
| 749 | The @var{fun} was defined by this library. | ||
| 750 | @item (t . @var{fun}) | ||
| 751 | The function @var{fun} was previously an autoload before this library | ||
| 752 | redefined it as a function. The following element is always the | ||
| 753 | symbol @var{fun}, which signifies that the library defined @var{fun} | ||
| 754 | as a function. | ||
| 755 | @item (autoload . @var{fun}) | ||
| 756 | The function @var{fun} was defined as an autoload. | ||
| 757 | @item (require . @var{feature}) | ||
| 758 | The feature @var{feature} was required. | ||
| 759 | @item (provide . @var{feature}) | ||
| 760 | The feature @var{feature} was provided. | ||
| 761 | @end table | ||
| 762 | |||
| 763 | The value of @code{load-history} may have one element whose @sc{car} is | ||
| 764 | @code{nil}. This element describes definitions made with | ||
| 765 | @code{eval-buffer} on a buffer that is not visiting a file. | ||
| 766 | @end defvar | ||
| 767 | |||
| 768 | The command @code{eval-region} updates @code{load-history}, but does so | ||
| 769 | by adding the symbols defined to the element for the file being visited, | ||
| 770 | rather than replacing that element. @xref{Eval}. | ||
| 771 | |||
| 717 | @node Unloading | 772 | @node Unloading |
| 718 | @section Unloading | 773 | @section Unloading |
| 719 | @cindex unloading | 774 | @cindex unloading |
| @@ -760,42 +815,6 @@ ignored and you can unload any library. | |||
| 760 | The @code{unload-feature} function is written in Lisp; its actions are | 815 | The @code{unload-feature} function is written in Lisp; its actions are |
| 761 | based on the variable @code{load-history}. | 816 | based on the variable @code{load-history}. |
| 762 | 817 | ||
| 763 | @defvar load-history | ||
| 764 | This variable's value is an alist connecting library names with the | ||
| 765 | names of functions and variables they define, the features they provide, | ||
| 766 | and the features they require. | ||
| 767 | |||
| 768 | Each element is a list and describes one library. The @sc{car} of the | ||
| 769 | list is the name of the library, as a string. The rest of the list | ||
| 770 | elements have these forms: | ||
| 771 | |||
| 772 | @table @code | ||
| 773 | @item @var{fun} | ||
| 774 | The function @var{fun} was defined by this library. | ||
| 775 | @item (t . @var{fun}) | ||
| 776 | The function @var{fun} was previously an autoload before this library | ||
| 777 | redefined it as a function. The following element is always the | ||
| 778 | symbol @var{fun}, which signifies that the library defined @var{fun} | ||
| 779 | as a function. | ||
| 780 | @item (autoload . @var{fun}) | ||
| 781 | The function @var{fun} was defined as an autoload. | ||
| 782 | @item (defvar . @var{var}) | ||
| 783 | The symbol @var{var} was defined as a variable. | ||
| 784 | @item (require . @var{feature}) | ||
| 785 | The feature @var{feature} was required. | ||
| 786 | @item (provide . @var{feature}) | ||
| 787 | The feature @var{feature} was provided. | ||
| 788 | @end table | ||
| 789 | |||
| 790 | The value of @code{load-history} may have one element whose @sc{car} is | ||
| 791 | @code{nil}. This element describes definitions made with | ||
| 792 | @code{eval-buffer} on a buffer that is not visiting a file. | ||
| 793 | @end defvar | ||
| 794 | |||
| 795 | The command @code{eval-region} updates @code{load-history}, but does so | ||
| 796 | by adding the symbols defined to the element for the file being visited, | ||
| 797 | rather than replacing that element. @xref{Eval}. | ||
| 798 | |||
| 799 | @defvar unload-feature-special-hooks | 818 | @defvar unload-feature-special-hooks |
| 800 | This variable holds a list of hooks to be scanned before unloading a | 819 | This variable holds a list of hooks to be scanned before unloading a |
| 801 | library, to remove functions defined in the library. | 820 | library, to remove functions defined in the library. |
diff --git a/lispref/modes.texi b/lispref/modes.texi index 01958873d33..2abb8a9c0d9 100644 --- a/lispref/modes.texi +++ b/lispref/modes.texi | |||
| @@ -1736,7 +1736,7 @@ It is normally @code{nil}, so that ordinary buffers have no header line. | |||
| 1736 | the text that would appear in a mode line or header line | 1736 | the text that would appear in a mode line or header line |
| 1737 | based on certain mode-line specification. | 1737 | based on certain mode-line specification. |
| 1738 | 1738 | ||
| 1739 | @defun format-mode-line &optional format window no-props | 1739 | @defun format-mode-line &optional format window no-props buffer |
| 1740 | This function formats a line of text according to @var{format} as if | 1740 | This function formats a line of text according to @var{format} as if |
| 1741 | it were generating the mode line for @var{window}, but instead of | 1741 | it were generating the mode line for @var{window}, but instead of |
| 1742 | displaying the text in the mode line or the header line, it returns | 1742 | displaying the text in the mode line or the header line, it returns |
| @@ -1752,6 +1752,8 @@ The argument @var{window} defaults to the selected window. | |||
| 1752 | The value string normally has text properties that correspond to the | 1752 | The value string normally has text properties that correspond to the |
| 1753 | faces, keymaps, etc., that the mode line would have. If | 1753 | faces, keymaps, etc., that the mode line would have. If |
| 1754 | @var{no-props} is non-@code{nil}, the value has no text properties. | 1754 | @var{no-props} is non-@code{nil}, the value has no text properties. |
| 1755 | If @var{buffer} is non-@code{nil}, all the information used is taken | ||
| 1756 | from @var{buffer}; by default,it comes from @var{window}'s buffer. | ||
| 1755 | @end defun | 1757 | @end defun |
| 1756 | 1758 | ||
| 1757 | @node Imenu | 1759 | @node Imenu |