RFC: gdb web page patch for git conversion

Tom Tromey
2013-08-29T20:15:48Z

Here's the patch I came up with for converting the gdb web pages to git.

Much of this is boilerplate from re-running index.sh.

Let me know what you think. As I explained on the binutils list, the
goal of sending these patches early is to get all the issues worked out
so that the actual switch can proceed as smoothly as possible.

I vaguely remember that there is some other crucial step after
committing, maybe in order to push the changes to the FSF? I don't
remember any details about it; so if you know, please respond.

Tom

Index: index.html
===================================================================
RCS file: /cvs/gdb/htdocs/index.html,v
retrieving revision 1.209
diff -u -r1.209 index.html
--- index.html 26 Apr 2013 13:53:19 -0000 1.209
+++ index.html 29 Aug 2013 20:15:22 -0000
@@ -27,7 +27,7 @@
[bugs]
[GDB Maintainers]
[contributing]
-[current cvs]
+[current git]
[documentation]
[download]
[home]
@@ -133,7 +133,7 @@
The GDB 7.6 branch ( gdb_7_6-branch ) has been created.
To check out a copy of the branch use:

-cvs -d :pserver:anoncvs@sourceware.org:/cvs/src co -r gdb_7_6-branch gdb
+git clone --branch gdb_7_6-branch git://sourceware.org/git/src.git



@@ -172,7 +172,7 @@

Late breaking information, such as recently added features, can be
found in the <a
-href="http://sourceware.org/cgi-bin/cvsweb.cgi/~checkout~/src/gdb/NEWS?content-type=text/x-cvsweb-markup&cvsroot=src"
+href="http://sourceware.org/git/gitweb.cgi?p=src.git;a=blob;f=gdb/NEWS;hb=HEAD"
>NEWS file in the gdb source tree. Old announcements are in the
news archive.

@@ -185,7 +185,7 @@
[bugs]
[GDB Maintainers]
[contributing]
-[current cvs]
+[current git]
[documentation]
[download]
[home]
@@ -217,7 +217,7 @@
Verbatim copying and distribution of this entire article is
permitted in any medium, provided this notice is preserved.

- Last modified 2013-04-26.
+ Last modified 2013-08-29.



Index: index.sh
===================================================================
RCS file: /cvs/gdb/htdocs/index.sh,v
retrieving revision 1.35
diff -u -r1.35 index.sh
--- index.sh 7 Nov 2012 16:51:05 -0000 1.35
+++ index.sh 29 Aug 2013 20:15:22 -0000
@@ -61,7 +61,7 @@
[bugs]
[GDB Maintainers]
[contributing]
-[current cvs]
+[current git]
[documentation]
[download]
[home]
Index: bugs/index.html
===================================================================
RCS file: /cvs/gdb/htdocs/bugs/index.html,v
retrieving revision 1.38
diff -u -r1.38 index.html
--- bugs/index.html 7 Nov 2012 16:51:04 -0000 1.38
+++ bugs/index.html 29 Aug 2013 20:15:23 -0000
@@ -27,7 +27,7 @@
[bugs]
[GDB Maintainers]
[contributing]
-[current cvs]
+[current git]
[documentation]
[download]
[home]
@@ -173,7 +173,7 @@
[bugs]
[GDB Maintainers]
[contributing]
-[current cvs]
+[current git]
[documentation]
[download]
[home]
@@ -205,7 +205,7 @@
Verbatim copying and distribution of this entire article is
permitted in any medium, provided this notice is preserved.

- Last modified 2012-11-07.
+ Last modified 2013-08-29.



