Re: Contributing to Emacs

[Christopher Dimech]

> Sent: Friday, September 09, 2022 at 1:47 AM
> From: "Eli Zaretskii" <eliz@gnu.org>
> To: "Christopher Dimech" <dimech@gmx.com>
> Cc: jaopaulolc@gmail.com, emacs-devel@gnu.org
> Subject: Re: Contributing to Emacs
>
> > From: Christopher Dimech <dimech@gmx.com>
> > Cc: jaopaulolc@gmail.com, emacs-devel@gnu.org
> > Date: Thu, 8 Sep 2022 14:12:01 +0200
> > 
> > @Eli, a pleasant thing would be to mention the commands for window and frame
> > related scaling in the documentation of "text-scale-increase" and 
> > "text-scale-decrease".
> 
> They are mentioned in the doc string of text-scale-adjust, which is
> the preferred user interface for this.

What I get is the following.  I do not see any reference for the functionality
that scales text in response to window resizing.

--------

text-scale-adjust is an autoloaded interactive byte-compiled Lisp
function in ‘face-remap.el’.

It is bound to C-x C-0, C-x C-=, C-x C--, C-x C-+.

(text-scale-adjust INC)

Adjust the height of the default face by INC.

INC may be passed as a numeric prefix argument.

The actual adjustment made depends on the final component of the
keybinding used to invoke the command, with all modifiers removed:

   +, =   Increase the height of the default face by one step
   -      Decrease the height of the default face by one step
   0      Reset the height of the default face to the global default

After adjusting, continue to read input events and further adjust
the face height as long as the input event read
(with all modifiers removed) is one of the above characters.

Each step scales the height of the default face by the variable
‘text-scale-mode-step’ (a negative number of steps decreases the
height by the same amount).  As a special case, an argument of 0
will remove any scaling currently active.

This command is a special-purpose wrapper around the
‘text-scale-increase’ command which makes repetition convenient
even when it is bound in a non-top-level keymap.  For binding in
a top-level keymap, ‘text-scale-increase’ or
‘text-scale-decrease’ may be more appropriate.

  Probably introduced at or before Emacs version 28.1.