From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Juri Linkov Newsgroups: gmane.emacs.devel Subject: Re: completing-read-multiple and read-face-name are not in Elisp manual Date: Wed, 20 Jun 2007 01:09:28 +0300 Organization: JURTA Message-ID: <87ir9j4mfl.fsf@jurta.org> References: NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1182291807 2766 80.91.229.12 (19 Jun 2007 22:23:27 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Tue, 19 Jun 2007 22:23:27 +0000 (UTC) Cc: emacs-devel@gnu.org To: "Drew Adams" Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Jun 20 00:23:25 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 1I0m6d-00030v-D2 for ged-emacs-devel@m.gmane.org; Wed, 20 Jun 2007 00:23:23 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1I0m6c-0000fa-Oy for ged-emacs-devel@m.gmane.org; Tue, 19 Jun 2007 18:23:22 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1I0m6Y-0000bR-EO for emacs-devel@gnu.org; Tue, 19 Jun 2007 18:23:18 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1I0m6W-0000Ym-TX for emacs-devel@gnu.org; Tue, 19 Jun 2007 18:23:18 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1I0m6W-0000YW-Ov for emacs-devel@gnu.org; Tue, 19 Jun 2007 18:23:16 -0400 Original-Received: from relay01.kiev.sovam.com ([62.64.120.200]) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1I0m6W-0004e2-Bu for emacs-devel@gnu.org; Tue, 19 Jun 2007 18:23:16 -0400 Original-Received: from [83.170.232.243] (helo=smtp.svitonline.com) by relay01.kiev.sovam.com with esmtp (Exim 4.67) (envelope-from ) id 1I0m6R-00089B-S9; Wed, 20 Jun 2007 01:23:14 +0300 In-Reply-To: (Drew Adams's message of "Tue\, 19 Jun 2007 11\:48\:45 -0700") User-Agent: Gnus/5.11 (Gnus v5.11) Emacs/22.1.50 (gnu/linux) X-Scanner-Signature: 1678f860418e8694a064f05d5e21ded6 X-DrWeb-checked: yes X-SpamTest-Envelope-From: juri@jurta.org X-SpamTest-Group-ID: 00000000 X-SpamTest-Header: Not Detected X-SpamTest-Info: Profiles 1157 [June 19 2007] X-SpamTest-Info: helo_type=3 X-SpamTest-Method: none X-SpamTest-Rate: 0 X-SpamTest-Status: Not detected X-SpamTest-Status-Extended: not_detected X-SpamTest-Version: SMTP-Filter Version 3.0.0 [0255], KAS30/Release X-detected-kernel: FreeBSD 4.8-5.1 (or MacOS X 10.2-10.3) 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:73342 Archived-At: > I find nothing about this behavior described anywhere in the Emacs manual or > the Elisp manual. How will users understand the UI? How will programmers > understand how these functions work (without examining the code in detail)? This is an optional feature that users can encounter only when running `describe-face' on the face name in the `defface' definition (where one face gets picked from the face name, and another from the face used to highlight it by font-lock mode - font-lock-variable-name). However, this feature could be documented and developed further to e.g. allowing selecting multiple faces from the *Completions* buffer, inserting them into the minibuffer separated by a comma, and calling a multi-command on them. -- Juri Linkov http://www.jurta.org/emacs/