From unknown Sun Jun 22 00:01:52 2025 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.509 (Entity 5.509) Content-Type: text/plain; charset=utf-8 From: bug#6018 <6018@debbugs.gnu.org> To: bug#6018 <6018@debbugs.gnu.org> Subject: Status: 23.1.96; doc of version(-list)* Reply-To: bug#6018 <6018@debbugs.gnu.org> Date: Sun, 22 Jun 2025 07:01:52 +0000 retitle 6018 23.1.96; doc of version(-list)* reassign 6018 emacs submitter 6018 "Drew Adams" severity 6018 minor tag 6018 wontfix thanks From debbugs-submit-bounces@debbugs.gnu.org Fri Apr 23 15:05:19 2010 Received: (at submit) by debbugs.gnu.org; 23 Apr 2010 19:05:20 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1O5OBj-0006gQ-O2 for submit@debbugs.gnu.org; Fri, 23 Apr 2010 15:05:19 -0400 Received: from mx10.gnu.org ([199.232.76.166]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1O5OBh-0006gJ-5B for submit@debbugs.gnu.org; Fri, 23 Apr 2010 15:05:17 -0400 Received: from lists.gnu.org ([199.232.76.165]:57193) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1O5OBc-0004E6-QO for submit@debbugs.gnu.org; Fri, 23 Apr 2010 15:05:12 -0400 Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1O5OBc-00013v-DY for bug-gnu-emacs@gnu.org; Fri, 23 Apr 2010 15:05:12 -0400 Received: from [140.186.70.92] (port=45697 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1O5OBb-00010l-0C for bug-gnu-emacs@gnu.org; Fri, 23 Apr 2010 15:05:11 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.0 (2010-01-18) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00,T_RP_MATCHES_RCVD, UNPARSEABLE_RELAY autolearn=unavailable version=3.3.0 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1O5OBZ-0003vT-GD for bug-gnu-emacs@gnu.org; Fri, 23 Apr 2010 15:05:10 -0400 Received: from rcsinet10.oracle.com ([148.87.113.121]:55266) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1O5OBZ-0003vL-BE for bug-gnu-emacs@gnu.org; Fri, 23 Apr 2010 15:05:09 -0400 Received: from acsinet15.oracle.com (acsinet15.oracle.com [141.146.126.227]) by rcsinet10.oracle.com (Switch-3.4.2/Switch-3.4.1) with ESMTP id o3NJ56pR024873 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK) for ; Fri, 23 Apr 2010 19:05:07 GMT Received: from acsmt353.oracle.com (acsmt353.oracle.com [141.146.40.153]) by acsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1) with ESMTP id o3N310Y1014075 for ; Fri, 23 Apr 2010 19:04:59 GMT Received: from abhmt005.oracle.com by acsmt355.oracle.com with ESMTP id 203864621272049495; Fri, 23 Apr 2010 12:04:55 -0700 Received: from dradamslap1 (/10.175.223.120) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Fri, 23 Apr 2010 12:04:54 -0700 From: "Drew Adams" To: Subject: 23.1.96; doc of version(-list)* Date: Fri, 23 Apr 2010 12:04:59 -0700 Message-ID: MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Mailer: Microsoft Office Outlook 11 Thread-Index: AcrjF962JlcW0ikCQzSYfEegE87qZQ== X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.5579 X-Auth-Type: Internal IP X-Source-IP: acsinet15.oracle.com [141.146.126.227] X-CT-RefId: str=0001.0A090204.4BD1EF64.000B:SCFMA922111,ss=1,fgs=0 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6, seldom 2.4 (older, 4) X-Spam-Score: -6.2 (------) X-Debbugs-Envelope-To: submit X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 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.2 (------) The new version<, version-list* etc. functions are not sufficiently documented. There is no explanation (spec) of the elements in the *-list functions. Examples are given, but no real explanation. If the elements must be integers, say so. And say what a negative integer means. There is a little more info in the doc strings of `version-regexp-alist' and `version-to-list', but again, there are only examples, no explanation. Please describe the _mapping_ between parts of version strings (e.g. the sub regexps "pre", "beta", "alpha" etc.) and negative integers as list elements. It is sufficient to describe this thoroughly in one doc string, if you then link to that doc string from the other doc strings. So far, however, the info necessary to understand this feature is lacking, especially regarding the use and meaning of negative integers. In GNU Emacs 23.1.96.1 (i386-mingw-nt5.1.2600) of 2010-04-20 on G41R2F1 Windowing system distributor `Microsoft Corp.', version 5.1.2600 configured using `configure --with-gcc (3.4) --no-opt --cflags -Ic:/xpm/include' From debbugs-submit-bounces@debbugs.gnu.org Fri Apr 23 16:41:08 2010 Received: (at 6018) by debbugs.gnu.org; 23 Apr 2010 20:41:08 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1O5PgR-0007VT-2z for submit@debbugs.gnu.org; Fri, 23 Apr 2010 16:41:07 -0400 Received: from mtaout21.012.net.il ([80.179.55.169]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1O5PgP-0007V6-2W for 6018@debbugs.gnu.org; Fri, 23 Apr 2010 16:41:06 -0400 Received: from conversion-daemon.a-mtaout21.012.net.il by a-mtaout21.012.net.il (HyperSendmail v2007.08) id <0L1C00100JWP5L00@a-mtaout21.012.net.il> for 6018@debbugs.gnu.org; Fri, 23 Apr 2010 23:39:16 +0300 (IDT) Received: from HOME-C4E4A596F7 ([84.228.104.173]) by a-mtaout21.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0L1C00MUZK189F60@a-mtaout21.012.net.il>; Fri, 23 Apr 2010 23:39:16 +0300 (IDT) Date: Fri, 23 Apr 2010 23:39:10 +0300 From: Eli Zaretskii Subject: Re: bug#6018: 23.1.96; doc of version(-list)* In-reply-to: X-012-Sender: halo1@inter.net.il To: Drew Adams Message-id: <831ve53nv5.fsf@gnu.org> References: X-Spam-Score: -2.0 (--) X-Debbugs-Envelope-To: 6018 Cc: 6018@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Reply-To: Eli Zaretskii 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.0 (--) > From: "Drew Adams" > Date: Fri, 23 Apr 2010 12:04:59 -0700 > Cc: > > There is no explanation (spec) of the elements in the *-list functions. They are internal functions. Perhaps we should say that explicitly in the doc strings. The doc strings that should be reviewed are those for version<, version=, and version<=. They are the ``entry points'' to this group of functions. The rest are internal subroutines. > There is a little more info in the doc strings of `version-regexp-alist' > and `version-to-list', but again, there are only examples, no > explanation. Please describe the _mapping_ between parts of version > strings (e.g. the sub regexps "pre", "beta", "alpha" etc.) and negative > integers as list elements. What description is needed, given that you can see the value? From debbugs-submit-bounces@debbugs.gnu.org Fri Apr 23 17:07:58 2010 Received: (at 6018) by debbugs.gnu.org; 23 Apr 2010 21:07:58 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1O5Q6Q-0007i9-35 for submit@debbugs.gnu.org; Fri, 23 Apr 2010 17:07:58 -0400 Received: from rcsinet10.oracle.com ([148.87.113.121]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1O5Q6N-0007i3-Mh for 6018@debbugs.gnu.org; Fri, 23 Apr 2010 17:07:56 -0400 Received: from rcsinet15.oracle.com (rcsinet15.oracle.com [148.87.113.117]) by rcsinet10.oracle.com (Switch-3.4.2/Switch-3.4.1) with ESMTP id o3NL7mKW001078 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Fri, 23 Apr 2010 21:07:50 GMT Received: from acsmt355.oracle.com (acsmt355.oracle.com [141.146.40.155]) by rcsinet15.oracle.com (Switch-3.4.2/Switch-3.4.1) with ESMTP id o3NL7l2c001702; Fri, 23 Apr 2010 21:07:47 GMT Received: from abhmt008.oracle.com by acsmt353.oracle.com with ESMTP id 185413851272056794; Fri, 23 Apr 2010 14:06:34 -0700 Received: from dradamslap1 (/10.175.223.120) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Fri, 23 Apr 2010 14:06:34 -0700 From: "Drew Adams" To: "'Eli Zaretskii'" References: <831ve53nv5.fsf@gnu.org> Subject: RE: bug#6018: 23.1.96; doc of version(-list)* Date: Fri, 23 Apr 2010 14:06:39 -0700 Message-ID: <0A1266CAFFCB4B17869EA0174A34F9AF@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: <831ve53nv5.fsf@gnu.org> Thread-Index: AcrjJUvj53AcWNneSpibC3wZAp/uzAAADhzA X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.5579 X-Auth-Type: Internal IP X-Source-IP: rcsinet15.oracle.com [148.87.113.117] X-CT-RefId: str=0001.0A090207.4BD20C26.00D4:SCFMA4539811,ss=1,fgs=0 X-Spam-Score: -2.9 (--) X-Debbugs-Envelope-To: 6018 Cc: 6018@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 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 (----) > > There is no explanation (spec) of the elements in the > > *-list functions. > > They are internal functions. Perhaps we should say that explicitly in > the doc strings. I don't see why they should be internal functions. > The doc strings that should be reviewed are those for version<, > version=, and version<=. They are the ``entry points'' to this group > of functions. The rest are internal subroutines. 1. Why? Why wouldn't they be useful to users? 2. Wrt the version* (non-list) functions, great energy is spent describing the treatment of trailing zeros and alpha strings, but nothing is said about the comparison of strings with digits other than zero. And that's arguably the most important and most up for grabs. And again, even for zeros and alpha strings, the "explanation" is only via examples. At least say something about what kind of string comparison is done: alphabetic for non-digits, describe the comparison of digit strings, mention case-insensitivity etc. Think about the different ways that file names that contain digits are sometimes sorted. Think about how that has often confused the hell out of users (especially Windows's notorious order). Give users a clear understanding of just what the numeric ordering is that we use. > > There is a little more info in the doc strings of > > `version-regexp-alist' and `version-to-list', but again, > > there are only examples, no explanation. Please describe > > the _mapping_ between parts of version strings (e.g. the > > sub regexps "pre", "beta", "alpha" etc.) and negative > > integers as list elements. > > What description is needed, given that you can see the value? A few examples do not define a mapping. At most, they define it partially. What does a negative integer mean? Which regexps are mapped to negative integers? Which of them correspond to which negative integers? etc. (It's not obvious that "pre" would follow "beta", for instance.) What do the various alpha regexp patterns ("pre" etc.) mean? There are only 3 predefined alpha regexp patterns. Please say what they mean. Also, we don't say what the "priority" means for version-regexp-alist. What does it mean for a particular alist entry to have a "priority" of -3? A spec, IOW. From debbugs-submit-bounces@debbugs.gnu.org Mon Apr 26 12:32:46 2010 Received: (at control) by debbugs.gnu.org; 26 Apr 2010 16:32:46 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1O6REk-0000on-4b for submit@debbugs.gnu.org; Mon, 26 Apr 2010 12:32:46 -0400 Received: from fencepost.gnu.org ([140.186.70.10]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1O6REi-0000oi-QN for control@debbugs.gnu.org; Mon, 26 Apr 2010 12:32:45 -0400 Received: from rgm by fencepost.gnu.org with local (Exim 4.69) (envelope-from ) id 1O6REe-0001tM-0h; Mon, 26 Apr 2010 12:32:40 -0400 MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Message-ID: <19413.49191.892618.963271@fencepost.gnu.org> Date: Mon, 26 Apr 2010 12:32:39 -0400 From: Glenn Morris To: control Subject: control X-Attribution: GM X-Mailer: VM (www.wonderworks.com/vm), GNU Emacs (www.gnu.org/software/emacs) X-Hue: white X-Ran: 3[pfxg,o#U$I`={2Q\}pa6Nwg_vOjC"uBuu:ADU@j)*:E[2y&tXT]i6P,b1*Y|8?h:D 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: -5.1 (-----) reassign 6040 emacs severity 6038 minor severity 6028 minor severity 6018 minor From debbugs-submit-bounces@debbugs.gnu.org Wed Jul 13 14:07:06 2011 Received: (at control) by debbugs.gnu.org; 13 Jul 2011 18:07:07 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Qh3py-0001WM-33 for submit@debbugs.gnu.org; Wed, 13 Jul 2011 14:07:06 -0400 Received: from hermes.netfonds.no ([80.91.224.195]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Qh3pw-0001Vt-9r for control@debbugs.gnu.org; Wed, 13 Jul 2011 14:07:04 -0400 Received: from cm-84.215.51.58.getinternet.no ([84.215.51.58] helo=quimbies.gnus.org) by hermes.netfonds.no with esmtpsa (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.72) (envelope-from ) id 1Qh3pl-00026j-BP for control@debbugs.gnu.org; Wed, 13 Jul 2011 20:06:53 +0200 Date: Wed, 13 Jul 2011 20:06:52 +0200 Message-Id: To: control@debbugs.gnu.org From: Lars Magne Ingebrigtsen Subject: control message for bug #6018 X-MailScanner-ID: 1Qh3pl-00026j-BP X-Netfonds-MailScanner: Found to be clean X-Netfonds-MailScanner-From: larsi@gnus.org MailScanner-NULL-Check: 1311185213.50253@v3sreGbsctb9HW4sBfNR+g X-Spam-Status: No X-Spam-Score: -2.7 (--) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 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.7 (--) tags 6018 wontfix close 6018 From debbugs-submit-bounces@debbugs.gnu.org Wed Jul 13 14:09:22 2011 Received: (at 6018) by debbugs.gnu.org; 13 Jul 2011 18:09:22 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Qh3sA-0001aX-0I for submit@debbugs.gnu.org; Wed, 13 Jul 2011 14:09:22 -0400 Received: from hermes.netfonds.no ([80.91.224.195]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Qh3s8-0001a6-4l for 6018@debbugs.gnu.org; Wed, 13 Jul 2011 14:09:20 -0400 Received: from cm-84.215.51.58.getinternet.no ([84.215.51.58] helo=quimbies.gnus.org) by hermes.netfonds.no with esmtpsa (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.72) (envelope-from ) id 1Qh3rw-0002Ah-R1; Wed, 13 Jul 2011 20:09:08 +0200 From: Lars Magne Ingebrigtsen To: Eli Zaretskii Subject: Re: bug#6018: 23.1.96; doc of version(-list)* In-Reply-To: <831ve53nv5.fsf@gnu.org> (Eli Zaretskii's message of "Fri, 23 Apr 2010 23:39:10 +0300") Date: Wed, 13 Jul 2011 20:06:46 +0200 Message-ID: References: <831ve53nv5.fsf@gnu.org> User-Agent: Gnus/5.110018 (No Gnus v0.18) Emacs/24.0.50 (gnu/linux) X-Now-Playing: Talking Heads's _The Name Of This Band Is Talking Heads (Disc 2: 1980-1981)_: "Born Under Punches (The Heat Goes On)" X-Hashcash: 1:23:110713:6018@debbugs.gnu.org::uiG37lz8P3p17ubz:0000000000000000000000000000000000000000002mf X-Hashcash: 1:23:110713:eliz@gnu.org::nzfy9w+dDAH2OY8b:00000UOLE X-Hashcash: 1:23:110713:drew.adams@oracle.com::Fuxf8gdynuM2DIk4:0000000000000000000000000000000000000000iQfX MIME-Version: 1.0 Content-Type: text/plain X-MailScanner-ID: 1Qh3rw-0002Ah-R1 X-Netfonds-MailScanner: Found to be clean X-Netfonds-MailScanner-From: larsi@gnus.org MailScanner-NULL-Check: 1311185348.94056@Jhzu1X8CIpkmLJNrs/UDbw X-Spam-Status: No X-Spam-Score: -2.7 (--) X-Debbugs-Envelope-To: 6018 Cc: 6018@debbugs.gnu.org, Drew Adams X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 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.7 (--) Eli Zaretskii writes: > The doc strings that should be reviewed are those for version<, > version=, and version<=. They are the ``entry points'' to this group > of functions. The rest are internal subroutines. The doc strings to these functions look fine to me, so I'm closing this report. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog http://lars.ingebrigtsen.no/ From debbugs-submit-bounces@debbugs.gnu.org Wed Jul 13 14:20:39 2011 Received: (at 6018) by debbugs.gnu.org; 13 Jul 2011 18:20:40 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Qh435-0002ij-4q for submit@debbugs.gnu.org; Wed, 13 Jul 2011 14:20:39 -0400 Received: from acsinet15.oracle.com ([141.146.126.227]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Qh433-0002iU-Ei for 6018@debbugs.gnu.org; Wed, 13 Jul 2011 14:20:37 -0400 Received: from rtcsinet21.oracle.com (rtcsinet21.oracle.com [66.248.204.29]) by acsinet15.oracle.com (Switch-3.4.4/Switch-3.4.4) with ESMTP id p6DIKSBW032018 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Wed, 13 Jul 2011 18:20:30 GMT Received: from acsmt358.oracle.com (acsmt358.oracle.com [141.146.40.158]) by rtcsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id p6DIKRpZ028280 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Wed, 13 Jul 2011 18:20:27 GMT Received: from abhmt112.oracle.com (abhmt112.oracle.com [141.146.116.64]) by acsmt358.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id p6DIKLdA003785; Wed, 13 Jul 2011 13:20:21 -0500 Received: from dradamslap1 (/130.35.178.194) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Wed, 13 Jul 2011 11:20:20 -0700 From: "Drew Adams" To: "'Lars Magne Ingebrigtsen'" , "'Eli Zaretskii'" References: <831ve53nv5.fsf@gnu.org> Subject: RE: bug#6018: 23.1.96; doc of version(-list)* Date: Wed, 13 Jul 2011 11:20:21 -0700 Message-ID: <73AC74BD8215444E997358F72C146FC8@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: AcxBh/+BGAC/OubZS1CgCIsyakk1hwAAHcJg X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6109 X-Source-IP: rtcsinet21.oracle.com [66.248.204.29] X-CT-RefId: str=0001.0A090206.4E1DE1EE.0180:SCFSTAT5015188, ss=1, re=-4.000, fgs=0 X-Spam-Score: -4.3 (----) X-Debbugs-Envelope-To: 6018 Cc: 6018@debbugs.gnu.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 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.3 (----) > The doc strings to these functions look fine to me, so I'm > closing this report. AFAICT, none of the questions raised here have been answered, and the original bug is still there. The doc string of `version-regexp-alist' refers to the `version-list-*' functions, saying to consult their doc, so they cannot be said be "internal". And the doc string of `version-to-list' refers to that of `version-regexp-alist'. Nothing has been specified (no mapping), to help an Emacs-Lisp programmer use these various functions. From unknown Sun Jun 22 00:01:52 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: Did not alter fixed versions and reopened. Date: Wed, 13 Jul 2011 18:22:01 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # Did not alter fixed versions and reopened. thanks # This fakemail brought to you by your local debbugs # administrator From debbugs-submit-bounces@debbugs.gnu.org Wed Jul 13 22:04:48 2011 Received: (at 6018) by debbugs.gnu.org; 14 Jul 2011 02:04:48 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QhBIG-0006PS-L2 for submit@debbugs.gnu.org; Wed, 13 Jul 2011 22:04:48 -0400 Received: from vm-emlprdomr-03.its.yale.edu ([130.132.50.144]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QhBIE-0006PG-S3 for 6018@debbugs.gnu.org; Wed, 13 Jul 2011 22:04:47 -0400 Received: from furball (dhcp128036014059.central.yale.edu [128.36.14.59]) (authenticated bits=0) by vm-emlprdomr-03.its.yale.edu (8.14.4/8.14.4) with ESMTP id p6E24e3q007843 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES128-SHA bits=128 verify=NOT); Wed, 13 Jul 2011 22:04:40 -0400 From: Chong Yidong To: "Drew Adams" Subject: Re: bug#6018: 23.1.96; doc of version(-list)* References: <831ve53nv5.fsf@gnu.org> <73AC74BD8215444E997358F72C146FC8@us.oracle.com> Date: Wed, 13 Jul 2011 22:04:39 -0400 In-Reply-To: <73AC74BD8215444E997358F72C146FC8@us.oracle.com> (Drew Adams's message of "Wed, 13 Jul 2011 11:20:21 -0700") Message-ID: <87r55tpqh4.fsf@stupidchicken.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Scanned-By: MIMEDefang 2.71 on 130.132.50.144 X-Spam-Score: -2.7 (--) X-Debbugs-Envelope-To: 6018 Cc: 'Lars Magne Ingebrigtsen' , 6018@debbugs.gnu.org, 'Eli Zaretskii' X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 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.7 (--) "Drew Adams" writes: >> The doc strings to these functions look fine to me, so I'm closing >> this report. > > AFAICT, none of the questions raised here have been answered, and the > original bug is still there. > > > The doc string of `version-regexp-alist' refers to the > `version-list-*' functions, saying to consult their doc, so they > cannot be said be "internal". > > And the doc string of `version-to-list' refers to that of > `version-regexp-alist'. > > Nothing has been specified (no mapping), to help an Emacs-Lisp > programmer use these various functions. Really? I looked again at the docstrings of version-to-list and version-regexp-alist, and it seems pretty clear to me. Even if an Emacs Lisp programmer is ignorant of what an EBNF is, it's pretty obvious from the context what the docstring is talking about. You have to be more specific about what's confusing you. From debbugs-submit-bounces@debbugs.gnu.org Wed Jul 13 22:51:39 2011 Received: (at 6018) by debbugs.gnu.org; 14 Jul 2011 02:51:39 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QhC1a-000055-Sj for submit@debbugs.gnu.org; Wed, 13 Jul 2011 22:51:39 -0400 Received: from rcsinet15.oracle.com ([148.87.113.117]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QhC1Y-0008WQ-Rq for 6018@debbugs.gnu.org; Wed, 13 Jul 2011 22:51:37 -0400 Received: from rtcsinet21.oracle.com (rtcsinet21.oracle.com [66.248.204.29]) by rcsinet15.oracle.com (Switch-3.4.4/Switch-3.4.4) with ESMTP id p6E2pS0F018164 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Thu, 14 Jul 2011 02:51:30 GMT Received: from acsmt357.oracle.com (acsmt357.oracle.com [141.146.40.157]) by rtcsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id p6E2pQW2004474 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Thu, 14 Jul 2011 02:51:27 GMT Received: from abhmt101.oracle.com (abhmt101.oracle.com [141.146.116.53]) by acsmt357.oracle.com (8.12.11.20060308/8.12.11) with ESMTP id p6E2pLhD009571; Wed, 13 Jul 2011 21:51:21 -0500 Received: from dradamslap1 (/10.159.37.192) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Wed, 13 Jul 2011 19:51:17 -0700 From: "Drew Adams" To: "'Chong Yidong'" References: <831ve53nv5.fsf@gnu.org> <73AC74BD8215444E997358F72C146FC8@us.oracle.com> <87r55tpqh4.fsf@stupidchicken.com> Subject: RE: bug#6018: 23.1.96; doc of version(-list)* Date: Wed, 13 Jul 2011 19:51:15 -0700 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: <87r55tpqh4.fsf@stupidchicken.com> Thread-Index: AcxBynF79p7+ZTDnQRGml8IbReUJdgABIAwg X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6109 X-Source-IP: rtcsinet21.oracle.com [66.248.204.29] X-CT-RefId: str=0001.0A090202.4E1E59B2.00D1:SCFSTAT5015188, ss=1, re=-4.000, fgs=0 X-Spam-Score: -4.3 (----) X-Debbugs-Envelope-To: 6018 Cc: 'Lars Magne Ingebrigtsen' , 6018@debbugs.gnu.org, 'Eli Zaretskii' X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 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.3 (----) > > AFAICT, none of the questions raised here have been > > answered, and the original bug is still there. > > > > > > The doc string of `version-regexp-alist' refers to the > > `version-list-*' functions, saying to consult their doc, so they > > cannot be said be "internal". > > > > And the doc string of `version-to-list' refers to that of > > `version-regexp-alist'. > > > > Nothing has been specified (no mapping), to help an Emacs-Lisp > > programmer use these various functions. > > Really? > You have to be more specific about what's confusing you. I was pretty darn specific about the non-specificity of this doc and what is missing. As I said: > > The doc string of `version-regexp-alist' refers to the > > `version-list-*' functions, saying to consult their doc, so they > > cannot be said to be "internal". And as I said about those referenced `version-list-*' functions: > Examples are given, but no real explanation. If the elements must be > integers, say so. And say what a negative integer means. And as I said about `version-regexp-alist' and `version-to-list': > again, there are only examples, no explanation. Please > describe the _mapping_ between parts of version > strings (e.g. the sub regexps "pre", "beta", "alpha" etc.) > and negative integers as list elements. And: > Which regexps are mapped to negative integers? Which of them > correspond to which negative integers? etc. (It's not > obvious that "pre" would follow "beta", for instance.) > > What do the various alpha regexp patterns ("pre" etc.) mean? > There are only 3 predefined alpha regexp patterns. Please > say what they mean. > > Also, we don't say what the "priority" means for > version-regexp-alist. What does it mean for a particular > alist entry to have a "priority" of -3? > It is sufficient to describe this thoroughly in one doc string, if you > then link to that doc string from the other doc strings. So far, > however, the info necessary to understand this feature is lacking, > especially regarding the use and meaning of negative integers. And as I said about the `version* (non-list) functions: > nothing is said about the comparison of strings with digits > other than zero. And that's arguably the most important and > most up for grabs. > > And again, even for zeros and alpha strings, the > "explanation" is only via examples. At least say something > about what kind of string comparison is done: > alphabetic for non-digits, describe the comparison of digit > strings, mention case-insensitivity etc. > Give users a clear understanding of just what the numeric > ordering is that we use. Enough details for you? That describes some of the interface/API info about these functions that is missing, and it includes some of the questions a user of these functions will have. From debbugs-submit-bounces@debbugs.gnu.org Thu Jul 14 02:31:04 2011 Received: (at 6018) by debbugs.gnu.org; 14 Jul 2011 06:31:04 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QhFRw-0007f2-AL for submit@debbugs.gnu.org; Thu, 14 Jul 2011 02:31:04 -0400 Received: from fencepost.gnu.org ([140.186.70.10]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QhFRv-0007eY-27 for 6018@debbugs.gnu.org; Thu, 14 Jul 2011 02:31:03 -0400 Received: from eliz by fencepost.gnu.org with local (Exim 4.71) (envelope-from ) id 1QhFRo-0003ID-T5; Thu, 14 Jul 2011 02:30:56 -0400 Date: Thu, 14 Jul 2011 02:30:56 -0400 Message-Id: From: Eli Zaretskii To: "Drew Adams" In-reply-to: (drew.adams@oracle.com) Subject: Re: bug#6018: 23.1.96; doc of version(-list)* References: <831ve53nv5.fsf@gnu.org> <73AC74BD8215444E997358F72C146FC8@us.oracle.com> <87r55tpqh4.fsf@stupidchicken.com> X-Spam-Score: -6.6 (------) X-Debbugs-Envelope-To: 6018 Cc: cyd@stupidchicken.com, 6018@debbugs.gnu.org, larsi@gnus.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Reply-To: Eli Zaretskii 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.6 (------) > From: "Drew Adams" > Cc: "'Lars Magne Ingebrigtsen'" , > "'Eli Zaretskii'" , <6018@debbugs.gnu.org> > Date: Wed, 13 Jul 2011 19:51:15 -0700 > > > Really? > > You have to be more specific about what's confusing you. > > I was pretty darn specific about the non-specificity of this doc and what is > missing. You were bikeshedding, as usual. > As I said: > > > > The doc string of `version-regexp-alist' refers to the > > > `version-list-*' functions, saying to consult their doc, so they > > > cannot be said to be "internal". That doc string no longer refers to anything but version-to-list. And version-regexp-alist is itself an internal variable, so this is not an evidence to the effect you want it to be. The doc string of version-regexp-alist is for developers of this group of functions, not for users of their advertised APIs. > > Examples are given, but no real explanation. If the elements must be > > integers, say so. And say what a negative integer means. Please explain where is the current doc string insufficient. What you did was express general consideration, not specific confusion points. Please make a point of giving specific practical use cases where a doc string leaves you in the dark regarding the outcome of a specific test that uses the advertised API for Lisp programs. > And as I said about `version-regexp-alist' and `version-to-list': > > > again, there are only examples, no explanation. Please > > describe the _mapping_ between parts of version > > strings (e.g. the sub regexps "pre", "beta", "alpha" etc.) > > and negative integers as list elements. See above: unless you show a specific use case where this mapping needs to be documented in the doc string, your arguments are nil and void. > And: > > > Which regexps are mapped to negative integers? Which of them > > correspond to which negative integers? etc. (It's not > > obvious that "pre" would follow "beta", for instance.) See above: why do you need that documented? I submit you don't. > > Also, we don't say what the "priority" means for > > version-regexp-alist. What does it mean for a particular > > alist entry to have a "priority" of -3? Nothing of interest to you (unless you read the code, in which case it should be obvious). This is an implementation detail. > And as I said about the `version* (non-list) functions: > > > nothing is said about the comparison of strings with digits > > other than zero. And that's arguably the most important and > > most up for grabs. You mean, it isn't obviously clear that 3 is greater than 2 and less than 4? It needs to be documented in a doc string? > > And again, even for zeros and alpha strings, the > > "explanation" is only via examples. At least say something > > about what kind of string comparison is done: > > alphabetic for non-digits, describe the comparison of digit > > strings, mention case-insensitivity etc. See above: give us a use case. At least one. > > Give users a clear understanding of just what the numeric > > ordering is that we use. > > Enough details for you? No, see above. You wrote a lot, but all of it is irrelevant. All the _real_ issues with these doc strings were taken care of, back when you submitted this bug report. All that's left is bikeshedding. > That describes some of the interface/API info about these functions > that is missing You didn't show a single issue with the _advertised_ API that indicates that some info is missing. > and it includes some of the questions a user of these functions will > have. A user called Drew, perhaps. Because he insists on having internal functions and implementation details be documented as if they were advertised APIs. From debbugs-submit-bounces@debbugs.gnu.org Thu Jul 14 10:06:21 2011 Received: (at 6018) by debbugs.gnu.org; 14 Jul 2011 14:06:21 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QhMYX-00049U-4Z for submit@debbugs.gnu.org; Thu, 14 Jul 2011 10:06:21 -0400 Received: from rcsinet15.oracle.com ([148.87.113.117]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QhMYR-000495-W4 for 6018@debbugs.gnu.org; Thu, 14 Jul 2011 10:06:16 -0400 Received: from rtcsinet22.oracle.com (rtcsinet22.oracle.com [66.248.204.30]) by rcsinet15.oracle.com (Switch-3.4.4/Switch-3.4.4) with ESMTP id p6EE67fn025877 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK); Thu, 14 Jul 2011 14:06:09 GMT Received: from acsmt356.oracle.com (acsmt356.oracle.com [141.146.40.156]) by rtcsinet22.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id p6EE66Go024033 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Thu, 14 Jul 2011 14:06:07 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 p6EE60vL008367; Thu, 14 Jul 2011 09:06:00 -0500 Received: from dradamslap1 (/10.159.37.192) by default (Oracle Beehive Gateway v4.0) with ESMTP ; Thu, 14 Jul 2011 07:06:00 -0700 From: "Drew Adams" To: "'Eli Zaretskii'" References: <831ve53nv5.fsf@gnu.org> <73AC74BD8215444E997358F72C146FC8@us.oracle.com> <87r55tpqh4.fsf@stupidchicken.com> Subject: RE: bug#6018: 23.1.96; doc of version(-list)* Date: Thu, 14 Jul 2011 07:05:57 -0700 Message-ID: <6939AE9645124A98A704884D2C66A2B1@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: AcxB75zEeyn/UqAPRJeG7X6c1pg2XAAO22DA X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2900.6109 X-Source-IP: rtcsinet22.oracle.com [66.248.204.30] X-CT-RefId: str=0001.0A090207.4E1EF7D2.0007:SCFSTAT5015188, ss=1, re=-4.000, fgs=0 X-Spam-Score: -4.3 (----) X-Debbugs-Envelope-To: 6018 Cc: cyd@stupidchicken.com, 6018@debbugs.gnu.org, larsi@gnus.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 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.3 (----) > > > > The doc string of `version-regexp-alist' refers to the > > > > `version-list-*' functions, saying to consult their doc, so they > > > > cannot be said to be "internal". > > That doc string no longer refers to anything but version-to-list. I was going by the description of the bug fix in this thread, which didn't mention that. > And version-regexp-alist is itself an internal variable, so this is > not an evidence to the effect you want it to be. The doc string of > version-regexp-alist is for developers of this group of functions, not > for users of their advertised APIs. Really? What about these parts of the doc string of `version-to-list': 1. "SEPARATOR ::= `version-separator' (which see) `version-regexp-alist' (which see)." 2. "The NUMBER part is optional if SEPARATOR is a match for an element in `version-regexp-alist'." 3. "See documentation for `version-separator' and `version-regexp-alist'." What, anywhere, indicates that `version-regexp-alist' is "internal"? All indications point to the contrary. Or are you now claiming that `version-to-list' is also internal, like you claimed for `version-list*'? It was you who placed an internal/external line in the sand here, pointing out that `v-r-alist' now refers only to `v-to-list' and no longer to `v-list*' (because "internal"). > > about the `version* (non-list) functions: > > > > > nothing is said about the comparison of strings with digits > > > other than zero. And that's arguably the most important and > > > most up for grabs. > > You mean, it isn't obviously clear that 3 is greater than 2 and less > than 4? It needs to be documented in a doc string? A digit is not a string of digits. And as you know full well (or should know), there are various ways to order strings of digits. One need look no further than the "interesting" way MS Windows (e.g. Windows Explorer) sorts file names that contain digits: "google windows explorer file name sort order". Don't you think we should specify how strings containing digits are ordered? It's not about 3 > 2. > > > And again, even for zeros and alpha strings, the > > > "explanation" is only via examples. At least say something > > > about what kind of string comparison is done: > > > alphabetic for non-digits, describe the comparison of digit > > > strings, mention case-insensitivity etc. > > See above Yes, please see above. How are strings containing digits compared? What about case sensitivity? Does `case-fold-search' affect that or not? Especially if the comparison is simple (e.g. orthographic/alphabetical order), it is simple to state what it is. For the rest - if you have removed all mention of everything you designate as "internal" from the doc of what you designate as not internal, then that part of the bug could be considered fixed. Fixed by sleight of hand, perhaps, but fixed. If there remain non-internal things whose doc is incompletely specified (see above), then that doc would remain to be fixed. From debbugs-submit-bounces@debbugs.gnu.org Thu Jul 14 11:56:20 2011 Received: (at 6018) by debbugs.gnu.org; 14 Jul 2011 15:56:21 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QhOGx-0003WT-LF for submit@debbugs.gnu.org; Thu, 14 Jul 2011 11:56:19 -0400 Received: from mtaout20.012.net.il ([80.179.55.166]) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1QhOGs-0003WC-Ux for 6018@debbugs.gnu.org; Thu, 14 Jul 2011 11:56:17 -0400 Received: from conversion-daemon.a-mtaout20.012.net.il by a-mtaout20.012.net.il (HyperSendmail v2007.08) id <0LOB00300YTYFB00@a-mtaout20.012.net.il> for 6018@debbugs.gnu.org; Thu, 14 Jul 2011 18:56:07 +0300 (IDT) Received: from HOME-C4E4A596F7 ([84.229.156.102]) by a-mtaout20.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0LOB003PRYXIFL00@a-mtaout20.012.net.il>; Thu, 14 Jul 2011 18:56:07 +0300 (IDT) Date: Thu, 14 Jul 2011 18:58:13 +0300 From: Eli Zaretskii Subject: Re: bug#6018: 23.1.96; doc of version(-list)* In-reply-to: <6939AE9645124A98A704884D2C66A2B1@us.oracle.com> X-012-Sender: halo1@inter.net.il To: Drew Adams Message-id: <83oc0wetwq.fsf@gnu.org> References: <831ve53nv5.fsf@gnu.org> <73AC74BD8215444E997358F72C146FC8@us.oracle.com> <87r55tpqh4.fsf@stupidchicken.com> <6939AE9645124A98A704884D2C66A2B1@us.oracle.com> X-Spam-Score: -2.0 (--) X-Debbugs-Envelope-To: 6018 Cc: cyd@stupidchicken.com, 6018@debbugs.gnu.org, larsi@gnus.org X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Reply-To: Eli Zaretskii 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.0 (--) > From: "Drew Adams" > Cc: , , <6018@debbugs.gnu.org> > Date: Thu, 14 Jul 2011 07:05:57 -0700 > > > And version-regexp-alist is itself an internal variable, so this is > > not an evidence to the effect you want it to be. The doc string of > > version-regexp-alist is for developers of this group of functions, not > > for users of their advertised APIs. > > Really? What about these parts of the doc string of `version-to-list': Irrelevant, see below. > Or are you now claiming that `version-to-list' is also internal, like you > claimed for `version-list*'? Of course! > > > > nothing is said about the comparison of strings with digits > > > > other than zero. And that's arguably the most important and > > > > most up for grabs. > > > > You mean, it isn't obviously clear that 3 is greater than 2 and less > > than 4? It needs to be documented in a doc string? > > A digit is not a string of digits. And as you know full well (or should know), > there are various ways to order strings of digits. But the default (and TRT) order is well known, especially in the context of version numbers. They are called "numbers" for a reason. > How are strings containing digits compared? As one expects. We don't document where Sun rises this morning, either. > What about case sensitivity? Ditto. > Does `case-fold-search' affect that or not? Ditto. From debbugs-submit-bounces@debbugs.gnu.org Sat Jul 16 14:42:22 2011 Received: (at 6018) by debbugs.gnu.org; 16 Jul 2011 18:42:22 +0000 Received: from localhost ([127.0.0.1] helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Qi9ok-00022Y-DG for submit@debbugs.gnu.org; Sat, 16 Jul 2011 14:42:22 -0400 Received: from [207.164.135.98] (helo=soln-sr3720.solutionip.com) by debbugs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1Qi9oh-00022H-Pu for 6018@debbugs.gnu.org; Sat, 16 Jul 2011 14:42:20 -0400 Received: from [172.22.15.247] (helo=ceviche.home) by soln-sr3720.solutionip.com with esmtp (Exim 3.34 #1) id 1Qi9oc-0006ir-00; Sat, 16 Jul 2011 14:42:14 -0400 Received: by ceviche.home (Postfix, from userid 20848) id 1DA2F660D5; Sat, 16 Jul 2011 14:42:14 -0400 (EDT) From: Stefan Monnier To: "Drew Adams" Subject: Re: bug#6018: 23.1.96; doc of version(-list)* Message-ID: References: <831ve53nv5.fsf@gnu.org> <73AC74BD8215444E997358F72C146FC8@us.oracle.com> Date: Sat, 16 Jul 2011 14:42:14 -0400 In-Reply-To: <73AC74BD8215444E997358F72C146FC8@us.oracle.com> (Drew Adams's message of "Wed, 13 Jul 2011 11:20:21 -0700") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -1.9 (-) X-Debbugs-Envelope-To: 6018 Cc: 'Lars Magne Ingebrigtsen' , 6018@debbugs.gnu.org, 'Eli Zaretskii' X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 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.9 (-) > The doc string of `version-regexp-alist' refers to the `version-list-*' > functions, saying to consult their doc, so they cannot be said be "internal". "internal" means you shouldn't call them or rely on their existence. It doesn't mean "we want to hide them as much as possible". But just like the code of version- can call those internal functions, their docstrings can refer to those internal functions's docstrings (as long as those references are kept uptodate when the internal functions change, of course). Stefan From debbugs-submit-bounces@debbugs.gnu.org Sat Jan 07 01:15:53 2012 Received: (at 6018) by debbugs.gnu.org; 7 Jan 2012 06:15:53 +0000 Received: from localhost ([127.0.0.1]:47578 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1RjPZI-00084h-M6 for submit@debbugs.gnu.org; Sat, 07 Jan 2012 01:15:53 -0500 Received: from hermes.netfonds.no ([80.91.224.195]:36405) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1RjPZG-00084X-3U for 6018@debbugs.gnu.org; Sat, 07 Jan 2012 01:15:51 -0500 Received: from cm-84.215.51.58.getinternet.no ([84.215.51.58] helo=stories.gnus.org) by hermes.netfonds.no with esmtpsa (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.72) (envelope-from ) id 1RjPZ8-0003WK-ER; Sat, 07 Jan 2012 07:15:42 +0100 From: Lars Magne Ingebrigtsen To: Eli Zaretskii Subject: Re: bug#6018: 23.1.96; doc of version(-list)* References: <831ve53nv5.fsf@gnu.org> <73AC74BD8215444E997358F72C146FC8@us.oracle.com> <87r55tpqh4.fsf@stupidchicken.com> <6939AE9645124A98A704884D2C66A2B1@us.oracle.com> <83oc0wetwq.fsf@gnu.org> X-Now-Playing: LA Vampires's _So Unreal_: "Still Goin' Down" Date: Sat, 07 Jan 2012 07:15:41 +0100 In-Reply-To: <83oc0wetwq.fsf@gnu.org> (Eli Zaretskii's message of "Thu, 14 Jul 2011 18:58:13 +0300") Message-ID: User-Agent: Gnus/5.110018 (No Gnus v0.18) Emacs/24.0.92 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-MailScanner-ID: 1RjPZ8-0003WK-ER X-Netfonds-MailScanner: Found to be clean X-Netfonds-MailScanner-From: larsi@gnus.org MailScanner-NULL-Check: 1326521742.67216@X939RuzpkpwjiOGbelSTnw X-Spam-Status: No X-Spam-Score: -1.9 (-) X-Debbugs-Envelope-To: 6018 Cc: cyd@stupidchicken.com, 6018@debbugs.gnu.org, Drew Adams 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.9 (-) Eli Zaretskii writes: >> How are strings containing digits compared? > > As one expects. We don't document where Sun rises this morning, > either. > >> What about case sensitivity? > > Ditto. > >> Does `case-fold-search' affect that or not? > > Ditto. So I'm closing this report again. -- (domestic pets only, the antidote for overdose, milk.) bloggy blog http://lars.ingebrigtsen.no/ From debbugs-submit-bounces@debbugs.gnu.org Sat Jan 07 01:15:57 2012 Received: (at control) by debbugs.gnu.org; 7 Jan 2012 06:15:57 +0000 Received: from localhost ([127.0.0.1]:47581 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1RjPZM-00084z-Km for submit@debbugs.gnu.org; Sat, 07 Jan 2012 01:15:57 -0500 Received: from hermes.netfonds.no ([80.91.224.195]:36410) by debbugs.gnu.org with esmtp (Exim 4.72) (envelope-from ) id 1RjPZK-00084q-N0 for control@debbugs.gnu.org; Sat, 07 Jan 2012 01:15:55 -0500 Received: from cm-84.215.51.58.getinternet.no ([84.215.51.58] helo=stories.gnus.org) by hermes.netfonds.no with esmtpsa (TLS1.0:DHE_RSA_AES_128_CBC_SHA1:16) (Exim 4.72) (envelope-from ) id 1RjPZE-0003WY-KM for control@debbugs.gnu.org; Sat, 07 Jan 2012 07:15:48 +0100 Date: Sat, 07 Jan 2012 07:15:48 +0100 Message-Id: To: control@debbugs.gnu.org From: Lars Magne Ingebrigtsen Subject: control message for bug #6018 X-MailScanner-ID: 1RjPZE-0003WY-KM X-Netfonds-MailScanner: Found to be clean X-Netfonds-MailScanner-From: larsi@gnus.org MailScanner-NULL-Check: 1326521748.77237@Ddi0Az1bSdLPDYI4XpgN3g X-Spam-Status: No X-Spam-Score: -1.9 (-) 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: -1.9 (-) close 6018 From unknown Sun Jun 22 00:01:52 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Sat, 04 Feb 2012 12:24:03 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator