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#11225: 24.1.50; Explanation of SPECS arg in docstrings in face-remap.el insufficient Date: Sat, 09 Jun 2012 14:27:25 +0800 Message-ID: <87sje5atki.fsf@gnu.org> References: <86aa2iyv8c.fsf@web.de> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: dough.gmane.org 1339223270 3407 80.91.229.3 (9 Jun 2012 06:27:50 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Sat, 9 Jun 2012 06:27:50 +0000 (UTC) Cc: 11225@debbugs.gnu.org To: michael_heerdegen@web.de Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Jun 09 08:27:48 2012 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 1SdF9E-0003cc-UY for geb-bug-gnu-emacs@m.gmane.org; Sat, 09 Jun 2012 08:27:45 +0200 Original-Received: from localhost ([::1]:54582 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SdF9E-00018Z-HB for geb-bug-gnu-emacs@m.gmane.org; Sat, 09 Jun 2012 02:27:44 -0400 Original-Received: from eggs.gnu.org ([208.118.235.92]:42970) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SdF9B-00018I-BO for bug-gnu-emacs@gnu.org; Sat, 09 Jun 2012 02:27:42 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SdF99-0007Rv-MS for bug-gnu-emacs@gnu.org; Sat, 09 Jun 2012 02:27:40 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:54358) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SdF99-0007Rr-J0 for bug-gnu-emacs@gnu.org; Sat, 09 Jun 2012 02:27:39 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.72) (envelope-from ) id 1SdFBS-0000VW-De for bug-gnu-emacs@gnu.org; Sat, 09 Jun 2012 02:30:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Chong Yidong Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 09 Jun 2012 06:30:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 11225 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 11225-submit@debbugs.gnu.org id=B11225.13392234011917 (code B ref 11225); Sat, 09 Jun 2012 06:30:02 +0000 Original-Received: (at 11225) by debbugs.gnu.org; 9 Jun 2012 06:30:01 +0000 Original-Received: from localhost ([127.0.0.1]:35671 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SdFBP-0000Uq-Pi for submit@debbugs.gnu.org; Sat, 09 Jun 2012 02:30:01 -0400 Original-Received: from fencepost.gnu.org ([208.118.235.10]:39005) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SdFBM-0000Uj-Tj for 11225@debbugs.gnu.org; Sat, 09 Jun 2012 02:29:58 -0400 Original-Received: from cm162.gamma80.maxonline.com.sg ([202.156.80.162]:45646 helo=ulysses) by fencepost.gnu.org with esmtpsa (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1SdF91-0006WI-Rk; Sat, 09 Jun 2012 02:27:32 -0400 In-Reply-To: <86aa2iyv8c.fsf@web.de> (Michael Heerdegen's message of "Wed, 11 Apr 2012 20:33:07 +0200") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.1 (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 (newer, 2) 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:60791 Archived-At: Michael Heerdegen writes: > there are commands in face-remap.el that take a "specs" argument > (`face-remap-add-relative', `face-remap-set-base'). Their doc tells > that SPECS can also be a list of faces. It doesn't explain what the > meaning of a list of faces for that functions is. > > Also the manual doesn't explain it (Node "Face Remapping"). > > Maybe the docstrings and the manual can be clarified by adding just > one or two sentences that describe the meaning. I've changed the manual and docstrings to clarify this. Thanks.