1
0
mirror of https://git.savannah.gnu.org/git/emacs.git synced 2024-12-14 09:39:42 +00:00

Document prettify-symbols-mode' and global-prettify-symbols-mode'.

* doc/emacs/emacs.texi (Top):
* doc/emacs/programs.texi (Programs, Prettifying Symbols):
Document `prettify-symbols-mode' and `global-prettify-symbols-mode'.

* etc/NEWS: Markup changes.
This commit is contained in:
Xue Fuqiao 2014-02-28 11:04:12 +08:00
commit 4f07dcdce6
4 changed files with 39 additions and 0 deletions

View File

@ -1,5 +1,9 @@
2014-02-28 Xue Fuqiao <xfq@gnu.org>
* emacs.texi (Top):
* programs.texi (Programs, Prettifying Symbols):
Document `prettify-symbols-mode' and `global-prettify-symbols-mode'.
* misc.texi (Saving Emacs Sessions): Document some new desktop user options.
2014-02-27 Xue Fuqiao <xfq@gnu.org>

View File

@ -670,6 +670,7 @@ Editing Programs
* Symbol Completion:: Completion on symbol names of your program or language.
* MixedCase Words:: Dealing with identifiersLikeThis.
* Semantic:: Suite of editing tools based on source code parsing.
* Prettifying Symbols:: Display symbols as composed characters.
* Misc for Programs:: Other Emacs features useful for editing programs.
* C Modes:: Special commands of C, C++, Objective-C,
Java, IDL, Pike and AWK modes.

View File

@ -38,6 +38,7 @@ Highlight program syntax (@pxref{Font Lock}).
* Symbol Completion:: Completion on symbol names of your program or language.
* MixedCase Words:: Dealing with identifiersLikeThis.
* Semantic:: Suite of editing tools based on source code parsing.
* Prettifying Symbols:: Display symbols as composed characters.
* Misc for Programs:: Other Emacs features useful for editing programs.
* C Modes:: Special commands of C, C++, Objective-C, Java,
IDL, Pike and AWK modes.
@ -1432,6 +1433,37 @@ is idle.
@xref{Top, Semantic,, semantic, Semantic}, for details.
@end ifnottex
@node Prettifying Symbols
@section Prettifying Symbols
@cindex prettifying symbols
@cindex symbol, prettifying
@code{prettify-symbols-mode} and @code{global-prettify-symbols-mode}
are two minor modes (@pxref{Minor Modes}) that can display specified
symbols as composed characters. For instance, in Emacs Lisp mode
(@pxref{Lisp Eval}), this mode will replace the string ``lambda'' with
the Greek lambda character.
@findex prettify-symbols-mode
@vindex prettify-symbols-alist
When Prettify Symbols mode and Font Lock mode (@pxref{Font Lock}) are
enabled, symbols are prettified (displayed as composed characters)
according to the rules in @code{prettify-symbols-alist}, which are
locally defined by major modes (@pxref{Major Modes}) supporting
prettifying. To add further customizations for a given major mode,
you can modify @code{prettify-symbols-alist}. For example:
@example
(add-hook 'emacs-lisp-mode-hook
(lambda ()
(push '("<=" . ?≤) prettify-symbols-alist)))
@end example
@findex global-prettify-symbols-mode
You can enable this mode locally in desired buffers, or use
@code{global-prettify-symbols-mode} to enable it for all modes that
support it.
@node Misc for Programs
@section Other Features Useful for Editing Programs

View File

@ -1185,6 +1185,7 @@ as a function to call to provide default values.
The default `crm-separator' has been changed to allow surrounding spaces
around the comma.
---
*** The `common-substring' argument of `display-completion-list',
which has been documented as obsolete since Emacs 23.1, is now _really_
obsolete, and no longer advertised. Instead use either
@ -1200,6 +1201,7 @@ to add the highlight.
*** New function `completion-table-merge' to combine several
completion tables by merging their completions.
+++
** New minor modes `prettify-symbols-mode' and `global-prettify-symbols-mode'
display specified symbols as composed characters. E.g., in Emacs Lisp mode,
this replaces the string "lambda" with the Greek lambda character.