Re: Question on set-window-margins

[Yuan Fu <casouri@gmail.com>]

> On Jan 2, 2024, at 7:23 PM, Eli Zaretskii <eliz@gnu.org> wrote:
> 
>> From: "Nicolas P. Rougier (inria)" <nicolas.rougier@inria.fr>
>> Cc: emacs-devel@gnu.org
>> Date: Tue, 02 Jan 2024 20:46:14 +0100
>> 
>> 
>> Eli Zaretskii [2024-01-02 at 21:20] wrote:
>>> From the ELisp manual:
>>> 
>>> -- Function: set-window-margins window left &optional right
>>>     This function specifies the margin widths for window 
>>>     WINDOW, in
>>>     character cell units.  The argument LEFT controls the left 
>>>     margin,
>>>     and RIGHT controls the right margin (default ‘0’).
>>> 
>>>     If WINDOW is not large enough to accommodate margins of the 
>>>     desired
>>>     width, this leaves the margins of WINDOW unchanged.
>>> 
>>>     The values specified here may be later overridden by 
>>>     invoking
>>>     ‘set-window-buffer’ (*note Buffers and Windows::) on WINDOW 
>>>     with
>>>     its KEEP-MARGINS argument ‘nil’ or omitted.
>> 
>> Thanks. The last paragraph is actually missing from function 
>> definition on 29.1 hence my question. 
> 
> Sorry, I don't understand what you mean by "missing from function
> definition".  Please elaborate.

I think Nicolas means that the last paragraph isn’t present in the docstring of set-window-margin. That paragraph is only in the manual. It might be a good idea to mention this caveat in the docstring.

Yuan