Index: committee/index.html
===================================================================
RCS file: /cvs/gdb/htdocs/committee/index.html,v
retrieving revision 1.21
diff -u -r1.21 index.html
--- committee/index.html 7 Nov 2012 17:00:16 -0000 1.21
+++ committee/index.html 29 Aug 2013 20:15:23 -0000
@@ -27,7 +27,7 @@
[bugs]
[GDB Maintainers]
[contributing]
-[current cvs]
+[current git]
[documentation]
[download]
[home]
@@ -91,7 +91,7 @@
[bugs]
[GDB Maintainers]
[contributing]
-[current cvs]
+[current git]
[documentation]
[download]
[home]
@@ -123,7 +123,7 @@
Verbatim copying and distribution of this entire article is
permitted in any medium, provided this notice is preserved.

- Last modified 2012-11-07.
+ Last modified 2013-08-29.



Index: committee/release-manager.html
===================================================================
RCS file: /cvs/gdb/htdocs/committee/release-manager.html,v
retrieving revision 1.8
diff -u -r1.8 release-manager.html
--- committee/release-manager.html 7 Nov 2012 16:51:04 -0000 1.8
+++ committee/release-manager.html 29 Aug 2013 20:15:23 -0000
@@ -27,7 +27,7 @@
[bugs]
[GDB Maintainers]
[contributing]
-[current cvs]
+[current git]
[documentation]
[download]
[home]
@@ -97,7 +97,7 @@
[bugs]
[GDB Maintainers]
[contributing]
-[current cvs]
+[current git]
[documentation]
[download]
[home]
Index: contribute/index.html
===================================================================
RCS file: /cvs/gdb/htdocs/contribute/index.html,v
retrieving revision 1.31
diff -u -r1.31 index.html
--- contribute/index.html 7 Nov 2012 16:51:04 -0000 1.31
+++ contribute/index.html 29 Aug 2013 20:15:23 -0000
@@ -27,7 +27,7 @@
[bugs]
[GDB Maintainers]
[contributing]
-[current cvs]
+[current git]
[documentation]
[download]
[home]
@@ -55,7 +55,7 @@


See the file <a
-href="http://sourceware.org/cgi-bin/cvsweb.cgi/~checkout~/src/gdb/CONTRIBUTE?content-type=text/x-cvsweb-markup&cvsroot=src"
+href="http://sourceware.org/git/gitweb.cgi?p=src.git;a=blob;f=gdb/CONTRIBUTE;hb=HEAD"
> CONTRIBUTE in the GDB directory for how to submit patches and
contribute new files to GDB.

@@ -78,7 +78,7 @@
[bugs]
[GDB Maintainers]
[contributing]
-[current cvs]
+[current git]
[documentation]
[download]
[home]
@@ -110,7 +110,7 @@
Verbatim copying and distribution of this entire article is
permitted in any medium, provided this notice is preserved.

- Last modified 2012-11-07.
+ Last modified 2013-08-29.



Index: current/index.html
===================================================================
RCS file: /cvs/gdb/htdocs/current/index.html,v
retrieving revision 1.45
diff -u -r1.45 index.html
--- current/index.html 7 Nov 2012 16:51:04 -0000 1.45
+++ current/index.html 29 Aug 2013 20:15:23 -0000
@@ -27,7 +27,7 @@
[bugs]
[GDB Maintainers]
[contributing]
-[current cvs]
+[current git]
[documentation]
[download]
[home]
@@ -50,7 +50,7 @@

Source code

-The sources to GDB are available via FTP, CVS and WWW.
+The sources to GDB are available via FTP, git and WWW.

Since GDB's development process is iterative (continuous incremental
change) current development sources can be considered stable and are
@@ -62,106 +62,46 @@


- Read-only CVS:
+ Read-only git:

-Before your first access of the CVS repository you will need to login.
-Use the command:
+You can check out a copy of the git repository directly using the
+command:


-cvs -d :pserver:anoncvs@sourceware.org:/cvs/src login
-{enter "anoncvs" as the password}
+git clone git://sourceware.org/git/src.git


