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: facemenu-set-face doc string Date: Tue, 20 Mar 2007 14:29:06 -0700 Message-ID: NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 7bit X-Trace: sea.gmane.org 1174426182 16988 80.91.229.12 (20 Mar 2007 21:29:42 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Tue, 20 Mar 2007 21:29:42 +0000 (UTC) To: "Emacs-Devel" Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Mar 20 22:29:36 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 1HTltg-0001l6-AI for ged-emacs-devel@m.gmane.org; Tue, 20 Mar 2007 22:29:36 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1HTlvH-0003e5-AG for ged-emacs-devel@m.gmane.org; Tue, 20 Mar 2007 16:31:15 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1HTlvE-0003dc-Bz for emacs-devel@gnu.org; Tue, 20 Mar 2007 17:31:12 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1HTlvD-0003dQ-CF for emacs-devel@gnu.org; Tue, 20 Mar 2007 17:31:12 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1HTlvD-0003dN-9h for emacs-devel@gnu.org; Tue, 20 Mar 2007 16:31:11 -0500 Original-Received: from rgminet01.oracle.com ([148.87.113.118]) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1HTltb-0002DM-7n for emacs-devel@gnu.org; Tue, 20 Mar 2007 17:29:31 -0400 Original-Received: from rgmgw1.us.oracle.com (rgmgw1.us.oracle.com [138.1.186.110]) by rgminet01.oracle.com (Switch-3.2.4/Switch-3.1.6) with ESMTP id l2KLTSfu015448 for ; Tue, 20 Mar 2007 15:29:28 -0600 Original-Received: from acsmt350.oracle.com (acsmt350.oracle.com [141.146.40.150]) by rgmgw1.us.oracle.com (Switch-3.2.4/Switch-3.1.7) with ESMTP id l2KK8c83028807 for ; Tue, 20 Mar 2007 15:29:27 -0600 Original-Received: from dhcp-amer-csvpn-gw1-141-144-64-36.vpn.oracle.com by acsmt350.oracle.com with ESMTP id 2548065871174426151; Tue, 20 Mar 2007 14:29:11 -0700 X-Priority: 3 (Normal) X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook IMO, Build 9.0.6604 (9.0.2911.0) Importance: Normal X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.3028 X-Whitelist: TRUE X-Whitelist: TRUE X-Brightmail-Tracker: AAAAAQAAAAI= X-detected-kernel: Linux 2.4-2.6 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:68177 Archived-At: The current explanation is not very clear, IMO (just what are "the faces to use"? apply a face to faces?). I propose a minor change: use active voice and refer to `facemenu-add-new-face' and `facemenu-add-face', whose doc strings are clear. OLD: Apply FACE to the region or next character typed. If the region is active (normally true except in Transient Mark mode) and nonempty, and there is no prefix argument, this command applies FACE to the region. Otherwise, it applies FACE to the faces to use for the next character inserted. (Moving point or switching buffers before typing a character to insert cancels the specification.) If FACE is `default', to \"apply\" it means clearing the list of faces to be used. For any other value of FACE, to \"apply\" it means putting FACE at the front of the list of faces to be used, and removing any faces further along in the list that would be completely overridden by preceding faces (including FACE). This command can also add FACE to the menu of faces, if `facemenu-listed-faces' says to do that. PROPOSED: Apply FACE to the region or the next character typed. If there is no prefix argument and the region is active and nonempty, then apply FACE to the region. Otherwise, apply FACE to the next character inserted. Call `facemenu-add-new-face', then `facemenu-add-face'.