Re: [AUCTeX-devel] modified

[Tassilo Horn]

Uwe Brauer <address@hidden> writes:

Hi Uwe,

I can apply it as suggested! :-)

Oh, however, then I can't compile the info docs anymore:

% make docs
cd doc ; make all
make[1]: Entering directory '/home/horn/Repos/el/auctex/doc'
/usr/bin/makeinfo auctex.texi
auctex.texi:1815: unknown command `font-latex-fontify-script'
auctex.texi:1815: misplaced {
auctex.texi:1815: misplaced }
auctex.texi:2190: unknown command `font-latex-fontify-script'
auctex.texi:2190: misplaced {
auctex.texi:2190: misplaced }
make[1]: *** [Makefile:127: auctex.info] Error 1
make[1]: Leaving directory '/home/horn/Repos/el/auctex/doc'
make: *** [Makefile:219: docs] Error 2

Well, and the problem is:
> address@hidden to ‘invisible’ so that the «^» and «_» in
> +sub and superscripts are not displayed.

Huh?  @font-latex-fontify-script{}?  I guess that's not what you wanted
but rather @code{font-latex-fontify-script} or something alike.

Please compile the docs before submitting anew.  I think @previewlatex{}
is also no existing TeXInfo macro (but I might be wrong).

> +Lastly, @AUCTeX{} with GNU Emacs 25 or later can display certain math
> +macros using Unicode characters. That's called prettification. XEmacs
> +user should either switch to GNU Emacs 25 or use the x-symbol package
> +which provides a similar feature. Prettification is pretty lightweight
> +and reasonable robust, however it only provides a limited WYSIWYG feature,
> +compared to @previewlatex{} a subsystem of @AUCTeX{}, see
> address@hidden,,Introduction,preview-latex,The @previewlatex{} Manual}, which
> +let LaTeX generate images that are displayed in your buffer. It is
> +extremely accurate but sometimes fragile with some packages. Note please
> +that you can use prettification and preview-latex together. 

Another nitpick.  In general, we use the convention having two spaces
after a sentence ending in a dot and the next sencence so that
`forward-sentence' and friends work right with the default value of
`sentence-end-double-space'.  So please do that as well.

>  @menu
>  * Font Locking::                Font Locking
> @@ -2174,6 +2186,10 @@
>  @defopt font-latex-fontify-script
>  If non-nil, fontify subscript and superscript strings.
>  
> +In addition you can configure Emacs so that the «^» and «_» in sub and
> +superscripts are not displayed. To enable that feature you have to set
> +the variable @font-latex-fontify-script{} to ‘invisible’.
> +
>  Note that this feature is not available on XEmacs, for which it is
>  disabled per default.  In GNU Emacs raising and lowering is not enabled
>  for versions 21.3 and before due to it working not properly.
> @@ -2587,15 +2603,20 @@
>  @section Prettifying
>  
>  Emacs 25 is able to prettify symbols in programming language buffers,
> address@hidden for Programs,,,emacs,GNU Emacs Manual}.  The canonical
> address@hidden for Programs,,,emacs,GNU Emacs Manual}. The canonical
>  example is to display @code{(lambda () ...)} as @code{(λ () ...)} in
>  Lisp buffers.
>  
>  @AUCTeX{} can use this feature in order to display certain math macros
> -and greek letters using their Unicode representation, too.  For example,
> +and greek letters using their Unicode representation, too. For example,
>  the @TeX{} code @code{\alpha \times \beta} will be displayed as @code{α
> -× β}.  When point is on one of the characters, it'll be unprettified
> -automatically, meaning you see the verbatim text again.
> +× β}. When point is on one of the characters, it'll be unprettified
> +automatically, meaning you see the verbatim text again. Note that when
> +you inserted \alpha which gets displayed as α, hitting delete after it
> +will result in \alph, i.e., just one character is deleted, not the
> +complete macro which just gets displayed as α. To delete the whole
> +macro, use @code{kill-word} or @code{backward-kill-word}.
> +
>  
>  To enable prettification in @AUCTeX{}, simply add
>  @code{prettify-symbols-mode} to @code{TeX-mode-hook}.  If you enabled
> # HG changeset patch
> # User Uwe Brauer <address@hidden>
> # Date 1474020254 0
> #      Fri Sep 16 10:04:14 2016 +0000
> # Node ID badd170d4f3df412a3eebb0e79a8d530ff2739bd
> # Parent  b60638f575a06f0ca4c57cfd80d7f9fd72864e5f
> Delete reference to x-symbol or switching Emacs version, Xemacs
>
> diff --git a/doc/auctex.texi b/doc/auctex.texi
> --- a/doc/auctex.texi
> +++ b/doc/auctex.texi
> @@ -1816,15 +1816,14 @@
>  sub and superscripts are not displayed.
>  
>  Lastly, @AUCTeX{} with GNU Emacs 25 or later can display certain math
> -macros using Unicode characters. That's called prettification. XEmacs
> -user should either switch to GNU Emacs 25 or use the x-symbol package
> -which provides a similar feature. Prettification is pretty lightweight
> -and reasonable robust, however it only provides a limited WYSIWYG feature,
> -compared to @previewlatex{} a subsystem of @AUCTeX{}, see
> address@hidden,,Introduction,preview-latex,The @previewlatex{} Manual}, which
> -let LaTeX generate images that are displayed in your buffer. It is
> -extremely accurate but sometimes fragile with some packages. Note please
> -that you can use prettification and preview-latex together. 
> +macros using Unicode characters. That's called prettification.
> +Prettification is pretty lightweight and reasonable robust, however it
> +only provides a limited WYSIWYG feature, compared to @previewlatex{} a
> +subsystem of @AUCTeX{}, see @ref{Top,,Introduction,preview-latex,The
> address@hidden Manual}, which let LaTeX generate images that are
> +displayed in your buffer. It is extremely accurate but sometimes fragile
> +with some packages. Note please that you can use prettification and
> +preview-latex together.

Did you actually test using both preview and prettify together?  I guessed
that you can do that without testing it.  So before writing something
like that in the docs, please verify that it really works.

Bye,
Tassilo