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: Thu, 14 Nov 2019 14:18:05 +0200 Message-ID: <834kz67ite.fsf@gnu.org> References: <87h83brvxg.fsf@wjsullivan.net> <0a820310-d4ce-d9ab-32b0-5d22c00d2122@cs.ucla.edu> <87sgmvozz9.fsf@wjsullivan.net> Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="225604"; 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 Thu Nov 14 13:18:35 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 1iVE54-000wWi-Tj for ged-emacs-devel@m.gmane.org; Thu, 14 Nov 2019 13:18:35 +0100 Original-Received: from localhost ([::1]:56710 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iVE52-0006li-TD for ged-emacs-devel@m.gmane.org; Thu, 14 Nov 2019 07:18:32 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:44513) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1iVE4s-0006kf-3D for emacs-devel@gnu.org; Thu, 14 Nov 2019 07:18:23 -0500 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:49317) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1iVE4r-0007Oq-Io; Thu, 14 Nov 2019 07:18:21 -0500 Original-Received: from [176.228.60.248] (port=1780 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1iVE4q-0006mt-Tu; Thu, 14 Nov 2019 07:18:21 -0500 In-reply-to: (message from Paul Eggert on Tue, 12 Nov 2019 11:32:00 -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:242148 Archived-At: > From: Paul Eggert > Date: Tue, 12 Nov 2019 11:32:00 -0800 > Cc: Emacs development discussions > > On 11/10/19 7:26 PM, John Sullivan wrote: > > maybe the solution could be to have two online > > versions, one that corresponds to print and is only updated when a new > > print version is made, and the other is the one that the developers with > > each release or whenever they feel is appropriate? And that latter > > version would not have any edition number. We wouldn't have any problem > > with the primary canonical manual link > > (https://www.gnu.org/software/emacs/manual/emacs.html) being used for > > the online-only version. What do you think? I didn't see John's response, not sure why. Can someone forward it to me? > Sounds good. This can be done by Texinfo flags, which are set for the > printed version and generate an edition number, and are clear for the > canonical online/info manual and do not generate an edition number. I > installed the attached patch into the GNU Emacs master to do this. We > can tweak it as needed later. Sigh... John said "WDYT", which assumed discussion, not an immediate commit... In any case, I'm not sure John was suggesting that someone will have to manually type a texi2any command. I think at the very least 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. Please note that such a command will have to be run to generate the on-line manual we have on the Web site. The fact that some manuals use EDITION while others use VERSION also doesn't make this very clean, IMO. I'd also like to hear John's opinion about this solution. Thanks.