public inbox for gentoo-commits@lists.gentoo.org
 help / color / mirror / Atom feed
* [gentoo-commits] proj/devmanual:master commit in: ebuild-writing/misc-files/changelog/
@ 2011-05-10 19:49 Petteri Räty
  0 siblings, 0 replies; 3+ messages in thread
From: Petteri Räty @ 2011-05-10 19:49 UTC (permalink / raw
  To: gentoo-commits

commit:     eee81246369d1124501528a289adbbb77a5e3cd1
Author:     Petteri Räty <betelgeuse <AT> gentoo <DOT> org>
AuthorDate: Tue May 10 19:37:49 2011 +0000
Commit:     Petteri Räty <betelgeuse <AT> gentoo <DOT> org>
CommitDate: Tue May 10 19:37:49 2011 +0000
URL:        http://git.overlays.gentoo.org/gitweb/?p=proj/devmanual.git;a=commit;h=eee81246

Updating ChangeLog in all situations is mandatory

Council just voted in the meeting today that ChangeLog must be updated
with each commit so that it is like a local VCS log. The original
trigger for this change was that ebuild removals were not logged in all
cases.

---
 ebuild-writing/misc-files/changelog/text.xml |    9 ++++-----
 1 files changed, 4 insertions(+), 5 deletions(-)

diff --git a/ebuild-writing/misc-files/changelog/text.xml b/ebuild-writing/misc-files/changelog/text.xml
index 85ec332..11f9653 100644
--- a/ebuild-writing/misc-files/changelog/text.xml
+++ b/ebuild-writing/misc-files/changelog/text.xml
@@ -5,11 +5,10 @@
 
 <body>
 <p>
-The <c>ChangeLog</c> should be used to record all non-trivial changes
-to ebuilds, including <e>keywording changes</e>. The echangelog tool
-should be used to create <c>ChangeLog</c> entries — the format of a
-<c>ChangeLog</c> is now defined as "whatever <c>echangelog</c>
-creates".
+The <c>ChangeLog</c> must be updated with each commit. The
+echangelog tool should be used to create <c>ChangeLog</c> entries
+— the format of a <c>ChangeLog</c> is now defined as "whatever
+<c>echangelog</c> creates".
 </p>
 
 <p>



^ permalink raw reply related	[flat|nested] 3+ messages in thread
* [gentoo-commits] proj/devmanual:master commit in: ebuild-writing/misc-files/changelog/
@ 2011-05-10 19:56 Petteri Räty
  0 siblings, 0 replies; 3+ messages in thread
From: Petteri Räty @ 2011-05-10 19:56 UTC (permalink / raw
  To: gentoo-commits

commit:     05923dc0acae7624116407b08cd9bb734e542826
Author:     Petteri Räty <betelgeuse <AT> gentoo <DOT> org>
AuthorDate: Tue May 10 19:49:44 2011 +0000
Commit:     Petteri Räty <betelgeuse <AT> gentoo <DOT> org>
CommitDate: Tue May 10 19:49:44 2011 +0000
URL:        http://git.overlays.gentoo.org/gitweb/?p=proj/devmanual.git;a=commit;h=05923dc0

Improve English for ChangeLog text

Brian Harring thinks a semicolon is better English here.

---
 ebuild-writing/misc-files/changelog/text.xml |    4 ++--
 1 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/ebuild-writing/misc-files/changelog/text.xml b/ebuild-writing/misc-files/changelog/text.xml
index 11f9653..d92bbf4 100644
--- a/ebuild-writing/misc-files/changelog/text.xml
+++ b/ebuild-writing/misc-files/changelog/text.xml
@@ -6,8 +6,8 @@
 <body>
 <p>
 The <c>ChangeLog</c> must be updated with each commit. The
-echangelog tool should be used to create <c>ChangeLog</c> entries
-— the format of a <c>ChangeLog</c> is now defined as "whatever
+echangelog tool should be used to create <c>ChangeLog</c> entries;
+the format of a <c>ChangeLog</c> is now defined as "whatever
 <c>echangelog</c> creates".
 </p>
 



^ permalink raw reply related	[flat|nested] 3+ messages in thread
* [gentoo-commits] proj/devmanual:master commit in: ebuild-writing/misc-files/changelog/
@ 2013-09-28  9:46 Markos Chandras
  0 siblings, 0 replies; 3+ messages in thread
From: Markos Chandras @ 2013-09-28  9:46 UTC (permalink / raw
  To: gentoo-commits

commit:     f4121175e9bc0d0260bbe399ef39339085afa481
Author:     Markos Chandras <hwoarang <AT> gentoo <DOT> org>
AuthorDate: Sat Sep 28 09:44:32 2013 +0000
Commit:     Markos Chandras <hwoarang <AT> gentoo <DOT> org>
CommitDate: Sat Sep 28 09:44:32 2013 +0000
URL:        http://git.overlays.gentoo.org/gitweb/?p=proj/devmanual.git;a=commit;h=f4121175

ChangeLog: Add note about missing ChangeLog files

Bug #464216

---
 ebuild-writing/misc-files/changelog/text.xml | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/ebuild-writing/misc-files/changelog/text.xml b/ebuild-writing/misc-files/changelog/text.xml
index 3cf1835..7ee5ce7 100644
--- a/ebuild-writing/misc-files/changelog/text.xml
+++ b/ebuild-writing/misc-files/changelog/text.xml
@@ -47,6 +47,12 @@ A typical <c>ChangeLog</c> snippet might look like the following:
       Stable on alpha
 </pre>
 
+<note>
+If a <c>ChangeLog</c> file is not present in your current working directory,
+then you should write a <c>ChangeLog</c> entry in the parent's directory
+<c>ChangeLog</c> file.
+</note>
+
 <section>
 <title>Writing correct ChangeLog messages</title>
 <body>


^ permalink raw reply related	[flat|nested] 3+ messages in thread

end of thread, other threads:[~2013-09-28  9:46 UTC | newest]

Thread overview: 3+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2011-05-10 19:49 [gentoo-commits] proj/devmanual:master commit in: ebuild-writing/misc-files/changelog/ Petteri Räty
  -- strict thread matches above, loose matches on Subject: below --
2011-05-10 19:56 Petteri Räty
2013-09-28  9:46 Markos Chandras

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox