From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.devel Subject: RE: defcustom and the stars. Date: Thu, 4 Jan 2007 09:16:27 -0800 Message-ID: References: NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Trace: sea.gmane.org 1167931112 29686 80.91.229.12 (4 Jan 2007 17:18:32 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Thu, 4 Jan 2007 17:18:32 +0000 (UTC) Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Jan 04 18:18:31 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 1H2WEW-0005Wu-C8 for ged-emacs-devel@m.gmane.org; Thu, 04 Jan 2007 18:18:28 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1H2WEV-0004Ih-Py for ged-emacs-devel@m.gmane.org; Thu, 04 Jan 2007 12:18:27 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1H2WEJ-0004IC-4H for emacs-devel@gnu.org; Thu, 04 Jan 2007 12:18:15 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1H2WEH-0004Hm-Mw for emacs-devel@gnu.org; Thu, 04 Jan 2007 12:18:14 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1H2WEH-0004Hj-H4 for emacs-devel@gnu.org; Thu, 04 Jan 2007 12:18:13 -0500 Original-Received: from [148.87.113.118] (helo=rgminet01.oracle.com) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA:32) (Exim 4.52) id 1H2WEG-0005tE-MH for emacs-devel@gnu.org; Thu, 04 Jan 2007 12:18:13 -0500 Original-Received: from rgmgw3.us.oracle.com (rgmgw3.us.oracle.com [138.1.186.112]) by rgminet01.oracle.com (Switch-3.2.4/Switch-3.1.6) with ESMTP id l04HIAJs011618 for ; Thu, 4 Jan 2007 10:18:10 -0700 Original-Received: from rcsmt251.oracle.com (rcsmt251.oracle.com [148.87.90.196]) by rgmgw3.us.oracle.com (Switch-3.2.4/Switch-3.1.7) with ESMTP id l04HEjoI030607 for ; Thu, 4 Jan 2007 10:18:09 -0700 Original-Received: from dhcp-4op11-4op12-west-130-35-178-179.us.oracle.com by rcsmt251.oracle.com with ESMTP id 2335176881167930992; Thu, 04 Jan 2007 10:16:32 -0700 Original-To: X-Priority: 3 (Normal) X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook IMO, Build 9.0.6604 (9.0.2911.0) In-Reply-To: X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.3028 Importance: Normal X-Whitelist: TRUE X-Whitelist: TRUE X-Brightmail-Tracker: AAAAAQAAAAI= 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:64757 Archived-At: > Not to defend modifying describe-variable right now, but this: >=20 > > Yes. Here is a doc string I have, for instance. > > > > "**Completions* window is removed if fewer chars than this are = input." >=20 > is basically incorrect, in the sense that >=20 > (defvar my-var nil "*Completions* window blah blah.") >=20 > is wrong; it makes my-var a user variable, when it isn't intended to. > Seems like a docstring payload (taking out the possible initial "*") > should not start with an asterisk... Sorry, I don't understand. The variable with that doc string (beginning = "**") _is_ a user variable. It is intended to be a user variable. You raise, I imagine, a different issue: how to prevent a variable from = becoming a user variable (changeable with `set-variable') if its doc = string begins with `*', as in your defvar: "*Completions* window blah = blah.". It's possible I misunderstand you. But if that is the issue you want to = raise, then I think it is not worth pursuing: people can rephrase the = text to avoid starting with `*' if they don't want `*' to indicate a = user variable. (In my case, I _do_ want it to indicate a user variable.)