GNU bug report logs - #18112
24.4.50; emacs --daemon infinite loop in find_interval

Previous Next

Full log

View this message in rfc822 format

From: martin rudalics <rudalics <at> gmx.at>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: mvoteiza <at> udel.edu, 18112 <at> debbugs.gnu.org
Subject: bug#18112: 24.4.50; emacs --daemon infinite loop in find_interval
Date: Sat, 09 Aug 2014 13:14:15 +0200

> I see no improvement for the "total" size.  The additions to the doc
> strings point to window-total-size, but that function's doc string
> does not explain what is the semantics of "total" in this respect.
> (The doc string of window-total-size references window-total-width and
> window-total-height, which do say something about that, but having to
> traverse more than 1 hyperlink to find the information is not a good
> idea, IMO.)
>
> Also, the way you document the *-new-* functions could be improved.
> You say something like
>
>    The new pixel size of WINDOW is used by `window-resize-apply' and, if
>    that function succeeds, will be subsequently returned by the functions
>    `window-pixel-height' and `window-pixel-width'.
>
> I suggest instead to say something that describes the effect, but not
> how the effect is achieved (which is low-level information that
> obscures and obfuscates what the reader would like to know):
>
>    The new pixel size of WINDOW, if it is valid, will be shortly
>    installed as WINDOW's size.

I've tried to follow your advices.  Please have another look.

Thanks, martin

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.