the text that would appear in a mode line or header line
based on certain mode-line specification.
-@defun format-mode-line format &optional window no-props buffer face
+@defun format-mode-line format &optional face window buffer
This function formats a line of text according to @var{format} as if
it were generating the mode line for @var{window}, but instead of
displaying the text in the mode line or the header line, it returns
that stands for either @code{mode-line} if @var{window} is selected,
otherwise @code{mode-line-inactive}.)
-However, if @var{no-props} is non-@code{nil}, the value has no text
-properties.
+However, if @var{face} is an integer, the value has no text properties.
For example, @code{(format-mode-line header-line-format)} returns the
text that would appear in the selected window's header line (@code{""}
if it has no header line). @code{(format-mode-line header-line-format
-nil nil nil 'header-line)} returns the same text, with each character
+'header-line)} returns the same text, with each character
carrying the face that it will have in the header line itself.
@end defun