* bug#17716: 24.4.50; doc string of `winner-mode'
@ 2014-06-06 15:08 Drew Adams
2016-04-29 20:28 ` Lars Ingebrigtsen
0 siblings, 1 reply; 2+ messages in thread
From: Drew Adams @ 2014-06-06 15:08 UTC (permalink / raw
To: 17716
C'mon. Don't you think there is something wrong with this description
of `winner-mode'?
Toggle Winner mode on or off.
With a prefix argument ARG, enable Winner mode if ARG is
positive, and disable it otherwise. If called from Lisp, enable
the mode if ARG is omitted or nil, and toggle it if ARG is `toggle'.
Substitute `alligator-mode' for `winner-mode' and you get just as much
information. It does not even mention "window". This is just the
default doc string from `define-minor-mode'. No one has bothered to
provide *any* user-helpful description of this mode. Why include a mode
in Emacs that cannot even provide a minimal description of itself?
If laziness is a prime concern, then just copy the text from the
Commentary into the doc string. This library was written in 1997 (!)
and has been in Emacs for a while now. It would at least be better to
have some of the Commentary in the doc string than to have a doc string
that says nothing besides how to turn the mode on.
;;; Commentary:
;; Winner mode is a global minor mode that records the changes in the
;; window configuration (i.e. how the frames are partitioned into
;; windows) so that the changes can be "undone" using the command
;; `winner-undo'. By default this one is bound to the key sequence
;; ctrl-c left. If you change your mind (while undoing), you can
;; press ctrl-c right (calling `winner-redo'). Even though it uses
;; some features of Emacs20.3, winner.el should also work with
;; Emacs19.34 and XEmacs20, provided that the installed version of
;; custom is not obsolete.
In GNU Emacs 24.4.50.1 (i686-pc-mingw32)
of 2014-06-01 on ODIEONE
Bzr revision: 117212 michael.albinus@gmx.de-20140601104945-g88x0mwrxorz302h
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
`configure --prefix=/c/Devel/emacs/snapshot/trunk
--enable-checking=yes,glyphs 'CFLAGS=-O0 -g3'
LDFLAGS=-Lc:/Devel/emacs/lib 'CPPFLAGS=-DGC_MCHECK=1
-Ic:/Devel/emacs/include''
^ permalink raw reply [flat|nested] 2+ messages in thread
* bug#17716: 24.4.50; doc string of `winner-mode'
2014-06-06 15:08 bug#17716: 24.4.50; doc string of `winner-mode' Drew Adams
@ 2016-04-29 20:28 ` Lars Ingebrigtsen
0 siblings, 0 replies; 2+ messages in thread
From: Lars Ingebrigtsen @ 2016-04-29 20:28 UTC (permalink / raw
To: Drew Adams; +Cc: 17716
Drew Adams <drew.adams@oracle.com> writes:
> If laziness is a prime concern, then just copy the text from the
> Commentary into the doc string.
I've now done so.
--
(domestic pets only, the antidote for overdose, milk.)
bloggy blog: http://lars.ingebrigtsen.no
^ permalink raw reply [flat|nested] 2+ messages in thread
end of thread, other threads:[~2016-04-29 20:28 UTC | newest]
Thread overview: 2+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2014-06-06 15:08 bug#17716: 24.4.50; doc string of `winner-mode' Drew Adams
2016-04-29 20:28 ` Lars Ingebrigtsen
Code repositories for project(s) associated with this external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.