Mercurial > emacs

--- a/doc/lispref/ChangeLog	Thu May 21 11:24:19 2009 +0000
+++ b/doc/lispref/ChangeLog	Thu May 21 15:31:31 2009 +0000
@@ -1,3 +1,91 @@
+2009-05-21  Martin Rudalics  <rudalics@gmx.at>
+
+	* abbrevs.texi (Abbrev Mode): abbrev-mode is an option.
+
+	* backups.texi (Making Backups): backup-directory-alist and
+	make-backup-file-name-function are options.
+	(Auto-Saving): auto-save-list-file-prefix is an option.
+
+	* buffers.texi (Killing Buffers): buffer-offer-save is an
+	option.
+
+	* display.texi (Refresh Screen): no-redraw-on-reenter is an
+	option.
+	(Echo Area Customization): echo-keystrokes is an option.
+	(Selective Display): selective-display-ellipses is an option.
+	(Temporary Displays): temp-buffer-show-function is an option.
+	(Face Attributes): underline-minimum-offset and x-bitmap-file-path
+	are options.
+	(Font Selection): face-font-family-alternatives,
+	face-font-selection-order, face-font-registry-alternatives, and
+	scalable-fonts-allowed are options.
+	(Fringe Indicators): indicate-buffer-boundaries is an option.
+	(Fringe Cursors): overflow-newline-into-fringe is an option.
+	(Scroll Bars): scroll-bar-mode is an option.
+
+	* eval.texi (Eval): max-lisp-eval-depth is an option.
+
+	* files.texi (Visiting Functions): find-file-hook is an option.
+	(Directory Names): directory-abbrev-alist is an option.
+	(Unique File Names): temporary-file-directory and
+	small-temporary-file-directory are options.
+
+	* frames.texi (Initial Parameters): initial-frame-alist,
+	minibuffer-frame-alist and default-frame-alist are options.
+	(Cursor Parameters): blink-cursor-alist and
+	cursor-in-non-selected-windows ar options.
+	(Window System Selections): selection-coding-system is an
+	option.
+	(Display Feature Testing): display-mm-dimensions-alist is an
+	option.
+
+	* help.texi (Help Functions): help-char and help-event-list are
+	options.
+
+	* keymaps.texi (Functions for Key Lookup): meta-prefix-char is
+	an option.
+
+	* minibuf.texi (Minibuffer History): history-length and
+	history-delete-duplicates are options.
+	(High-Level Completion): read-buffer-function and
+	read-buffer-completion-ignore-case are options.
+	(Reading File Names): read-file-name-completion-ignore-case is
+	an option.
+
+	* modes.texi (Mode Line Top): mode-line-format is an option.
+	(Mode Line Variables): mode-line-position and mode-line-modes
+	are options.
+
+	* nonascii.texi (Text Representations):
+	enable-multibyte-characters is an option.
+	(Default Coding Systems): auto-coding-regexp-alist,
+	file-coding-system-alist, auto-coding-alist and
+	auto-coding-functions are options.
+	(Specifying Coding Systems): inhibit-eol-conversion is an
+	option.
+
+	* os.texi (Init File): site-run-file is an option.
+	(System Environment): mail-host-address is an option.
+	(User Identification): user-mail-address is an option.
+	(Terminal Output): baud-rate is an option.
+
+	* positions.texi (Word Motion): words-include-escapes is an
+	option.
+
+	* searching.texi (Standard Regexps): page-delimiter,
+	paragraph-separate, paragraph-separate and sentence-end are
+	options.
+
+	* text.texi (Margins): left-margin and fill-nobreak-predicate
+	are options.
+
+	* variables.texi (Local Variables): max-specpdl-size is an
+	option.
+
+	* windows.texi (Choosing Window):
+	split-window-preferred-function, special-display-function and
+	display-buffer-function are options.
+
 2009-05-20  Chong Yidong  <cyd@stupidchicken.com>

 	Fix errors spotted by Martin Rudalics.
--- a/doc/lispref/abbrevs.texi	Thu May 21 11:24:19 2009 +0000
+++ b/doc/lispref/abbrevs.texi	Thu May 21 15:31:31 2009 +0000
@@ -64,13 +64,13 @@
   Abbrev mode is a minor mode controlled by the variable
 @code{abbrev-mode}.

-@defvar abbrev-mode
+@defopt abbrev-mode
 If this variable is non-@code{nil}, abbrevs are automatically expanded
 in the buffer.  If the value is @code{nil}, abbrevs may be defined,
 but they are not expanded automatically.

 This variable automatically becomes buffer-local when set in any fashion.
-@end defvar
+@end defopt

 @defvar default-abbrev-mode
 This is the value of @code{abbrev-mode} for buffers that do not
--- a/doc/lispref/backups.texi	Thu May 21 11:24:19 2009 +0000
+++ b/doc/lispref/backups.texi	Thu May 21 15:31:31 2009 +0000
@@ -122,7 +122,7 @@
 @code{make-backup-files} instead.
 @end defvar

