On 13/01/20 09:02 -0500, Eric S. Raymond wrote:
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
-     <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>.

This makes the text say:

"the up-to-date source , and can be cloned via Git: see [web]."

NACK. Please fix.

    </para>

    <para>
@@ -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 <application>Subversion</application>.
+    is <application>Git</application>.

I think "Since January 2020 that tool is Git" would be better. It's
unfortunate that all the closed branches will continue to say "at this
time" forever, as it's unclear when that was written.

    </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>.

"For more information see [details]."

    </para>
  </answer>
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 @@

      <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>;

I don't think that git command is the equivalent of the previous svn
one. I think originally NEW was meant to be the modified file ... but
I'm not really sure. I don't think "git diff > NEW" is very helpful
though.
Also, if you've just done "git pull" then presumably you have a clean
working tree, and "git diff" won't show anything. I think we should
either completely avoid trying to tell people how to produce patches
from git, or should do it right.

The libstdc++ hunks of this patch above are not OK. Please fix the
grammar so the updated text make sense, or leave those bits to me to
fix. Let me know if you want me to do that (and I can also commit the
rest of the patch for you, which Sandra approved).

          else, use <command>diff -cp OLD NEW</command> ... If your

I don't know why we suggest -p here, that *never* shows anything
useful for libstdc++ code. I'll consider fixing that separately
though.

The rest of the libstdc++ changes below are OK to commit.

          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>

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.
</para>

<para>
-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.
</para>

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.
</para>

<para>
-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.
</para>

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.
</para>

<para>
-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.
</para>

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.
</para>

<para>
-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.
</para>

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.
</para>

<para>
-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.
</para>

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
</para>

<para>
-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.
</para>

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
</para>

<para>
-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.
</para>

--
2.20.1


--
                <a href="http://www.catb.org/~esr/";>Eric S. Raymond</a>


Reply via email to