public inbox for gcc-cvs@sourceware.org help / color / mirror / Atom feed
From: Jakub Jelinek <jakub@gcc.gnu.org> To: gcc-cvs@gcc.gnu.org, libstdc++-cvs@gcc.gnu.org Subject: [gcc(refs/vendors/redhat/heads/gcc-8-branch)] libstdc++: Fix recent documentation changes Date: Thu, 17 Sep 2020 16:36:38 +0000 (GMT) [thread overview] Message-ID: <20200917163638.EFDFF398791D@sourceware.org> (raw) https://gcc.gnu.org/g:0ae525f794368985b7ae894d93aee03171d411f7 commit 0ae525f794368985b7ae894d93aee03171d411f7 Author: Jonathan Wakely <jwakely@redhat.com> Date: Fri Jan 24 11:17:58 2020 +0000 libstdc++: Fix recent documentation changes Backport from mainline 2020-01-20 Jonathan Wakely <jwakely@redhat.com> * doc/xml/faq.xml: Fix grammar. * doc/xml/manual/appendix_contributing.xml: Improve instructions. * doc/xml/manual/spine.xml: Update copyright years. * doc/html/*: Regenerate. Diff: --- libstdc++-v3/ChangeLog | 10 ++++++++ libstdc++-v3/doc/html/faq.html | 28 ++++++---------------- .../doc/html/manual/appendix_contributing.html | 12 ++++------ libstdc++-v3/doc/html/manual/index.html | 2 +- libstdc++-v3/doc/xml/faq.xml | 18 ++++++-------- .../doc/xml/manual/appendix_contributing.xml | 7 +++--- libstdc++-v3/doc/xml/manual/spine.xml | 2 ++ 7 files changed, 36 insertions(+), 43 deletions(-) diff --git a/libstdc++-v3/ChangeLog b/libstdc++-v3/ChangeLog index bf3886867a9..bf42afb10a3 100644 --- a/libstdc++-v3/ChangeLog +++ b/libstdc++-v3/ChangeLog @@ -1,3 +1,13 @@ +2020-01-24 Jonathan Wakely <jwakely@redhat.com> + + Backport from mainline + 2020-01-20 Jonathan Wakely <jwakely@redhat.com> + + * doc/xml/faq.xml: Fix grammar. + * doc/xml/manual/appendix_contributing.xml: Improve instructions. + * doc/xml/manual/spine.xml: Update copyright years. + * doc/html/*: Regenerate. + 2020-01-19 Eric S. Raymond <esr@thyrsus.com> Sandra Loosemore <sandra@codesourcery.com> diff --git a/libstdc++-v3/doc/html/faq.html b/libstdc++-v3/doc/html/faq.html index 1f6934ef4c8..ac99835acf2 100644 --- a/libstdc++-v3/doc/html/faq.html +++ b/libstdc++-v3/doc/html/faq.html @@ -113,9 +113,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 - <a class="link" href="https://gcc.gnu.org/svn.html" target="_top">web</a>. + bleeding-edge code, the up-to-date source can be cloned via + <a class="link" href="https://gcc.gnu.org/git.html" target="_top">Git</a>. </p><p> N.B. The library is called libstdc++ <span class="emphasis"><em>not</em></span> stdlibc++. </p></td></tr><tr class="question"><td align="left" valign="top"><a id="faq.why"></a><a id="q-why"></a><p><strong>1.2.</strong></p></td><td align="left" valign="top"><p> @@ -260,24 +259,11 @@ mirrors. A full <a class="link" href="https://gcc.gnu.org/mirrors.html" target="_top">list of download sites</a> is provided on the main GCC site. </p><p> - 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 <span class="application">Subversion</span>. - </p><p> - <span class="application">Subversion</span>, or <acronym class="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 <a class="link" href="http://subversion.tigris.org" target="_top"> Subversion - home page</a> has a better description. - </p><p> - The <span class="quote">“<span class="quote">anonymous client checkout</span>”</span> feature of SVN is - similar to anonymous FTP in that it allows anyone to retrieve - the latest libstdc++ sources. - </p><p> - For more information - see <a class="link" href="https://gcc.gnu.org/svn.html" target="_top"><acronym class="acronym">SVN</acronym> - details</a>. + Current libstdc++ sources can always be found in the main GCC source + repository, available using the appropriate version control tool. + At this time, that tool is <span class="application">Git</span>. + For more details see the documentation on + <a class="link" href="https://gcc.gnu.org/git.html" target="_top">using the Git repository</a>. </p></td></tr><tr class="question"><td align="left" valign="top"><a id="faq.how_to_test"></a><a id="q-how_to_test"></a><p><strong>3.3.</strong></p></td><td align="left" valign="top"><p>How do I know if it works? </p></td></tr><tr class="answer"><td align="left" valign="top"><a id="a-how_to_test"></a></td><td align="left" valign="top"><p> Libstdc++ comes with its own validation testsuite, which includes diff --git a/libstdc++-v3/doc/html/manual/appendix_contributing.html b/libstdc++-v3/doc/html/manual/appendix_contributing.html index ca8ae873b9e..2f384a64afa 100644 --- a/libstdc++-v3/doc/html/manual/appendix_contributing.html +++ b/libstdc++-v3/doc/html/manual/appendix_contributing.html @@ -90,14 +90,12 @@ easily and simply show the existing error or test new functionality. </p></li><li class="listitem"><p> - The patch itself. If you are accessing the SVN - repository use <span class="command"><strong>svn update; svn diff NEW</strong></span>; - else, use <span class="command"><strong>diff -cp OLD NEW</strong></span> ... If your + The patch itself. If you are using the Git repository use + <span class="command"><strong>git diff</strong></span> or <span class="command"><strong>git format-patch</strong></span> + to produce a patch; + otherwise, use <span class="command"><strong>diff -cp OLD NEW</strong></span>. If your version of diff does not support these options, then get the - latest version of GNU - diff. The <a class="link" href="http://gcc.gnu.org/wiki/SvnTricks" target="_top">SVN - Tricks</a> wiki page has information on customising the - output of <code class="code">svn diff</code>. + latest version of GNU diff. </p></li><li class="listitem"><p> When you have all these pieces, bundle them up in a mail message and send it to libstdc++@gcc.gnu.org. All diff --git a/libstdc++-v3/doc/html/manual/index.html b/libstdc++-v3/doc/html/manual/index.html index eecb195a016..534b9a647ec 100644 --- a/libstdc++-v3/doc/html/manual/index.html +++ b/libstdc++-v3/doc/html/manual/index.html @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="UTF-8" standalone="no"?> -<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>The GNU C++ Library Manual</title><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot" /><meta name="keywords" content="ISO C++, runtime, library" /><link rel="home" href="../index.html" title="The GNU C++ Library" /><link rel="up" href="../index.html" title="The GNU C++ Library" /><link rel="prev" href="../index.html" title="The GNU C++ Library" /><link rel="next" href="intro.html" title="Part I. Introduction" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">The GNU C++ Library Manual</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="../index.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="intro.html">Next</a></td></tr></table><hr /></div><div class="book"><div class="titlepage"><div><div><h1 class="title"><a id="manual"></a>The GNU C++ Library Manual</h1></div><div><div class="authorgroup"><div class="author"><h3 class="author"><span class="firstname"></span> <span class="surname"></span></h3></div><div class="author"><h3 class="author"><span class="firstname">Paolo</span> <span class="surname">Carlini</span></h3></div><div class="author"><h3 class="author"><span class="firstname">Phil</span> <span class="surname">Edwards</span></h3></div><div class="author"><h3 class="author"><span class="firstname">Doug</span> <span class="surname">Gregor</span></h3></div><div class="author"><h3 class="author"><span class="firstname">Benjamin</span> <span class="surname">Kosnik</span></h3></div><div class="author"><h3 class="author"><span class="firstname">Dhruv</span> <span class="surname">Matani</span></h3></div><div class="author"><h3 class="author"><span class="firstname">Jason</span> <span class="surname">Merrill</span></h3></div><div class="author"><h3 class="author"><span class="firstname">Mark</span> <span class="surname">Mitchell</span></h3></div><div class="author"><h3 class="author"><span class="firstname">Nathan</span> <span class="surname">Myers</span></h3></div><div class="author"><h3 class="author"><span class="firstname">Felix</span> <span class="surname">Natter</span></h3></div><div class="author"><h3 class="author"><span class="firstname">Stefan</span> <span class="surname">Olsson</span></h3></div><div class="author"><h3 class="author"><span class="firstname">Silvius</span> <span class="surname">Rus</span></h3></div><div class="author"><h3 class="author"><span class="firstname">Johannes</span> <span class="surname">Singler</span></h3></div><div class="author"><h3 class="author"><span class="firstname">Ami</span> <span class="surname">Tavory</span></h3></div><div class="author"><h3 class="author"><span class="firstname">Jonathan</span> <span class="surname">Wakely</span></h3></div></div></div><div><p class="copyright">Copyright © 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018 +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>The GNU C++ Library Manual</title><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot" /><meta name="keywords" content="ISO C++, runtime, library" /><link rel="home" href="../index.html" title="The GNU C++ Library" /><link rel="up" href="../index.html" title="The GNU C++ Library" /><link rel="prev" href="../index.html" title="The GNU C++ Library" /><link rel="next" href="intro.html" title="Part I. Introduction" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">The GNU C++ Library Manual</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="../index.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="intro.html">Next</a></td></tr></table><hr /></div><div class="book"><div class="titlepage"><div><div><h1 class="title"><a id="manual"></a>The GNU C++ Library Manual</h1></div><div><div class="authorgroup"><div class="author"><h3 class="author"><span class="firstname"></span> <span class="surname"></span></h3></div><div class="author"><h3 class="author"><span class="firstname">Paolo</span> <span class="surname">Carlini</span></h3></div><div class="author"><h3 class="author"><span class="firstname">Phil</span> <span class="surname">Edwards</span></h3></div><div class="author"><h3 class="author"><span class="firstname">Doug</span> <span class="surname">Gregor</span></h3></div><div class="author"><h3 class="author"><span class="firstname">Benjamin</span> <span class="surname">Kosnik</span></h3></div><div class="author"><h3 class="author"><span class="firstname">Dhruv</span> <span class="surname">Matani</span></h3></div><div class="author"><h3 class="author"><span class="firstname">Jason</span> <span class="surname">Merrill</span></h3></div><div class="author"><h3 class="author"><span class="firstname">Mark</span> <span class="surname">Mitchell</span></h3></div><div class="author"><h3 class="author"><span class="firstname">Nathan</span> <span class="surname">Myers</span></h3></div><div class="author"><h3 class="author"><span class="firstname">Felix</span> <span class="surname">Natter</span></h3></div><div class="author"><h3 class="author"><span class="firstname">Stefan</span> <span class="surname">Olsson</span></h3></div><div class="author"><h3 class="author"><span class="firstname">Silvius</span> <span class="surname">Rus</span></h3></div><div class="author"><h3 class="author"><span class="firstname">Johannes</span> <span class="surname">Singler</span></h3></div><div class="author"><h3 class="author"><span class="firstname">Ami</span> <span class="surname">Tavory</span></h3></div><div class="author"><h3 class="author"><span class="firstname">Jonathan</span> <span class="surname">Wakely</span></h3></div></div></div><div><p class="copyright">Copyright © 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020 <a class="link" href="https://www.fsf.org" target="_top">FSF</a> </p></div></div><hr /></div><div class="toc"><p><strong>Table of Contents</strong></p><dl class="toc"><dt><span class="part"><a href="intro.html">I. Introduction diff --git a/libstdc++-v3/doc/xml/faq.xml b/libstdc++-v3/doc/xml/faq.xml index 21c312dce35..aff6c8d6004 100644 --- a/libstdc++-v3/doc/xml/faq.xml +++ b/libstdc++-v3/doc/xml/faq.xml @@ -34,8 +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 , 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>. + bleeding-edge code, the up-to-date source can be cloned via + <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="https://gcc.gnu.org/git.html">Git</link>. </para> <para> @@ -295,15 +295,11 @@ download sites</link> is provided on the main GCC site. </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>Git</application>. - </para> - <para> - For more information - see <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="https://gcc.gnu.org/git.html"> - details</link>. + Current libstdc++ sources can always be found in the main GCC source + repository, available using the appropriate version control tool. + At this time, that tool is <application>Git</application>. + For more details see the documentation on + <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="https://gcc.gnu.org/git.html">using the Git repository</link>. </para> </answer> </qandaentry> diff --git a/libstdc++-v3/doc/xml/manual/appendix_contributing.xml b/libstdc++-v3/doc/xml/manual/appendix_contributing.xml index a049d7d91ad..eb011cbd4bc 100644 --- a/libstdc++-v3/doc/xml/manual/appendix_contributing.xml +++ b/libstdc++-v3/doc/xml/manual/appendix_contributing.xml @@ -170,9 +170,10 @@ <listitem> <para> - The patch itself. If you are accessing the Git - repository use <command>git pull; git diff >NEW</command>; - else, use <command>diff -cp OLD NEW</command> ... If your + The patch itself. If you are using the Git repository use + <command>git diff</command> or <command>git format-patch</command> + to produce a patch; + otherwise, 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. </para> diff --git a/libstdc++-v3/doc/xml/manual/spine.xml b/libstdc++-v3/doc/xml/manual/spine.xml index b9f05e24f3d..9585f1eed01 100644 --- a/libstdc++-v3/doc/xml/manual/spine.xml +++ b/libstdc++-v3/doc/xml/manual/spine.xml @@ -26,6 +26,8 @@ <year>2016</year> <year>2017</year> <year>2018</year> + <year>2019</year> + <year>2020</year> <holder> <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="https://www.fsf.org">FSF</link> </holder>
reply other threads:[~2020-09-17 16:36 UTC|newest] Thread overview: [no followups] expand[flat|nested] mbox.gz Atom feed
Reply instructions: You may reply publicly to this message via plain-text email using any one of the following methods: * Save the following mbox file, import it into your mail client, and reply-to-all from there: mbox Avoid top-posting and favor interleaved quoting: https://en.wikipedia.org/wiki/Posting_style#Interleaved_style * Reply using the --to, --cc, and --in-reply-to switches of git-send-email(1): git send-email \ --in-reply-to=20200917163638.EFDFF398791D@sourceware.org \ --to=jakub@gcc.gnu.org \ --cc=gcc-cvs@gcc.gnu.org \ --cc=libstdc++-cvs@gcc.gnu.org \ /path/to/YOUR_REPLY https://kernel.org/pub/software/scm/git/docs/git-send-email.html * If your mail client supports setting the In-Reply-To header via mailto: links, try the mailto: linkBe sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions for how to clone and mirror all data and code used for this inbox; as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).