aboutsummaryrefslogtreecommitdiffstats
path: root/lispref
diff options
context:
space:
mode:
authorKaroly Lorentey2005-01-06 15:00:09 +0000
committerKaroly Lorentey2005-01-06 15:00:09 +0000
commit0feecea9fb7079a2c1fbfee32a992449a22cf478 (patch)
tree0826d68e3dc2ce370c7bd4dae7db3cffc3568321 /lispref
parent17d51b68fb4e7da4f18eff72c589b7ffc4f9c22c (diff)
parent1a63439b34c3455a317feda5c271dfdb7af0296b (diff)
downloademacs-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/ChangeLog15
-rw-r--r--lispref/Makefile.in2
-rw-r--r--lispref/buffers.texi7
-rw-r--r--lispref/display.texi56
-rw-r--r--lispref/elisp.texi8
-rw-r--r--lispref/loading.texi109
-rw-r--r--lispref/modes.texi4
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 @@
12004-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
12004-12-21 Richard M. Stallman <rms@gnu.org> 162004-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
31TEXI2DVI = texi2dvi 31TEXI2DVI = texi2dvi
32SHELL = /bin/sh 32SHELL = /bin/sh
33INSTALL_INFO = install-info 33INSTALL_INFO = install-info
34MAKEINFO = makeinfo 34MAKEINFO = makeinfo --force
35 35
36# The name of the manual: 36# The name of the manual:
37VERSION=2.9 37VERSION=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.
1041for any reason. @xref{Buffer-Local Variables}. 1041for any reason. @xref{Buffer-Local Variables}.
1042@end defvar 1042@end defvar
1043 1043
1044@defvar buffer-save-without-query
1045This variable, if non-@code{nil} in a particular buffer, tells
1046@code{save-buffers-kill-emacs} and @code{save-some-buffers} to save
1047this buffer (if it's modified) without asking the user. The variable
1048automatically becomes buffer-local when set for any reason.
1049@end defvar
1050
1044@defun buffer-live-p object 1051@defun buffer-live-p object
1045This function returns @code{t} if @var{object} is a buffer which has 1052This function returns @code{t} if @var{object} is a buffer which has
1046not been killed, @code{nil} otherwise. 1053not 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
1534that controls the total height of the display line ending in that 1534that controls the total height of the display line ending in that
1535newline. If the property value is zero, the displayed height of the 1535newline. If the property value is zero, the displayed height of the
1536line is exactly what its contents need; no line-spacing is added. 1536line is exactly what its contents demand; no line-spacing is added.
1537This case is useful for tiling small images or image slices without 1537This case is useful for tiling small images or image slices without
1538adding blank areas between the images. 1538adding 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: 1541spec stands for a numeric height value; this heigh spec specifies the
1542actual line height, @var{line-height}. There are several ways to
1543write a height spec; here's how each of them translates into a numeric
1544height:
1542 1545
1543@table @code 1546@table @code
1544@item @var{integer} 1547@item @var{integer}
1545If the property is a positive integer, @var{line-height} is that integer. 1548If the height spec is a positive integer, the height value is that integer.
1546@item @var{float} 1549@item @var{float}
1547If the property is a float, @var{float}, @var{line-height} is @var{float} 1550If the height spec is a float, @var{float}, the numeric height value
1548times the frame's default line height. 1551is @var{float} times the frame's default line height.
1549@item (@var{ratio} . @var{face}) 1552@item (@var{ratio} . @var{face})
1550If the property is a cons of the format shown, @var{line-height} is 1553If 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 1554is @var{ratio} times the height of face @var{face}. @var{ratio} can
1552any type of number. If @var{face} is @code{t}, it refers to the 1555be any type of number. If @var{face} is @code{t}, it refers to the
1553current face. 1556current 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
1563height consists of the contents' height plus the line spacing. 1566height consists of the contents' height plus the line spacing.
1567There are several ways to specify the line spacing for different
1568parts 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
1584newline. The property value overrides the default frame line spacing 1589newline. The property value overrides the default frame line spacing
1585and the buffer local @code{line-spacing} variable. 1590and 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
1588line. Let's call the value @var{line-spacing}. 1593spacing of each line. The value is a height spec, and it translates
1589 1594into a Lisp value as described above. However, in this case the
1590 If the @var{line-spacing} value is a positive integer, it specifies 1595numeric height value specifies the line spacing, rather than the line
1591the number of pixels of additional vertical space. This space appears 1596height.
1592below the display line contents.
1593
1594 If the @var{line-spacing} value is a floating point number or cons,
1595the additional vertical space is @var{line-spacing} times the frame
1596default 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})} 1599a cons @code{(total . @var{spacing})}, then @var{spacing} itself is
1600where @var{spacing} is any of the forms described above, the value of 1600treated as a heigh spec, and specifies the total displayed height of
1601@var{spacing} specifies the total displayed height of the line, 1601the line, so the line spacing equals the specified amount minus the
1602regardless of the height of the characters in it. This is equivalent 1602line height. This differs from using the @code{line-height} property
1603to using the @code{line-height} property. 1603because 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}
1607goes 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
420Loading 420Loading
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
427Byte Compilation 433Byte 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
36containing Lisp code. 36containing 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
722This function returns the name of the file that defined @var{symbol}.
723If @var{type} is @code{nil}, then any kind of definition is
724acceptable. If @var{type} is @code{defun} or @code{defvar}, that
725specifies function definition only or variable definition only.
726
727The value is the file name as it was specified to @code{load}:
728either an absolute file name, or a library name
729(with no directory name and no @samp{.el} or @samp{.elc} at the end).
730It 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
737This variable's value is an alist connecting library names with the
738names of functions and variables they define, the features they provide,
739and the features they require.
740
741Each element is a list and describes one library. The @sc{car} of the
742list is the name of the library, as a string. The rest of the list
743elements have these forms:
744
745@table @code
746@item @var{var}
747The symbol @var{var} was defined as a variable.
748@item (defun . @var{fun})
749The @var{fun} was defined by this library.
750@item (t . @var{fun})
751The function @var{fun} was previously an autoload before this library
752redefined it as a function. The following element is always the
753symbol @var{fun}, which signifies that the library defined @var{fun}
754as a function.
755@item (autoload . @var{fun})
756The function @var{fun} was defined as an autoload.
757@item (require . @var{feature})
758The feature @var{feature} was required.
759@item (provide . @var{feature})
760The feature @var{feature} was provided.
761@end table
762
763The 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
769by adding the symbols defined to the element for the file being visited,
770rather 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
761based on the variable @code{load-history}. 816based on the variable @code{load-history}.
762 817
763@defvar load-history
764This variable's value is an alist connecting library names with the
765names of functions and variables they define, the features they provide,
766and the features they require.
767
768Each element is a list and describes one library. The @sc{car} of the
769list is the name of the library, as a string. The rest of the list
770elements have these forms:
771
772@table @code
773@item @var{fun}
774The function @var{fun} was defined by this library.
775@item (t . @var{fun})
776The function @var{fun} was previously an autoload before this library
777redefined it as a function. The following element is always the
778symbol @var{fun}, which signifies that the library defined @var{fun}
779as a function.
780@item (autoload . @var{fun})
781The function @var{fun} was defined as an autoload.
782@item (defvar . @var{var})
783The symbol @var{var} was defined as a variable.
784@item (require . @var{feature})
785The feature @var{feature} was required.
786@item (provide . @var{feature})
787The feature @var{feature} was provided.
788@end table
789
790The 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
796by adding the symbols defined to the element for the file being visited,
797rather than replacing that element. @xref{Eval}.
798
799@defvar unload-feature-special-hooks 818@defvar unload-feature-special-hooks
800This variable holds a list of hooks to be scanned before unloading a 819This variable holds a list of hooks to be scanned before unloading a
801library, to remove functions defined in the library. 820library, 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.
1736the text that would appear in a mode line or header line 1736the text that would appear in a mode line or header line
1737based on certain mode-line specification. 1737based 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
1740This function formats a line of text according to @var{format} as if 1740This function formats a line of text according to @var{format} as if
1741it were generating the mode line for @var{window}, but instead of 1741it were generating the mode line for @var{window}, but instead of
1742displaying the text in the mode line or the header line, it returns 1742displaying 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.
1752The value string normally has text properties that correspond to the 1752The value string normally has text properties that correspond to the
1753faces, keymaps, etc., that the mode line would have. If 1753faces, 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.
1755If @var{buffer} is non-@code{nil}, all the information used is taken
1756from @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