-@defvar backup-directory-alist
+@defopt backup-directory-alist
 This variable's value is an alist of filename patterns and backup
 directory names.  Each element looks like
 @smallexample
@@ -147,9 +147,9 @@

 On MS-DOS filesystems without long names this variable is always
 ignored.
-@end defvar
+@end defopt

-@defvar make-backup-file-name-function
+@defopt make-backup-file-name-function
 This variable's value is a function to use for making backups instead
 of the default @code{make-backup-file-name}.  A value of @code{nil}
 gives the default @code{make-backup-file-name} behavior.
@@ -158,7 +158,7 @@
 This could be buffer-local to do something special for specific
 files.  If you define it, you may need to change
 @code{backup-file-name-p} and @code{file-name-sans-versions} too.
-@end defvar
+@end defopt


 @node Rename or Copy
@@ -652,13 +652,13 @@
 host name.
 @end defvar

-@defvar auto-save-list-file-prefix
+@defopt auto-save-list-file-prefix
 After Emacs reads your init file, it initializes
 @code{auto-save-list-file-name} (if you have not already set it
 non-@code{nil}) based on this prefix, adding the host name and process
 ID.  If you set this to @code{nil} in your init file, then Emacs does
 not initialize @code{auto-save-list-file-name}.
-@end defvar
+@end defopt

 @node Reverting
 @section Reverting
--- a/doc/lispref/buffers.texi	Thu May 21 11:24:19 2009 +0000
+++ b/doc/lispref/buffers.texi	Thu May 21 15:31:31 2009 +0000
@@ -1065,7 +1065,7 @@
 is not cleared by changing major modes.
 @end defvar

-@defvar buffer-offer-save
+@defopt buffer-offer-save
 This variable, if non-@code{nil} in a particular buffer, tells
 @code{save-buffers-kill-emacs} and @code{save-some-buffers} (if the
 second optional argument to that function is @code{t}) to offer to
@@ -1073,7 +1073,7 @@
 @xref{Definition of save-some-buffers}.  The variable
 @code{buffer-offer-save} automatically becomes buffer-local when set
 for any reason.  @xref{Buffer-Local Variables}.
-@end defvar
+@end defopt

 @defvar buffer-save-without-query
 This variable, if non-@code{nil} in a particular buffer, tells
--- a/doc/lispref/display.texi	Thu May 21 11:24:19 2009 +0000
+++ b/doc/lispref/display.texi	Thu May 21 15:31:31 2009 +0000
@@ -66,13 +66,13 @@
 sequential display.  If you are using such a terminal, you might want
 to inhibit the redisplay on resumption.

-@defvar no-redraw-on-reenter
+@defopt no-redraw-on-reenter
 @cindex suspend (cf. @code{no-redraw-on-reenter})
 @cindex resume (cf. @code{no-redraw-on-reenter})
 This variable controls whether Emacs redraws the entire screen after it
 has been suspended and resumed.  Non-@code{nil} means there is no need
 to redraw, @code{nil} means redrawing is needed.  The default is @code{nil}.
-@end defvar
+@end defopt

 @node Forcing Redisplay
 @section Forcing Redisplay
@@ -543,7 +543,7 @@
 @code{(message nil)} or for any other reason.
 @end defvar

-@defvar echo-keystrokes
+@defopt echo-keystrokes
 This variable determines how much time should elapse before command
 characters echo.  Its value must be an integer or floating point number,
 which specifies the
@@ -554,7 +554,7 @@
 sequence are echoed immediately.)

 If the value is zero, then command input is not echoed.
-@end defvar
+@end defopt

 @defvar message-truncate-lines
 Normally, displaying a long message resizes the echo area to display
@@ -994,7 +994,7 @@
 @end example
 @end defvar

-@defvar selective-display-ellipses
+@defopt selective-display-ellipses
 If this buffer-local variable is non-@code{nil}, then Emacs displays
 @samp{@dots{}} at the end of a line that is followed by hidden text.
 This example is a continuation of the previous one.
@@ -1015,7 +1015,7 @@

 You can use a display table to substitute other text for the ellipsis
 (@samp{@dots{}}).  @xref{Display Tables}.
-@end defvar
+@end defopt

 @node Temporary Displays
 @section Temporary Displays
@@ -1078,7 +1078,7 @@
 @end example
 @end defspec

-@defvar temp-buffer-show-function
+@defopt temp-buffer-show-function
 If this variable is non-@code{nil}, @code{with-output-to-temp-buffer}
 calls it as a function to do the job of displaying a help buffer.  The
 function gets one argument, which is the buffer it should display.
@@ -1087,7 +1087,7 @@
 just as @code{with-output-to-temp-buffer} normally would, inside of
 @code{save-selected-window} and with the chosen window and buffer
 selected.
-@end defvar
+@end defopt

 @defvar temp-buffer-setup-hook
 This normal hook is run by @code{with-output-to-temp-buffer} before
