From unknown Sun Jun 22 11:39:29 2025 X-Loop: help-debbugs@gnu.org Subject: bug#12059: 24.1; undefined term "alternate display form" in of `format' doc string Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 26 Jul 2012 16:17:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 12059 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 12059@debbugs.gnu.org X-Debbugs-Original-To: Received: via spool by submit@debbugs.gnu.org id=B.134331937432474 (code B ref -1); Thu, 26 Jul 2012 16:17:01 +0000 Received: (at submit) by debbugs.gnu.org; 26 Jul 2012 16:16:14 +0000 Received: from localhost ([127.0.0.1]:41224 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SuQjW-0008Rj-7W for submit@debbugs.gnu.org; Thu, 26 Jul 2012 12:16:14 -0400 Received: from eggs.gnu.org ([208.118.235.92]:44752) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1SuQjT-0008Rb-IP for submit@debbugs.gnu.org; Thu, 26 Jul 2012 12:16:12 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SuQcg-0000mF-HD for submit@debbugs.gnu.org; Thu, 26 Jul 2012 12:09:19 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-6.9 required=5.0 tests=BAYES_00,RCVD_IN_DNSWL_HI, UNPARSEABLE_RELAY autolearn=unavailable version=3.3.2 Received: from lists.gnu.org ([208.118.235.17]:39263) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SuQcg-0000mB-Dj for submit@debbugs.gnu.org; Thu, 26 Jul 2012 12:09:10 -0400 Received: from eggs.gnu.org ([208.118.235.92]:47636) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SuQcf-0002Rt-FX for bug-gnu-emacs@gnu.org; Thu, 26 Jul 2012 12:09:10 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SuQcb-0000lM-CO for bug-gnu-emacs@gnu.org; Thu, 26 Jul 2012 12:09:09 -0400 Received: from rcsinet15.oracle.com ([148.87.113.117]:26835) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SuQcb-0000lH-6P for bug-gnu-emacs@gnu.org; Thu, 26 Jul 2012 12:09:05 -0400 Received: from acsinet22.oracle.com (acsinet22.oracle.com [141.146.126.238]) by rcsinet15.oracle.com (Sentrion-MTA-4.2.2/Sentrion-MTA-4.2.2) with ESMTP id q6QG93GC012710 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Thu, 26 Jul 2012 16:09:04 GMT Received: from acsmt356.oracle.com (acsmt356.oracle.com [141.146.40.156]) by acsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id q6QG93II015067 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Thu, 26 Jul 2012 16:09:03 GMT Received: from abhmt113.oracle.com (abhmt113.oracle.com [141.146.116.65]) by acsmt356.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id q6QG92ig028501 for ; Thu, 26 Jul 2012 11:09:03 -0500 Received: from dradamslap1 (/130.35.179.10) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Thu, 26 Jul 2012 09:09:02 -0700 From: "Drew Adams" Date: Thu, 26 Jul 2012 09:09:02 -0700 Message-ID: <5412BFCEE45F4ED0AC9E2D73676750FC@us.oracle.com> MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 Thread-Index: Ac1rSPjTnOFuWxZeR0mO+pmNs8kNuQ== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 X-Source-IP: acsinet22.oracle.com [141.146.126.238] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 1) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 208.118.235.17 X-Spam-Score: -6.1 (------) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -6.1 (------) The description of `#' in the doc string is useless. It just refers to a mysterious "alternate display form" without saying anything about what that is. Either add that information (see the Elisp manual for it) or get rid of any (pseudo) explanation of `#' and just point to node (elisp) `Formatting Strings'. IOW, either actually describe `#' or punt to the manual. But please do not give the impression that this explains something where it does not. That misleads readers into thinking that they have been told what it is and wondering why they do not understand. In GNU Emacs 24.1.1 (i386-mingw-nt5.1.2600) of 2012-06-10 on MARVIN Windowing system distributor `Microsoft Corp.', version 5.1.2600 Configured using: `configure --with-gcc (4.6) --cflags -ID:/devel/emacs/libs/libXpm-3.5.8/include -ID:/devel/emacs/libs/libXpm-3.5.8/src -ID:/devel/emacs/libs/libpng-dev_1.4.3-1/include -ID:/devel/emacs/libs/zlib-dev_1.2.5-2/include -ID:/devel/emacs/libs/giflib-4.1.4-1/include -ID:/devel/emacs/libs/jpeg-6b-4/include -ID:/devel/emacs/libs/tiff-3.8.2-1/include -ID:/devel/emacs/libs/gnutls-3.0.9/include' From unknown Sun Jun 22 11:39:29 2025 X-Loop: help-debbugs@gnu.org Subject: bug#12059: 24.1; undefined term "alternate display form" in of `format' doc string Resent-From: Chong Yidong Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 14 Aug 2012 16:31:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 12059 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: "Drew Adams" Cc: 12059@debbugs.gnu.org Received: via spool by 12059-submit@debbugs.gnu.org id=B12059.13449618256004 (code B ref 12059); Tue, 14 Aug 2012 16:31:01 +0000 Received: (at 12059) by debbugs.gnu.org; 14 Aug 2012 16:30:25 +0000 Received: from localhost ([127.0.0.1]:56582 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1T1K0b-0001Yi-Jz for submit@debbugs.gnu.org; Tue, 14 Aug 2012 12:30:25 -0400 Received: from mail-qa0-f44.google.com ([209.85.216.44]:33763) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1T1K0W-0001YZ-Su for 12059@debbugs.gnu.org; Tue, 14 Aug 2012 12:30:20 -0400 Received: by qadb17 with SMTP id b17so2780091qad.3 for <12059@debbugs.gnu.org>; Tue, 14 Aug 2012 09:21:37 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=sender:from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version:content-type; bh=mGxgqmwpYUTA3XOFCgwZZvAA0DrnCoVNHEiJzG/vx6c=; b=V2ICOkYbM/9bmmLbowFsfVS4sS3RkxKV6f5Kiv3t+SyW2okbVyzmVo3dpU35g5/bD7 5gt3KDj+4pKNalboHrPsmKaHWwgVwPuvm0qn5ho3+ONzuvFDoXPtxatJiuli2xFOfhF3 8JnNaqj2qSdJ9X+UZfBIpR+1e7Tj4H6XUMUMiHT7JRTX5/2IDVN2VmQrp2gS/qK6SnFm +MJpK5JpLjwtBuMhHqQAKTQ0bRXkG9BE0vJB0E0ptiT4qFjaEa9jG0VIUacyuhmIE0CS /meriHA7+2pNP/lzV4Lj57DeUKjskXsoRjqbCottGzJPRF9Tb7XsJHxoKEw+CkM49blS KuGg== Received: by 10.60.2.74 with SMTP id 10mr13237357oes.64.1344961297683; Tue, 14 Aug 2012 09:21:37 -0700 (PDT) Received: from ulysses ([155.69.183.59]) by mx.google.com with ESMTPS id g8sm3082320obz.16.2012.08.14.09.21.34 (version=SSLv3 cipher=OTHER); Tue, 14 Aug 2012 09:21:36 -0700 (PDT) From: Chong Yidong References: <5412BFCEE45F4ED0AC9E2D73676750FC@us.oracle.com> Date: Wed, 15 Aug 2012 00:21:32 +0800 In-Reply-To: <5412BFCEE45F4ED0AC9E2D73676750FC@us.oracle.com> (Drew Adams's message of "Thu, 26 Jul 2012 09:09:02 -0700") Message-ID: <87d32tculv.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.1.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -2.6 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.6 (--) "Drew Adams" writes: > Either add that information (see the Elisp manual for it) or get rid of > any (pseudo) explanation of `#' and just point to node (elisp) > `Formatting Strings'. Fixed in trunk. From debbugs-submit-bounces@debbugs.gnu.org Tue Aug 14 12:30:29 2012 Received: (at control) by debbugs.gnu.org; 14 Aug 2012 16:30:29 +0000 Received: from localhost ([127.0.0.1]:56585 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1T1K0j-0001Z0-CE for submit@debbugs.gnu.org; Tue, 14 Aug 2012 12:30:29 -0400 Received: from mail-qa0-f44.google.com ([209.85.216.44]:33763) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1T1K0g-0001YZ-P9 for control@debbugs.gnu.org; Tue, 14 Aug 2012 12:30:27 -0400 Received: by mail-qa0-f44.google.com with SMTP id b17so2780091qad.3 for ; Tue, 14 Aug 2012 09:21:48 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=sender:from:to:subject:date:message-id:mime-version:content-type; bh=0NPhyv5cN8m0NxnytULqtoTmVFHb5i0Fd4SGPDteNkc=; b=t09qCvudOdn9zT8JGS5FFS9PicdtQ/xa7/eLO2y2zYaqslrel7LNG0SAfgPLvyFM6Q irfPpO3HeWs05ImG/MUBNshxsAOFR2s2KJRitFroRqLhjKxyZJfmgc/ELYhz9eNUo4Qm wtCqxVF+lsj8xegDwZ+O5cAy1dIrwEQ+N7QsgJ9TqzgVY2JS/MHVXMi39GqlJyAJZZw7 xbnn9aMEnxPlBxfkfOm0GfCUXxaFh6vZLrX8//kpJUawwvDKvOcRDvRwUXg/3cjoJazX kugyGSQkfjkqWHpIxNXmjguMqeca1eEGcUgbk/+lRAPZKsa2Km47OaDEM+Qz573nn9M5 U/jw== Received: by 10.60.0.167 with SMTP id 7mr25925068oef.13.1344961307925; Tue, 14 Aug 2012 09:21:47 -0700 (PDT) Received: from ulysses ([155.69.183.59]) by mx.google.com with ESMTPS id d4sm3091280obx.3.2012.08.14.09.21.45 (version=SSLv3 cipher=OTHER); Tue, 14 Aug 2012 09:21:47 -0700 (PDT) From: Chong Yidong To: control@debbugs.gnu.org Subject: close 12059 Date: Wed, 15 Aug 2012 00:21:43 +0800 Message-ID: <87txw5bg14.fsf@gnu.org> MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -2.6 (--) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: debbugs-submit-bounces@debbugs.gnu.org Errors-To: debbugs-submit-bounces@debbugs.gnu.org X-Spam-Score: -2.6 (--) close 12059 thanks