From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: Fwd: version vs edition numbers in Emacs manuals Date: Fri, 15 Nov 2019 11:29:31 +0200 Message-ID: <83tv7532tg.fsf@gnu.org> References: <87h83brvxg.fsf@wjsullivan.net> <0a820310-d4ce-d9ab-32b0-5d22c00d2122@cs.ucla.edu> <87sgmvozz9.fsf@wjsullivan.net> <834kz67ite.fsf@gnu.org> <9f91d45c-d1c9-da2d-c4bf-20f22e4a59bb@cs.ucla.edu> Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="173727"; mail-complaints-to="usenet@blaine.gmane.org" Cc: johns@fsf.org, emacs-devel@gnu.org To: Paul Eggert Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Nov 15 10:30:45 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 1iVXwD-000j1e-MP for ged-emacs-devel@m.gmane.org; Fri, 15 Nov 2019 10:30:45 +0100 Original-Received: from localhost ([::1]:36962 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iVXwC-0005sW-Dy for ged-emacs-devel@m.gmane.org; Fri, 15 Nov 2019 04:30:44 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:50240) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iVXvH-0005nM-9R for emacs-devel@gnu.org; Fri, 15 Nov 2019 04:29:48 -0500 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:41757) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1iVXvG-0007uc-Ti; Fri, 15 Nov 2019 04:29:46 -0500 Original-Received: from [176.228.60.248] (port=4453 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1iVXvG-0007T2-7i; Fri, 15 Nov 2019 04:29:46 -0500 In-reply-to: <9f91d45c-d1c9-da2d-c4bf-20f22e4a59bb@cs.ucla.edu> (message from Paul Eggert on Thu, 14 Nov 2019 11:42:09 -0800) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] 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:242222 Archived-At: > Cc: johns@fsf.org, emacs-devel@gnu.org > From: Paul Eggert > Date: Thu, 14 Nov 2019 11:42:09 -0800 > > On 11/14/19 4:18 AM, Eli Zaretskii wrote: > > > I didn't see John's response, not sure why. Can someone forward it to > > me? > > Sure, here it is: Thanks. > > we should have a separate target in the Makefile, and we should maintain > > the last printed edition in some separate file, because no one will > > remember that otherwise. > > A separate Makefile target would be fine, but the separate file should > be something that the FSF Press maintains. How will that work in practice? Isn't the printed version built by using our Makefile's and our build infrastructure? Then how can this file be kept separate, and how will it be maintained to be available when needed? > The FSF Press is downstream from developers, they generate edition > numbers at their convenience not developers', and they can and > should be the ones who keep track of the edition numbers that they > maintain. Fine with me if that works. But we must somehow make sure this knowledge doesn't get lost. Whoever prepares a manual for printing should be aware that they need to do something that isn't already done in the Emacs sources. Maybe a simple README in those directories could be the solution, e.g. if its name was indicative of its being a necessary read when a manual is being prepared for printing. Thoughts. > > The fact that some manuals use EDITION while others use VERSION also > > doesn't make this very clean, IMO. > > Yes, that area could easily be made more systematic. For example, we > could systematically use just EDITION and DATE for all the FSF > Press-maintained info. I'd like that, yes.