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: Thu, 04 Jan 2007 20:28:39 +0100 Organization: Epita/LRDE Message-ID: <87hcv6k2vs.fsf@lrde.org> References: <877iw3tfc4.fsf@lrde.org> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="===============1056387447==" X-Trace: sea.gmane.org 1167939026 1871 80.91.229.12 (4 Jan 2007 19:30:26 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Thu, 4 Jan 2007 19:30:26 +0000 (UTC) Cc: lekktu@gmail.com, rms@gnu.org, emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Jan 04 20:30:20 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 1H2YI3-0004eL-0E for ged-emacs-devel@m.gmane.org; Thu, 04 Jan 2007 20:30:15 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1H2YI2-0001o4-GH for ged-emacs-devel@m.gmane.org; Thu, 04 Jan 2007 14:30:14 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1H2YHC-0001bE-Jr for emacs-devel@gnu.org; Thu, 04 Jan 2007 14:29:22 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1H2YH8-0001Zg-PL for emacs-devel@gnu.org; Thu, 04 Jan 2007 14:29:22 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1H2YH8-0001ZZ-I8 for emacs-devel@gnu.org; Thu, 04 Jan 2007 14:29:18 -0500 Original-Received: from [213.186.62.213] (helo=30.mail-out.ovh.net) by monty-python.gnu.org with smtp (Exim 4.52) id 1H2YH8-0006dE-0n for emacs-devel@gnu.org; Thu, 04 Jan 2007 14:29:18 -0500 Original-Received: (qmail 18394 invoked by uid 503); 4 Jan 2007 19:29:13 -0000 Original-Received: (QMFILT: 1.0); 04 Jan 2007 19:29:13 -0000 Original-Received: from b6.ovh.net (HELO mail193.ha.ovh.net) (213.186.33.56) by 30.mail-out.ovh.net with SMTP; 4 Jan 2007 19:29:13 -0000 Original-Received: from b0.ovh.net (HELO queue-out) (213.186.33.50) by b0.ovh.net with SMTP; 4 Jan 2007 19:28:58 -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; 4 Jan 2007 19:28:57 -0000 Original-To: "Drew Adams" User-Agent: Gnus/5.110006 (No Gnus v0.6) Emacs/22.0.92 (gnu/linux) 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== 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== 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:64769 Archived-At: --===============1056387447== Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha1; protocol="application/pgp-signature" --=-=-= Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: quoted-printable Hi Drew! Please, do not remove me from the list of Cc as I don't scrupulously read Emacs Devel usually. "Drew Adams" writes: >> + ;; 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. > > Yes. Here is a doc string I have, for instance. > > "**Completions* window is removed if fewer chars than this are input." I don't see your point. Maybe this has been discussed with Juanma, but what's the harm removing the first * ? > Why not just leave any extra `*' there? Because it's confusing and somewhat useless for the user. >> Again, it is with the previous patch. With it, not only =AB You can >> customize the variable =BB can appear, but also =AB You can change at us= er >> level the variable =BB, which means that you can M-x set-var this var. > > If that's what you mean, then that's what should be said: "You can use > command `set-variable' to change the value". This is confusing: "change at > user level". > "You can change at user level" doesn't teach anything. It says less (beca= use > it is confusing) than just "You can change this variable" (with a link on > "change"). =AB You can change this variable =BB can lead the user to think that the only variables s?he can change are those ones, whereas `setq' can change nearly everything. But I do agree that =AB at user level =BB is confusing. What about =AB You can change this variable using `set-variable' =BB with a link on =AB change =BB ? It would show up as: ,----[ C-h v show-paren-highlight-openparen RET ] | show-paren-highlight-openparen is a variable defined in `paren.el'. | Its value is t |=20 |=20 | Documentation: | Non-nil turns on openparen highlighting when matching forward. |=20 | You can change this variable using `set-variable'. `---- =2D-=20 | Micha=EBl `Micha' Cadilhac | =ABTu aimeras ton prochain.=BB = | | Epita/LRDE Promo 2007 | D'abord, Dieu ou pas, = | | http://michael.cadilhac.name | j'ai horreur qu'on me tutoie. = | `--JID: michael.cadilhac@gmail.com--' -- P. Desproges - = --' --=-=-= Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.5 (GNU/Linux) iD8DBQFFnVVoUJhDmOfFA3URAuJmAJ9sePTPGwAL9PTuiRzpe9wzjToGTwCguFJc rsmN23+64dELAhbncqaxy2g= =qdbU -----END PGP SIGNATURE----- --=-=-=-- --===============1056387447== 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 --===============1056387447==--