From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: Common Lisp Emulation vs Common Lisp Extensions Date: Sat, 28 May 2016 18:59:44 +0300 Message-ID: <83r3cmxjf3.fsf@gnu.org> References: <1E868375-1773-40FB-95F5-2E141BA7CCCA@gmail.com> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1464451230 24294 80.91.229.3 (28 May 2016 16:00:30 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 28 May 2016 16:00:30 +0000 (UTC) Cc: emacs-devel@gnu.org To: Jean-Christophe Helary Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat May 28 18:00:21 2016 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1b6gez-0006d6-2B for ged-emacs-devel@m.gmane.org; Sat, 28 May 2016 18:00:21 +0200 Original-Received: from localhost ([::1]:53580 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1b6gev-0004DX-2q for ged-emacs-devel@m.gmane.org; Sat, 28 May 2016 12:00:17 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:59302) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1b6geJ-0004DC-Sq for emacs-devel@gnu.org; Sat, 28 May 2016 11:59:41 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1b6geD-0007lt-VM for emacs-devel@gnu.org; Sat, 28 May 2016 11:59:38 -0400 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:40020) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1b6geD-0007li-S0; Sat, 28 May 2016 11:59:33 -0400 Original-Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:2361 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1b6geB-0003x2-VZ; Sat, 28 May 2016 11:59:32 -0400 In-reply-to: <1E868375-1773-40FB-95F5-2E141BA7CCCA@gmail.com> (message from Jean-Christophe Helary on Sat, 28 May 2016 22:39:46 +0900) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.org gmane.emacs.devel:204111 Archived-At: > From: Jean-Christophe Helary > Date: Sat, 28 May 2016 22:39:46 +0900 > > The Elisp Reference points at a "Common Lisp Extensions" document or chapter without specifying where to find that document. > > Cf. p2 of the PDF (Lisp History) and 6 other references in the manual. > > It looks like the correct reference is: "GNU Emacs Common Lisp Emulation" according to: > http://www.gnu.org/software/emacs/manual/html_mono/cl.html > > The Emacs Manual uses the same reference (p. 526 of the PDF) > > It would be good to fix the two manuals to properly reference the document. Are you looking at the PDF versions of the manuals, or at HTML versions? Each one has a different title name. The PDF (and the printed version) uses "Common Lisp Extensions", which is what appears on the title page of the printed CL library manual. The HTML version uses the name of the top node, which is "GNU Emacs Common Lisp Emulation". Does this information help to understand the confusion? > Also, the web page for the GNU Emacs Manual Online uses "GNU Emacs Common Lisp support." to describe the package and the page that is linked to from there is "CL manual". I see nothing wrong in the reference, it could be a Texinfo problem in how it processes cross-references for HTML versions. I also don't see "GNU Emacs Common Lisp support.", can you point to it more specifically with a complete URL? In general, for all of the problems you mention, it is better to provide more specific references, like the context or the name of the node/chapter where the reference lives. Otherwise, it is very hard to look for these instances. Thanks.