From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Stefan Monnier Newsgroups: gmane.emacs.bugs Subject: bug#6018: 23.1.96; doc of version(-list)* Date: Sat, 16 Jul 2011 14:42:14 -0400 Message-ID: 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 1310841810 849 80.91.229.12 (16 Jul 2011 18:43:30 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Sat, 16 Jul 2011 18:43:30 +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 Sat Jul 16 20:43:24 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 1Qi9pk-0000Rb-9p for geb-bug-gnu-emacs@m.gmane.org; Sat, 16 Jul 2011 20:43:24 +0200 Original-Received: from localhost ([::1]:37097 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Qi9pj-0000Wb-F1 for geb-bug-gnu-emacs@m.gmane.org; Sat, 16 Jul 2011 14:43:23 -0400 Original-Received: from eggs.gnu.org ([140.186.70.92]:45509) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Qi9pR-0000W8-7n for bug-gnu-emacs@gnu.org; Sat, 16 Jul 2011 14:43:06 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Qi9pP-0000es-SK for bug-gnu-emacs@gnu.org; Sat, 16 Jul 2011 14:43:05 -0400 Original-Received: from debbugs.gnu.org ([140.186.70.43]:41510) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Qi9pP-0000eo-Kh for bug-gnu-emacs@gnu.org; Sat, 16 Jul 2011 14:43:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.69) (envelope-from ) id 1Qi9pO-00023W-Li; Sat, 16 Jul 2011 14:43:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Stefan Monnier Original-Sender: debbugs-submit-bounces@debbugs.gnu.org Resent-To: owner@debbugs.gnu.org Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 16 Jul 2011 18:43: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.13108417427849 (code B ref 6018); Sat, 16 Jul 2011 18:43:02 +0000 Original-Received: (at 6018) by debbugs.gnu.org; 16 Jul 2011 18:42:22 +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 1Qi9ok-00022Y-DG for submit@debbugs.gnu.org; Sat, 16 Jul 2011 14:42:22 -0400 Original-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 Original-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 Original-Received: by ceviche.home (Postfix, from userid 20848) id 1DA2F660D5; Sat, 16 Jul 2011 14:42:14 -0400 (EDT) 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-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.11 Precedence: list Resent-Date: Sat, 16 Jul 2011 14:43: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:49265 Archived-At: > 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