[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: face-remapping patch
From: |
Eli Zaretskii |
Subject: |
Re: face-remapping patch |
Date: |
Thu, 29 May 2008 21:28:21 +0300 |
> Date: Thu, 29 May 2008 04:47:30 -0400
> From: Miles Bader <address@hidden>
> Cc: Emacs-Devel <address@hidden>
>
> Here's a new patch addressing your comments.
Not my comments, but allow me a few remarks on the manual bits.
> address@hidden face-remapping-alist
Are we still using @tindex? I thought it was not needed anymore a
long time ago, and should not be used. I don't see it anywhere in the
ELisp manual in CVS trunk.
> + This variable is used for buffer-local changes in the appearance of
> +a face, for instance making the @code{default} face a variable-pitch
> +face in a particular buffer.
> +
> + Its value should be an alist, whose elements have the form
> address@hidden(@var{face} @address@hidden)}; when the text specifies
> +face @var{face}, Emacs redisplay uses @address@hidden instead.
It took me a few moments to understand what you meant by "when text
specifies face". I finally realized that you are talking about text
properties, so please add the word "property" here, because in Emacs,
text does not specify anything except itself.
> address@hidden@dots{} may be any face specification suitable for a
Using @dots{} in the middle of text will cause TeX render it as an end
of a sentence, I think. At least put a @: after it, if you must use
it (I'd recommend against that).
> address@hidden text property, usually a face name, but also perhaps a
> +property list of face attribute/value pairs; @xref{Special
> +Properties}.
It's not a good idea to use @xref in the middle of a sentence: it
produces capitalized "See" which is incorrect English. "see @ref" is
a better alternative; or just start a new sentence.
> +The new definition @address@hidden is the complete
> +specification of how to display @var{face}---it entirely replaces,
> +rather than augmenting or modifying, the normal definition of that
> +face.
Isn't "augments or modifies" more correct, English-wise (because it
matches "replaces" better)?
> +If @address@hidden recursively references the same face name
> address@hidden, either directly remapping entry, or via the
> address@hidden:inherit} attribute of some other face in
> address@hidden@dots{}, then that reference uses normal frame-wide
> +definition of @var{face} instead of the `remapped' definition.
^^^^^^^^
There should never be a need to use `...' in Texinfo. Either you want
``...'', for quoting, or you want @samp. I think you want the former
here.
> +For instance, if the @code{mode-line} face is remapped using this
> +entry in @code{face-remapping-alist}:
> address@hidden
> +(mode-line italic mode-line)
> address@hidden example
> +Then the new definition of the @code{mode-line} face inherits from the
^^^^
This "Then" should not begin with a capital letter, since it continues
the sentence before the @example, and you want an @outdent before it,
to prevent automatic indentation of each new paragraph.
- Re: Specifiers, (continued)
- Re: Specifiers, Stefan Monnier, 2008/05/29
- Re: Specifiers, David Kastrup, 2008/05/30
- Re: Specifiers, Stefan Monnier, 2008/05/30
- Re: Specifiers, David Kastrup, 2008/05/30
- Re: Specifiers, Stefan Monnier, 2008/05/30
- Re: Specifiers, Richard M Stallman, 2008/05/31
- Re: face-remapping patch, Stefan Monnier, 2008/05/29
- Re: face-remapping patch, David Kastrup, 2008/05/29
Re: face-remapping patch, Miles Bader, 2008/05/29
Re: face-remapping patch, Chong Yidong, 2008/05/28
Re: face-remapping patch, Dan Nicolaescu, 2008/05/28