GNU bug report logs - #10541
24.0.92; doc string of `customize-unsaved'

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 10541 in the body.
You can then email your comments to 10541 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: "Drew Adams" <drew.adams <at> oracle.com>
To: <bug-gnu-emacs <at> gnu.org>
Subject: 24.0.92; doc string of `customize-unsaved'
Date: Wed, 18 Jan 2012 09:02:26 -0800

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'
 

Message #8 received at 10541 <at> debbugs.gnu.org (full text, mbox):

From: Chong Yidong <cyd <at> gnu.org>
To: "Drew Adams" <drew.adams <at> oracle.com>
Cc: 10541 <at> debbugs.gnu.org
Subject: Re: bug#10541: 24.0.92; doc string of `customize-unsaved'
Date: Sat, 28 Jan 2012 10:56:32 +0800

"Drew Adams" <drew.adams <at> 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.

Message #13 received at 10541 <at> debbugs.gnu.org (full text, mbox):

From: "Drew Adams" <drew.adams <at> oracle.com>
To: "'Chong Yidong'" <cyd <at> gnu.org>
Cc: 10541 <at> debbugs.gnu.org
Subject: RE: bug#10541: 24.0.92; doc string of `customize-unsaved'
Date: Fri, 27 Jan 2012 19:12:28 -0800

> > 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.

Previous Next

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