@@ -2162,15 +2162,15 @@
 to be displayed; if it is @code{nil}, the selected frame is used.
 @end defun

-@defvar underline-minimum-offset
+@defopt underline-minimum-offset
 This variable specifies the minimum distance between the baseline and
 the underline, in pixels, when displaying underlined text.
-@end defvar
-
-@defvar x-bitmap-file-path
+@end defopt
+
+@defopt x-bitmap-file-path
 This variable specifies a list of directories for searching
 for bitmap files, for the @code{:stipple} attribute.
-@end defvar
+@end defopt

 @defun bitmap-spec-p object
 This returns @code{t} if @var{object} is a valid bitmap specification,
@@ -2674,7 +2674,7 @@
 Emacs looks for the @dfn{closest matching font}.  The variables in
 this section control how Emacs makes this selection.

-@defvar face-font-family-alternatives
+@defopt face-font-family-alternatives
 If a given family is specified but does not exist, this variable
 specifies alternative font families to try.  Each element should have
 this form:
@@ -2686,9 +2686,9 @@
 If @var{family} is specified but not available, Emacs will try the other
 families given in @var{alternate-families}, one by one, until it finds a
 family that does exist.
-@end defvar
-
-@defvar face-font-selection-order
+@end defopt
+
+@defopt face-font-selection-order
 If there is no font that exactly matches all desired face attributes
 (@code{:width}, @code{:height}, @code{:weight}, and @code{:slant}),
 this variable specifies the order in which these attributes should be
@@ -2714,9 +2714,9 @@
 default one.  But if you put @code{:slant} before @code{:height}, the
 @code{italic} face will use an italic font, even if its height is not
 quite right.
-@end defvar
-
-@defvar face-font-registry-alternatives
+@end defopt
+
+@defopt face-font-registry-alternatives
 This variable lets you specify alternative font registries to try, if a
 given registry is specified and doesn't exist.  Each element should have
 this form:
@@ -2728,12 +2728,12 @@
 If @var{registry} is specified but not available, Emacs will try the
 other registries given in @var{alternate-registries}, one by one,
 until it finds a registry that does exist.
-@end defvar
+@end defopt

   Emacs can make use of scalable fonts, but by default it does not use
 them.

-@defvar scalable-fonts-allowed
+@defopt scalable-fonts-allowed
 This variable controls which scalable fonts to use.  A value of
 @code{nil}, the default, means do not use scalable fonts.  @code{t}
 means to use any scalable font that seems appropriate for the text.
@@ -2748,7 +2748,7 @@

 @noindent
 allows the use of scalable fonts with registry @code{muleindian-2}.
-@end defvar
+@end defopt

 @defvar face-font-rescale-alist
 This variable specifies scaling for certain faces.  Its value should
@@ -3214,7 +3214,7 @@
 buffer-local in every buffer.
 @end defopt

-@defvar indicate-buffer-boundaries
+@defopt indicate-buffer-boundaries
 This buffer-local variable controls how the buffer boundaries and
 window scrolling are indicated in the window fringes.

@@ -3250,7 +3250,7 @@
 bitmap in left fringe, and the bottom angle bitmap as well as both
 arrow bitmaps in right fringe.  To show the angle bitmaps in the left
 fringe, and no arrow bitmaps, use @code{((top .  left) (bottom . left))}.
-@end defvar
+@end defopt

 @defvar default-indicate-buffer-boundaries
 The value of this variable is the default value for
@@ -3345,12 +3345,12 @@
 normal @code{hollow-rectangle} bitmap is too tall to fit on a specific
 display line.

-@defvar overflow-newline-into-fringe
+@defopt overflow-newline-into-fringe
 If this is non-@code{nil}, lines exactly as wide as the window (not
 counting the final newline character) are not continued.  Instead,
 when point is at the end of the line, the cursor appears in the right
 fringe.
-@end defvar
+@end defopt

 @defvar fringe-cursor-alist
 This variable specifies the mapping from logical cursor type to the
@@ -3587,12 +3587,12 @@
 window take note of the new values by calling @code{set-window-buffer}
 specifying the same buffer that is already displayed.

-@defvar scroll-bar-mode
+@defopt scroll-bar-mode
 This variable, always local in all buffers, controls whether and where
 to put scroll bars in windows displaying the buffer.  The possible values
 are @code{nil} for no scroll bar, @code{left} to put a scroll bar on
 the left, and @code{right} to put a scroll bar on the right.
-@end defvar
+@end defopt

 @defun window-current-scroll-bars &optional window
 This function reports the scroll bar type for window @var{window}.
--- a/doc/lispref/eval.texi	Thu May 21 11:24:19 2009 +0000
+++ b/doc/lispref/eval.texi	Thu May 21 15:31:31 2009 +0000
@@ -672,7 +672,7 @@
 @code{eval-current-buffer} is an alias for this command.
 @end deffn

