comparison doc/lispref/display.texi @ 102981:789bf99f58e7

* display.texi (Line Height): Emphasize that line-spacing only takes effect on graphical terminals.
author Chong Yidong <cyd@stupidchicken.com>
date Wed, 15 Apr 2009 22:06:52 +0000
parents efeb215b8665
children c32ec20d0ab5
comparison
equal deleted inserted replaced
102980:4ac543a14f94 102981:789bf99f58e7
1763 height consists of the contents' height plus the line spacing. 1763 height consists of the contents' height plus the line spacing.
1764 There are several ways to specify the line spacing for different 1764 There are several ways to specify the line spacing for different
1765 parts of Emacs text. 1765 parts of Emacs text.
1766 1766
1767 @vindex default-line-spacing 1767 @vindex default-line-spacing
1768 You can specify the line spacing for all lines in a frame with the 1768 On graphical terminals, you can specify the line spacing for all
1769 @code{line-spacing} frame parameter (@pxref{Layout Parameters}). 1769 lines in a frame, using the @code{line-spacing} frame parameter
1770 However, if the variable @code{default-line-spacing} is 1770 (@pxref{Layout Parameters}). However, if the variable
1771 non-@code{nil}, it overrides the frame's @code{line-spacing} 1771 @code{default-line-spacing} is non-@code{nil}, it overrides the
1772 parameter. An integer value specifies the number of pixels put below 1772 frame's @code{line-spacing} parameter. An integer value specifies the
1773 lines on graphical displays. A floating point number specifies the 1773 number of pixels put below lines. A floating point number specifies
1774 spacing relative to the frame's default line height. 1774 the spacing relative to the frame's default line height.
1775 1775
1776 @vindex line-spacing 1776 @vindex line-spacing
1777 You can specify the line spacing for all lines in a buffer via the 1777 You can specify the line spacing for all lines in a buffer via the
1778 buffer-local @code{line-spacing} variable. An integer value specifies 1778 buffer-local @code{line-spacing} variable. An integer value specifies
1779 the number of pixels put below lines on graphical displays. A floating 1779 the number of pixels put below lines. A floating point number
1780 point number specifies the spacing relative to the default frame line 1780 specifies the spacing relative to the default frame line height. This
1781 height. This overrides line spacings specified for the frame. 1781 overrides line spacings specified for the frame.
1782 1782
1783 @kindex line-spacing @r{(text property)} 1783 @kindex line-spacing @r{(text property)}
1784 Finally, a newline can have a @code{line-spacing} text or overlay 1784 Finally, a newline can have a @code{line-spacing} text or overlay
1785 property that overrides the default frame line spacing and the buffer 1785 property that overrides the default frame line spacing and the buffer
1786 local @code{line-spacing} variable, for the display line ending in 1786 local @code{line-spacing} variable, for the display line ending in
1789 One way or another, these mechanisms specify a Lisp value for the 1789 One way or another, these mechanisms specify a Lisp value for the
1790 spacing of each line. The value is a height spec, and it translates 1790 spacing of each line. The value is a height spec, and it translates
1791 into a Lisp value as described above. However, in this case the 1791 into a Lisp value as described above. However, in this case the
1792 numeric height value specifies the line spacing, rather than the line 1792 numeric height value specifies the line spacing, rather than the line
1793 height. 1793 height.
1794
1795 On text-only terminals, the line spacing cannot be altered.
1794 1796
1795 @node Faces 1797 @node Faces
1796 @section Faces 1798 @section Faces
1797 @cindex faces 1799 @cindex faces
1798 1800