Re: Further problem with recent changes to custom-magic-alist.

[Luc Teirlinck]

Robert Chassell wrote:

      You have set this %c and saved it in your init file.

   This wording is correct.  In this case, you did not write the code
   yourself, but had a library do it.

But nothing in the sentence tells the latter.  Therefore, the sentence
is very misleading.

_The_ most important thing one needs to know when trying to save a
previously saved option to a new value or reset it to standard, is
whether it was saved _by Custom_, because that affects whether trying
to save a new value or resetting to standard is guaranteed to work.

A State message tries to identify which of nine possible states an
option is in.  A list of them can be found in the initial comment to
cus-edit.el.  That is _all_ a State message should try to do.  Telling
that it was saved in the init file does not help clarifying which of
the nine state the option is in.  On the contrary, it tends to suggest
that the state is "Modified" (set outside Custom) instead of "Saved"
(saved through Custom).  Hence, it does not belong in the State message.

If it _has_ to be told somewhere it would be in the general
documentation at the top of the Custom-buffer, for instance:

===File ~/cus-edit.el-newdiff===============================
*** cus-edit.el 22 Feb 2005 16:55:41 -0600      1.213
--- cus-edit.el 22 Feb 2005 18:32:23 -0600      
***************
*** 1377,1384 ****
        (widget-insert (format ".
  %s show active fields; type RET or click mouse-1
  on an active field to invoke its action.  Editing an option value
! changes the text in the buffer; invoke the State button and
  choose the Set operation to set the option value.
  Invoke " (if custom-raised-buttons
             "`Raised' buttons"
             "Square brackets")))
--- 1377,1388 ----
        (widget-insert (format ".
  %s show active fields; type RET or click mouse-1
  on an active field to invoke its action.  Editing an option value
! changes the text in the buffer.  Invoke the State button and
  choose the Set operation to set the option value.
+ Choose the Save operation to save it.  Saving an option writes a
+ `custom-set-variables' and a `custom-set-faces' form in your
+ `custom-file' (usually .emacs) if they are not yet present and
+ edits these forms otherwise.
  Invoke " (if custom-raised-buttons
             "`Raised' buttons"
             "Square brackets")))
***************
*** 1683,1689 ****
  this %c has been changed outside the customize buffer." "\
  something in this group has been changed outside customize.")
      (saved "!" custom-saved-face "\
! You have set this %c and saved it through Customize in your init file." "\
  something in this group has been set and saved.")
      (rogue "@" custom-rogue-face "\
  this %c has not been changed with customize." "\
--- 1687,1693 ----
  this %c has been changed outside the customize buffer." "\
  something in this group has been changed outside customize.")
      (saved "!" custom-saved-face "\
! You have set and saved this %c through Customize." "\
  something in this group has been set and saved.")
      (rogue "@" custom-rogue-face "\
  this %c has not been changed with customize." "\
============================================================