face-font-rescale-alist not documented

face-font-rescale-alist not documented

[Werner LEMBERG]

It seems that the new `face-font-rescale-alist' variable isn't
documented.


    Werner

Re: face-font-rescale-alist not documented

[Kenichi Handa]

In article <20030410.073134.35674377.wl@gnu.org>, Werner LEMBERG <wl@gnu.org> writes:
> It seems that the new `face-font-rescale-alist' variable isn't
> documented.

?? I wrote the docstring as this (in xfaces.c).

  DEFVAR_LISP ("face-font-rescale-alist", &Vface_font_rescale_alist,
	       doc: /* Alist of fonts vs the rescaling factors.
Each element is a cons (FONT-NAME-PATTERN . RESCALE-RATIO), where
FONT-NAME-PATTERN is a regular expression matching a font name, and
RESCALE-RATIO is a floating point number to specify how much larger
\(or smaller) font we should use.  For instance, if a face requests
a font of 10 point, we actually use a font of 10 * RESCALE-RATIO point.  */);

But, hmmm, something is wrong.  C-x v
face-font-rescale-alist RET surely shows the above
docstring, but there are two empty lines after the first
line in *Help* in my case!?!

---
Ken'ichi HANDA
handa@m17n.org

Re: face-font-rescale-alist not documented

[Werner LEMBERG]

> > It seems that the new `face-font-rescale-alist' variable isn't
> > documented.
> 
> ?? I wrote the docstring as this (in xfaces.c).

Sorry for being imprecise.  I couldn't find an entry in the NEWS file
or in any of the texinfo documents.  How shall the user know that
this variable exist at all?


    Werner

Re: face-font-rescale-alist not documented

[Kenichi Handa]

In article <20030410.225839.34748828.wl@gnu.org>, Werner LEMBERG <wl@gnu.org> writes:
> Sorry for being imprecise.  I couldn't find an entry in the NEWS file
> or in any of the texinfo documents.  How shall the user know that
> this variable exist at all?

Ah!  I forgot to commit NEWS.  Just done.

** The variable `face-font-rescale-alist' specifies how much larger
(or smaller) font we should use.  For instance, if the value is
'((SOME-FONTNAME-PATTERN . 1.3) and a face requests a font of 10
point, we actually use a font of 13 point if the font matches
SOME-FONTNAME-PATTERN.

---
Ken'ichi HANDA
handa@m17n.org

Re: face-font-rescale-alist not documented

[Richard Stallman]

    It seems that the new `face-font-rescale-alist' variable isn't
    documented.

Which kind of documentation does it lack?