From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Richard M. Stallman" Newsgroups: gmane.emacs.devel Subject: Re: Argument names in Elisp Reference vs docstrings Date: Fri, 16 Sep 2005 08:59:29 -0400 Message-ID: References: <87acieyoo9.fsf@jurta.org> Reply-To: rms@gnu.org NNTP-Posting-Host: main.gmane.org Content-Type: text/plain; charset=ISO-8859-15 X-Trace: sea.gmane.org 1126877320 17135 80.91.229.2 (16 Sep 2005 13:28:40 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Fri, 16 Sep 2005 13:28:40 +0000 (UTC) Cc: lekktu@gmail.com, emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Sep 16 15:28:37 2005 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1EGGGM-000311-PH for ged-emacs-devel@m.gmane.org; Fri, 16 Sep 2005 15:28:24 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1EGGGM-0002fN-3x for ged-emacs-devel@m.gmane.org; Fri, 16 Sep 2005 09:28:22 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1EGFtW-0002iM-GF for emacs-devel@gnu.org; Fri, 16 Sep 2005 09:04:46 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1EGFtU-0002h5-4N for emacs-devel@gnu.org; Fri, 16 Sep 2005 09:04:44 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1EGFtR-0002Gw-U3 for emacs-devel@gnu.org; Fri, 16 Sep 2005 09:04:42 -0400 Original-Received: from [199.232.76.164] (helo=fencepost.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.34) id 1EGFoS-00016Y-4M for emacs-devel@gnu.org; Fri, 16 Sep 2005 08:59:32 -0400 Original-Received: from rms by fencepost.gnu.org with local (Exim 4.34) id 1EGFoP-0004vp-Fx; Fri, 16 Sep 2005 08:59:29 -0400 Original-To: Juri Linkov In-reply-to: <87acieyoo9.fsf@jurta.org> (message from Juri Linkov on Fri, 16 Sep 2005 01:03:02 +0300) 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:42987 Archived-At: Below is a list of arguments with similar names of minibuffer functions collected from docstrings and descriptions in the Emacs Lisp Reference: prompt, prompt-string initial, initial-contents, initial-input history, hist def, defalt, default, default-value, default-filename, default-dirname inherit-input-method require-match, mustmatch, must-match, existing collection, table, alist nospace, hide-spaces directory, dir It is not necessarily desirable to make them uniform. That may or may not be an improvement, depending on the details. Thus, the changes you propose may be good in some cases, but not necessarily in each one. So I do not want to make these decisions in a blanket fashion. How about if you pick one of these groups of alternatives, make the changes to standardize that group, and send the diff here to be looked at? inherit-input-method THat is not an inconsistency, just long. collection, table, alist I don't like "collection" very much. nospace, hide-spaces "nospace" and "hide-spaces" suggest different meanings. I don't know how they are actually used, but it is possible that it is better to keep them both. history, hist The only possible reason not to change "hist" to "history" is to save space. require-match, mustmatch, must-match, existing This seems like a good case to standardize, but it is possible that there is a reason to use "existing" in a specific case.