From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: Generate NEWS.XX.Y.html file for Emacs website Date: Thu, 15 Sep 2022 16:07:12 +0300 Message-ID: <83h718zszj.fsf@gnu.org> References: Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="7649"; mail-complaints-to="usenet@ciao.gmane.io" Cc: emacs-devel@gnu.org To: Stefan Kangas Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Thu Sep 15 15:11:02 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 1oYodx-0001oP-O0 for ged-emacs-devel@m.gmane-mx.org; Thu, 15 Sep 2022 15:11:01 +0200 Original-Received: from localhost ([::1]:37698 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1oYodw-00066S-7s for ged-emacs-devel@m.gmane-mx.org; Thu, 15 Sep 2022 09:11:00 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:36866) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oYoaP-0004xE-DC for emacs-devel@gnu.org; Thu, 15 Sep 2022 09:07:27 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:53362) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oYoaP-0007EX-4P; Thu, 15 Sep 2022 09:07:21 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=5Klois9beXEUuoTtAHW+pF3ZHQlJwQIkj0US+N5RM3Y=; b=FqUUeFkhkEY1 PSvhBkhLHjh089dfqFyl5UoTIQol9PgRN9xjrU/s64EXbH6ZCsIfS3OT8N+WaA0FADccEeCErPvzU OgeLkQRNtEpTJtv65PpNmruUnwR6sAdAARm6gctFdX6xgzBgUEzvZHijQbbm/69i2vfUhWQR+SVhg uIEMOqSUrFI5zTgZWCcJU0f1foVgkjBxEcOuNRGGDgThqXPyUPOgS6g164bKHNpvs3mWL+o4QqRUT 0w2NkPv+AdwdwGJyNs8J7f+73fZ2tIg+DCUEhibOaRO8UmEhi0ruvTsdwXaSfjtXFbE2xihOqeqeP t2mXJAmKrXfwuMs2+IrbSg==; Original-Received: from [87.69.77.57] (port=1088 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oYoaN-0000I5-UM; Thu, 15 Sep 2022 09:07:20 -0400 In-Reply-To: (message from Stefan Kangas on Thu, 15 Sep 2022 01:39:44 -0700) 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:295415 Archived-At: > From: Stefan Kangas > Date: Thu, 15 Sep 2022 01:39:44 -0700 > > > [P]lease describe what is needed (which commands and packages, and how > > to use them) to produce this HTML version. > > The command is: > > ./src/emacs -l admin/admin.el -f make-news-html-file > mv etc/NEWS.XX.Y.html $EMACS_WEBROOT/news > cd $EMACS_WEBROOT > cvs commit -m "Update NEWS.XX.Y.html" news/NEWS.XX.Y.html > > Please see `make-news-html-file' in admin/admin.el for more details. I see that you changed admin.el on master, which means Emacs 28.x will be unable to use this? 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. > > 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). > 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? > 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.