aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorChong Yidong2009-03-29 17:42:26 +0000
committerChong Yidong2009-03-29 17:42:26 +0000
commit2079438ac666b09e29e908116e4e386daba8976c (patch)
tree86576ece4d2abd3f58d54e84c58bd46e328b5b03
parentb9723f39840bc9dd64982e1499651f2a13517e83 (diff)
downloademacs-2079438ac666b09e29e908116e4e386daba8976c.tar.gz
emacs-2079438ac666b09e29e908116e4e386daba8976c.zip
(Mode Line Variables): The default values of the mode
line variables are now more complicated.
-rw-r--r--doc/lispref/modes.texi68
1 files changed, 17 insertions, 51 deletions
diff --git a/doc/lispref/modes.texi b/doc/lispref/modes.texi
index cd923e8fe4d..f166877b45c 100644
--- a/doc/lispref/modes.texi
+++ b/doc/lispref/modes.texi
@@ -1800,53 +1800,31 @@ current input method. @xref{Non-ASCII Characters}.
1800 1800
1801@defvar mode-line-modified 1801@defvar mode-line-modified
1802This variable holds the value of the mode-line construct that displays 1802This variable holds the value of the mode-line construct that displays
1803whether the current buffer is modified. 1803whether the current buffer is modified. Its default value displays
1804 1804@samp{**} if the buffer is modified, @samp{--} if the buffer is not
1805The default value of @code{mode-line-modified} is @code{("%1*%1+")}. 1805modified, @samp{%%} if the buffer is read only, and @samp{%*} if the
1806This means that the mode line displays @samp{**} if the buffer is 1806buffer is read only and modified.
1807modified, @samp{--} if the buffer is not modified, @samp{%%} if the
1808buffer is read only, and @samp{%*} if the buffer is read only and
1809modified.
1810 1807
1811Changing this variable does not force an update of the mode line. 1808Changing this variable does not force an update of the mode line.
1812@end defvar 1809@end defvar
1813 1810
1814@defvar mode-line-frame-identification 1811@defvar mode-line-frame-identification
1815This variable identifies the current frame. The default value is 1812This variable identifies the current frame. Its default value
1816@code{" "} if you are using a window system which can show multiple 1813displays @code{" "} if you are using a window system which can show
1817frames, or @code{"-%F "} on an ordinary terminal which shows only one 1814multiple frames, or @code{"-%F "} on an ordinary terminal which shows
1818frame at a time. 1815only one frame at a time.
1819@end defvar 1816@end defvar
1820 1817
1821@defvar mode-line-buffer-identification 1818@defvar mode-line-buffer-identification
1822This variable identifies the buffer being displayed in the window. Its 1819This variable identifies the buffer being displayed in the window.
1823default value is @code{("%12b")}, which displays the buffer name, padded 1820Its default value displays the buffer name, padded with spaces to at
1824with spaces to at least 12 columns. 1821least 12 columns.
1825@end defvar 1822@end defvar
1826 1823
1827@defvar mode-line-position 1824@defvar mode-line-position
1828This variable indicates the position in the buffer. Here is a 1825This variable indicates the position in the buffer. Its default value
1829simplified version of its default value. The actual default value 1826displays the buffer percentage and, optionally, the buffer size, the
1830also specifies addition of the @code{help-echo} text property. 1827line number and the column number.
1831
1832@example
1833@group
1834((-3 "%p")
1835 (size-indication-mode (8 " of %I"))
1836@end group
1837@group
1838 (line-number-mode
1839 ((column-number-mode
1840 (10 " (%l,%c)")
1841 (6 " L%l")))
1842 ((column-number-mode
1843 (5 " C%c")))))
1844@end group
1845@end example
1846
1847This means that @code{mode-line-position} displays at least the buffer
1848percentage and possibly the buffer size, the line number and the column
1849number.
1850@end defvar 1828@end defvar
1851 1829
1852@defvar vc-mode 1830@defvar vc-mode
@@ -1857,21 +1835,9 @@ line, or @code{nil} for no version control.
1857@end defvar 1835@end defvar
1858 1836
1859@defvar mode-line-modes 1837@defvar mode-line-modes
1860This variable displays the buffer's major and minor modes. Here is a 1838This variable displays the buffer's major and minor modes. Its
1861simplified version of its default value. The real default value also 1839default value also displays the recursive editing level, information
1862specifies addition of text properties. 1840on the process status, and whether narrowing is in effect.
1863
1864@example
1865@group
1866("%[(" mode-name
1867 mode-line-process minor-mode-alist
1868 "%n" ")%]--")
1869@end group
1870@end example
1871
1872So @code{mode-line-modes} normally also displays the recursive editing
1873level, information on the process status and whether narrowing is in
1874effect.
1875@end defvar 1841@end defvar
1876 1842
1877 The following three variables are used in @code{mode-line-modes}: 1843 The following three variables are used in @code{mode-line-modes}: