comparison man/custom.texi @ 90203:187d6a1f84f7

Revision: [e-mail]--gnu-2005/emacs--unicode--0--patch-71 Merge from emacs--cvs-trunk--0 Patches applied: * emacs--cvs-trunk--0 (patch 485-492) - Update from CVS - Merge from gnus--rel--5.10 * gnus--rel--5.10 (patch 92-94) - Merge from emacs--cvs-trunk--0 - Update from CVS

90202:7597b4a23c3b

Index (@pxref{Variable Index}).  The rest are faces and their
attributes (@pxref{Faces}).

@findex customize
@cindex customization buffer
  You can browse interactively through the the user options and change
some of them using @kbd{M-x customize}.  This command creates a
@dfn{customization buffer}, which offers commands to navigate through
a logically organized structure of the Emacs user options; you can
also use it to edit and set their values, and to save settings
permanently in your @file{~/.emacs} file (@pxref{Init File}).

@example
(put 'narrow-to-region 'disabled nil)
@end example

@item
Adjusting the configuration to various contexts.

In most of the cases, people want their Emacs to behave the same on
all their machines, so their configuration should be the same, no
matter whether it's GNU/Linux or not, under X11 or on a tty, with one
version of  Emacs or another, ...

What can happen, tho, is that depending on the circumstance some
features may or may not be available.  In that case just prepend each
such customization with a little test that ensures that the feature
can be used.  The best tests are usually checking that the feature is
available, rather than checking what kind of environment is
being used.

@example
(if (fboundp 'blinking-cursor-mode)
    (blinking-cursor-mode 0))
@end example

@example
(if (boundp 'coding-category-utf-8)
  (set-coding-priority '(coding-category-utf-8)))
@end example

@example
(require 'cl)                   ; To define `ignore-errors'.
(ignore-errors (set-face-background 'region "grey75"))
@end example

Note also that a @code{setq} on a variable which does not exist is
generally harmless, so those usually do not need to be made
conditional on any kind of test.

@end itemize


@node Terminal Init
@subsection Terminal-specific Initialization

  Each terminal type can have a Lisp library to be loaded into Emacs when

90203:187d6a1f84f7

Index (@pxref{Variable Index}).  The rest are faces and their
attributes (@pxref{Faces}).

@findex customize
@cindex customization buffer
  You can browse interactively through the user options and change
some of them using @kbd{M-x customize}.  This command creates a
@dfn{customization buffer}, which offers commands to navigate through
a logically organized structure of the Emacs user options; you can
also use it to edit and set their values, and to save settings
permanently in your @file{~/.emacs} file (@pxref{Init File}).

@example
(put 'narrow-to-region 'disabled nil)
@end example

@item
Adjusting the configuration to various platforms and Emacs versions.

Users typically want Emacs to behave the same on all systems, so the
same init file is right for all platforms.  However, sometimes it
happens that a function you use for customizing Emacs is not available
on some platforms or in older Emacs versions.  To deal with that
situation, put the customization inside a conditional that tests whether
the function or facility is available, like this:

@example
(if (fboundp 'blink-cursor-mode)
    (blink-cursor-mode 0))

(if (boundp 'coding-category-utf-8)
    (set-coding-priority '(coding-category-utf-8)))
@end example

@noindent
You can also simply disregard the errors that occur if the
function is not defined.

@example
(condition case ()
    (set-face-background 'region "grey75")
  (error nil))
@end example

A @code{setq} on a variable which does not exist is generally
harmless, so those do not need a conditional.
@end itemize

@node Terminal Init
@subsection Terminal-specific Initialization

  Each terminal type can have a Lisp library to be loaded into Emacs when