]> git.ipfire.org Git - thirdparty/gcc.git/commitdiff
Clean up references to Subversion in documentation sources.
authorEric S. Raymond <esr@thyrsus.com>
Mon, 20 Jan 2020 02:10:52 +0000 (18:10 -0800)
committerSandra Loosemore <sandra@codesourcery.com>
Mon, 20 Jan 2020 02:10:52 +0000 (18:10 -0800)
Clean up references to SVN in in the GCC docs, redirecting to Git
documentation as appropriate.

Where references to "the source code repository" rather than a
specific VCS make sense, I have used them. You might, after
all, change VCSes again someday.

I have not modified either generated HTML files nor maintainer scripts.
These changes should be complete with repect to the documentation tree.

2020-01-19  Eric S. Raymond <esr@thyrsus.com>
    Sandra Loosemore  <sandra@codesourcery.com>

Partial backport from mainline:

2020-01-19  Eric S. Raymond <esr@thyrsus.com>

gcc/
* doc/contribute.texi: Update for SVN -> Git transition.
* doc/install.texi: Likewise.

libstdc++-v3
* doc/xml/faq.xml: Update for SVN -> Git transition.
* doc/xml/manual/appendix_contributing.xml: Likewise.

gcc/ChangeLog
gcc/doc/contribute.texi
gcc/doc/install.texi
libstdc++-v3/ChangeLog
libstdc++-v3/doc/xml/faq.xml
libstdc++-v3/doc/xml/manual/appendix_contributing.xml

index 4a3e06a3819acd4a8ab64a32cc12145afb44b46d..47c1876dc9c203e08c5d53bebc0210c5d969eeac 100644 (file)
@@ -1,3 +1,13 @@
+2020-01-19  Eric S. Raymond <esr@thyrsus.com>
+           Sandra Loosemore  <sandra@codesourcery.com>
+
+       Backport from mainline:
+
+       2020-01-19  Eric S. Raymond <esr@thyrsus.com>
+
+       * doc/contribute.texi: Update for SVN -> Git transition.
+       * doc/install.texi: Likewise.
+
 2020-01-15  Uroš Bizjak  <ubizjak@gmail.com>
 
        PR target/93254
index bc3d209630dfa468828d2ae8adc87b30a1102f82..039cc6eed9cea1052a7fdd4a108dde842448c4d3 100644 (file)
@@ -6,8 +6,8 @@
 @chapter Contributing to GCC Development
 
 If you would like to help pretest GCC releases to assure they work well,
