From b33cdf726c2fe81ac43b89af795b52224f8c38ae Mon Sep 17 00:00:00 2001 From: Glenn Morris Date: Sun, 16 Jun 2019 15:25:19 -0700 Subject: [PATCH] ; Update admin notes re web pages --- admin/make-tarball.txt | 4 +--- admin/notes/www | 38 ++++++++++++++++++++++++++++++++++++++ 2 files changed, 39 insertions(+), 3 deletions(-) diff --git a/admin/make-tarball.txt b/admin/make-tarball.txt index 43992a0bb2b..64c61705f4c 100644 --- a/admin/make-tarball.txt +++ b/admin/make-tarball.txt @@ -194,9 +194,7 @@ General steps (for each step, check for possible errors): UPDATING THE EMACS WEB PAGES AFTER A RELEASE As soon as possible after a release, the Emacs web pages should be updated. -Anyone with write access to the Emacs code repository can do this. -For instructions, see . -Changes go live more or less as soon as they are committed. +(See admin/notes/www for general information.) The pages to update are: diff --git a/admin/notes/www b/admin/notes/www index ed2349d9667..9ff25cb20ac 100644 --- a/admin/notes/www +++ b/admin/notes/www @@ -5,6 +5,29 @@ See the end of the file for license conditions. NOTES FOR EMACS WWW PAGES +* Access + +Anyone with write access to the Emacs code repository has the same +access to the web pages. See +for instructions. After you commit a change to the CVS repository, +it normally appears automatically on www.gnu.org within a few minutes. +The basic procedure is: + +Initial checkout: +cvs -z3 -d:ext:@cvs.savannah.gnu.org:/web/emacs co emacs + +Update from repository: +cvs up -dP + +You can use Emacs's VC mode to commit files without having to worry +about knowing CVS syntax. You may find M-x cvs-examine a useful, +more specialized, alternative to M-x vc-dir. + +* Manual pages + +The scripts admin/make-manuals, admin/upload-manuals can be used to do +a complete update of the on-line manual pages (eg after a release). + * Renaming pages, redirects Sometimes you want to move a page to a new location. @@ -64,6 +87,21 @@ work; see manual/.htaccess in the repository. You only have to add a single redirect for every given external manual, you can redirect html_node to hmtl_node and html_mono to html_mono. +* Why CVS? + +Savannah supports other VCS, and no-one is especially attached to CVS. +Rather, CVS is the only supported mechanism for getting the changes +onto www.gnu.org. See eg +https://lists.gnu.org/r/bug-gnulib/2012-12/msg00072.html + +* CVS alternatives + +To use something other than CVS, convert the web-pages CVS repository +to the other VCS, then set up a two-way sync between them. +It needs to be two-way in case eg GNU webmasters make a change to the CVS. +Ref eg +https://github.com/mikjo/bigitr +https://lists.gnu.org/r/savannah-hackers-public/2013-04/msg00022.html This file is part of GNU Emacs. -- 2.39.2