-A weekly snapshot (gdb-weekly-CVS-VERSION.YYYYMMDD.tar.bz2) of the
-sources checked out using CVS is available for download from the <a
-href="ftp://sourceware.org/pub/gdb/snapshots/current/"> current
-snapshot directory. The latest weekly snapshot is also accessible
-under gdb.tar.bz2. Since the archive is compressed using
-bzip2 it is the fastest
-and most efficient way of obtaining a read-only source tree under
-CVS.
-
-Once you have downloaded and unpacked this snapshot, you can
- cd to the src directory and use the command:
-
-
-cvs update
-
+ Read-write git (GDB developers only):

-to bring your sources up-to-date (see note above about login). Note
-though that new directories should not be checked out using
- cvs update -d (that will check out the entire repository),
-instead each new directory should e checked out individually using
- cvs update -d DIRECTORY .
+If you already have a read-only copy of git on hand then there is no
+need to re-check out a source tree. Instead, you can edit your
+.git/config to change the remote to use the read-write URL.

-Alternativly, you can check out a copy of the CVS repository directly
-using the command:
+For example, you might have:


-cvs -d :pserver:anoncvs@sourceware.org:/cvs/src co gdb
+[remote "origin"]
+ url = git://sourceware.org/git/src.git
+ fetch = +refs/heads/*:refs/remotes/origin/*


-Slow internet connection? Use cvs -z COMPRESSION-LEVEL -d
-... . The -z COMPRESSION-LEVEL causes CVS to compress
-files with gzip before
-transfering them. The option can either be specified on the command
-line or added to your ~/.cvsrc file.
-
-See the CVS home page for further
-information.
-
-
- Read-write CVS (GDB developers only):
-
-If you already have a read-only copy of CVS on hand then there is no
-need to re-check out a source tree. Instead a shell script like the
-below can be used to create a read-rewite source tree from a read-only
-tree:
+And you would edit this to use "ssh:" rather than "git:":


-#!/bin/sh -ex
-if test $# -ne 3
-then
- echo Usage: $0 source dest youraccount
-fi
-src=$1 ; shift
-dst=$1 ; shift
-acc=$1 ; shift
-
-# Copy the CVS repository to the new home
-( cd `dirname ${src}` && tar cf - `basename ${src}` ) \
- | ( cd ${dst} && tar xpf - )
-
-# Convert the copied CVS repository to read/write
-cd ${dst}
-find `basename ${src}` -name 'Root' -print | while read root
-do
- echo ":ext:${acc}@sourceware.org:/cvs/src" > $root
-done
+[remote "origin"]
+ url = ssh://sourceware.org/git/src.git
+ fetch = +refs/heads/*:refs/remotes/origin/*


Alternatively, to check out a new read-write copy of the repository,
-use a command sequence like:
+use:


-CVS_RSH=ssh ; export CVS_RSH
-cvs -d :ext:YOURACCOUNT@sourceware.org:/cvs/src co gdb
+git clone ssh://sourceware.org/git/src.git




- Read-only git:
-
-A read-only git mirror of GDB's repository is also available.
-This repository is not a real-time mirror, but is automatically
-resynchronized at regular intervals, currently every 30 minutes.
-
-To get a copy of that repository, use the following command:
-
-
-git clone git://sourceware.org/git/gdb.git
-
-
FTP:

A daily snapshot of the current development sources (<a
@@ -183,8 +123,8 @@

WWW:

-Browse the CVS repository via the web using the <a
-href="http://sourceware.org/cgi-bin/cvsweb.cgi/src/?cvsroot=src">CVSweb
+Browse the git repository via the web using the <a
+href="http://sourceware.org/git/gitweb.cgi?p=src.git">gitweb
interface.


@@ -244,7 +184,7 @@
[bugs]
[GDB Maintainers]
[contributing]
-[current cvs]
+[current git]
[documentation]
[download]
[home]
@@ -276,7 +216,7 @@
Verbatim copying and distribution of this entire article is
permitted in any medium, provided this notice is preserved.

- Last modified 2012-11-07.
+ Last modified 2013-08-29.



Index: documentation/index.html
===================================================================
RCS file: /cvs/gdb/htdocs/documentation/index.html,v
retrieving revision 1.47
diff -u -r1.47 index.html
--- documentation/index.html 7 Nov 2012 16:51:04 -0000 1.47
+++ documentation/index.html 29 Aug 2013 20:15:23 -0000
@@ -27,7 +27,7 @@
[bugs]
[GDB Maintainers]
[contributing]
-[current cvs]
+[current git]
[documentation]
[download]
[home]
@@ -201,7 +201,7 @@
[bugs]
[GDB Maintainers]
[contributing]
-[current cvs]
+[current git]
[documentation]
[download]
[home]
@@ -233,7 +233,7 @@
Verbatim copying and distribution of this entire article is
permitted in any medium, provided this notice is preserved.

- Last modified 2012-11-07.
+ Last modified 2013-08-29.



Index: download/index.html
===================================================================
RCS file: /cvs/gdb/htdocs/download/index.html,v
retrieving revision 1.61
diff -u -r1.61 index.html
--- download/index.html 26 Apr 2013 13:53:19 -0000 1.61
+++ download/index.html 29 Aug 2013 20:15:23 -0000
@@ -27,7 +27,7 @@
[bugs]
[GDB Maintainers]
[contributing]
-[current cvs]
+[current git]
[documentation]
[download]
[home]
@@ -66,7 +66,7 @@


Sources to the current development version are also available using
-FTP, CVS and WWW. See current.
+FTP, git and WWW. See current.

Ancient versions

@@ -91,7 +91,7 @@
[bugs]
[GDB Maintainers]
[contributing]
-[current cvs]
+[current git]
[documentation]
[download]
[home]
@@ -123,7 +123,7 @@
Verbatim copying and distribution of this entire article is
permitted in any medium, provided this notice is preserved.

- Last modified 2013-04-26.
+ Last modified 2013-08-29.



Index: irc/index.html
===================================================================
RCS file: /cvs/gdb/htdocs/irc/index.html,v
retrieving revision 1.2
diff -u -r1.2 index.html
--- irc/index.html 7 Nov 2012 16:51:05 -0000 1.2
+++ irc/index.html 29 Aug 2013 20:15:23 -0000
@@ -27,7 +27,7 @@
[bugs]
[GDB Maintainers]
[contributing]
-[current cvs]
+[current git]
[documentation]
[download]
[home]
@@ -60,7 +60,7 @@
[bugs]
[GDB Maintainers]
[contributing]
-[current cvs]
+[current git]
[documentation]
[download]
[home]
@@ -92,7 +92,7 @@
Verbatim copying and distribution of this entire article is
permitted in any medium, provided this notice is preserved.

- Last modified 2012-11-07.
+ Last modified 2013-08-29.



Index: links/index.html
===================================================================
RCS file: /cvs/gdb/htdocs/links/index.html,v
retrieving revision 1.40
diff -u -r1.40 index.html
--- links/index.html 7 Nov 2012 16:51:05 -0000 1.40
+++ links/index.html 29 Aug 2013 20:15:23 -0000
@@ -27,7 +27,7 @@
[bugs]
[GDB Maintainers]
[contributing]
-[current cvs]
+[current git]
[documentation]
[download]
[home]
@@ -163,7 +163,7 @@
[bugs]
[GDB Maintainers]
[contributing]
-[current cvs]
+[current git]
[documentation]
[download]
[home]
@@ -195,7 +195,7 @@
Verbatim copying and distribution of this entire article is
permitted in any medium, provided this notice is preserved.

- Last modified 2012-11-07.
+ Last modified 2013-08-29.



Index: mailing-lists/index.html
===================================================================
RCS file: /cvs/gdb/htdocs/mailing-lists/index.html,v
retrieving revision 1.38
diff -u -r1.38 index.html
--- mailing-lists/index.html 7 Nov 2012 16:51:05 -0000 1.38
+++ mailing-lists/index.html 29 Aug 2013 20:15:23 -0000
@@ -27,7 +27,7 @@
[bugs]
[GDB Maintainers]
[contributing]
-[current cvs]
+[current git]
[documentation]
[download]
[home]
@@ -84,13 +84,15 @@
results.


-gdb-cvs A read-only list for CVS commit messages
-from commits to the GDB CVS repository. Note that this list may be
-high volume from time to time.
+gdb-cvs A read-only list for git commit messages
+from commits to the GDB git repository. Note that this list may be
+high volume from time to time. It has an odd name for historical
+reasons.


-src-cvs A read-only list for CVS commit messages
-from the top-level files and shared directories.
+src-cvs A read-only list for git commit messages
+from the top-level files and shared directories. It has an odd
+name for historical reasons


gdbadmin A read-only list for cron log
@@ -142,7 +144,7 @@
[bugs]
[GDB Maintainers]
[contributing]
-[current cvs]
+[current git]
[documentation]
[download]
[home]
@@ -174,7 +176,7 @@
Verbatim copying and distribution of this entire article is
permitted in any medium, provided this notice is preserved.

- Last modified 2012-11-07.
+ Last modified 2013-08-29.



Index: mascot/index.html
===================================================================
RCS file: /cvs/gdb/htdocs/mascot/index.html,v
retrieving revision 1.19
diff -u -r1.19 index.html
--- mascot/index.html 7 Nov 2012 16:51:05 -0000 1.19
+++ mascot/index.html 29 Aug 2013 20:15:23 -0000
@@ -27,7 +27,7 @@
[bugs]
[GDB Maintainers]
[contributing]
-[current cvs]
+[current git]
[documentation]
[download]
[home]
@@ -76,7 +76,7 @@
[bugs]
[GDB Maintainers]
[contributing]
-[current cvs]
+[current git]
[documentation]
[download]
[home]
@@ -108,7 +108,7 @@
Verbatim copying and distribution of this entire article is
permitted in any medium, provided this notice is preserved.

- Last modified 2012-11-07.
+ Last modified 2013-08-29.



Index: news/index.html
===================================================================
RCS file: /cvs/gdb/htdocs/news/index.html,v
retrieving revision 1.109
diff -u -r1.109 index.html
--- news/index.html 26 Apr 2013 13:53:19 -0000 1.109
+++ news/index.html 29 Aug 2013 20:15:23 -0000
@@ -27,7 +27,7 @@
[bugs]
[GDB Maintainers]
[contributing]
-[current cvs]
+[current git]
[documentation]
[download]
[home]
@@ -1067,7 +1067,7 @@
[bugs]
[GDB Maintainers]
[contributing]
-[current cvs]
+[current git]
[documentation]
[download]
[home]
@@ -1099,7 +1099,7 @@
Verbatim copying and distribution of this entire article is
permitted in any medium, provided this notice is preserved.

- Last modified 2013-04-26.
+ Last modified 2013-08-29.



Index: news/reversible.html
===================================================================
RCS file: /cvs/gdb/htdocs/news/reversible.html,v
retrieving revision 1.10
diff -u -r1.10 reversible.html
--- news/reversible.html 7 Nov 2012 16:51:05 -0000 1.10
+++ news/reversible.html 29 Aug 2013 20:15:23 -0000
@@ -27,7 +27,7 @@
[bugs]
[GDB Maintainers]
[contributing]
-[current cvs]
+[current git]
[documentation]
[download]
[home]
@@ -139,7 +139,7 @@
[bugs]
[GDB Maintainers]
[contributing]
-[current cvs]
+[current git]
[documentation]
[download]
[home]
Index: papers/index.html
===================================================================
RCS file: /cvs/gdb/htdocs/papers/index.html,v
retrieving revision 1.36
diff -u -r1.36 index.html
--- papers/index.html 7 Nov 2012 16:51:05 -0000 1.36
+++ papers/index.html 29 Aug 2013 20:15:23 -0000
@@ -27,7 +27,7 @@
[bugs]
[GDB Maintainers]
[contributing]
-[current cvs]
+[current git]
[documentation]
[download]
[home]
@@ -64,7 +64,7 @@
[bugs]
[GDB Maintainers]
[contributing]
-[current cvs]
+[current git]
[documentation]
[download]
[home]
@@ -96,7 +96,7 @@
Verbatim copying and distribution of this entire article is
permitted in any medium, provided this notice is preserved.

- Last modified 2012-11-07.
+ Last modified 2013-08-29.



Index: schedule/index.html
===================================================================
RCS file: /cvs/gdb/htdocs/schedule/index.html,v
retrieving revision 1.58
diff -u -r1.58 index.html
--- schedule/index.html 26 Apr 2013 14:03:06 -0000 1.58
+++ schedule/index.html 29 Aug 2013 20:15:23 -0000
@@ -27,7 +27,7 @@
[bugs]
[GDB Maintainers]
[contributing]
-[current cvs]
+[current git]
[documentation]
[download]
[home]
@@ -200,7 +200,7 @@
[bugs]
[GDB Maintainers]
[contributing]
-[current cvs]
+[current git]
[documentation]
[download]
[home]
@@ -232,7 +232,7 @@
Verbatim copying and distribution of this entire article is
permitted in any medium, provided this notice is preserved.

- Last modified 2012-11-07.
+ Last modified 2013-08-29.



Index: song/index.html
===================================================================
RCS file: /cvs/gdb/htdocs/song/index.html,v
retrieving revision 1.23
diff -u -r1.23 index.html
--- song/index.html 7 Nov 2012 16:51:05 -0000 1.23
+++ song/index.html 29 Aug 2013 20:15:23 -0000
@@ -27,7 +27,7 @@
[bugs]
[GDB Maintainers]
[contributing]
-[current cvs]
+[current git]
[documentation]
[download]
[home]
@@ -73,7 +73,7 @@
[bugs]
[GDB Maintainers]
[contributing]
-[current cvs]
+[current git]
[documentation]
[download]
[home]
@@ -105,7 +105,7 @@
Verbatim copying and distribution of this entire article is
permitted in any medium, provided this notice is preserved.

- Last modified 2012-11-07.
+ Last modified 2013-08-29.



Index: talks/index.html
===================================================================
RCS file: /cvs/gdb/htdocs/talks/index.html,v
retrieving revision 1.29
diff -u -r1.29 index.html
--- talks/index.html 7 Nov 2012 16:51:05 -0000 1.29
+++ talks/index.html 29 Aug 2013 20:15:23 -0000
@@ -27,7 +27,7 @@
[bugs]
[GDB Maintainers]
[contributing]
-[current cvs]
+[current git]
[documentation]
[download]
[home]
@@ -65,7 +65,7 @@
[bugs]
[GDB Maintainers]
[contributing]
-[current cvs]
+[current git]
[documentation]
[download]
[home]
@@ -97,7 +97,7 @@
Verbatim copying and distribution of this entire article is
permitted in any medium, provided this notice is preserved.

- Last modified 2012-11-07.
+ Last modified 2013-08-29.



Index: testing/index.html
===================================================================
RCS file: /cvs/gdb/htdocs/testing/index.html,v
retrieving revision 1.29
diff -u -r1.29 index.html
--- testing/index.html 7 Nov 2012 16:51:05 -0000 1.29
+++ testing/index.html 29 Aug 2013 20:15:23 -0000
@@ -27,7 +27,7 @@
[bugs]
[GDB Maintainers]
[contributing]
-[current cvs]
+[current git]
[documentation]
[download]
[home]
@@ -64,7 +64,7 @@
[bugs]
[GDB Maintainers]
[contributing]
-[current cvs]
+[current git]
[documentation]
[download]
[home]
@@ -96,7 +96,7 @@
Verbatim copying and distribution of this entire article is
permitted in any medium, provided this notice is preserved.

- Last modified 2012-11-07.
+ Last modified 2013-08-29.