From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Chong Yidong Newsgroups: gmane.emacs.bugs Subject: bug#12912: 24.3.50; doc string for `read-face-name' Date: Wed, 09 Jan 2013 17:46:57 +0800 Message-ID: <87bocy4rji.fsf@gnu.org> References: <516312D8C1444CE28E4459BC7115A1BA@us.oracle.com> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1357724883 4507 80.91.229.3 (9 Jan 2013 09:48:03 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 9 Jan 2013 09:48:03 +0000 (UTC) Cc: 12912-done@debbugs.gnu.org To: "Drew Adams" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Wed Jan 09 10:48:20 2013 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1TssGi-0007C6-Hz for geb-bug-gnu-emacs@m.gmane.org; Wed, 09 Jan 2013 10:48:20 +0100 Original-Received: from localhost ([::1]:48501 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TssGP-0001A3-UT for geb-bug-gnu-emacs@m.gmane.org; Wed, 09 Jan 2013 04:48:01 -0500 Original-Received: from eggs.gnu.org ([208.118.235.92]:50837) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TssGL-00019j-Ke for bug-gnu-emacs@gnu.org; Wed, 09 Jan 2013 04:48:00 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TssGI-0002t3-Gu for bug-gnu-emacs@gnu.org; Wed, 09 Jan 2013 04:47:57 -0500 Original-Received: from debbugs.gnu.org ([140.186.70.43]:44672) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TssGI-0002sx-EC for bug-gnu-emacs@gnu.org; Wed, 09 Jan 2013 04:47:54 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1TssGQ-0002E2-ND for bug-gnu-emacs@gnu.org; Wed, 09 Jan 2013 04:48:02 -0500 Resent-From: Chong Yidong Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: bug-gnu-emacs@gnu.org Resent-Date: Wed, 09 Jan 2013 09:48:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: cc-closed 12912 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Mail-Followup-To: 12912@debbugs.gnu.org, cyd@gnu.org, drew.adams@oracle.com Original-Received: via spool by 12912-done@debbugs.gnu.org id=D12912.13577248448502 (code D ref 12912); Wed, 09 Jan 2013 09:48:02 +0000 Original-Received: (at 12912-done) by debbugs.gnu.org; 9 Jan 2013 09:47:24 +0000 Original-Received: from localhost ([127.0.0.1]:57912 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TssFn-0002D5-Ic for submit@debbugs.gnu.org; Wed, 09 Jan 2013 04:47:23 -0500 Original-Received: from mail-pb0-f46.google.com ([209.85.160.46]:50643) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TssFj-0002Co-Ne for 12912-done@debbugs.gnu.org; Wed, 09 Jan 2013 04:47:20 -0500 Original-Received: by mail-pb0-f46.google.com with SMTP id wy7so835797pbc.19 for <12912-done@debbugs.gnu.org>; Wed, 09 Jan 2013 01:47:04 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=x-received:sender:from:to:cc:subject:references:date:in-reply-to :message-id:user-agent:mime-version:content-type; bh=Ke2R+b2YVaVZJBGaPgEXaRgE3tsDa2Q3u10VkcIoAr8=; b=oCuGP718geqGppC3nuFsZZGtTklg8vCayFy0AQG3+FdMc5bZDNOV9a56GClmwkwLDg cqEcBr3RL++LIQMyCpXWfJJsBhm/VOgIT79qZkoDaRbW/QFPXt42l3omeM7C/TlmXWg9 9lNn6FnUHYiV5QareTgVgXfnrTpnf35DiXeI3M788ZRBHkryAoKeCKoVSdCYvYQ81y3y zqHuZ6zWzdEXh4ntyh+xZPRPGi94Je2y29MqZL39oe1HCfMdPSI7Y0DxvrC0sfT70RB+ KfTOh0TVh1txH9JSQEz7glN0Ez3deRjo6F452XUKx/QOpFyecR/RPQ0o57eTHyk8gRV5 N+TA== X-Received: by 10.66.75.100 with SMTP id b4mr188335765paw.0.1357724824074; Wed, 09 Jan 2013 01:47:04 -0800 (PST) Original-Received: from tsparkle ([155.69.17.48]) by mx.google.com with ESMTPS id pm8sm41345262pbb.29.2013.01.09.01.47.00 (version=SSLv3 cipher=OTHER); Wed, 09 Jan 2013 01:47:02 -0800 (PST) In-Reply-To: <516312D8C1444CE28E4459BC7115A1BA@us.oracle.com> (Drew Adams's message of "Fri, 16 Nov 2012 16:37:34 -0800") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.2.91 (gnu/linux) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x 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:69537 Archived-At: "Drew Adams" writes: > This doc seems to be incomplete and unclear wrt DEFAULT. > > It speaks of a case where DEFAULT is not a string. It does not say what > else it must/can be (besides nil). Can it be a symbol - e.g., a face > symbol? Can it be a list of strings, i.e., multiple defaults? A list > of faces (symbols)? > > What's more, there is nothing in the doc string that indicates that the > face name(s) is/are read using `completing-read-multiple'. Not that > that implementation detail need be mentioned explicitly, but its > _behavior_, i.e., what the behavior of `read-face-name' is, should be > described. Should be fixed now, thanks.