public inbox for gcc-cvs-wwwdocs@sourceware.org help / color / mirror / Atom feed
From: gerald@gcc.gnu.org To: gcc-cvs-wwwdocs@gcc.gnu.org Subject: gcc-wwwdocs branch master updated. 144607e8df2b31f6b4e5787804fb587d08935341 Date: Fri, 17 Jan 2020 21:17:00 -0000 [thread overview] Message-ID: <20200117211754.124425.qmail@sourceware.org> (raw) This is an automated email from the git hooks/post-receive script. It was generated because a ref change was pushed to the repository containing the project "gcc-wwwdocs". The branch, master has been updated via 144607e8df2b31f6b4e5787804fb587d08935341 (commit) from c0eb9de3940874588c718198697825646374bf18 (commit) Those revisions listed above that are new to this repository have not appeared on any other notification email; so we list those revisions in full, below. - Log ----------------------------------------------------------------- commit 144607e8df2b31f6b4e5787804fb587d08935341 Author: Gerald Pfeifer <gerald@pfeifer.com> Date: Fri Jan 17 22:09:42 2020 +0100 Simplify and adjust to the switch from SVN to Git. Remove a section that only applies to SVN and some specifics on encoding patches in mails that are rarely relevant. Shorten the initial statement, the note on copyright disclaimers, and trim some further overly picky/explicit statements. Use active voice and improve markup in one case each. diff --git a/htdocs/contribute.html b/htdocs/contribute.html index ae19cb88..042ff069 100644 --- a/htdocs/contribute.html +++ b/htdocs/contribute.html @@ -1,5 +1,6 @@ <!DOCTYPE html> <html lang="en"> + <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <meta name="description" content="Contributing to the GCC project." /> @@ -12,12 +13,11 @@ <body> <h1>Contributing to GCC</h1> -<p>We strongly encourage individuals as well as organizations to -contribute to the development of GCC in the form of new features, new +<p>We strongly encourage contributions in the form of features, new or improved optimizations, bug fixes, documentation updates, web page improvements, etc....</p> -<p>There are certain legal requirements and style issues which all +<p>There are certain legal requirements and style issues which contributions must meet:</p> <ul> @@ -52,11 +52,10 @@ your request.</p> <p>If a contributor is reluctant to sign a copyright assignment for a change, a copyright disclaimer to put the change in the public domain is -acceptable as well. The copyright disclaimer form is different than an -employer disclaimer form. A copyright assignment is more convenient if a +acceptable as well. A copyright assignment is more convenient if a contributor plans to make several separate contributions.</p> -<p>Small changes can be accepted without a copyright disclaimer or a +<p>We can accept small changes without a copyright disclaimer or a copyright assignment on file.</p> @@ -85,9 +84,7 @@ addition to using real hardware, you can <p>Much of GCC's code is used only by some targets, or used in quite different ways by different targets. When choosing targets to test a patch with, make sure that your selections exercise all aspects of the -code you are changing. For instance, a change to conditional branch -handling should be tested both with targets that use <code>cc0</code>, -and targets that don't.</p> +code you are changing.</p> <p>You will of course have tested that your change does what you expected it to do: fix a bug, improve an optimization, add a new @@ -127,9 +124,8 @@ must perform a complete bootstrap; however, running other language testsuites is not necessary.</p> <p>In all cases you must test exactly the change that you intend to -submit; it's not good enough to test an earlier variant. The tree -where you perform this test should not have any other changes applied -to it. Include all your new testcases in your testsuite run.</p> +submit. The tree where you perform this test should not have any +other changes applied.</p> <h2 id="docchanges">Documentation Changes</h2> @@ -207,14 +203,8 @@ of your testing. <dt>The patch itself</dt> <dd> -If you are accessing the <a href="svn.html">SVN repository</a> at -gcc.gnu.org, please configure your svn to use GNU diff -and generate patches using the "<code>-up</code>" or -"<code>-cp</code>" options. -See <a href="https://gcc.gnu.org/wiki/SvnSetup">SVN setup instructions</a> -for more details.<br /> Do not include generated files as part of the patch, just mention -them in the ChangeLog (e.g., "* configure: Regenerate."). +them in the ChangeLog (e.g., "<code>* configure: Regenerate.</code>"). </dd> </dl> @@ -234,14 +224,11 @@ the changes that actually make use of the new code and change GCC's behavior.)</p> <p>We prefer patches posted as plain text or as MIME parts of type -<code>text/x-patch</code> or <code>text/plain</code>, disposition -<code>inline</code>, encoded as <code>7bit</code> or -<code>8bit</code>. +<code>text/x-patch</code> or <code>text/plain</code>. It is strongly discouraged to post patches as MIME parts of type <code>application/</code><i>whatever</i>, disposition <code>attachment</code> or encoded as <code>base64</code> or -<code>quoted-printable</code>. Avoid MIME large-message splitting -(<code>message/partial</code>) at all costs.</p> +<code>quoted-printable</code>.</p> <p> If the patch is too big or too mechanical, posting it gzipped or bzip2ed and uuencoded or encoded as a <code>base64</code> MIME part is ----------------------------------------------------------------------- Summary of changes: htdocs/contribute.html | 35 +++++++++++------------------------ 1 file changed, 11 insertions(+), 24 deletions(-) hooks/post-receive -- gcc-wwwdocs
reply other threads:[~2020-01-17 21:17 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=20200117211754.124425.qmail@sourceware.org \ --to=gerald@gcc.gnu.org \ --cc=gcc-cvs-wwwdocs@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).