procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Update the Customization chapter of Emacs manual.

Browse source 
* doc/emacs/custom.texi (Customization Groups): Update example.
(Browsing Custom): Document the new search field.
(Changing a Variable): Update example for Emacs 24 changes.
Document Custom-set and Custom-save commands.
(Face Customization): Document Emacs 24 changes.  De-document
modify-face.
(Specific Customization): Mention customize-variable.
(Custom Themes): Add customize-themes, custom-theme-load-path,
custom-theme-directory, and describe-theme.
(Creating Custom Themes): New node.
(Examining): Mention M-:.

* doc/emacs/package.texi (Packages): Fix typo.
This commit is contained in:
Chong Yidong 2012-01-05 19:09:27 +08:00
parent acaf905b11
commit b0d7d8af07
6 changed files with 517 additions and 400 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

1
admin/FOR-RELEASE
View file

@ -162,6 +162,7 @@ msdog.texi
msdog-xtra.texi
mule.texi
m-x.texi cyd
package.texi cyd
picture-xtra.texi
programs.texi cyd
regs.texi cyd

16
doc/emacs/ChangeLog
View file

@ -1,3 +1,19 @@
2012-01-05 Chong Yidong <cyd@gnu.org>
* custom.texi (Customization Groups): Update example.
(Browsing Custom): Document the new search field.
(Changing a Variable): Update example for Emacs 24 changes.
Document Custom-set and Custom-save commands.
(Face Customization): Document Emacs 24 changes. De-document
modify-face.
(Specific Customization): Mention customize-variable.
(Custom Themes): Add customize-themes, custom-theme-load-path,
custom-theme-directory, and describe-theme.
(Creating Custom Themes): New node.
(Examining): Mention M-:.
* package.texi (Packages): Fix typo.
2012-01-03 Chong Yidong <cyd@gnu.org>
* misc.texi (Single Shell): Don't document Lisp usage of

872
doc/emacs/custom.texi
View file

File diff suppressed because it is too large Load diff

11
doc/emacs/emacs.texi
View file

@ -1033,15 +1033,14 @@ Customization
Easy Customization Interface
* Customization Groups:: How settings are classified in a structure.
* Customization Groups:: How settings are classified.
* Browsing Custom:: Browsing and searching for settings.
* Changing a Variable:: How to edit an option's value and set the option.
* Saving Customizations:: Specifying the file for saving customizations.
* Saving Customizations:: Saving customizations for future Emacs sessions.
* Face Customization:: How to edit the attributes of a face.
* Specific Customization:: Making a customization buffer for specific
variables, faces, or groups.
* Custom Themes:: How to define collections of customized options
that can be loaded and unloaded together.
* Specific Customization:: Customizing specific settings or groups.
* Custom Themes:: Collections of customization settings.
* Creating Custom Themes:: How to create a new custom theme.
Variables

8
doc/emacs/package.texi
View file

@ -20,7 +20,7 @@ via this buffer. @xref{Package Menu}.
@findex describe-package
The command @kbd{C-h P} (@code{describe-package}) prompts for the
name of a package, and displays a help buffer describing that
name of a package, and displays a help buffer describing the
attributes of the package and the features that it implements.
By default, Emacs downloads packages from a @dfn{package archive}
@ -119,9 +119,9 @@ dependencies; also, delete all packages marked with @kbd{d}
(@code{package-menu-execute}). This also removes the marks.
@item r
Refresh the package list (@code{package-menu-refresh}). This also
retrieves the list of available packages from the package archive
again.
Refresh the package list (@code{package-menu-refresh}). This fetches
the list of available packages from the package archive again, and
recomputes the package list.
@end table
@noindent

9
etc/NEWS
View file

@ -341,14 +341,14 @@ automatically when Emacs starts up. To disable this, set
loaded, customize `package-load-list'.
** Custom Themes
+++
*** `M-x customize-themes' lists Custom themes which can be enabled.
+++
*** New option `custom-theme-load-path' is the load path for themes.
Emacs no longer looks for custom themes in `load-path'. The default
is to search in `custom-theme-directory', followed by a built-in theme
directory named "themes/" in `data-directory'.
+++
*** New option `custom-safe-themes' records known-safe theme files.
If a theme is not in this list, Emacs queries before loading it, and
offers to save the theme to `custom-safe-themes' automatically. By
@ -640,15 +640,18 @@ in the *compilation* buffer was used.
** Customize
+++
*** Customize buffers now contain a search field.
The search is performed using `customize-apropos'.
To turn off the search field, set custom-search-field to nil.
+++
*** Custom options now start out hidden if at their default values.
Use the arrow to the left of the option name to toggle visibility.
*** custom-buffer-sort-alphabetically now defaults to t.
+++
*** The color widget now has a "Choose" button, which allows you to
choose a color via list-colors-display.