From unknown Mon Jun 23 04:09:18 2025 X-Loop: help-debbugs@gnu.org Subject: bug#12323: 24.2.50; doc string of `get-text-property' Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 01 Sep 2012 17:15:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 12323 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 12323@debbugs.gnu.org X-Debbugs-Original-To: Received: via spool by submit@debbugs.gnu.org id=B.13465196939214 (code B ref -1); Sat, 01 Sep 2012 17:15:02 +0000 Received: (at submit) by debbugs.gnu.org; 1 Sep 2012 17:14:53 +0000 Received: from localhost ([127.0.0.1]:33114 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1T7rHY-0002OY-UT for submit@debbugs.gnu.org; Sat, 01 Sep 2012 13:14:53 -0400 Received: from eggs.gnu.org ([208.118.235.92]:58267) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1T7rHW-0002ON-LE for submit@debbugs.gnu.org; Sat, 01 Sep 2012 13:14:51 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1T7rGB-00072q-CG for submit@debbugs.gnu.org; Sat, 01 Sep 2012 13:13:28 -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]:56414) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1T7rGB-00072m-8q for submit@debbugs.gnu.org; Sat, 01 Sep 2012 13:13:27 -0400 Received: from eggs.gnu.org ([208.118.235.92]:58148) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1T7rGA-0000y0-6Z for bug-gnu-emacs@gnu.org; Sat, 01 Sep 2012 13:13:27 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1T7rG9-00072U-8h for bug-gnu-emacs@gnu.org; Sat, 01 Sep 2012 13:13:26 -0400 Received: from acsinet15.oracle.com ([141.146.126.227]:32984) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1T7rG9-00072P-2h for bug-gnu-emacs@gnu.org; Sat, 01 Sep 2012 13:13:25 -0400 Received: from acsinet21.oracle.com (acsinet21.oracle.com [141.146.126.237]) by acsinet15.oracle.com (Sentrion-MTA-4.2.2/Sentrion-MTA-4.2.2) with ESMTP id q81HDMZ7026796 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Sat, 1 Sep 2012 17:13:23 GMT Received: from acsmt357.oracle.com (acsmt357.oracle.com [141.146.40.157]) by acsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id q81HDL8K012741 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Sat, 1 Sep 2012 17:13:22 GMT Received: from abhmt119.oracle.com (abhmt119.oracle.com [141.146.116.71]) by acsmt357.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id q81HDLFo008194 for ; Sat, 1 Sep 2012 12:13:21 -0500 Received: from dradamslap1 (/71.202.147.44) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Sat, 01 Sep 2012 10:13:21 -0700 From: "Drew Adams" Date: Sat, 1 Sep 2012 10:13:14 -0700 Message-ID: <5E7B5DDCF40C4669B0E8D9CCA4C06533@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: Ac2IZRINrJGtvSt4Svqdb//iMFqMPw== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 X-Source-IP: acsinet21.oracle.com [141.146.126.237] 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 (------) Just like in the Elisp manual, the doc string should say what parameter OBJECT is. It should say that it is a buffer or a string. An uninformed reader could easily imagine that it might be something else, such as a character. (Yes, a reader who knows what strings and chars are will not make that mistake. Nevertheless, the doc string should describe the acceptable OBJECT values.) In GNU Emacs 24.2.50.1 (i386-mingw-nt5.1.2600) of 2012-08-26 on MARVIN Bzr revision: 109788 dmantipov@yandex.ru-20120827041533-3cy7pdjdqz14o90c Windowing system distributor `Microsoft Corp.', version 5.1.2600 Configured using: `configure --with-gcc (4.6) --no-opt --enable-checking --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 -ID:/devel/emacs/libs/libiconv-1.13.1-1-dev/include -ID:/devel/emacs/libs/libxml2-2.7.8/include/libxml2' From unknown Mon Jun 23 04:09:18 2025 X-Loop: help-debbugs@gnu.org Subject: bug#12323: 24.2.50; doc string of `get-text-property' Resent-From: Chong Yidong Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 07 Sep 2012 14:47:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 12323 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: "Drew Adams" Cc: 12323@debbugs.gnu.org Received: via spool by 12323-submit@debbugs.gnu.org id=B12323.134702916432497 (code B ref 12323); Fri, 07 Sep 2012 14:47:01 +0000 Received: (at 12323) by debbugs.gnu.org; 7 Sep 2012 14:46:04 +0000 Received: from localhost ([127.0.0.1]:46760 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1T9zoq-0008S6-Jh for submit@debbugs.gnu.org; Fri, 07 Sep 2012 10:46:04 -0400 Received: from mail-iy0-f172.google.com ([209.85.210.172]:36554) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1T9zoo-0008Rz-LZ for 12323@debbugs.gnu.org; Fri, 07 Sep 2012 10:46:03 -0400 Received: by iabz21 with SMTP id z21so3213471iab.3 for <12323@debbugs.gnu.org>; Fri, 07 Sep 2012 07:45:44 -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=6qiq3Uaoo2xOg+/0Kqwp/TwjAzw5wrVLQ0q17okkH7Q=; b=zyWwlYLmwPf04YbWSDZu26OQY6fljYjSZD7oaivnBF6XeCdROY7nQkYff2cqLq+dR/ kv2FLvNZ9vpNud22/Z5jcekGOObvNA9zY/jcyky62PLgC8a+E/amSBWQ65LAJz4PvmGM fHFrpbh2LADo21a8psMg/4cqRx3VbxtOrcnYtNWF5c8HRT+Ilq5N0kPjv3Iw481cp/NH 4y0MKqwqvyI1Hd/6ehvJQ4ZZPmWxspnFYqagXy5wDx8WxsNhb1IjABtsbU4VGSsIy7FY G1k3qzEgXL1DOH252VI0hWyeU1lxrk5sYzwFtlcEv36+DRAmf2g53w0YFCGn+WE3mhfH ZHUw== Received: by 10.42.212.67 with SMTP id gr3mr7254373icb.44.1347029144040; Fri, 07 Sep 2012 07:45:44 -0700 (PDT) Received: from ulysses (cm162.gamma80.maxonline.com.sg. [202.156.80.162]) by mx.google.com with ESMTPS id ey10sm13252173igb.17.2012.09.07.07.45.39 (version=SSLv3 cipher=OTHER); Fri, 07 Sep 2012 07:45:42 -0700 (PDT) From: Chong Yidong References: <5E7B5DDCF40C4669B0E8D9CCA4C06533@us.oracle.com> Date: Fri, 07 Sep 2012 22:45:36 +0800 In-Reply-To: <5E7B5DDCF40C4669B0E8D9CCA4C06533@us.oracle.com> (Drew Adams's message of "Sat, 1 Sep 2012 10:13:14 -0700") Message-ID: <87txv9zyb3.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.2.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: > Just like in the Elisp manual, the doc string should say what parameter > OBJECT is. It should say that it is a buffer or a string. Fixed in trunk. From debbugs-submit-bounces@debbugs.gnu.org Fri Sep 07 10:46:19 2012 Received: (at control) by debbugs.gnu.org; 7 Sep 2012 14:46:19 +0000 Received: from localhost ([127.0.0.1]:46763 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1T9zp4-0008SV-QT for submit@debbugs.gnu.org; Fri, 07 Sep 2012 10:46:19 -0400 Received: from mail-ie0-f172.google.com ([209.85.223.172]:50951) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1T9zp3-0008SO-6x for control@debbugs.gnu.org; Fri, 07 Sep 2012 10:46:17 -0400 Received: by ieak13 with SMTP id k13so5113078iea.3 for ; Fri, 07 Sep 2012 07:45:58 -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=zobBVnzVmXusdsNE1Vyre1mD9tR33VoZVwuI+0jEttc=; b=KjynD4YIVk6RpfoG82pQUaSQRjro/AgEdNM3iTRtZ4gehthtACazv4fvsbIQVzW0gg SQNZGmOAODJPbsiFP+kTPqa0XMUGDOKDRwveKCg03Qrc4E2Fp6PkUNBGc8fIGl4orHq+ MXHe3dRj3v4f2pwMuFhksL1perfl+Hl421s7NNn/RgKek1eWh7OQATYGIchr9SVhp4cd 234AoAh8SoNoN5JpS5pPRBDpg9NXBzKv6YN03Ch0R4kMa/vsFHXCcwOQ2Ps7gzZir9Fu laOUHFgQjl+FOKFQ/aHqfPcplj8p7S71uymX3dQ5R4l2x/BSPd6yk3lzkpu5RziqxBtU YBXQ== Received: by 10.50.202.4 with SMTP id ke4mr9197914igc.72.1347029158582; Fri, 07 Sep 2012 07:45:58 -0700 (PDT) Received: from ulysses (cm162.gamma80.maxonline.com.sg. [202.156.80.162]) by mx.google.com with ESMTPS id va9sm8320600igb.17.2012.09.07.07.45.55 (version=SSLv3 cipher=OTHER); Fri, 07 Sep 2012 07:45:57 -0700 (PDT) From: Chong Yidong To: control@debbugs.gnu.org Subject: close 12323 Date: Fri, 07 Sep 2012 22:45:46 +0800 Message-ID: <87zk51c2n9.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 12323 thanks