From unknown Sat Aug 16 19:17:11 2025 X-Loop: help-debbugs@gnu.org Subject: bug#13081: 24.3.50; doc of `compare-strings' says nothing about the compare function used Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 04 Dec 2012 18:36:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 13081 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 13081@debbugs.gnu.org X-Debbugs-Original-To: Received: via spool by submit@debbugs.gnu.org id=B.13546461604159 (code B ref -1); Tue, 04 Dec 2012 18:36:02 +0000 Received: (at submit) by debbugs.gnu.org; 4 Dec 2012 18:36:00 +0000 Received: from localhost ([127.0.0.1]:53533 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TfxLb-000151-20 for submit@debbugs.gnu.org; Tue, 04 Dec 2012 13:35:59 -0500 Received: from eggs.gnu.org ([208.118.235.92]:35481) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TfxLZ-00014u-Gl for submit@debbugs.gnu.org; Tue, 04 Dec 2012 13:35:58 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TfxLQ-0008Q2-A7 for submit@debbugs.gnu.org; Tue, 04 Dec 2012 13:35:54 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-104.2 required=5.0 tests=BAYES_00, RCVD_IN_DNSWL_MED, RP_MATCHES_RCVD, UNPARSEABLE_RELAY, USER_IN_WHITELIST autolearn=unavailable version=3.3.2 Received: from lists.gnu.org ([208.118.235.17]:44205) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TfxLQ-0008Pv-7O for submit@debbugs.gnu.org; Tue, 04 Dec 2012 13:35:48 -0500 Received: from eggs.gnu.org ([208.118.235.92]:46809) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TfxLK-0003RP-EB for bug-gnu-emacs@gnu.org; Tue, 04 Dec 2012 13:35:48 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TfxLE-0008Mc-JX for bug-gnu-emacs@gnu.org; Tue, 04 Dec 2012 13:35:42 -0500 Received: from userp1040.oracle.com ([156.151.31.81]:37846) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TfxLE-0008MU-CC for bug-gnu-emacs@gnu.org; Tue, 04 Dec 2012 13:35:36 -0500 Received: from ucsinet22.oracle.com (ucsinet22.oracle.com [156.151.31.94]) by userp1040.oracle.com (Sentrion-MTA-4.2.2/Sentrion-MTA-4.2.2) with ESMTP id qB4IZXt3010838 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Tue, 4 Dec 2012 18:35:34 GMT Received: from acsmt357.oracle.com (acsmt357.oracle.com [141.146.40.157]) by ucsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id qB4IZWiG006260 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Tue, 4 Dec 2012 18:35:33 GMT Received: from abhmt102.oracle.com (abhmt102.oracle.com [141.146.116.54]) by acsmt357.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id qB4IZWZ2010477 for ; Tue, 4 Dec 2012 12:35:32 -0600 Received: from dradamslap1 (/10.159.232.171) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Tue, 04 Dec 2012 10:35:32 -0800 From: "Drew Adams" Date: Tue, 4 Dec 2012 10:35:28 -0800 Message-ID: <7D334704F49643BDB98A047592ED7768@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: Ac3STiHzinQ6RyhYQaiNw9gb3FyfCA== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 X-Source-IP: ucsinet22.oracle.com [156.151.31.94] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 208.118.235.17 X-Spam-Score: -3.4 (---) 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: -4.2 (----) The doc mentions case-sensitivity, and it says what the function does if the specified portions match etc. But it says NOTHING (apart from possibly ignoring case) about what "matching" means. Is lexicographic order used? How can you document a function about comparing two sequences without defining/mentioning the helper function that is used to compare two elements, one from each sequence? In GNU Emacs 24.3.50.1 (i386-mingw-nt5.1.2600) of 2012-12-03 on MS-W7-DANI Bzr revision: 111077 agustin.martin@hispalinux.es-20121203172342-ifsebjmhksk28qa9 Windowing system distributor `Microsoft Corp.', version 5.1.2600 Configured using: `configure --with-gcc (4.7) --no-opt --enable-checking --cflags -Ic:/emacs/libs/libXpm-3.5.10/include -Ic:/emacs/libs/libXpm-3.5.10/src -Ic:/emacs/libs/libpng-1.2.37-lib/include -Ic:/emacs/libs/zlib-1.2.5 -Ic:/emacs/libs/giflib-4.1.4-1-lib/include -Ic:/emacs/libs/jpeg-6b-4-lib/include -Ic:/emacs/libs/tiff-3.8.2-1-lib/include -Ic:/emacs/libs/libxml2-2.7.8-w32-bin/include/libxml2 -Ic:/emacs/libs/gnutls-3.0.9-w32-bin/include -Ic:/emacs/libs/libiconv-1.9.2-1-lib/include' From unknown Sat Aug 16 19:17:11 2025 X-Loop: help-debbugs@gnu.org Subject: bug#13081: 24.3.50; doc of `compare-strings' says nothing about the compare function used Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 04 Dec 2012 18:45:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 13081 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: <13081@debbugs.gnu.org> Received: via spool by 13081-submit@debbugs.gnu.org id=B13081.13546466844965 (code B ref 13081); Tue, 04 Dec 2012 18:45:02 +0000 Received: (at 13081) by debbugs.gnu.org; 4 Dec 2012 18:44:44 +0000 Received: from localhost ([127.0.0.1]:53538 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TfxU4-0001I2-Jt for submit@debbugs.gnu.org; Tue, 04 Dec 2012 13:44:44 -0500 Received: from aserp1040.oracle.com ([141.146.126.69]:38924) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TfxU2-0001Hv-Rv for 13081@debbugs.gnu.org; Tue, 04 Dec 2012 13:44:43 -0500 Received: from acsinet22.oracle.com (acsinet22.oracle.com [141.146.126.238]) by aserp1040.oracle.com (Sentrion-MTA-4.2.2/Sentrion-MTA-4.2.2) with ESMTP id qB4IicEZ023545 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for <13081@debbugs.gnu.org>; Tue, 4 Dec 2012 18:44:39 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 qB4IicPW022429 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for <13081@debbugs.gnu.org>; Tue, 4 Dec 2012 18:44:38 GMT Received: from abhmt109.oracle.com (abhmt109.oracle.com [141.146.116.61]) by acsmt356.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id qB4Iicb9014504 for <13081@debbugs.gnu.org>; Tue, 4 Dec 2012 12:44:38 -0600 Received: from dradamslap1 (/10.159.232.171) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Tue, 04 Dec 2012 10:44:37 -0800 From: "Drew Adams" References: <7D334704F49643BDB98A047592ED7768@us.oracle.com> Date: Tue, 4 Dec 2012 10:44:34 -0800 Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 In-Reply-To: <7D334704F49643BDB98A047592ED7768@us.oracle.com> Thread-Index: Ac3STiHzinQ6RyhYQaiNw9gb3FyfCAAAHlAw X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 X-Source-IP: acsinet22.oracle.com [141.146.126.238] X-Spam-Score: -1.5 (-) 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: -1.5 (-) 1. I should have said that the doc problem applies to both the doc string and Elisp manual. 2. What's more, the doc string says that "END1 and END2 default to". This language is incorrect - there is no defaulting. These parameters are mandatory, so they do not have any default values. What the doc should say is two things: a. START1, START2, END1, and END2 are either 0-based indexes into the string. (This information is missing.) b. START1, START2, END1, and END2 can each alternatively be nil. For START1 and START2, nil is the same as 0. For END1 and END2, nil is the same as the length of STR1 and STR2, respectively. From unknown Sat Aug 16 19:17:11 2025 X-Loop: help-debbugs@gnu.org Subject: bug#13081: 24.3.50; doc of `compare-strings' says nothing about the compare function used Resent-From: "Drew Adams" Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Tue, 04 Dec 2012 18:51:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 13081 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: <13081@debbugs.gnu.org> Received: via spool by 13081-submit@debbugs.gnu.org id=B13081.13546470265548 (code B ref 13081); Tue, 04 Dec 2012 18:51:01 +0000 Received: (at 13081) by debbugs.gnu.org; 4 Dec 2012 18:50:26 +0000 Received: from localhost ([127.0.0.1]:53558 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TfxZa-0001RR-K3 for submit@debbugs.gnu.org; Tue, 04 Dec 2012 13:50:26 -0500 Received: from aserp1040.oracle.com ([141.146.126.69]:27718) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TfxZY-0001RK-SI for 13081@debbugs.gnu.org; Tue, 04 Dec 2012 13:50:25 -0500 Received: from acsinet21.oracle.com (acsinet21.oracle.com [141.146.126.237]) by aserp1040.oracle.com (Sentrion-MTA-4.2.2/Sentrion-MTA-4.2.2) with ESMTP id qB4IoKuf030177 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for <13081@debbugs.gnu.org>; Tue, 4 Dec 2012 18:50:21 GMT Received: from acsmt356.oracle.com (acsmt356.oracle.com [141.146.40.156]) by acsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id qB4IoKTU020486 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for <13081@debbugs.gnu.org>; Tue, 4 Dec 2012 18:50:20 GMT Received: from abhmt117.oracle.com (abhmt117.oracle.com [141.146.116.69]) by acsmt356.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id qB4IoKjB019075 for <13081@debbugs.gnu.org>; Tue, 4 Dec 2012 12:50:20 -0600 Received: from dradamslap1 (/10.159.232.171) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Tue, 04 Dec 2012 10:50:19 -0800 From: "Drew Adams" References: <7D334704F49643BDB98A047592ED7768@us.oracle.com> Date: Tue, 4 Dec 2012 10:50:16 -0800 Message-ID: <97D7786DE8624320B1FB1915D75B0997@us.oracle.com> MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 In-Reply-To: Thread-Index: Ac3STiHzinQ6RyhYQaiNw9gb3FyfCAAAHlAwAABMicA= X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 X-Source-IP: acsinet21.oracle.com [141.146.126.237] X-Spam-Score: -1.5 (-) 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: -1.5 (-) > a. START1, START2, END1, and END2 are either 0-based indexes > into the string. (This information is missing.) > > b. START1, START2, END1, and END2 can each alternatively be > nil. Typo in above text: strike the "either". Or else add "or nil" after "either" and rephrase (b) to just say what happens when nil. From unknown Sat Aug 16 19:17:11 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.428 (Entity 5.428) X-Loop: help-debbugs@gnu.org From: help-debbugs@gnu.org (GNU bug Tracking System) To: "Drew Adams" Subject: bug#13081: closed (Re: bug#13081: 24.3.50; doc of `compare-strings' says nothing about the compare function used) Message-ID: References: <87d2ybh1kp.fsf@gnu.org> <7D334704F49643BDB98A047592ED7768@us.oracle.com> X-Gnu-PR-Message: they-closed 13081 X-Gnu-PR-Package: emacs Reply-To: 13081@debbugs.gnu.org Date: Sat, 15 Dec 2012 13:46:02 +0000 Content-Type: multipart/mixed; boundary="----------=_1355579162-20077-1" This is a multi-part message in MIME format... ------------=_1355579162-20077-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #13081: 24.3.50; doc of `compare-strings' says nothing about the compare fu= nction used which was filed against the emacs package, has been closed. The explanation is attached below, along with your original report. If you require more details, please reply to 13081@debbugs.gnu.org. --=20 13081: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D13081 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1355579162-20077-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 13081-done) by debbugs.gnu.org; 15 Dec 2012 13:45:53 +0000 Received: from localhost ([127.0.0.1]:43500 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Tjs3t-0005DW-BU for submit@debbugs.gnu.org; Sat, 15 Dec 2012 08:45:53 -0500 Received: from mail-pb0-f44.google.com ([209.85.160.44]:40427) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1Tjs3q-0005DO-Ui for 13081-done@debbugs.gnu.org; Sat, 15 Dec 2012 08:45:52 -0500 Received: by mail-pb0-f44.google.com with SMTP id uo1so2946084pbc.3 for <13081-done@debbugs.gnu.org>; Sat, 15 Dec 2012 05:44:45 -0800 (PST) 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=Im6KibsfArzROx6G0KzClMtOG1O2TX/+6JErf7xuqvw=; b=xH/cQb9Ct+tzv7ypiLSb+GfPsV+8AaMHEWqZbKNHhrF6zI9dlBmtg3MJ2pNGyEtC+J VfUFX10HCuMb/KdRvsxkll5ij4K9iAC8eL/kw0XasQ6YtkH50w9V2R5L232dcaX17WLP 6jYBx37GSULMRonFZ2For9eG1lRuizqYdr7B2So5T+Wa5idF3Wv6+6ZNxh0nQzjO4OyN WPI59vJOkJzwTFsBSj+5l869O+IdzM20f/B6bs5hVKcfubrTDlHKD4TErtWt7YU3SiFC T0ao8Hs7TW88rI5QF5x3qCyNi5vY1/hA9KfWYNTDg+E5Tzlw+isFF+WZWFtMiZbkRsS0 Nt/A== Received: by 10.66.82.162 with SMTP id j2mr25006003pay.13.1355579084097; Sat, 15 Dec 2012 05:44:44 -0800 (PST) Received: from ulysses (cm107.delta179.maxonline.com.sg. [59.189.179.107]) by mx.google.com with ESMTPS id rq7sm4747460pbc.69.2012.12.15.05.44.40 (version=SSLv3 cipher=OTHER); Sat, 15 Dec 2012 05:44:42 -0800 (PST) From: Chong Yidong To: "Drew Adams" Subject: Re: bug#13081: 24.3.50; doc of `compare-strings' says nothing about the compare function used References: <7D334704F49643BDB98A047592ED7768@us.oracle.com> Date: Sat, 15 Dec 2012 21:44:38 +0800 In-Reply-To: <7D334704F49643BDB98A047592ED7768@us.oracle.com> (Drew Adams's message of "Tue, 4 Dec 2012 10:35:28 -0800") Message-ID: <87d2ybh1kp.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.2.90 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: 0.1 (/) X-Debbugs-Envelope-To: 13081-done Cc: 13081-done@debbugs.gnu.org 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: -0.7 (/) "Drew Adams" writes: > The doc mentions case-sensitivity, and it says what the function does if > the specified portions match etc. But it says NOTHING (apart from > possibly ignoring case) about what "matching" means. Is lexicographic > order used? Fixed, thanks. (The other issues too.) ------------=_1355579162-20077-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by debbugs.gnu.org; 4 Dec 2012 18:36:00 +0000 Received: from localhost ([127.0.0.1]:53533 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TfxLb-000151-20 for submit@debbugs.gnu.org; Tue, 04 Dec 2012 13:35:59 -0500 Received: from eggs.gnu.org ([208.118.235.92]:35481) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1TfxLZ-00014u-Gl for submit@debbugs.gnu.org; Tue, 04 Dec 2012 13:35:58 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TfxLQ-0008Q2-A7 for submit@debbugs.gnu.org; Tue, 04 Dec 2012 13:35:54 -0500 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-104.2 required=5.0 tests=BAYES_00, RCVD_IN_DNSWL_MED, RP_MATCHES_RCVD, UNPARSEABLE_RELAY, USER_IN_WHITELIST autolearn=unavailable version=3.3.2 Received: from lists.gnu.org ([208.118.235.17]:44205) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TfxLQ-0008Pv-7O for submit@debbugs.gnu.org; Tue, 04 Dec 2012 13:35:48 -0500 Received: from eggs.gnu.org ([208.118.235.92]:46809) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TfxLK-0003RP-EB for bug-gnu-emacs@gnu.org; Tue, 04 Dec 2012 13:35:48 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TfxLE-0008Mc-JX for bug-gnu-emacs@gnu.org; Tue, 04 Dec 2012 13:35:42 -0500 Received: from userp1040.oracle.com ([156.151.31.81]:37846) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TfxLE-0008MU-CC for bug-gnu-emacs@gnu.org; Tue, 04 Dec 2012 13:35:36 -0500 Received: from ucsinet22.oracle.com (ucsinet22.oracle.com [156.151.31.94]) by userp1040.oracle.com (Sentrion-MTA-4.2.2/Sentrion-MTA-4.2.2) with ESMTP id qB4IZXt3010838 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Tue, 4 Dec 2012 18:35:34 GMT Received: from acsmt357.oracle.com (acsmt357.oracle.com [141.146.40.157]) by ucsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id qB4IZWiG006260 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Tue, 4 Dec 2012 18:35:33 GMT Received: from abhmt102.oracle.com (abhmt102.oracle.com [141.146.116.54]) by acsmt357.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id qB4IZWZ2010477 for ; Tue, 4 Dec 2012 12:35:32 -0600 Received: from dradamslap1 (/10.159.232.171) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Tue, 04 Dec 2012 10:35:32 -0800 From: "Drew Adams" To: Subject: 24.3.50; doc of `compare-strings' says nothing about the compare function used Date: Tue, 4 Dec 2012 10:35:28 -0800 Message-ID: <7D334704F49643BDB98A047592ED7768@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: Ac3STiHzinQ6RyhYQaiNw9gb3FyfCA== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6157 X-Source-IP: ucsinet22.oracle.com [156.151.31.94] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.4.x-2.6.x [generic] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 208.118.235.17 X-Spam-Score: -3.4 (---) X-Debbugs-Envelope-To: submit 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: -4.2 (----) The doc mentions case-sensitivity, and it says what the function does if the specified portions match etc. But it says NOTHING (apart from possibly ignoring case) about what "matching" means. Is lexicographic order used? How can you document a function about comparing two sequences without defining/mentioning the helper function that is used to compare two elements, one from each sequence? In GNU Emacs 24.3.50.1 (i386-mingw-nt5.1.2600) of 2012-12-03 on MS-W7-DANI Bzr revision: 111077 agustin.martin@hispalinux.es-20121203172342-ifsebjmhksk28qa9 Windowing system distributor `Microsoft Corp.', version 5.1.2600 Configured using: `configure --with-gcc (4.7) --no-opt --enable-checking --cflags -Ic:/emacs/libs/libXpm-3.5.10/include -Ic:/emacs/libs/libXpm-3.5.10/src -Ic:/emacs/libs/libpng-1.2.37-lib/include -Ic:/emacs/libs/zlib-1.2.5 -Ic:/emacs/libs/giflib-4.1.4-1-lib/include -Ic:/emacs/libs/jpeg-6b-4-lib/include -Ic:/emacs/libs/tiff-3.8.2-1-lib/include -Ic:/emacs/libs/libxml2-2.7.8-w32-bin/include/libxml2 -Ic:/emacs/libs/gnutls-3.0.9-w32-bin/include -Ic:/emacs/libs/libiconv-1.9.2-1-lib/include' ------------=_1355579162-20077-1--