From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Paul Eggert Newsgroups: gmane.emacs.devel Subject: version vs edition numbers in Emacs manuals Date: Fri, 1 Nov 2019 17:35:53 -0700 Organization: UCLA Computer Science Department Message-ID: <0d07699b-0b9f-fd44-11a2-9058c9eaa02b@cs.ucla.edu> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="------------2299B540EA117394CB05ACC2" Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="99686"; mail-complaints-to="usenet@blaine.gmane.org" User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.1.1 To: Emacs development discussions Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Nov 02 01:37:07 2019 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.89) (envelope-from ) id 1iQhPf-000Pnc-58 for ged-emacs-devel@m.gmane.org; Sat, 02 Nov 2019 01:37:07 +0100 Original-Received: from localhost ([::1]:44140 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iQhPd-0004lO-7g for ged-emacs-devel@m.gmane.org; Fri, 01 Nov 2019 20:37:05 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:39860) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iQhOe-0004ip-QL for emacs-devel@gnu.org; Fri, 01 Nov 2019 20:36:07 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1iQhOb-0004DK-8z for emacs-devel@gnu.org; Fri, 01 Nov 2019 20:36:03 -0400 Original-Received: from zimbra.cs.ucla.edu ([131.179.128.68]:41818) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1iQhOZ-0004A7-DE for emacs-devel@gnu.org; Fri, 01 Nov 2019 20:36:01 -0400 Original-Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id AA850160172 for ; Fri, 1 Nov 2019 17:35:55 -0700 (PDT) Original-Received: from zimbra.cs.ucla.edu ([127.0.0.1]) by localhost (zimbra.cs.ucla.edu [127.0.0.1]) (amavisd-new, port 10032) with ESMTP id WWr-HnV5Q-wU for ; Fri, 1 Nov 2019 17:35:54 -0700 (PDT) Original-Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id 3AA66160570 for ; Fri, 1 Nov 2019 17:35:54 -0700 (PDT) X-Virus-Scanned: amavisd-new at zimbra.cs.ucla.edu Original-Received: from zimbra.cs.ucla.edu ([127.0.0.1]) by localhost (zimbra.cs.ucla.edu [127.0.0.1]) (amavisd-new, port 10026) with ESMTP id PCyuJixxLKjo for ; Fri, 1 Nov 2019 17:35:54 -0700 (PDT) Original-Received: from Penguin.CS.UCLA.EDU (Penguin.CS.UCLA.EDU [131.179.64.200]) by zimbra.cs.ucla.edu (Postfix) with ESMTPSA id 1B7DC160172 for ; Fri, 1 Nov 2019 17:35:54 -0700 (PDT) Content-Language: en-US X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [fuzzy] X-Received-From: 131.179.128.68 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.23 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:241715 Archived-At: This is a multi-part message in MIME format. --------------2299B540EA117394CB05ACC2 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 7bit I noticed Glenn's comment at the start of doc/emacs/emacs.texi that EDITION (which was "Seventeenth") offers nothing that EMACSVER ("27.0.50") does not. I'd go further and say that it's a net minus, since it's confusing to have competing version numbers for the same thing. Although separating software version numbers from book edition numbers made sense in the old days when most users had only low-resolution displays and/or printers, nowadays the practice appears to be more trouble than it's worth. So I installed the attached patch, to switch the main Emacs manuals to simple version numbers like "27.0". Comments welcome. --------------2299B540EA117394CB05ACC2 Content-Type: text/x-patch; charset=UTF-8; name="0001-Omit-edition-numbers-and-dates-in-manuals.patch" Content-Disposition: attachment; filename="0001-Omit-edition-numbers-and-dates-in-manuals.patch" Content-Transfer-Encoding: quoted-printable >From d12c5c21c5aa143965e41e7cd6f8f4a62818e0b5 Mon Sep 17 00:00:00 2001 From: Paul Eggert Date: Fri, 1 Nov 2019 17:24:02 -0700 Subject: [PATCH] Omit edition numbers and dates in manuals MIME-Version: 1.0 Content-Type: text/plain; charset=3DUTF-8 Content-Transfer-Encoding: 8bit These seem to cause more confusion than they cure; e.g., https://shop.fsf.org/books/gnu-emacs-manual-18th-edition-v-261 currently advertises "18th edition" even as it points to https://www.gnu.org/software/emacs/manual/pdf/emacs.pdf which says "Seventeenth Edition". It is simpler and less confusing to stick to one version number like "26.3". If we need a separate edition number for each printed manual for some reason (marketing?) we can put =E2=80=9C@ifset printed-edition=E2=80= =9D around anything specific to the printed editions. (as opposed to online PDF copies). * doc/emacs/emacs.texi (EDITION): * doc/lispintro/emacs-lisp-intro.texi (edition-number, update-date): * doc/lispref/elisp.texi (VERSION, DATE): Remove, and remove uses. --- doc/emacs/emacs.texi | 20 +------------------- doc/lispintro/emacs-lisp-intro.texi | 7 ------- doc/lispref/elisp.texi | 13 +------------ 3 files changed, 2 insertions(+), 38 deletions(-) diff --git a/doc/emacs/emacs.texi b/doc/emacs/emacs.texi index a7967ecaee..678ccb9ba5 100644 --- a/doc/emacs/emacs.texi +++ b/doc/emacs/emacs.texi @@ -3,28 +3,10 @@ @setfilename ../../info/emacs.info @settitle GNU Emacs Manual @include docstyle.texi - -@c The edition number appears in more than one place in this file -@c I don't really know what it means... -@c For example, it has said "Sixteenth" since sometime in the Emacs 22 -@c series, all through 23, and into 24. So it is not very useful IMO, -@c and offers nothing that EMACSVER does not. I guess it relates -@c mainly to the published book sold by the FSF. Hence no longer -@c bother including it except iftex. Really, I think it should not be -@c here at all (since anyone can make a pdf version), but should just -@c be something added by the FSF during the publishing process. -@c Also, the lispref uses a float (3.0), whereas this uses an ordinal, -@c so the format is not even consistent. -@set EDITION Seventeenth @include emacsver.texi =20 @copying -@iftex -This is the @value{EDITION} edition of the @cite{GNU Emacs Manual},@* -@end iftex -@ifnottex This is the @cite{GNU Emacs Manual}, -@end ifnottex updated for Emacs version @value{EMACSVER}. =20 Copyright @copyright{} 1985--1987, 1993--2019 Free Software Foundation, = Inc. @@ -82,7 +64,7 @@ @sp 6 @center @titlefont{GNU Emacs Manual} @sp 4 -@center @value{EDITION} Edition, Updated for Emacs Version @value{EMACSV= ER}. +@center Updated for Emacs Version @value{EMACSVER} @sp 5 @center Richard Stallman et al. @page diff --git a/doc/lispintro/emacs-lisp-intro.texi b/doc/lispintro/emacs-li= sp-intro.texi index 489ba8d6ef..9ad4cf102e 100644 --- a/doc/lispintro/emacs-lisp-intro.texi +++ b/doc/lispintro/emacs-lisp-intro.texi @@ -63,10 +63,6 @@ \global\hbadness=3D6666 % don't worry about not-too-underfull boxes @end tex =20 -@c These refer to the printed book sold by the FSF. -@set edition-number 3.10 -@set update-date 28 October 2009 - @c For next or subsequent edition: @c create function using with-output-to-temp-buffer @c create a major mode, with keymaps @@ -106,9 +102,6 @@ This is @cite{An Introduction to Programming in Emacs Lisp}, for people who are not programmers. @sp 1 -@iftex -Edition @value{edition-number}, @value{update-date} -@end iftex @ifnottex Distributed with Emacs version @value{EMACSVER}. @end ifnottex diff --git a/doc/lispref/elisp.texi b/doc/lispref/elisp.texi index d667c51d78..652175c395 100644 --- a/doc/lispref/elisp.texi +++ b/doc/lispref/elisp.texi @@ -52,12 +52,7 @@ @end ifset @end tex =20 - -@c Version of the manual and of Emacs. -@c (See comments for EDITION in emacs.texi) -@set VERSION 3.1 @include emacsver.texi -@set DATE October 2014 =20 @c in general, keep the following line commented out, unless doing a @c copy of this manual that will be published. The manual should go @@ -91,12 +86,7 @@ @c @syncodeindex tp fn =20 @copying -@iftex -This is edition @value{VERSION} of the @cite{GNU Emacs Lisp Reference Ma= nual},@* -@end iftex -@ifnottex -This is the @cite{GNU Emacs Lisp Reference Manual} -@end ifnottex +This is the @cite{GNU Emacs Lisp Reference Manual}, corresponding to Emacs version @value{EMACSVER}. =20 Copyright @copyright{} 1990--1996, 1998--2019 Free Software Foundation, = Inc. @@ -127,7 +117,6 @@ @subtitle @value{voltitle} @end ifset @subtitle For Emacs Version @value{EMACSVER} -@subtitle Revision @value{VERSION}, @value{DATE} =20 @author by Bil Lewis, Dan LaLiberte, Richard Stallman, @author the GNU Manual Group, et al. --=20 2.23.0 --------------2299B540EA117394CB05ACC2--