From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Deniz Dogan Newsgroups: gmane.emacs.bugs Subject: bug#3135: 23.0.92; doc of custom-variable-documentation Date: Mon, 11 Jul 2011 19:30:51 +0200 Message-ID: <4E1B334B.4070305@dogan.se> References: <002001c9c77d$603d9da0$0ab32382@us.oracle.com><2ACB4C4205C543BF810CFD7ABD0D424F@us.oracle.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-Trace: dough.gmane.org 1310406414 3362 80.91.229.12 (11 Jul 2011 17:46:54 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Mon, 11 Jul 2011 17:46:54 +0000 (UTC) To: 3135@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Jul 11 19:46:50 2011 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([140.186.70.17]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1QgKZF-0008V8-3R for geb-bug-gnu-emacs@m.gmane.org; Mon, 11 Jul 2011 19:46:49 +0200 Original-Received: from localhost ([::1]:46528 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QgKZE-0002Wz-3N for geb-bug-gnu-emacs@m.gmane.org; Mon, 11 Jul 2011 13:46:48 -0400 Original-Received: from eggs.gnu.org ([140.186.70.92]:51083) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QgKL0-0007XP-MV for bug-gnu-emacs@gnu.org; Mon, 11 Jul 2011 13:32:08 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1QgKKz-0008Fi-3r for bug-gnu-emacs@gnu.org; Mon, 11 Jul 2011 13:32:06 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:47217) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QgKKz-0008Fc-0v for bug-gnu-emacs@gnu.org; Mon, 11 Jul 2011 13:32:05 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1QgKKy-0006rp-IA; Mon, 11 Jul 2011 13:32:04 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Deniz Dogan Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Mon, 11 Jul 2011 17:32:04 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 3135 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: notabug X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.131040551226365 (code B ref -1); Mon, 11 Jul 2011 17:32:04 +0000 Original-Received: (at submit) by debbugs.gnu.org; 11 Jul 2011 17:31:52 +0000 Original-Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QgKKl-0006rC-GV for submit@debbugs.gnu.org; Mon, 11 Jul 2011 13:31:51 -0400 Original-Received: from eggs.gnu.org ([140.186.70.92]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QgKKj-0006qy-72 for submit@debbugs.gnu.org; Mon, 11 Jul 2011 13:31:49 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1QgKKd-00081w-1B for submit@debbugs.gnu.org; Mon, 11 Jul 2011 13:31:43 -0400 Original-Received: from lists.gnu.org ([140.186.70.17]:52451) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QgKKc-00081m-PA for submit@debbugs.gnu.org; Mon, 11 Jul 2011 13:31:42 -0400 Original-Received: from eggs.gnu.org ([140.186.70.92]:50972) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QgKKX-0007RI-2D for bug-gnu-emacs@gnu.org; Mon, 11 Jul 2011 13:31:42 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1QgKKV-0007zU-LX for bug-gnu-emacs@gnu.org; Mon, 11 Jul 2011 13:31:36 -0400 Original-Received: from ch-smtp05.sth.basefarm.net ([80.76.153.6]:36399) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QgKKV-0007zN-5S for bug-gnu-emacs@gnu.org; Mon, 11 Jul 2011 13:31:35 -0400 Original-Received: from c80-216-105-155.bredband.comhem.se ([80.216.105.155]:63127 helo=[192.168.0.10]) by ch-smtp05.sth.basefarm.net with esmtp (Exim 4.76) (envelope-from ) id 1QgKJr-00033Q-GF for bug-gnu-emacs@gnu.org; Mon, 11 Jul 2011 19:30:56 +0200 User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:5.0) Gecko/20110624 Thunderbird/5.0 In-Reply-To: X-Originating-IP: 80.216.105.155 X-Scan-Result: No virus found in message 1QgKJr-00033Q-GF. X-Scan-Signature: ch-smtp05.sth.basefarm.net 1QgKJr-00033Q-GF ca5f1101dfddb33ea51adeed823c2f0e X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Mon, 11 Jul 2011 13:32:04 -0400 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 140.186.70.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:48630 Archived-At: On 2011-07-11 18:24, Drew Adams wrote: >>>> In my opinion, it's clear enough as it is. >>> >>> What makes it clear that VARIABLE is not necessarily a user variable >>> (`user-variable-p')? >> >> It says nothing about VARIABLE being a special kind of variable, so it >> seems pretty obvious to me that it's talking about all kinds of >> variables. > > It might be clear to you, but not to users. Customize is all about user > variables (options). We should be very clear whenever we mean a variable that > is not necessarily a user variable. > For what it's worth, I'm with Lars on this one. We shouldn't have to clarify what things are *not*, only what they are, concisely. Both defvars and defcustoms can have docstrings and I don't think anyone is confused by it. > What does this added clarity cost? It's about _users_; it's not about Emacs > Dev's ease in dispatching bugs summarily. > It doesn't cost many bytes, but unnecessary "clarity" is...unnecessary. I don't see why any user would be confused by this. Deniz