* bug#10541: 24.0.92; doc string of `customize-unsaved'
@ 2012-01-18 17:02 Drew Adams
2012-01-28 2:56 ` Chong Yidong
0 siblings, 1 reply; 3+ messages in thread
From: Drew Adams @ 2012-01-18 17:02 UTC (permalink / raw)
To: 10541
Doc string:
"Customize all user options set in this session but not saved."
It should instead say something like this:
"Open Customize to check all faces and options currently set but not saved."
1. Mention faces too, not just options, which are variables.
2. This is not so much in order to customize as it is to check changes
that have been made during the session. The current doc string misses
the main purpose.
In GNU Emacs 24.0.92.1 (i386-mingw-nt5.1.2600) of 2012-01-16 on MARVIN
Windowing system distributor `Microsoft Corp.', version 5.1.2600
configured using `configure --with-gcc (4.6) --no-opt --cflags
-ID:/devel/emacs/libs/libXpm-3.5.8/include
-ID:/devel/emacs/libs/libXpm-3.5.8/src
-ID:/devel/emacs/libs/libpng-dev_1.4.3-1/include
-ID:/devel/emacs/libs/zlib-dev_1.2.5-2/include
-ID:/devel/emacs/libs/giflib-4.1.4-1/include
-ID:/devel/emacs/libs/jpeg-6b-4/include
-ID:/devel/emacs/libs/tiff-3.8.2-1/include
-ID:/devel/emacs/libs/gnutls-3.0.9/include --ldflags
-LD:/devel/emacs/libs/gnutls-3.0.9/lib'
^ permalink raw reply [flat|nested] 3+ messages in thread
* bug#10541: 24.0.92; doc string of `customize-unsaved'
2012-01-18 17:02 bug#10541: 24.0.92; doc string of `customize-unsaved' Drew Adams
@ 2012-01-28 2:56 ` Chong Yidong
2012-01-28 3:12 ` Drew Adams
0 siblings, 1 reply; 3+ messages in thread
From: Chong Yidong @ 2012-01-28 2:56 UTC (permalink / raw)
To: Drew Adams; +Cc: 10541
"Drew Adams" <drew.adams@oracle.com> writes:
> 1. Mention faces too, not just options, which are variables.
Fixed, thanks.
> 2. This is not so much in order to customize as it is to check changes
> that have been made during the session. The current doc string misses
> the main purpose.
"Customize" in this context means "edit using the Customize interface".
No need to clutter up the docstring.
^ permalink raw reply [flat|nested] 3+ messages in thread
* bug#10541: 24.0.92; doc string of `customize-unsaved'
2012-01-28 2:56 ` Chong Yidong
@ 2012-01-28 3:12 ` Drew Adams
0 siblings, 0 replies; 3+ messages in thread
From: Drew Adams @ 2012-01-28 3:12 UTC (permalink / raw)
To: 'Chong Yidong'; +Cc: 10541
> > 2. This is not so much in order to customize as it is to
> > check changes that have been made during the session.
> > The current doc string misses the main purpose.
>
> "Customize" in this context means "edit using the Customize
> interface". No need to clutter up the docstring.
It sounds like you missed the point. Users use this function not so much to
"edit using the Customize interface" as to check unsaved changes to see if they
might want to save some. 99.999% of the time I expect users will do no editing.
They will simply save or not (exit without saving).
This function is _not_ about _editing_ or _customizing_. It is about using "the
Customize interface" to _check_ unsaved values.
^ permalink raw reply [flat|nested] 3+ messages in thread
end of thread, other threads:[~2012-01-28 3:12 UTC | newest]
Thread overview: 3+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2012-01-18 17:02 bug#10541: 24.0.92; doc string of `customize-unsaved' Drew Adams
2012-01-28 2:56 ` Chong Yidong
2012-01-28 3:12 ` Drew Adams
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).