-current development sources are available by SVN (see
-@uref{http://gcc.gnu.org/svn.html}).  Source and binary snapshots are
+current development sources are available via Git (see
+@uref{http://gcc.gnu.org/git.html}).  Source and binary snapshots are
 also available for FTP; see @uref{http://gcc.gnu.org/snapshots.html}.
 
 If you would like to work on improvements to GCC, please read the
index 78a59e6b21c139e1659fc8785f91c4b793b88fdf..d14a9a8dda3d703bf9cba72f2af739db9bc88bd0 100644 (file)
@@ -335,8 +335,9 @@ and up works.
 Necessary when regenerating @file{Makefile} dependencies in libiberty.
 Necessary when regenerating @file{libiberty/functions.texi}.
 Necessary when generating manpages from Texinfo manuals.
-Used by various scripts to generate some files included in SVN (mainly
-Unicode-related and rarely changing) from source tables.
+Used by various scripts to generate some files included in the source
+repository (mainly Unicode-related and rarely changing) from source
+tables.
 
 Used by @command{automake}.
 
@@ -458,8 +459,8 @@ Necessary to regenerate the top level @file{Makefile.in} file from
 Necessary when modifying @file{*.l} files.
 
 Necessary to build GCC during development because the generated output
-files are not included in the SVN repository.  They are included in
-releases.
+files are not included in the version-controlled source repository.
+They are included in releases.
 
 @item Texinfo version 4.7 (or later)
 
@@ -471,7 +472,7 @@ create printable documentation in DVI or PDF format.  Texinfo version
 4.8 or later is required for @command{make pdf}.
 
 Necessary to build GCC documentation during development because the
-generated output files are not included in the SVN repository.  They are
+generated output files are not included in the repository.  They are
 included in releases.
 
 @item @TeX{} (any working version)
@@ -485,11 +486,11 @@ DVI or PDF files, respectively.
 Necessary to regenerate @file{jit/docs/_build/texinfo} from the @file{.rst}
 files in the directories below @file{jit/docs}.
 
-@item SVN (any version)
+@item git (any version)
 @itemx SSH (any version)
 
-Necessary to access the SVN repository.  Public releases and weekly
-snapshots of the development sources are also available via FTP@.
+Necessary to access the source repository.  Public releases and weekly
+snapshots of the development sources are also available via HTTPS@.
 
 @item GNU diffutils version 2.7 (or later)
 
@@ -523,9 +524,8 @@ own sources.
 @cindex Downloading GCC
 @cindex Downloading the Source
 
-GCC is distributed via @uref{http://gcc.gnu.org/svn.html,,SVN} and FTP
-tarballs compressed with @command{gzip} or
-@command{bzip2}.
+GCC is distributed via @uref{http://gcc.gnu.org/git.html,,git} and via
+HTTPS as tarballs compressed with @command{gzip} or @command{bzip2}.
 
 Please refer to the @uref{http://gcc.gnu.org/releases.html,,releases web page}
 for information on how to obtain GCC@.
@@ -583,9 +583,10 @@ for both native and cross targets.
 We use @var{srcdir} to refer to the toplevel source directory for
 GCC; we use @var{objdir} to refer to the toplevel build/object directory.
 
-If you obtained the sources via SVN, @var{srcdir} must refer to the top
-@file{gcc} directory, the one where the @file{MAINTAINERS} file can be
-found, and not its @file{gcc} subdirectory, otherwise the build will fail.
+If you obtained the sources by cloning the repository, @var{srcdir}
+must refer to the top @file{gcc} directory, the one where the
+@file{MAINTAINERS} file can be found, and not its @file{gcc}
+subdirectory, otherwise the build will fail.
 
 If either @var{srcdir} or @var{objdir} is located on an automounted NFS
 file system, the shell's built-in @command{pwd} command will return
@@ -1512,7 +1513,7 @@ with @option{--enable-bootstrap}.
 @item --enable-generated-files-in-srcdir
 Neither the .c and .h files that are generated from Bison and flex nor the
 info manuals and man pages that are built from the .texi files are present
-in the SVN development tree.  When building GCC from that development tree,
+in the repository development tree.  When building GCC from that development tree,
 or from one of our snapshots, those generated files are placed in your
 build directory, which allows for the source to be in a readonly
 directory.
@@ -1812,7 +1813,7 @@ consistency checks of the requested complexity.  This does not change the
 generated code, but adds error checking within the compiler.  This will
 slow down the compiler and may only work properly if you are building
 the compiler with GCC@.  This is @samp{yes,extra} by default when building
-from SVN or snapshots, but @samp{release} for releases.  The default
+from the source repository or snapshots, but @samp{release} for releases.  The default
 for building the stage1 compiler is @samp{yes}.  More control
 over the checks may be had by specifying @var{list}.  The categories of
 checks available are @samp{yes} (most common checks
@@ -2408,7 +2409,7 @@ that type mismatches occur, this could be the cause.
 
 The solution is not to use such a directory for building GCC@.
 
-Similarly, when building from SVN or snapshots, or if you modify
+Similarly, when building from the source repository or snapshots, or if you modify
 @file{*.l} files, you need the Flex lexical analyzer generator
 installed.  If you do not modify @file{*.l} files, releases contain
 the Flex-generated files and you do not need Flex installed to build
@@ -2416,7 +2417,7 @@ them.  There is still one Flex-based lexical analyzer (part of the
 build machinery, not of GCC itself) that is used even if you only
 build the C front end.
 
-When building from SVN or snapshots, or if you modify Texinfo
+When building from the source repository or snapshots, or if you modify Texinfo
 documentation, you need version 4.7 or later of Texinfo installed if you
 want Info documentation to be regenerated.  Releases contain Info
 documentation pre-built for the unmodified documentation in the release.
index 4eaa8f265dd1cbddacf78bc62a7cb571bc56a928..c80447757a9e2075e0123dd40d695399df29c8f6 100644 (file)
@@ -1,3 +1,12 @@
+2020-01-19  Eric S. Raymond <esr@thyrsus.com>
+           Sandra Loosemore  <sandra@codesourcery.com>
+
+       Partial backport from mainline:
+
+       2020-01-19  Eric S. Raymond <esr@thyrsus.com>
+       * doc/xml/faq.xml: Update for SVN -> Git transition.
+       * doc/xml/manual/appendix_contributing.xml: Likewise.
+
 2020-01-13  Jonathan Wakely  <jwakely@redhat.com>
 
        Backport from mainlne
index b4bf333e26ad24a1e70602186711dc5947c6d1cc..21c312dce35fbb62ccefd5831d29810095fb07ba 100644 (file)
@@ -34,9 +34,8 @@
      clauses 20 through 33 and annex D (prior to the 2017 standard
      the library clauses started with 17).  For those who want to see
      exactly how far the project has come, or just want the latest
-     bleeding-edge code, the up-to-date source is available over
-     anonymous SVN, and can be browsed over the
-     <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="https://gcc.gnu.org/svn.html">web</link>.
+     bleeding-edge code, the up-to-date source , and can be cloned via Git: see
+     <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="https://gcc.gnu.org/git.html">web</link>.
     </para> 
 
     <para>
     Current libstdc++ sources can always be checked out of the main
     GCC source repository using the appropriate version control
     tool. At this time, that tool
-    is <application>Subversion</application>.
+    is <application>Git</application>.
     </para>
     <para>
-    <application>Subversion</application>, or <acronym>SVN</acronym>, is
-    one of several revision control packages.  It was selected for GNU
-    projects because it's free (speech), free (beer), and very high
-    quality.  The <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://subversion.tigris.org"> Subversion
-    home page</link> has a better description.
-    </para>
-    <para>
-    The <quote>anonymous client checkout</quote> feature of SVN is
-    similar to anonymous FTP in that it allows anyone to retrieve
-    the latest libstdc++ sources.
-    </para> 
-    <para>
     For more information
-    see <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="https://gcc.gnu.org/svn.html"><acronym>SVN</acronym>
+    see <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="https://gcc.gnu.org/git.html">
     details</link>.
     </para>
   </answer>
index 41335475f3b17aaeaca39ed2a64b74661f5ea12d..a049d7d91adfcc886a9be99f29cbde68848766f3 100644 (file)
 
       <listitem>
        <para>
-         The patch itself. If you are accessing the SVN
-         repository use <command>svn update; svn diff NEW</command>;
+         The patch itself. If you are accessing the Git
+         repository use <command>git pull; git diff &gt;NEW</command>;
          else, use <command>diff -cp OLD NEW</command> ... If your
          version of diff does not support these options, then get the
-         latest version of GNU
-         diff. The <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://gcc.gnu.org/wiki/SvnTricks">SVN
-         Tricks</link> wiki page has information on customising the
-         output of <code>svn diff</code>.
+         latest version of GNU diff.
        </para>
       </listitem>