From f4d83eba60b5b1292a7cae660f03a2377e92a845 Mon Sep 17 00:00:00 2001 From: "Eric S. Raymond" Date: Sun, 19 Jan 2020 17:12:29 -0800 Subject: [PATCH] Clean up references to Subversion in documentation sources. 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 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. * doc/xml/manual/status_cxx1998.xml: Likewise. * doc/xml/manual/status_cxx2011.xml: Likewise. * doc/xml/manual/status_cxx2014.xml: Likewise. * doc/xml/manual/status_cxx2017.xml: Likewise. * doc/xml/manual/status_cxx2020.xml: Likewise. * doc/xml/manual/status_cxxtr1.xml: Likewise. * doc/xml/manual/status_cxxtr24733.xml: Likewise. --- gcc/ChangeLog | 5 +++ gcc/doc/contribute.texi | 4 +-- gcc/doc/install.texi | 32 ++++++++++--------- libstdc++-v3/ChangeLog | 12 +++++++ libstdc++-v3/doc/xml/faq.xml | 21 +++--------- .../doc/xml/manual/appendix_contributing.xml | 9 ++---- .../doc/xml/manual/status_cxx1998.xml | 2 +- .../doc/xml/manual/status_cxx2011.xml | 2 +- .../doc/xml/manual/status_cxx2014.xml | 2 +- .../doc/xml/manual/status_cxx2017.xml | 2 +- .../doc/xml/manual/status_cxx2020.xml | 2 +- libstdc++-v3/doc/xml/manual/status_cxxtr1.xml | 2 +- .../doc/xml/manual/status_cxxtr24733.xml | 2 +- 13 files changed, 50 insertions(+), 47 deletions(-) diff --git a/gcc/ChangeLog b/gcc/ChangeLog index a50847992f9..b6758fe479a 100644 --- a/gcc/ChangeLog +++ b/gcc/ChangeLog @@ -1,3 +1,8 @@ +2020-01-19 Eric S. Raymond + + * doc/contribute.texi: Update for SVN -> Git transition. + * doc/install.texi: Likewise. + 2020-01-18 Jan Hubicka PR lto/93318 diff --git a/gcc/doc/contribute.texi b/gcc/doc/contribute.texi index 3c711554419..b0b3b44b6a7 100644 --- a/gcc/doc/contribute.texi +++ b/gcc/doc/contribute.texi @@ -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 diff --git a/gcc/doc/install.texi b/gcc/doc/install.texi index e62b3dae545..643f3bb311f 100644 --- a/gcc/doc/install.texi +++ b/gcc/doc/install.texi @@ -356,8 +356,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}. @@ -482,8 +483,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) @@ -495,7 +496,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) @@ -509,10 +510,10 @@ 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 +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) @@ -547,7 +548,7 @@ own sources. @cindex Downloading GCC @cindex Downloading the Source -GCC is distributed via @uref{http://gcc.gnu.org/svn.html,,SVN} and via +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} @@ -606,9 +607,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 @@ -1543,7 +1545,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. @@ -1843,7 +1845,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 @@ -2495,7 +2497,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 @@ -2503,7 +2505,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. diff --git a/libstdc++-v3/ChangeLog b/libstdc++-v3/ChangeLog index 79bab714419..906f4ba6f10 100644 --- a/libstdc++-v3/ChangeLog +++ b/libstdc++-v3/ChangeLog @@ -1,3 +1,15 @@ +2020-01-19 Eric S. Raymond + + * doc/xml/faq.xml: Update for SVN -> Git transition. + * doc/xml/manual/appendix_contributing.xml: Likewise. + * doc/xml/manual/status_cxx1998.xml: Likewise. + * doc/xml/manual/status_cxx2011.xml: Likewise. + * doc/xml/manual/status_cxx2014.xml: Likewise. + * doc/xml/manual/status_cxx2017.xml: Likewise. + * doc/xml/manual/status_cxx2020.xml: Likewise. + * doc/xml/manual/status_cxxtr1.xml: Likewise. + * doc/xml/manual/status_cxxtr24733.xml: Likewise. + 2020-01-18 Iain Sandoe * include/Makefile.am: Add coroutine to the std set. diff --git a/libstdc++-v3/doc/xml/faq.xml b/libstdc++-v3/doc/xml/faq.xml index b4bf333e26a..21c312dce35 100644 --- a/libstdc++-v3/doc/xml/faq.xml +++ b/libstdc++-v3/doc/xml/faq.xml @@ -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 - web. + bleeding-edge code, the up-to-date source , and can be cloned via Git: see + web. @@ -299,23 +298,11 @@ 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 Subversion. + is Git. - Subversion, or SVN, 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 Subversion - home page has a better description. - - - The anonymous client checkout feature of SVN is - similar to anonymous FTP in that it allows anyone to retrieve - the latest libstdc++ sources. - - For more information - see SVN + see details. diff --git a/libstdc++-v3/doc/xml/manual/appendix_contributing.xml b/libstdc++-v3/doc/xml/manual/appendix_contributing.xml index b399e71d482..d2913b1663c 100644 --- a/libstdc++-v3/doc/xml/manual/appendix_contributing.xml +++ b/libstdc++-v3/doc/xml/manual/appendix_contributing.xml @@ -170,14 +170,11 @@ - The patch itself. If you are accessing the SVN - repository use svn update; svn diff NEW; + The patch itself. If you are accessing the Git + repository use git pull; git diff >NEW; else, use diff -cp OLD NEW ... If your version of diff does not support these options, then get the - latest version of GNU - diff. The SVN - Tricks wiki page has information on customising the - output of svn diff. + latest version of GNU diff. diff --git a/libstdc++-v3/doc/xml/manual/status_cxx1998.xml b/libstdc++-v3/doc/xml/manual/status_cxx1998.xml index 2b05ff6601a..cf5722377a6 100644 --- a/libstdc++-v3/doc/xml/manual/status_cxx1998.xml +++ b/libstdc++-v3/doc/xml/manual/status_cxx1998.xml @@ -18,7 +18,7 @@ This status table is based on the table of contents of ISO/IEC 14882:2003. -This page describes the C++ support in mainline GCC SVN, not in any +This page describes the C++ support in mainline GCC, not in any particular release. diff --git a/libstdc++-v3/doc/xml/manual/status_cxx2011.xml b/libstdc++-v3/doc/xml/manual/status_cxx2011.xml index 6f3551ff65d..9d2de532f3d 100644 --- a/libstdc++-v3/doc/xml/manual/status_cxx2011.xml +++ b/libstdc++-v3/doc/xml/manual/status_cxx2011.xml @@ -27,7 +27,7 @@ presence of the required flag. -This page describes the C++11 support in mainline GCC SVN, not in any +This page describes the C++11 support in mainline GCC, not in any particular release. diff --git a/libstdc++-v3/doc/xml/manual/status_cxx2014.xml b/libstdc++-v3/doc/xml/manual/status_cxx2014.xml index a33b4ec1611..a0b900d9a12 100644 --- a/libstdc++-v3/doc/xml/manual/status_cxx2014.xml +++ b/libstdc++-v3/doc/xml/manual/status_cxx2014.xml @@ -20,7 +20,7 @@ presence of the required flag. -This page describes the C++14 and library TS support in mainline GCC SVN, +This page describes the C++14 and library TS support in mainline GCC, not in any particular release. diff --git a/libstdc++-v3/doc/xml/manual/status_cxx2017.xml b/libstdc++-v3/doc/xml/manual/status_cxx2017.xml index d154d725391..188c3f88551 100644 --- a/libstdc++-v3/doc/xml/manual/status_cxx2017.xml +++ b/libstdc++-v3/doc/xml/manual/status_cxx2017.xml @@ -20,7 +20,7 @@ presence of the required flag. -This section describes the C++17 and library TS support in mainline GCC SVN, +This section describes the C++17 and library TS support in mainline GCC, not in any particular release. diff --git a/libstdc++-v3/doc/xml/manual/status_cxx2020.xml b/libstdc++-v3/doc/xml/manual/status_cxx2020.xml index a8f0ac294f3..17f28887119 100644 --- a/libstdc++-v3/doc/xml/manual/status_cxx2020.xml +++ b/libstdc++-v3/doc/xml/manual/status_cxx2020.xml @@ -20,7 +20,7 @@ presence of the required flag. -This section describes the C++20 and library TS support in mainline GCC SVN, +This section describes the C++20 and library TS support in mainline GCC, not in any particular release. diff --git a/libstdc++-v3/doc/xml/manual/status_cxxtr1.xml b/libstdc++-v3/doc/xml/manual/status_cxxtr1.xml index 32ad20a2fb2..b9e415d21ac 100644 --- a/libstdc++-v3/doc/xml/manual/status_cxxtr1.xml +++ b/libstdc++-v3/doc/xml/manual/status_cxxtr1.xml @@ -22,7 +22,7 @@ In this implementation the header names are prefixed by -This page describes the TR1 support in mainline GCC SVN, not in any particular +This page describes the TR1 support in mainline GCC, not in any particular release. diff --git a/libstdc++-v3/doc/xml/manual/status_cxxtr24733.xml b/libstdc++-v3/doc/xml/manual/status_cxxtr24733.xml index e8d445116a2..92d892da8ac 100644 --- a/libstdc++-v3/doc/xml/manual/status_cxxtr24733.xml +++ b/libstdc++-v3/doc/xml/manual/status_cxxtr24733.xml @@ -16,7 +16,7 @@ decimal floating-point arithmetic -This page describes the TR 24733 support in mainline GCC SVN, not in any +This page describes the TR 24733 support in mainline GCC, not in any particular release. -- 2.30.2