From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Chong Yidong Newsgroups: gmane.emacs.bugs Subject: bug#6018: 23.1.96; doc of version(-list)* Date: Wed, 13 Jul 2011 22:04:39 -0400 Message-ID: <87r55tpqh4.fsf@stupidchicken.com> References: <831ve53nv5.fsf@gnu.org> <73AC74BD8215444E997358F72C146FC8@us.oracle.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: dough.gmane.org 1310609124 30318 80.91.229.12 (14 Jul 2011 02:05:24 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Thu, 14 Jul 2011 02:05:24 +0000 (UTC) Cc: 'Lars Magne Ingebrigtsen' , 6018@debbugs.gnu.org To: "Drew Adams" Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Thu Jul 14 04:05:20 2011 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([140.186.70.17]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1QhBIl-0003Vj-RW for geb-bug-gnu-emacs@m.gmane.org; Thu, 14 Jul 2011 04:05:20 +0200 Original-Received: from localhost ([::1]:48568 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QhBIk-00035N-Gu for geb-bug-gnu-emacs@m.gmane.org; Wed, 13 Jul 2011 22:05:18 -0400 Original-Received: from eggs.gnu.org ([140.186.70.92]:51590) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QhBIV-00035E-L3 for bug-gnu-emacs@gnu.org; Wed, 13 Jul 2011 22:05:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1QhBIU-0003jz-OM for bug-gnu-emacs@gnu.org; Wed, 13 Jul 2011 22:05:03 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:54396) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QhBIU-0003jv-Hq for bug-gnu-emacs@gnu.org; Wed, 13 Jul 2011 22:05:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1QhBIU-0006Ps-Gt; Wed, 13 Jul 2011 22:05:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Chong Yidong Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 14 Jul 2011 02:05:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 6018 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: wontfix Original-Received: via spool by 6018-submit@debbugs.gnu.org id=B6018.131060908824645 (code B ref 6018); Thu, 14 Jul 2011 02:05:02 +0000 Original-Received: (at 6018) by debbugs.gnu.org; 14 Jul 2011 02:04:48 +0000 Original-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 Original-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 Original-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 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) X-Scanned-By: MIMEDefang 2.71 on 130.132.50.144 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Wed, 13 Jul 2011 22:05:02 -0400 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 140.186.70.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.bugs:48973 Archived-At: "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.