-@defvar max-lisp-eval-depth
+@defopt max-lisp-eval-depth
 @anchor{Definition of max-lisp-eval-depth}
 This variable defines the maximum depth allowed in calls to @code{eval},
 @code{apply}, and @code{funcall} before an error is signaled (with error
@@ -697,7 +697,7 @@

 @code{max-specpdl-size} provides another limit on nesting.
 @xref{Definition of max-specpdl-size,, Local Variables}.
-@end defvar
+@end defopt

 @defvar values
 The value of this variable is a list of the values returned by all the
--- a/doc/lispref/files.texi	Thu May 21 11:24:19 2009 +0000
+++ b/doc/lispref/files.texi	Thu May 21 15:31:31 2009 +0000
@@ -203,14 +203,14 @@
 and never treat wildcard characters specially.
 @end defopt

-@defvar find-file-hook
+@defopt find-file-hook
 The value of this variable is a list of functions to be called after a
 file is visited.  The file's local-variables specification (if any) will
 have been processed before the hooks are run.  The buffer visiting the
 file is current when the hook functions are run.

 This variable is a normal hook.  @xref{Hooks}.
-@end defvar
+@end defopt

 @defvar find-file-not-found-functions
 The value of this variable is a list of functions to be called when
@@ -1914,7 +1914,7 @@
 name as an abbreviation for the ``real'' name, Emacs shows users the
 abbreviation instead.

-@defvar directory-abbrev-alist
+@defopt directory-abbrev-alist
 The variable @code{directory-abbrev-alist} contains an alist of
 abbreviations to use for file directories.  Each element has the form
 @code{(@var{from} . @var{to})}, and says to replace @var{from} with
@@ -1936,7 +1936,7 @@
  ("^/home/gp" . "/gp")
  ("^/home/gd" . "/gd"))
 @end example
-@end defvar
+@end defopt

   To convert a directory name to its abbreviation, use this
 function:
@@ -2186,7 +2186,7 @@
 truncate the @var{string} prefix to fit into the 8+3 file-name limits.
 @end defun

-@defvar temporary-file-directory
+@defopt temporary-file-directory
 @cindex @code{TMPDIR} environment variable
 @cindex @code{TMP} environment variable
 @cindex @code{TEMP} environment variable
@@ -2206,9 +2206,9 @@
 put the file in.  However, if you expect the file to be small, you
 should use @code{small-temporary-file-directory} first if that is
 non-@code{nil}.
-@end defvar
-
-@defvar small-temporary-file-directory
+@end defopt
+
+@defopt small-temporary-file-directory
 This variable specifies the directory name for
 creating certain temporary files, which are likely to be small.

@@ -2221,7 +2221,7 @@
                     (or small-temporary-file-directory
                         temporary-file-directory)))
 @end example
-@end defvar
+@end defopt

 @node File Name Completion
 @subsection File Name Completion
--- a/doc/lispref/frames.texi	Thu May 21 11:24:19 2009 +0000
+++ b/doc/lispref/frames.texi	Thu May 21 15:31:31 2009 +0000
@@ -398,7 +398,7 @@
 You can specify the parameters for the initial startup frame
 by setting @code{initial-frame-alist} in your init file (@pxref{Init File}).

-@defvar initial-frame-alist
+@defopt initial-frame-alist
 This variable's value is an alist of parameter values used when creating
 the initial window frame.  You can set this variable to specify the
 appearance of the initial frame without altering subsequent frames.
@@ -426,27 +426,27 @@
 X resources for subsequent frames; then, to prevent these from affecting
 the initial frame, specify the same parameters in
 @code{initial-frame-alist} with values that match the X resources.
-@end defvar
+@end defopt

 If these parameters specify a separate minibuffer-only frame with
 @code{(minibuffer . nil)}, and you have not created one, Emacs creates
 one for you.

-@defvar minibuffer-frame-alist
+@defopt minibuffer-frame-alist
 This variable's value is an alist of parameter values used when
 creating an initial minibuffer-only frame.  This is the
 minibuffer-only frame that Emacs creates if @code{initial-frame-alist}
 specifies a frame with no minibuffer.
-@end defvar
-
-@defvar default-frame-alist
+@end defopt
+
+@defopt default-frame-alist
 This is an alist specifying default values of frame parameters for all
 Emacs frames---the first frame, and subsequent frames.  When using the X
 Window System, you can get the same results by means of X resources
 in many cases.

 Setting this variable does not affect existing frames.
