23.4.5 %-Constructs in the Mode Line

Strings used as mode-line constructs can use certain %-constructs to substitute various kinds of data. Here is a list of the defined %-constructs, and what they mean. In any construct except ‘%%’, you can add a decimal integer after the ‘%’ to specify a minimum field width. If the width is less, the field is padded with spaces to the right.

%b

The current buffer name, obtained with the buffer-name function. Voir la section Buffer Names.

%c

The current column number of point.

%e

When Emacs is nearly out of memory for Lisp objects, a brief message saying so. Otherwise, this is empty.

%f

The visited file name, obtained with the buffer-file-name function. Voir la section Buffer File Name.

%F

The title (only on a window system) or the name of the selected frame. Voir la section Basic Parameters.

%i

The size of the accessible part of the current buffer; basically (- (point-max) (point-min)).

%I

Like ‘%i’, but the size is printed in a more readable way by using ‘k’ for 10^3, ‘M’ for 10^6, ‘G’ for 10^9, etc., to abbreviate.

%l

The current line number of point, counting within the accessible portion of the buffer.

%n

‘Narrow’ when narrowing is in effect; nothing otherwise (see narrow-to-region in Narrowing).

%p

The percentage of the buffer text above the top of window, or ‘Top’, ‘Bottom’ or ‘All’. Note that the default mode-line specification truncates this to three characters.

%P

The percentage of the buffer text that is above the bottom of the window (which includes the text visible in the window, as well as the text above the top), plus ‘Top’ if the top of the buffer is visible on screen; or ‘Bottom’ or ‘All’.

%s

The status of the subprocess belonging to the current buffer, obtained with process-status. Voir la section Process Information.

%t

Whether the visited file is a text file or a binary file. This is a meaningful distinction only on certain operating systems (voir la section MS-DOS File Types).

%z

The mnemonics of keyboard, terminal, and buffer coding systems.

%Z

Like ‘%z’, but including the end-of-line format.

%*

‘%’ if the buffer is read only (see buffer-read-only);
‘*’ if the buffer is modified (see buffer-modified-p);
‘-’ otherwise. Voir la section Buffer Modification.

%+

‘*’ if the buffer is modified (see buffer-modified-p);
‘%’ if the buffer is read only (see buffer-read-only);
‘-’ otherwise. This differs from ‘%*’ only for a modified read-only buffer. Voir la section Buffer Modification.

%&

‘*’ if the buffer is modified, and ‘-’ otherwise.

%[

An indication of the depth of recursive editing levels (not counting minibuffer levels): one ‘[’ for each editing level. Voir la section Recursive Editing.

%]

One ‘]’ for each recursive editing level (not counting minibuffer levels).

%-

Dashes sufficient to fill the remainder of the mode line.

%%

The character ‘%’—this is how to include a literal ‘%’ in a string in which %-constructs are allowed.

The following two %-constructs are still supported, but they are obsolete, since you can get the same results with the variables mode-name and global-mode-string.

%m

The value of mode-name.

%M

The value of global-mode-string.

Ce document a été généré par Eric Reinbold le 13 Octobre 2007 en utilisant texi2html 1.78.