[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

bug#12172: 24.1.50; doc string of `special-display-popup-frame'

From: Drew Adams
Subject: bug#12172: 24.1.50; doc string of `special-display-popup-frame'
Date: Fri, 10 Aug 2012 09:18:58 -0700

(This is minor.)
The first line of a function's doc string should give and overall idea
of what it does.
The first line of this doc string says nothing about what the function
does that makes it different from just displaying a buffer normally.
IOW, it indicates nothing about "special display" or "frame".
It should at least make the point that BUFFER is popped up in a frame.
That is sufficiently vague to cover all of the cases, I think, including
cases where BUFFER is already displayed somewhere: a frame showing it is
simply raised in that case.
Here is a suggested first line for the doc string:
 Pop up a frame displaying BUFFER.  Return its window.
Or you could move that second sentence later.

In GNU Emacs (i386-mingw-nt5.1.2600)
 of 2012-08-08 on DANI-PC
Bzr revision: 109511 address@hidden
Windowing system distributor `Microsoft Corp.', version 5.1.2600
Configured using:
 `configure --with-gcc (4.7) --no-opt --enable-checking --cflags
 -I../../libs/libxpm-3.5.8/include -I../../libs/libxpm-3.5.8/src
 -I../../libs/libpng-1.4.10 -I../../libs/zlib-1.2.6
 -I../../libs/giflib-4.1.4-1/include -I../../libs/jpeg-6b-4/include

reply via email to

[Prev in Thread] Current Thread [Next in Thread]