unofficial mirror of emacs-devel@gnu.org 
 help / color / mirror / code / Atom feed
* custom-reevaluate-setting docstring
@ 2005-07-11  3:26 Luc Teirlinck
  0 siblings, 0 replies; only message in thread
From: Luc Teirlinck @ 2005-07-11  3:26 UTC (permalink / raw)


I propose the following small changes to the
`custom-reevaluate-setting' docstring.  I believe that "default value"
might be somewhat confusing, since it is often used as the opposite of
"buffer local value".  I believe that "standard value", the standard
name used by Custom, is less ambiguous.  I also believe that the
docstring should make clear that it calls the :set function.

I can install, if desired.

===File ~/custom.el-diff====================================
*** custom.el	10 Jul 2005 20:26:42 -0500	1.90
--- custom.el	10 Jul 2005 21:55:00 -0500	
***************
*** 685,694 ****
    (apply 'custom-theme-set-variables 'user args))
  
  (defun custom-reevaluate-setting (symbol)
!   "Reset the value of SYMBOL by re-evaluating its saved or default value.
! This is useful for variables that are defined before their default value
! can really be computed.  E.g. dumped variables whose default depends on
! run-time information."
    (funcall (or (get symbol 'custom-set) 'set-default)
  	   symbol
  	   (eval (car (or (get symbol 'saved-value) (get symbol 'standard-value))))))
--- 685,694 ----
    (apply 'custom-theme-set-variables 'user args))
  
  (defun custom-reevaluate-setting (symbol)
!   "Reset the value of SYMBOL by re-evaluating its saved or standard value.
! Use the :set function to do so.  This is useful for customizable options
! that are defined before their standard value can really be computed.
! E.g. dumped variables whose default depends on run-time information."
    (funcall (or (get symbol 'custom-set) 'set-default)
  	   symbol
  	   (eval (car (or (get symbol 'saved-value) (get symbol 'standard-value))))))
============================================================

^ permalink raw reply	[flat|nested] only message in thread

only message in thread, other threads:[~2005-07-11  3:26 UTC | newest]

Thread overview: (only message) (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2005-07-11  3:26 custom-reevaluate-setting docstring Luc Teirlinck

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