[gentoo-commits] proj/devmanual:master commit in: ebuild-writing/user-submitted/

[gentoo-commits] proj/devmanual:master commit in: ebuild-writing/user-submitted/

[Ulrich Müller]

commit:     71f8cc1a2a08d191c561b9af429df99189067879
Author:     Sam James <sam <AT> gentoo <DOT> org>
AuthorDate: Sun Mar 21 02:27:55 2021 +0000
Commit:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Wed Apr  7 17:28:13 2021 +0000
URL:        https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=71f8cc1a

ebuild-writing/user-submitted: mention git commit --author

Signed-off-by: Sam James <sam <AT> gentoo.org>
Signed-off-by: Ulrich Müller <ulm <AT> gentoo.org>

 ebuild-writing/user-submitted/text.xml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/ebuild-writing/user-submitted/text.xml b/ebuild-writing/user-submitted/text.xml
index b97af10..b5bc8a8 100644
--- a/ebuild-writing/user-submitted/text.xml
+++ b/ebuild-writing/user-submitted/text.xml
@@ -29,7 +29,8 @@ commit message format section</uri>, is highly encouraged.
 Note that ebuilds received in the form of git patches or pull requests
 will have the user as the commit author by default, in which case
 including the user information in the commit message explicitly
-may not be necessary.
+may not be necessary. If that is not the case, you may wish to use
+git commit's <c>--author</c> parameter to explicitly give them credit.
 </p>
 
 <p>

[gentoo-commits] proj/devmanual:master commit in: ebuild-writing/user-submitted/

[Ulrich Müller]

commit:     d03e2375564ef7eb7a95b26e4f8318b7ca88526f
Author:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
AuthorDate: Wed Mar 30 16:07:17 2022 +0000
Commit:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Wed Mar 30 16:07:17 2022 +0000
URL:        https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=d03e2375

ebuild-writing/user-submitted: Add cross-reference to copyright policy

Signed-off-by: Ulrich Müller <ulm <AT> gentoo.org>

 ebuild-writing/user-submitted/text.xml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/ebuild-writing/user-submitted/text.xml b/ebuild-writing/user-submitted/text.xml
index a389677..364fa87 100644
--- a/ebuild-writing/user-submitted/text.xml
+++ b/ebuild-writing/user-submitted/text.xml
@@ -36,6 +36,8 @@ git commit's <c>--author</c> parameter to explicitly give them credit.
 <p>
 Developers must check for a valid <c>Signed-off-by</c> line either within
 the provided patches by a user or within a comment on e.g. Bugzilla.
+See <uri link="::general-concepts/copyright-policy/#Certificate of Origin"/>
+for details.
 </p>
 
 <p>

[gentoo-commits] proj/devmanual:master commit in: ebuild-writing/user-submitted/

[Ulrich Müller]

commit:     9034dc0f5a277f84a7ce8a4bf528979afe5bb4b5
Author:     Sam James <sam <AT> gentoo <DOT> org>
AuthorDate: Tue Mar 30 09:47:13 2021 +0000
Commit:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Wed Apr  7 17:28:18 2021 +0000
URL:        https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=9034dc0f

ebuild-writing/user-submitted: mention checking for Signed-off-by

Signed-off-by: Sam James <sam <AT> gentoo.org>
Signed-off-by: Ulrich Müller <ulm <AT> gentoo.org>

 ebuild-writing/user-submitted/text.xml | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/ebuild-writing/user-submitted/text.xml b/ebuild-writing/user-submitted/text.xml
index c603e0a..a389677 100644
--- a/ebuild-writing/user-submitted/text.xml
+++ b/ebuild-writing/user-submitted/text.xml
@@ -33,6 +33,11 @@ may not be necessary. If that is not the case, you may wish to use
 git commit's <c>--author</c> parameter to explicitly give them credit.
 </p>
 
+<p>
+Developers must check for a valid <c>Signed-off-by</c> line either within
+the provided patches by a user or within a comment on e.g. Bugzilla.
+</p>
+
 <p>
 Users should be encouraged to submit diffs to an existing ebuild if they
 are submitting an upgrade. Doing this will help to avoid re-introduction

[gentoo-commits] proj/devmanual:master commit in: ebuild-writing/user-submitted/

[Ulrich Müller]

commit:     88cebf0c533c060e803a95927f1ffa8b2d5d9f8f
Author:     Sam James <sam <AT> gentoo <DOT> org>
AuthorDate: Sun Mar 21 02:28:38 2021 +0000
Commit:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Wed Apr  7 17:28:14 2021 +0000
URL:        https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=88cebf0c

ebuild-writing/user-submitted: unified diffs are preferred

