public inbox for libstdc++-cvs@sourceware.org
help / color / mirror / Atom feed
* [gcc r14-9217] libstdc++: Update outdated docs on contributing
@ 2024-02-28 14:33 Jonathan Wakely
0 siblings, 0 replies; only message in thread
From: Jonathan Wakely @ 2024-02-28 14:33 UTC (permalink / raw)
To: gcc-cvs, libstdc++-cvs
https://gcc.gnu.org/g:7c7c937b5e71cf2b53f462cfa6a1df39b5538cee
commit r14-9217-g7c7c937b5e71cf2b53f462cfa6a1df39b5538cee
Author: Jonathan Wakely <jwakely@redhat.com>
Date: Wed Feb 28 11:24:47 2024 +0000
libstdc++: Update outdated docs on contributing
We don't want a separate ChangeLog submission now.
libstdc++-v3/ChangeLog:
* doc/xml/manual/appendix_contributing.xml: Replace outdated
info on ChangeLog entries.
* doc/html/manual/appendix_contributing.html: Regenerate.
Diff:
---
libstdc++-v3/doc/html/manual/appendix_contributing.html | 16 +++++++++-------
libstdc++-v3/doc/xml/manual/appendix_contributing.xml | 16 +++++++++-------
2 files changed, 18 insertions(+), 14 deletions(-)
diff --git a/libstdc++-v3/doc/html/manual/appendix_contributing.html b/libstdc++-v3/doc/html/manual/appendix_contributing.html
index e0b253ad263..cd2c1e153d7 100644
--- a/libstdc++-v3/doc/html/manual/appendix_contributing.html
+++ b/libstdc++-v3/doc/html/manual/appendix_contributing.html
@@ -79,19 +79,19 @@
bug. For new features a description of the feature and your
implementation.
</p></li><li class="listitem"><p>
- A ChangeLog entry as plain text; see the various
- ChangeLog files for format and content. If you are
- using emacs as your editor, simply position the insertion
- point at the beginning of your change and hit CX-4a to bring
- up the appropriate ChangeLog entry. See--magic! Similar
- functionality also exists for vi.
+ A ChangeLog entry as part of the Git commit message. Check
+ some recent commits for format and content. The
+ <code class="filename">contrib/mklog.py</code> script can be used to
+ generate a ChangeLog template for commit messages. See
+ <a class="link" href="http://gcc.gnu.org/gitwrite.html" target="_top">Read-write Git access</a>
+ for scripts and aliases that are useful here.
</p></li><li class="listitem"><p>
A testsuite submission or sample program that will
easily and simply show the existing error or test new
functionality.
</p></li><li class="listitem"><p>
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>
+ <span class="command"><strong>git show</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
@@ -102,6 +102,8 @@
patches and related discussion should be sent to the
libstdc++ mailing list. In common with the rest of GCC,
patches should also be sent to the gcc-patches mailing list.
+ So you could send your email To:libstdc++@gcc.gnu.org and
+ Cc:gcc-patches@gcc.gnu.org for example.
</p></li></ul></div></div></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="appendix.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="appendix.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="source_organization.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">Part IV.
Appendices
</td><td width="20%" align="center"><a accesskey="h" href="../index.html">Home</a></td><td width="40%" align="right" valign="top"> Directory Layout and Source Conventions</td></tr></table></div></body></html>
\ No newline at end of file
diff --git a/libstdc++-v3/doc/xml/manual/appendix_contributing.xml b/libstdc++-v3/doc/xml/manual/appendix_contributing.xml
index a9196493adc..0dcafcb98af 100644
--- a/libstdc++-v3/doc/xml/manual/appendix_contributing.xml
+++ b/libstdc++-v3/doc/xml/manual/appendix_contributing.xml
@@ -151,12 +151,12 @@
<listitem>
<para>
- A ChangeLog entry as plain text; see the various
- ChangeLog files for format and content. If you are
- using emacs as your editor, simply position the insertion
- point at the beginning of your change and hit CX-4a to bring
- up the appropriate ChangeLog entry. See--magic! Similar
- functionality also exists for vi.
+ A ChangeLog entry as part of the Git commit message. Check
+ some recent commits for format and content. The
+ <filename>contrib/mklog.py</filename> script can be used to
+ generate a ChangeLog template for commit messages. See
+ <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://gcc.gnu.org/gitwrite.html">Read-write Git access</link>
+ for scripts and aliases that are useful here.
</para>
</listitem>
@@ -171,7 +171,7 @@
<listitem>
<para>
The patch itself. If you are using the Git repository use
- <command>git diff</command> or <command>git format-patch</command>
+ <command>git show</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
@@ -186,6 +186,8 @@
patches and related discussion should be sent to the
libstdc++ mailing list. In common with the rest of GCC,
patches should also be sent to the gcc-patches mailing list.
+ So you could send your email To:libstdc++@gcc.gnu.org and
+ Cc:gcc-patches@gcc.gnu.org for example.
</para>
</listitem>
</itemizedlist>
^ permalink raw reply [flat|nested] only message in thread
only message in thread, other threads:[~2024-02-28 14:33 UTC | newest]
Thread overview: (only message) (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2024-02-28 14:33 [gcc r14-9217] libstdc++: Update outdated docs on contributing Jonathan Wakely
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).