Re: [AUCTeX-devel] other patch for auctex.texi

[Tassilo Horn]

Uwe Brauer <address@hidden> writes:

Hi Uwe,

> @@ -164,7 +164,8 @@
>  * Folding::                     Folding Macros and Environments
>  * Outline::                     Outlining the Document
>  * Narrowing::                   Restricting display and editing to a portion 
> of the buffer
> -* Prettifying::                 Displaying Greek and math macros as Unicode 
> characters including super and subscripts 
> +* Prettifying::                 Displaying Greek and math macros as Unicode 
> characters
> +* Semi-WYSIWYW::                (Semi--) WYSIWYW features

Why a new node that comes even after all the semi-WYSIWYG features have
already been discussed?  I would have put it just as a paragraph just
before this TOC.

> +Lisp buffers. Deleting prettified symbols cannot be done by simply
> +hitting delete or backspace, one must use @code{kill-word} or
> address@hidden

I still don't like that sentence because it sounds like a limitation.
Can you please rephrase it somehow?  Like

    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 backward-kill-word
    or kill-word.

(Well, I still think that note is not really necessary but if it makes
you happy, let's put it in.)

> address@hidden Semi--WYSIWYG
> address@hidden Semi--WYSIWYG
> +
> +It is possible to use various features which resemble to a certain
> +degree a semi--WYSIWYG feature. The first one is the @previewlatex{}
> +subsystem of @AUCTeX{}, see @ref{Top,,Introduction,preview-latex,The
> address@hidden Manual}. The second concerns
> address@hidden see @ref{Top,,Controlling Screen Display}.
> +The third concerns @font-latex-fontify-script{}, see
> address@hidden,,Controlling Screen Display}.

IMHO, there should be a brief note about these two different WYSIWYG
features work and what's their benefit:

  1. preview: let LaTeX generate images that are displayed in your buffer
     + extremely accurate
     - some overhead
     - fragile with some packages

  2. prettify/font-latex: light-weight Emacs-only approach
     + light-weight
     + pretty robust
     - not anywhere as WYSIWYG as preview

Ah, and at last, I cannot apply your patch (just using patch <
your.patch).  Three out of four hunks fail to apply.  Didn't you change
the master version?

Oh, and is there a way I can apply your HG patch directly with git so
that I don't have to commit it under your name and address by typing
everything manually?

Bye,
Tassilo