Signed-off-by: Sam James <sam <AT> gentoo.org>
Signed-off-by: Ulrich Müller <ulm <AT> gentoo.org>

 ebuild-writing/user-submitted/text.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/ebuild-writing/user-submitted/text.xml b/ebuild-writing/user-submitted/text.xml
index b5bc8a8..c603e0a 100644
--- a/ebuild-writing/user-submitted/text.xml
+++ b/ebuild-writing/user-submitted/text.xml
@@ -37,7 +37,7 @@ git commit's <c>--author</c> parameter to explicitly give them credit.
 Users should be encouraged to submit diffs to an existing ebuild if they
 are submitting an upgrade. Doing this will help to avoid re-introduction
 of previously fixed bugs into "new" ebuilds. When not working from a
-diff but from a complete user-submitted ebuild, the <c>diff</c> command
+diff but from a complete user-submitted ebuild, the <c>diff -u</c> command
 should be used to see what has changed; attention should be payed for
 anything from the current ebuild that should appear in the new ebuild,
 or anything in the new ebuild that should be fixed or removed.

[gentoo-commits] proj/devmanual:master commit in: ebuild-writing/user-submitted/

[Ulrich Müller]

commit:     277ded9ddd1000759727ffd2d0dbc61498b5d96e
Author:     Gokturk Yuksek <gokturk <AT> binghamton <DOT> edu>
AuthorDate: Thu Feb  4 00:57:49 2016 +0000
Commit:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Fri Feb  5 12:58:22 2016 +0000
URL:        https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=277ded9d

ebuild-writing/user-submitted: mention git style tags in commit messages #558642

Gentoo-Bug: https://bugs.gentoo.org/show_bug.cgi?id=558642
Signed-off-by: Gokturk Yuksek <gokturk <AT> binghamton.edu>

 ebuild-writing/user-submitted/text.xml | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/ebuild-writing/user-submitted/text.xml b/ebuild-writing/user-submitted/text.xml
index a148042..68c88f0 100644
--- a/ebuild-writing/user-submitted/text.xml
+++ b/ebuild-writing/user-submitted/text.xml
@@ -22,6 +22,10 @@ The user-submitted ebuild must not contain custom headers like this:
 
 <p>
 Such information should be included in the git commit message instead.
+The use of tags such as <c>Suggested-By:</c> or <c>Reported-By:</c>in
+the commit message, as explained in the
+<uri link="::ebuild-maintenance#git-commit-message-format">commit
+message format section</uri>, is highly encouraged.
 Note that ebuilds received in the form of git patches or pull requests
 will have the user as the commit author by default, in which case
 including the user information in the commit message explicitly

[gentoo-commits] proj/devmanual:master commit in: ebuild-writing/user-submitted/

[Ulrich Müller]

commit:     b2b11705f3fe10df6c632ec3e1dcd945b19dd36f
Author:     Gokturk Yuksek <gokturk <AT> binghamton <DOT> edu>
AuthorDate: Thu Feb  4 00:57:34 2016 +0000
Commit:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Fri Feb  5 12:58:19 2016 +0000
URL:        https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=b2b11705

ebuild-writing/user-submitted: do not put user information in ChangeLog #558642

ChangeLog files are auto-generated by infra post git-migration.
For user-submitted ebuilds, include the user information in the commit
message instead. Mention that user submitted git patches and pull
requests preserve the authorship information by default.

Gentoo-Bug: https://bugs.gentoo.org/show_bug.cgi?id=558642
Signed-off-by: Gokturk Yuksek <gokturk <AT> binghamton.edu>

 ebuild-writing/user-submitted/text.xml | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/ebuild-writing/user-submitted/text.xml b/ebuild-writing/user-submitted/text.xml
index ef80c0d..a148042 100644
--- a/ebuild-writing/user-submitted/text.xml
+++ b/ebuild-writing/user-submitted/text.xml
@@ -16,14 +16,16 @@ the ebuild meets all Gentoo Linux development standards.
 The user-submitted ebuild must not contain custom headers like this:
 </p>
 
-<pre caption="A custom header that should be transferred to the ChangeLog">
+<pre caption="A custom header that should be included in the commit message instead">
 # Ebuild updated by: me &lt;me@example.com&gt;
 </pre>
 
 <p>
-Such information should be added to the <c>ChangeLog</c> instead.
-The first <c>ChangeLog</c> entry should always credit the user who
-submitted the ebuild, with their full name and e-mail address.
+Such information should be included in the git commit message instead.
+Note that ebuilds received in the form of git patches or pull requests
+will have the user as the commit author by default, in which case
+including the user information in the commit message explicitly
+may not be necessary.
 </p>
 
 <p>