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-listed-faces Date: Tue, 20 Mar 2007 13:38:52 -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 1174423232 32150 80.91.229.12 (20 Mar 2007 20:40:32 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Tue, 20 Mar 2007 20:40:32 +0000 (UTC) To: "Emacs-Devel" Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Mar 20 21:40: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 1HTl84-0002aP-PG for ged-emacs-devel@m.gmane.org; Tue, 20 Mar 2007 21:40:25 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1HTl9f-0006Cq-O3 for ged-emacs-devel@m.gmane.org; Tue, 20 Mar 2007 15:42:03 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1HTl9c-0006CX-SE for emacs-devel@gnu.org; Tue, 20 Mar 2007 16:42:00 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1HTl9Z-0005yw-3I for emacs-devel@gnu.org; Tue, 20 Mar 2007 16:42:00 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1HTl9Y-0005yP-SQ for emacs-devel@gnu.org; Tue, 20 Mar 2007 15:41:56 -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 1HTl7x-0000kh-1Q for emacs-devel@gnu.org; Tue, 20 Mar 2007 16:40:17 -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 l2KKeE7V005034 for ; Tue, 20 Mar 2007 14:40:14 -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 l2KKC0KB005316 for ; Tue, 20 Mar 2007 14:40:11 -0600 Original-Received: from dhcp-amer-csvpn-gw1-141-144-64-36.vpn.oracle.com by acsmt351.oracle.com with ESMTP id 2547195011174423136; Tue, 20 Mar 2007 13:38:56 -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:68174 Archived-At: I don't understand user option `facemenu-listed-faces'. Shouldn't the default value be t? Wouldn't it be normal, whenever the user applies a face to text, to add that face to the menu? Isn't that the usual case, which should be the default? Also, this user option is not explained anywhere in either the Emacs manual or the Elisp manual. Given that I don't understand the doc string well (e.g. "this value _takes effect_ (??) when you load facemenu.el"), I would appreciate some more explanation. This is a user option, but the doc string reads as if it were an internal variable ("subsequently defining or creating those faces", "you can call `facemenu-update'", etc.). I think we need some user doc for this option, and it needs to be clear on how you can make use of it.