Re: defcustom and the stars.

[michael@cadilhac.name (Michaël Cadilhac)]

[-- Attachment #1.1: Type: text/plain, Size: 3129 bytes --]

Richard Stallman <rms@gnu.org> writes:

>       Documentation:
>     ! *Column beyond which automatic line-wrapping should happen.
>       Interactively, you can set the buffer local value using C-x f.

>       Documentation:
>     ! Column beyond which automatic line-wrapping should happen.
>       Interactively, you can set the buffer local value using C-x f.
>
> That is incorrect, because the Documentation of fill-column
> does include a star at present.

Yes, this is to be read with the change I proposed to remove this `*' in
C-h v.

>       The line that says you can customize the variable indicates that this
>     ! variable is a user option, as would have indicated a line saying that
>     ! you can change at user level the variable.  @kbd{C-h v} is not
>     ! restricted to user options; it allows any variable name.
>
> I can't understand that new text.
> What is it supposed to mean?

Again, it is with the previous patch.  With it, not only « You can
customize the variable » can appear, but also « You can change at user
level the variable », which means that you can M-x set-var this var.

Richard Stallman <rms@gnu.org> writes:

> This change
>
>     + 	      ;; If DOC starts with a `*' remove it.
>     + 	      (when (eq (aref doc 0) ?*)
>     + 		(setq doc (substring doc 1)))
>
> might be ok, but I am not sure it is really right -- it seems
> like a hard question.  So I would rather leave this alone, for now.

This is just an eye candy change for C-h v: the user doesn't need this
`*', so let's remove it before printing.  Why would it be a hard
question?

>     ! 	      (if (user-variable-p variable)
>     ! 		  (let ((change-label "change"))
>     ! 		    (terpri)
>     ! 		    (terpri)
>     ! 		    (princ (concat "You can " change-label
>     ! 				   " at user level this variable."))
>     ! 		    (with-current-buffer standard-output
>     ! 		      (save-excursion
>     ! 			(re-search-backward
>     ! 			 (concat "\\(" change-label "\\)") nil t)
>     ! 			(help-xref-button 1 'help-change-variable variable))))))
>
> What is that meant to achieve?
> What does the feature look like at user level?

C-h v propose to change customizable vars ; this patch allows to
change all user option vars from C-h v. It looks like that :

,----[ C-h v show-paren-highlight-openparen RET ]
| show-paren-highlight-openparen is a variable defined in `paren.el'.
| Its value is t
| 
| 
| Documentation:
| Non-nil turns on openparen highlighting when matching forward.
| 
| You can change at user level this variable.
`----

« change » is a hyperlink. Following it is the same as
M-x set-variable RET s-p-h-openparen RET, so leads to:
« Set show-paren-highlight-openparen globally to value: »

-- 
 |      Michaël `Micha' Cadilhac     |  Si les religions etaient aussi tole-  |
 |         Epita/LRDE Promo 2007     |  rantes qu'elles le pretendent, il y   |
 |  http://michael.cadilhac.name     |  a longtemps qu'il n'y en aurait plus  |
 `--JID: michael.cadilhac@gmail.com--'           -- Moustic              -  --'

[-- Attachment #1.2: Type: application/pgp-signature, Size: 188 bytes --]

[-- Attachment #2: Type: text/plain, Size: 142 bytes --]

_______________________________________________
Emacs-devel mailing list
Emacs-devel@gnu.org
http://lists.gnu.org/mailman/listinfo/emacs-devel