From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Stefan Kangas Newsgroups: gmane.emacs.devel Subject: Re: Generate NEWS.XX.Y.html file for Emacs website Date: Thu, 15 Sep 2022 13:45:31 -0400 Message-ID: References: <83h718zszj.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="17881"; mail-complaints-to="usenet@ciao.gmane.io" Cc: emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Thu Sep 15 19:47:25 2022 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1oYsxQ-0004VD-MC for ged-emacs-devel@m.gmane-mx.org; Thu, 15 Sep 2022 19:47:24 +0200 Original-Received: from localhost ([::1]:54592 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1oYsxP-0001nl-9k for ged-emacs-devel@m.gmane-mx.org; Thu, 15 Sep 2022 13:47:23 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:50768) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oYsvj-00015M-Oo for emacs-devel@gnu.org; Thu, 15 Sep 2022 13:45:40 -0400 Original-Received: from mail-ot1-x32c.google.com ([2607:f8b0:4864:20::32c]:36673) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1oYsvd-0000Oj-Ei; Thu, 15 Sep 2022 13:45:36 -0400 Original-Received: by mail-ot1-x32c.google.com with SMTP id w10-20020a056830410a00b00655d70a1aeaso683441ott.3; Thu, 15 Sep 2022 10:45:32 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=cc:to:subject:message-id:date:mime-version:references:in-reply-to :from:from:to:cc:subject:date; bh=4iwudQwoeXh5C1FcHAQgquoN5fm9HY3OGNx0Lulu6J8=; b=isHwXHTS1ZziYidz1CmlKy3C4WmzJv+qi62rJbMw284P+RgIqs5Iosg1ujc8drQw00 9OQyG+rTMgWDgNDa9Gqp32fixVzK32u6Zgq+eVDYehUUh3Wu8Gp8AkJfXyjrgP1GS/WM g+RFVUyHdpd8kaa7Zk2Y46lB2roA18gx3ceGf0wLeZXksFclV2bZ+eb0BhTq4srFwUzp od9xEliFijBjANfHlbda6ZQAIWYq3TzmF51ZuHCQVHLlz5BTY2W+iuxUTpWcWdtBNyyx v5DILBd6m8IWsaIet1zma4wpaHTpjVoY+NdJhkvHdvsd/XlZUDUvQi1Y6rSg/tj1133B HoSQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=cc:to:subject:message-id:date:mime-version:references:in-reply-to :from:x-gm-message-state:from:to:cc:subject:date; bh=4iwudQwoeXh5C1FcHAQgquoN5fm9HY3OGNx0Lulu6J8=; b=Wnvr2MY8BG87rd68aQCBHboo4GtLHACv3yc7RKXD11CFwkgt0HKIWJ/VfrU2XEttr3 eISHnfPP4F2kS78kCiMmO+1jaME1IPByzRE1D+Dr5NQ8PMX9rF4VkFqvZLQXW9u5ULmR MQ+iYO3iCSfzD5Ov/ttsZ8RrTuZfIxJVGk2h2vMQKOePrGfE88KiMeA7YRAiCcyDcwEY cI2Fzqg5Y7AtpUeDz3NEOwi02Joj4E7sBSSPh8NSbWgmS/vWrLGgjDoAHDLTA3islLL0 nUFAuqQnWzPVbms5Jzsvc80arH1ijvCbNdLP9NZcz8UiE+pxWSDmVJNbxaB2oGB5/oX8 obGA== X-Gm-Message-State: ACrzQf1vMBTk+LIhkqbdujL554OzJLWOJtNOj6VZJqONFBnerlscckKh 9gGgcvhniq3PEmECgza+uOrK4zYoGGKpsTso3k7bA2xO X-Google-Smtp-Source: AMsMyM6O+AKBI6KBb3qravbek6gS+KTMrV4WIlO4ADmqLOSfvOQAl0cAWy0Mf52oSGLBZ7viWmr77h0Sybug3s/x2I8= X-Received: by 2002:a9d:7c89:0:b0:655:dfb1:331c with SMTP id q9-20020a9d7c89000000b00655dfb1331cmr398361otn.224.1663263931839; Thu, 15 Sep 2022 10:45:31 -0700 (PDT) Original-Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Thu, 15 Sep 2022 13:45:31 -0400 In-Reply-To: <83h718zszj.fsf@gnu.org> X-Hashcash: 1:20:220915:eliz@gnu.org::+PSSoNnlmIXQddoM:68jS Received-SPF: pass client-ip=2607:f8b0:4864:20::32c; envelope-from=stefankangas@gmail.com; helo=mail-ot1-x32c.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.29 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-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:295437 Archived-At: Eli Zaretskii writes: > I see that you changed admin.el on master, which means Emacs 28.x will > be unable to use this? I pushed it to emacs-28 (as this is only in admin/admin.el and doesn't touch anything else). So we can use it on Emacs 28.2, and that's what I did to generate the HTML file I posted. > In any case, if we want the above to be part of updating the Emacs Web > site and the on-line manuals, those commands will need to be part of > the scripts that are used for those jobs, or maybe a separate script. Indeed. I will work on it, as well as updating the relevant docs. >> > Also, how will this HTML version be maintained, after it is produced. >> >> The easiest option is to just leave the old generated HTML files alone >> and update them only if absolutely necessary. > > I meant to ask how will we keep them under VCS (CVS in this case). I might be missing some context here, because I don't think I understand what you're asking. Do we need to do anything else besides copying them in place (to "news/NEWS.NN.Y.html") and running "cvs update"? >> But it'd be better if we could generate HTML versions of all etc/NEWS.* >> files whenever we make a new release. > > Each time we make a new release, or just once? We could decide which way we want to go with it. I imagine that the template could change over time, so it might be nice to do it every time we make a release (but we'd need to automate it). On the other hand, it might save us some work if we only do it once. >> I didn't yet look into this, so I don't know how realistic this is, >> but I have a hunch that it's doable. Maybe we will only be able to >> do it for releases newer than Emacs 21 (or something) though. > > Do we have links for those older NEWS files on the Web site? If not, > I see no point in generating NEWS in HTML format for old releases. The only benefit I see is that you could then edit the URL to visit the pages for older releases. I think Karl Fogel pointed out this use case, and it's definitely something I have done in the past too. But I'm not sure it's very important. We could perhaps do it if it turns out to be only a very small amount of work.