From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: michael@cadilhac.name (=?iso-8859-1?Q?Micha=EBl?= Cadilhac) Newsgroups: gmane.emacs.devel Subject: Re: defcustom and the stars. Date: Wed, 03 Jan 2007 15:52:19 +0100 Organization: Epita/LRDE Message-ID: <87mz50nows.fsf@lrde.org> References: <87d55xozrn.fsf@lrde.org> <877iw4pdyo.fsf@lrde.org> <873b6sp96d.fsf@lrde.org> <87vejont95.fsf@lrde.org> <87r6ucns3x.fsf@lrde.org> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="===============0658429419==" X-Trace: sea.gmane.org 1167835985 20848 80.91.229.12 (3 Jan 2007 14:53:05 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Wed, 3 Jan 2007 14:53:05 +0000 (UTC) Cc: Stefan Monnier , emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Jan 03 15:53:03 2007 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1H27U9-0003Gh-TC for ged-emacs-devel@m.gmane.org; Wed, 03 Jan 2007 15:52:58 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1H27U9-0000gq-EA for ged-emacs-devel@m.gmane.org; Wed, 03 Jan 2007 09:52:57 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1H27To-0000g5-HC for emacs-devel@gnu.org; Wed, 03 Jan 2007 09:52:36 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1H27Tl-0000eq-RU for emacs-devel@gnu.org; Wed, 03 Jan 2007 09:52:36 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1H27Tl-0000ei-LK for emacs-devel@gnu.org; Wed, 03 Jan 2007 09:52:33 -0500 Original-Received: from [213.186.38.137] (helo=27.mail-out.ovh.net) by monty-python.gnu.org with smtp (Exim 4.52) id 1H27Tk-00050G-Uy for emacs-devel@gnu.org; Wed, 03 Jan 2007 09:52:33 -0500 Original-Received: (qmail 13804 invoked by uid 503); 3 Jan 2007 14:54:19 -0000 Original-Received: from b6.ovh.net (HELO mail173.ha.ovh.net) (213.186.33.56) by 27.mail-out.ovh.net with SMTP; 3 Jan 2007 14:54:19 -0000 Original-Received: from b0.ovh.net (HELO queue-out) (213.186.33.50) by b0.ovh.net with SMTP; 3 Jan 2007 14:51:56 -0000 Original-Received: from ivr94-6-82-230-255-91.fbx.proxad.net (HELO localhost) (82.230.255.91) by ns0.ovh.net with SMTP; 3 Jan 2007 14:51:54 -0000 Original-To: "Juanma Barranquero" Face: iVBORw0KGgoAAAANSUhEUgAAADAAAAAwBAMAAAClLOS0AAAAElBMVEVWPh+Tai+5r5YKBAEU CQQzGAtiq7gjAAACR0lEQVQ4jW2UzW7lIAyFzVW8BzTZX5DmCZLuU2H2pMXv/ypzbK7aSh2kRCRf /HNsE0q7Sg+RQ7JFKaqtrRNAl5AIIKe6D5DBqgbmUAe5hBI1wIRFAHjeM0RKtZi7XVVEpb0BSNfA IddChChT5DildSLWOWhY5IEItMnncZgFcUAc/5jjwCMsDosRNdfKPDTFEdVBW8C+RebDb4N5Orio RhM1+11IJyx0ng2+LryFHBMPDQDYHrY6IfGuU3ouiXTQNE8LIJDKOWpNxERTFrggQwRPd7USUsTW fJ0XbR3bdj5KgBYy4SACpxDeUYEUAzLmtJ1iIrD2gczPq8Qomjhsh/RjGIgKIO8p7NITjwlx7WID nsnQe5NeuTvoBpi8LX6vLLOh5icjOHqBypgnuSp7M+RE1agbQKHQr5E2z1WObhYW4gMqeGQL7joM jCf2DxSk5ApADSYHfFF4igNfJZL1z0GKP0FN02s4XiDXr7V5P94W6I9v8MfBOQDmfwAaVYt+x8Da v4DJvX8BAdin3Knm5yMZYAO4ABDkDniZLLfi4P40gP1F0TPGZOu0CGwA1lcowxwlGy6A9705mD0V jHCxwVZT/hYdRJVUGZNlx6l7ScQBTluof6Wj6bsPYlvpwoTvXFD9gHPn2TZPF3ntI2ecxVrW5MrV XiCie5EeNa7BlWu/HNSkprDUva163PHxAv5jyGV7gVzyAghSKOTnat85UIYFICXbD2NV9rRiv0BS tKQsg6OHH4A15F1WW+UHKHHa32h6aPnAm3/pUcWp+WYnTQAAAABJRU5ErkJggg== In-Reply-To: (Juanma Barranquero's message of "Wed\, 3 Jan 2007 14\:57\:33 +0100") User-Agent: Gnus/5.110006 (No Gnus v0.6) Emacs/22.0.92 (gnu/linux) X-Ovh-Remote: 82.230.255.91 (ivr94-6-82-230-255-91.fbx.proxad.net) X-Ovh-Local: 213.186.33.20 (ns0.ovh.net) X-Spam-Check: DONE|H 0.5/N X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:64692 Archived-At: --===============0658429419== Content-Type: multipart/signed; boundary="==-=-="; micalg=pgp-sha1; protocol="application/pgp-signature" --==-=-= Content-Type: multipart/mixed; boundary="=-=-=" --=-=-= Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: quoted-printable "Juanma Barranquero" writes: > On 1/3/07, Micha=EBl Cadilhac wrote: > >> http://permalink.gmane.org/gmane.emacs.devel/64677 > >> And the only reference to user variable in this doc is >> for customizable vars (AFAICS). > > Then yes, perhaps a doc patch would be in order. So let's give it a try (writing doc is always funny for me as my English is far from good). This is to be read together with the previous patch (if applied). --=-=-= Content-Type: text/x-patch; charset=iso-8859-1 Content-Disposition: inline; filename=custom.patch Content-Transfer-Encoding: quoted-printable Index: man/custom.texi =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D RCS file: /sources/emacs/emacs/man/custom.texi,v retrieving revision 1.124 diff -c -r1.124 custom.texi *** man/custom.texi 1 Jan 2007 01:57:16 -0000 1.124 =2D-- man/custom.texi 3 Jan 2007 14:36:31 -0000 *************** *** 807,813 **** Display the value and documentation of variable @var{var} (@code{describe-variable}). @item M-x set-variable @key{RET} @var{var} @key{RET} @var{value} @key{RET} ! Change the value of variable @var{var} to @var{value}. @end table =20=20 To examine the value of a single variable, use @kbd{C-h v} =2D-- 807,813 ---- Display the value and documentation of variable @var{var} (@code{describe-variable}). @item M-x set-variable @key{RET} @var{var} @key{RET} @var{value} @key{RET} ! Change the value of the user option variable @var{var} to @var{value}. @end table =20=20 To examine the value of a single variable, use @kbd{C-h v} *************** *** 832,838 **** satisfies the predicate `integerp'. =20=20 Documentation: ! *Column beyond which automatic line-wrapping should happen. Interactively, you can set the buffer local value using C-x f. =20=20 You can customize this variable. =2D-- 832,838 ---- satisfies the predicate `integerp'. =20=20 Documentation: ! Column beyond which automatic line-wrapping should happen. Interactively, you can set the buffer local value using C-x f. =20=20 You can customize this variable. *************** *** 840,848 **** =20=20 @noindent The line that says you can customize the variable indicates that this ! variable is a user option. (The star also indicates this, but it is ! an obsolete indicator that may eventually disappear.) @kbd{C-h v} is ! not restricted to user options; it allows any variable name. =20=20 @findex set-variable The most convenient way to set a specific user option variable is with =2D-- 840,848 ---- =20=20 @noindent 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. =20=20 @findex set-variable The most convenient way to set a specific user option variable is with Index: man/ChangeLog =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D RCS file: /sources/emacs/emacs/man/ChangeLog,v retrieving revision 1.1177 diff -C0 -r1.1177 ChangeLog *** man/ChangeLog 1 Jan 2007 22:20:46 -0000 1.1177 =2D-- man/ChangeLog 3 Jan 2007 14:36:47 -0000 *************** *** 0 **** =2D-- 1,9 ---- + 2007-01-03 Micha=EBl Cadilhac +=20 + * custom.texi (Examining): Say sooner that set-variable takes only + user option variables. + Remove the leading `*' in the documentation of `fill-column' used as an + example. Remove the mention on the obsolescence of this star. + Indicate that the line `you can change at user level the variable' + means that the variable is a user option. +=20 --=-=-= Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: quoted-printable > Regarding your patch, I'm not sure. On one hand, talking about > set-variable in the output of describe-variable can be useful, and it > certainly isn't like we are shy about adding useful info there (try > with an automatically buffer-local, obsolete variable alias with a > safe-local-variable property :) > > On the other hand, it is already quite crowded... At least, it will not add any line to an automatically buffer-local, obsolete variable alias with a safe-local-variable property WHICH IS customizable. Only to a [...] that has a "*" and is not customizable! =2D-=20 | Micha=EBl `Micha' Cadilhac | The second-degree, = | | Epita/LRDE Promo 2007 | is kind of = | | http://michael.cadilhac.name | the semantic back slang. = | `--JID: michael.cadilhac@gmail.com--' - = --' --=-=-=-- --==-=-= Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.5 (GNU/Linux) iD8DBQFFm8MmUJhDmOfFA3URAqsVAJ9iTcZyvp2Xtzysb6D1+jyCBpnq8wCfRTgT Pxr3uTZ/czbRx4hiefjzhu8= =owIn -----END PGP SIGNATURE----- --==-=-=-- --===============0658429419== Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Disposition: inline _______________________________________________ Emacs-devel mailing list Emacs-devel@gnu.org http://lists.gnu.org/mailman/listinfo/emacs-devel --===============0658429419==--