From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.bugs Subject: doc string of `format' - FLAGS unexplained Date: Sat, 23 Feb 2008 16:42:00 -0800 Message-ID: <003c01c8767e$115f1520$0600a8c0@us.oracle.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1203813749 14169 80.91.229.12 (24 Feb 2008 00:42:29 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sun, 24 Feb 2008 00:42:29 +0000 (UTC) To: Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Feb 24 01:42:54 2008 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1JT4xA-0005qu-Q8 for geb-bug-gnu-emacs@m.gmane.org; Sun, 24 Feb 2008 01:42:53 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1JT4wf-0007z4-JY for geb-bug-gnu-emacs@m.gmane.org; Sat, 23 Feb 2008 19:42:21 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1JT4wb-0007yu-FP for bug-gnu-emacs@gnu.org; Sat, 23 Feb 2008 19:42:17 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1JT4wZ-0007yW-82 for bug-gnu-emacs@gnu.org; Sat, 23 Feb 2008 19:42:16 -0500 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1JT4wZ-0007yS-5c for bug-gnu-emacs@gnu.org; Sat, 23 Feb 2008 19:42:15 -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 1JT4wY-0000kM-N6 for bug-gnu-emacs@gnu.org; Sat, 23 Feb 2008 19:42:14 -0500 Original-Received: from rgmgw2.us.oracle.com (rgmgw2.us.oracle.com [138.1.186.111]) by rgminet01.oracle.com (Switch-3.2.4/Switch-3.1.6) with ESMTP id m1O0gCJK005889 for ; Sat, 23 Feb 2008 17:42:12 -0700 Original-Received: from acsmt351.oracle.com (acsmt351.oracle.com [141.146.40.151]) by rgmgw2.us.oracle.com (Switch-3.2.4/Switch-3.2.4) with ESMTP id m1O03gOa010381 for ; Sat, 23 Feb 2008 17:42:11 -0700 Original-Received: from inet-141-146-46-1.oracle.com by acsmt350.oracle.com with ESMTP id 3587778031203813730; Sat, 23 Feb 2008 16:42:10 -0800 Original-Received: from dradamslap1 (/141.144.64.130) by bhmail.oracle.com (Oracle Beehive Gateway v4.0) with ESMTP ; Sat, 23 Feb 2008 16:42:10 -0800 X-Mailer: Microsoft Office Outlook 11 Thread-Index: Ach2fhD9HLDa1nruSRm7yhRXgwY6Ww== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.3198 X-Brightmail-Tracker: AAAAAQAAAAI= X-Brightmail-Tracker: AAAAAQAAAAI= X-Whitelist: TRUE X-Whitelist: TRUE X-detected-kernel: by monty-python.gnu.org: Linux 2.4-2.6 X-BeenThere: bug-gnu-emacs@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:17571 Archived-At: The doc string includes this: The basic structure of a %-sequence is % character where flags is [-+ #0]+, width is [0-9]+, and precision is .[0-9]+ But there is absolutely no explanation of what FLAGS, WIDTH, and PRECISION mean. One might be able to guess for WIDTH and PRECISION, but not for FLAGS. Please include some of the explanation from the Elisp manual, adapting it as needed. Also, the EMACS convention for doc strings is to use uppercase: FLAGS, not angle brackets: . In GNU Emacs 22.1.1 (i386-mingw-nt5.1.2600) of 2007-06-02 on RELEASE Windowing system distributor `Microsoft Corp.', version 5.1.2600 configured using `configure --with-gcc (3.4) --cflags -Ic:/gnuwin32/include'