From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Stephen J. Turnbull" Newsgroups: gmane.emacs.devel Subject: Re: Elisp manual: @section Mode Line Format is unclear Date: Fri, 30 Dec 2005 16:02:43 +0900 Organization: The XEmacs Project Message-ID: <87lky3rrsc.fsf@tleepslib.sk.tsukuba.ac.jp> References: NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 X-Trace: sea.gmane.org 1135926340 3270 80.91.229.2 (30 Dec 2005 07:05:40 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Fri, 30 Dec 2005 07:05:40 +0000 (UTC) Cc: Alan Mackenzie , emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Dec 30 08:05:37 2005 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1EsEKN-00023Y-MZ for ged-emacs-devel@m.gmane.org; Fri, 30 Dec 2005 08:05:27 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1EsELm-0002ED-1D for ged-emacs-devel@m.gmane.org; Fri, 30 Dec 2005 02:06:54 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1EsEJQ-00029D-SA for emacs-devel@gnu.org; Fri, 30 Dec 2005 02:04:29 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1EsEJN-00028e-4a for emacs-devel@gnu.org; Fri, 30 Dec 2005 02:04:27 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1EsEJM-00028K-FZ for emacs-devel@gnu.org; Fri, 30 Dec 2005 02:04:24 -0500 Original-Received: from [130.158.98.109] (helo=tleepslib.sk.tsukuba.ac.jp) by monty-python.gnu.org with esmtp (TLS-1.0:RSA_AES_128_CBC_SHA:16) (Exim 4.34) id 1EsEJq-0002TL-1Q for emacs-devel@gnu.org; Fri, 30 Dec 2005 02:04:54 -0500 Original-Received: from steve by tleepslib.sk.tsukuba.ac.jp with local (Exim 4.60) (envelope-from ) id 1EsEHj-0000cO-Tk; Fri, 30 Dec 2005 16:02:43 +0900 Original-To: Andreas Schwab In-Reply-To: (Andreas Schwab's message of "Fri, 30 Dec 2005 01:24:11 +0100") User-Agent: Gnus/5.1007 (Gnus v5.10.7) XEmacs/21.5-b24 (dandelion, linux) 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:48542 Archived-At: >>>>> "Andreas" == Andreas Schwab writes: Andreas> What is that if not a definition? It *is* a definition. What it is not, is *documentation*. Thus the reference to "specifiers" (an over-elaborated XEmacs API full of YAGNI[1] violations, whose documentation focuses on what YAGN). What Alan would like to see, I suppose, is something like: - Variable: mode-line-format The value of this variable is a mode-line construct which describes the mode-line to redisplay. The simplest form of mode-line construct is a string containing zero or more %-constructs. A %-construct is a reference to a variable whose value is to be interpolated into the modeline at that point. The %-construct is introduced by the character `%', followed by optional formatting specifications, and terminated by a single character which indicates the variable whose value is to be interpolated. Example: `(setq mode-line-format "%B")' puts the buffer name, and nothing else, in the mode-line of the current buffer. A symbol is also a modeline construct. Its value is interpolated in the Footnotes: [1] "You Aren't Gonna Need It", for those who most naturally interpret "XP" to refer to a proprietary operating system, is one of the basic ideas of the XP == Extreme Programming style. -- School of Systems and Information Engineering http://turnbull.sk.tsukuba.ac.jp University of Tsukuba Tennodai 1-1-1 Tsukuba 305-8573 JAPAN Ask not how you can "do" free software business; ask what your business can "do for" free software.