-@end defvar
+@end defopt

 Functions that display a buffer in a separate frame can override the
 default parameters by supplying their own parameters.  @xref{Definition
@@ -793,7 +793,7 @@
 the @code{cursor-type} frame parameter, but if it is @code{t}, that
 means to use the cursor specified for the frame.

-@defvar blink-cursor-alist
+@defopt blink-cursor-alist
 This variable specifies how to blink the cursor.  Each element has the
 form @code{(@var{on-state} . @var{off-state})}.  Whenever the cursor
 type equals @var{on-state} (comparing using @code{equal}), the
@@ -805,16 +805,16 @@
 the type is not mentioned as an @var{on-state} here.  Changes in this
 variable do not take effect immediately, only when you specify the
 @code{cursor-type} frame parameter.
-@end defvar
-
-@defvar cursor-in-non-selected-windows
+@end defopt
+
+@defopt cursor-in-non-selected-windows
 This variable controls how the cursor looks in a window that is not
 selected.  It supports the same values as the @code{cursor-type} frame
 parameter; also, @code{nil} means don't display a cursor in
 nonselected windows, and @code{t} (the default) means use a standard
 modificatoin of the usual cursor type (solid box becomes hollow box,
 and bar becomes a narrower bar).
-@end defvar
+@end defopt

 @node Font and Color Parameters
 @subsubsection Font and Color Parameters
@@ -1926,12 +1926,12 @@
 the third, and so on through all eight cut buffers.
 @end defun

-@defvar selection-coding-system
+@defopt selection-coding-system
 This variable specifies the coding system to use when reading and
 writing selections or the clipboard.  @xref{Coding
 Systems}.  The default is @code{compound-text-with-extensions}, which
 converts to the text representation that X11 normally uses.
-@end defvar
+@end defopt

 @cindex clipboard support (for MS-Windows)
 When Emacs runs on MS-Windows, it does not implement X selections in
@@ -2327,11 +2327,11 @@
 or @code{nil} if Emacs cannot get that information.
 @end defun

-@defvar display-mm-dimensions-alist
+@defopt display-mm-dimensions-alist
 This variable allows the user to specify the dimensions of graphical
 displays returned by @code{display-mm-height} and
 @code{display-mm-width} in case the system provides incorrect values.
-@end defvar
+@end defopt

 @defun display-backing-store &optional display
 This function returns the backing store capability of the display.
--- a/doc/lispref/help.texi	Thu May 21 11:24:19 2009 +0000
+++ b/doc/lispref/help.texi	Thu May 21 15:31:31 2009 +0000
@@ -557,7 +557,7 @@
 @end smallexample
 @end deffn

-@defvar help-char
+@defopt help-char
 The value of this variable is the help character---the character that
 Emacs recognizes as meaning Help.  By default, its value is 8, which
 stands for @kbd{C-h}.  When Emacs reads this character, if
@@ -574,13 +574,13 @@
 binding as a subcommand of the prefix key, it runs
 @code{describe-prefix-bindings}, which displays a list of all the
 subcommands of the prefix key.
-@end defvar
+@end defopt

-@defvar help-event-list
+@defopt help-event-list
 The value of this variable is a list of event types that serve as
 alternative ``help characters.''  These events are handled just like the
 event specified by @code{help-char}.
-@end defvar
+@end defopt

 @defvar help-form
 If this variable is non-@code{nil}, its value is a form to evaluate
--- a/doc/lispref/keymaps.texi	Thu May 21 11:24:19 2009 +0000
+++ b/doc/lispref/keymaps.texi	Thu May 21 15:31:31 2009 +0000
@@ -1179,7 +1179,7 @@
 bindings, as in @code{lookup-key} (above).
 @end defun

-@defvar meta-prefix-char
+@defopt meta-prefix-char
 @cindex @key{ESC}
 This variable is the meta-prefix character code.  It is used for
 translating a meta character to a two-character sequence so it can be
@@ -1225,7 +1225,7 @@
 This translation of one event into two happens only for characters, not
 for other kinds of input events.  Thus, @kbd{M-@key{F1}}, a function
 key, is not converted into @kbd{@key{ESC} @key{F1}}.
-@end defvar
+@end defopt

 @node Changing Key Bindings
 @section Changing Key Bindings
--- a/doc/lispref/minibuf.texi	Thu May 21 11:24:19 2009 +0000
+++ b/doc/lispref/minibuf.texi	Thu May 21 15:31:31 2009 +0000
@@ -508,19 +508,19 @@
 set to a non-@code{nil} value.
 @end defvar

-@defvar history-length
+@defopt history-length
 The value of this variable specifies the maximum length for all
 history lists that don't specify their own maximum lengths.  If the
 value is @code{t}, that means there no maximum (don't delete old
 elements).  The value of @code{history-length} property of the history
 list variable's symbol, if set, overrides this variable for that
 particular history list.
-@end defvar
+@end defopt

-@defvar history-delete-duplicates
+@defopt history-delete-duplicates
 If the value of this variable is @code{t}, that means when adding a
 new history element, all previous identical elements are deleted.
-@end defvar
+@end defopt

   Here are some of the standard minibuffer history list variables:

@@ -1188,17 +1188,17 @@
 @end example
 @end defun

-@defvar read-buffer-function
+@defopt read-buffer-function
 This variable specifies how to read buffer names.  For example, if you
 set this variable to @code{iswitchb-read-buffer}, all Emacs commands
 that call @code{read-buffer} to read a buffer name will actually use the
 @code{iswitchb} package to read it.
-@end defvar
+@end defopt

-@defvar read-buffer-completion-ignore-case
+@defopt read-buffer-completion-ignore-case
 If this variable is non-@code{nil}, @code{read-buffer} ignores case
 when performing completion.
-@end defvar
+@end defopt

 @defun read-command prompt &optional default
 This function reads the name of a command and returns it as a Lisp
@@ -1442,10 +1442,10 @@
 doing its usual work.
 @end defvar

-@defvar read-file-name-completion-ignore-case
+@defopt read-file-name-completion-ignore-case
 If this variable is non-@code{nil}, @code{read-file-name} ignores case
 when performing completion.
-@end defvar
+@end defopt

 @defun read-directory-name prompt &optional directory default require-match initial
 This function is like @code{read-file-name} but allows only directory
--- a/doc/lispref/modes.texi	Thu May 21 11:24:19 2009 +0000
+++ b/doc/lispref/modes.texi	Thu May 21 15:31:31 2009 +0000
@@ -1714,14 +1714,14 @@
   The variable in overall control of the mode line is
 @code{mode-line-format}.

-@defvar mode-line-format
+@defopt mode-line-format
 The value of this variable is a mode-line construct that controls the
 contents of the mode-line.  It is always buffer-local in all buffers.

 If you set this variable to @code{nil} in a buffer, that buffer does
 not have a mode line.  (A window that is just one line tall never
 displays a mode line.)
-@end defvar
+@end defopt

   The default value of @code{mode-line-format} is designed to use the
 values of other variables such as @code{mode-line-position} and
@@ -1821,11 +1821,11 @@
 least 12 columns.
 @end defvar

-@defvar mode-line-position
+@defopt mode-line-position
 This variable indicates the position in the buffer.  Its default value
 displays the buffer percentage and, optionally, the buffer size, the
 line number and the column number.
-@end defvar
+@end defopt

 @defvar vc-mode
 The variable @code{vc-mode}, buffer-local in each buffer, records
@@ -1834,11 +1834,11 @@
 line, or @code{nil} for no version control.
 @end defvar

-@defvar mode-line-modes
+@defopt mode-line-modes
 This variable displays the buffer's major and minor modes.  Its
 default value also displays the recursive editing level, information
 on the process status, and whether narrowing is in effect.
-@end defvar
+@end defopt

   The following three variables are used in @code{mode-line-modes}:
--- a/doc/lispref/nonascii.texi	Thu May 21 11:24:19 2009 +0000
+++ b/doc/lispref/nonascii.texi	Thu May 21 15:31:31 2009 +0000
@@ -95,14 +95,14 @@
 The representation for a string is determined and recorded in the string
 when the string is constructed.

-@defvar enable-multibyte-characters
+@defopt enable-multibyte-characters
 This variable specifies the current buffer's text representation.
 If it is non-@code{nil}, the buffer contains multibyte text; otherwise,
 it contains unibyte encoded text or binary non-text data.

 You cannot set this variable directly; instead, use the function
 @code{set-buffer-multibyte} to change a buffer's representation.
-@end defvar
+@end defopt

 @defvar default-enable-multibyte-characters
 This variable's value is entirely equivalent to @code{(default-value
@@ -1289,7 +1289,7 @@
 (@pxref{Specifying Coding Systems}).

 @cindex file contents, and default coding system
-@defvar auto-coding-regexp-alist
+@defopt auto-coding-regexp-alist
 This variable is an alist of text patterns and corresponding coding
 systems. Each element has the form @code{(@var{regexp}
 . @var{coding-system})}; a file whose first few kilobytes match
@@ -1299,10 +1299,10 @@
 @code{file-coding-system-alist} (see below).  The default value is set
 so that Emacs automatically recognizes mail files in Babyl format and
 reads them with no code conversions.
-@end defvar
+@end defopt

 @cindex file name, and default coding system
-@defvar file-coding-system-alist
+@defopt file-coding-system-alist
 This variable is an alist that specifies the coding systems to use for
 reading and writing particular files.  Each element has the form
 @code{(@var{pattern} . @var{coding})}, where @var{pattern} is a regular
@@ -1325,14 +1325,14 @@

 If @var{coding} (or what returned by the above function) is
 @code{undecided}, the normal code-detection is performed.
-@end defvar
+@end defopt

-@defvar auto-coding-alist
+@defopt auto-coding-alist
 This variable is an alist that specifies the coding systems to use for
 reading and writing particular files.  Its form is like that of
 @code{file-coding-system-alist}, but, unlike the latter, this variable
 takes priority over any @code{coding:} tags in the file.
-@end defvar
+@end defopt

 @cindex program name, and default coding system
 @defvar process-coding-system-alist
@@ -1380,7 +1380,7 @@
 @end defvar

 @cindex default coding system, functions to determine
-@defvar auto-coding-functions
+@defopt auto-coding-functions
 This variable holds a list of functions that try to determine a
 coding system for a file based on its undecoded contents.

@@ -1394,7 +1394,7 @@

 If a file has a @samp{coding:} tag, that takes precedence, so these
 functions won't be called.
-@end defvar
+@end defopt

 @defun find-auto-coding filename size
 This function tries to determine a suitable coding system for
@@ -1521,12 +1521,12 @@
 affect it.
 @end defvar

-@defvar inhibit-eol-conversion
+@defopt inhibit-eol-conversion
 When this variable is non-@code{nil}, no end-of-line conversion is done,
 no matter which coding system is specified.  This applies to all the
 Emacs I/O and subprocess primitives, and to the explicit encoding and
 decoding functions (@pxref{Explicit Encoding}).
-@end defvar
+@end defopt

 @cindex priority order of coding systems
 @cindex coding systems, priority
--- a/doc/lispref/os.texi	Thu May 21 11:24:19 2009 +0000
+++ b/doc/lispref/os.texi	Thu May 21 15:31:31 2009 +0000
@@ -279,12 +279,12 @@
 loads this @emph{before} the user's init file.  You can inhibit the
 loading of this file with the option @samp{--no-site-file}.

-@defvar site-run-file
+@defopt site-run-file
 This variable specifies the site-customization file to load before the
 user's init file.  Its normal value is @code{"site-start"}.  The only
 way you can change it with real effect is to do so before dumping
 Emacs.
-@end defvar
+@end defopt

   @xref{Init Examples,, Init File Examples, emacs, The GNU Emacs Manual}, for
 examples of how to make various commonly desired customizations in your
@@ -821,14 +821,14 @@
 system.  The variable is also useful for constructing frame titles
 (@pxref{Frame Titles}).

-@defvar mail-host-address
+@defopt mail-host-address
 If this variable is non-@code{nil}, it is used instead of
 @code{system-name} for purposes of generating email addresses.  For
 example, it is used when constructing the default value of
 @code{user-mail-address}.  @xref{User Identification}.  (Since this is
 done when Emacs starts up, the value actually used is the one saved when
 Emacs was dumped.  @xref{Building Emacs}.)
-@end defvar
+@end defopt

 @deffn Command getenv var &optional frame
 @cindex environment variable access
@@ -1009,13 +1009,13 @@
 files or user profile.
 @end defvar

-@defvar user-mail-address
+@defopt user-mail-address
 This holds the nominal email address of the user who is using Emacs.
 Emacs normally sets this variable to a default value after reading your
 init files, but not if you have already set it.  So you can set the
 variable to some other value in your init file if you do not
 want to use the default value.
-@end defvar
+@end defopt

 @defun user-login-name &optional uid
 If you don't specify @var{uid}, this function returns the name under
@@ -1928,7 +1928,7 @@
 track of output sent to the terminal.  The variable @code{baud-rate}
 tells you what Emacs thinks is the output speed of the terminal.

-@defvar baud-rate
+@defopt baud-rate
 This variable's value is the output speed of the terminal, as far as
 Emacs knows.  Setting this variable does not change the speed of actual
 data transmission, but the value is used for calculations such as
@@ -1939,7 +1939,7 @@
 for the corresponding functionality on graphical terminals.

 The value is measured in baud.
-@end defvar
+@end defopt

   If you are running across a network, and different parts of the
 network work at different baud rates, the value returned by Emacs may be
--- a/doc/lispref/positions.texi	Thu May 21 11:24:19 2009 +0000
+++ b/doc/lispref/positions.texi	Thu May 21 15:31:31 2009 +0000
@@ -220,13 +220,13 @@
 backward until encountering the front of a word, rather than forward.
 @end deffn

-@defvar words-include-escapes
+@defopt words-include-escapes
 @c Emacs 19 feature
 This variable affects the behavior of @code{forward-word} and everything
 that uses it.  If it is non-@code{nil}, then characters in the
 ``escape'' and ``character quote'' syntax classes count as part of
 words.  Otherwise, they do not.
-@end defvar
+@end defopt

 @defvar inhibit-field-text-motion
 If this variable is non-@code{nil}, certain motion functions including
--- a/doc/lispref/searching.texi	Thu May 21 11:24:19 2009 +0000
+++ b/doc/lispref/searching.texi	Thu May 21 15:31:31 2009 +0000
@@ -1786,12 +1786,12 @@
   This section describes some variables that hold regular expressions
 used for certain purposes in editing:

-@defvar page-delimiter
+@defopt page-delimiter
 This is the regular expression describing line-beginnings that separate
 pages.  The default value is @code{"^\014"} (i.e., @code{"^^L"} or
 @code{"^\C-l"}); this matches a line that starts with a formfeed
 character.
-@end defvar
+@end defopt

   The following two regular expressions should @emph{not} assume the
 match always starts at the beginning of a line; they should not use
@@ -1802,22 +1802,22 @@
 @samp{^} would be incorrect.  However, a @samp{^} is harmless in modes
 where a left margin is never used.

-@defvar paragraph-separate
+@defopt paragraph-separate
 This is the regular expression for recognizing the beginning of a line
 that separates paragraphs.  (If you change this, you may have to
 change @code{paragraph-start} also.)  The default value is
 @w{@code{"[@ \t\f]*$"}}, which matches a line that consists entirely of
 spaces, tabs, and form feeds (after its left margin).
-@end defvar
+@end defopt

-@defvar paragraph-start
+@defopt paragraph-start
 This is the regular expression for recognizing the beginning of a line
 that starts @emph{or} separates paragraphs.  The default value is
 @w{@code{"\f\\|[ \t]*$"}}, which matches a line containing only
 whitespace or starting with a form feed (after its left margin).
-@end defvar
+@end defopt

-@defvar sentence-end
+@defopt sentence-end
 If non-@code{nil}, the value should be a regular expression describing
 the end of a sentence, including the whitespace following the
 sentence.  (All paragraph boundaries also end sentences, regardless.)
@@ -1826,7 +1826,7 @@
 @code{sentence-end} has to construct the regexp.  That is why you
 should always call the function @code{sentence-end} to obtain the
 regexp to be used to recognize the end of a sentence.
-@end defvar
+@end defopt

 @defun sentence-end
 This function returns the value of the variable @code{sentence-end},
--- a/doc/lispref/text.texi	Thu May 21 11:24:19 2009 +0000
+++ b/doc/lispref/text.texi	Thu May 21 15:31:31 2009 +0000
@@ -1690,20 +1690,20 @@
 is value of @code{indent-line-function} in Paragraph-Indent Text mode.
 @end defun

-@defvar left-margin
+@defopt left-margin
 This variable specifies the base left margin column.  In Fundamental
 mode, @kbd{C-j} indents to this column.  This variable automatically
 becomes buffer-local when set in any fashion.
-@end defvar
-
-@defvar fill-nobreak-predicate
+@end defopt
+
+@defopt fill-nobreak-predicate
 This variable gives major modes a way to specify not to break a line
 at certain places.  Its value should be a list of functions.  Whenever
 filling considers breaking the line at a certain place in the buffer,
 it calls each of these functions with no arguments and with point
 located at that place.  If any of the functions returns
 non-@code{nil}, then the line won't be broken there.
-@end defvar
+@end defopt

 @node Adaptive Fill
 @section Adaptive Fill Mode
--- a/doc/lispref/variables.texi	Thu May 21 11:24:19 2009 +0000
+++ b/doc/lispref/variables.texi	Thu May 21 15:31:31 2009 +0000
@@ -260,7 +260,7 @@
 like ordinary local bindings, but they are localized depending on
 ``where'' you are in Emacs, rather than localized in time.

-@defvar max-specpdl-size
+@defopt max-specpdl-size
 @anchor{Definition of max-specpdl-size}
 @cindex variable limit error
 @cindex evaluation error
@@ -279,7 +279,7 @@
 The default value is 1000.  Entry to the Lisp debugger increases the
 value, if there is little room left, to make sure the debugger itself
 has room to execute.
-@end defvar
+@end defopt

 @node Void Variables
 @section When a Variable is ``Void''
--- a/doc/lispref/windows.texi	Thu May 21 11:24:19 2009 +0000
+++ b/doc/lispref/windows.texi	Thu May 21 15:31:31 2009 +0000
@@ -959,7 +959,7 @@
 @code{display-buffer} does not split any window.
 @end defopt

-@defvar split-window-preferred-function
+@defopt split-window-preferred-function
 This variable must specify a function with one argument, which is a
 window.  The @code{display-buffer} routines will call this function with
 one or more candidate windows when they look for a window to split.  The
@@ -987,7 +987,7 @@
 window or @code{nil}, but you are not encouraged to do so
 unconditionally.  If you want @code{display-buffer} to never split any
 windows, set @code{pop-up-windows} to @code{nil}.
-@end defvar
+@end defopt

 @defun split-window-sensibly window
 This function takes a window as argument and tries to split that window
@@ -1130,12 +1130,12 @@
 of frame parameters.
 @end defun

-@defvar special-display-function
+@defopt special-display-function
 This variable holds the function to call to display a buffer specially.
 It receives the buffer as an argument, and should return the window in
 which it is displayed.  The default value of this variable is
 @code{special-display-popup-frame}, see below.
-@end defvar
+@end defopt

 @defun special-display-popup-frame buffer &optional args
 This function tries to make @var{buffer} visible in a frame of its own.
@@ -1183,7 +1183,7 @@
 @end defun

 @c Emacs 19 feature
-@defvar display-buffer-function
+@defopt display-buffer-function
 This variable is the most flexible way to customize the behavior of
 @code{display-buffer}.  If it is non-@code{nil}, it should be a function
 that @code{display-buffer} calls to do the work.  The function should
@@ -1193,7 +1193,7 @@

 This variable takes precedence over all the other options described
 above.
-@end defvar
+@end defopt

 If all options described above fail to produce a suitable window,
 @code{display-buffer} tries to reuse an existing window.  As a last