Re: master a739cab6637 2/2: ; * doc/lispref/display.texi (Image Descriptors): Insert missing text.

[Robert Pluim <rpluim@gmail.com>]

>>>>> On Thu, 06 Jun 2024 21:58:20 +0800, Po Lu <luangruo@yahoo.com> said:

    Po Lu> Eli Zaretskii <eliz@gnu.org> writes:
    >>> From: Po Lu <luangruo@yahoo.com>
    >>> Cc: Robert Pluim <rpluim@gmail.com>,  emacs-devel@gnu.org
    >>> Date: Thu, 06 Jun 2024 21:18:44 +0800
    >>> 
    >>> Eli Zaretskii <eliz@gnu.org> writes:
    >>> 
    >>> >>     @vindex image-scaling-factor
    >>> >>     Alternatively, the symbol @code{default} may be specified, indicating
    >>> >>     that the image should be scaled according as the value of the
    >>> >>     @code{image-scaling-factor} variable is the default @code{auto} or a
    >>> >>     number, which by default scales the image in proportion to the average
    >>> >>     widths (@pxref{Low-Level Font}) of the default faces of frames on which
    >>> >>     it happens to be displayed, if such widths should exceed @code{10}
    >>> >>     pixels.  If no other value is provided, @code{create-image} will specify
    >>> >>     this value in image specifications it creates.
    >>> >> 
    >>> >> which apart from saying 'according as' rather than 'according to' is
    >>> >> completely incomprehensible to me.
    >>> >
    >>> > Agreed.  Po Lu, can you please fix that text?
    >>> 
    >>> Is it "according as XXX or YYY" that is incomprehensible to both of you,
    >>> or just the punctuation?
    >> 
    >> The entire paragraph is incomprehensible.  I simply don't understand
    >> what you wanted to say there.  Perhaps explain it in simple words, and
    >> then I will be able to suggest how to rephrase.

    Po Lu> How's this?

    Po Lu> Alternatively, the symbol @code{default} may be specified, indicating
    Po Lu> that the image should be scaled in one of two ways, selected by the
    Po Lu> value of the @code{image-scaling-factor} variable.  This value is either
    Po Lu> a number providing a constant scale factor, or the default, @code{auto},
    Po Lu> in which case the image will be scaled in proportion to the average
    Po Lu> widths (@pxref{Low-Level Font}) of the default faces of frames on which
    Po Lu> it is displayed and where this default width exceeds @code{10} pixels.
    Po Lu> If no other value is provided, @code{create-image} will specify
    Po Lu> @code{default} in image specifications it creates.

That reads a lot better, thanks.

Robert
--