Re: Bug#725772: RFS: nfft -- Library for computing Non-uniform Fast Fourier Transforms
Hi Andreas and Ghislain,
On 10/25/2013 11:15 AM, Andreas Tille wrote:
> [...]
>
> So my advise would be to *not* log your actual changes inside
> d/changelog until we have *really* the first version inside Debian.
> There is sufficient information inside the Git commit logs. Just
> remove the 3.2.3-2 paragraph and it also makes sense to "target"
> with 3.2.3-1 at UNRELEASED while leaving me as the sponsor the
> task to switch this to unstable once I decide to upload.
That's good to know !
> This is (should be??) written in Debian Science policy document and
> helps other team members to see immediately that a package was not
> yet uploaded.
I did not see this information in the Debian Sciency Policy.
Attached is a patch proposal.
Kind Regards,
Pablo
>From bab8c4d0b81306735d5919760ac404db214595ff Mon Sep 17 00:00:00 2001
From: Pablo de Oliveira <pablo@sifflez.org>
Date: Fri, 25 Oct 2013 14:34:07 +0200
Subject: [PATCH] Clarify usage of debian/changelog file
* As suggested in http://lists.debian.org/debian-mentors/2013/10/msg00321.html
---
debian-science-policy.xml | 47 +++++++++++++++++++++++++++++++----------------
1 file changed, 31 insertions(+), 16 deletions(-)
diff --git a/debian-science-policy.xml b/debian-science-policy.xml
index ee9f1d0..3a02332 100644
--- a/debian-science-policy.xml
+++ b/debian-science-policy.xml
@@ -27,22 +27,23 @@
CDBS is no longer recommended. Debian source package formats 3.0 is now mandatory.</revremark>
</revision>
<revision>
- <revnumber>1.1</revnumber>
- <date>2013-09-11</date>
- <authorinitials>PO</authorinitials>
- <revremark>
- * Fix the path to VCS-*
- * Point the DEP5 link to the correct place
- * Update the git url
-* Clarify that /git/ is mounted read-only on alioth.debian.org and one should log into git.debian.org instead.
-
-* Give the reportbug syntax to put debian-maintainers in CC when filling a new ITP bug
-
-* Fix example to activate post-update hook in git
-* Add a link to gpb in section Package Repositories
-* Fix FIXME requesting internal links
-</revremark>
+ <revnumber>1.1</revnumber>
+ <date>2013-09-11</date>
+ <authorinitials>PO</authorinitials>
+ <revremark>
+ Fix the path to VCS-*; Point the DEP5 link to the correct place; Update the git url; Clarify that /git/ is mounted read-only on alioth.debian.org and one should log into git.debian.org instead.;
+ Give the reportbug syntax to put debian-maintainers in CC when filling a new ITP bug; Fix example to activate post-update hook in git; Add a link to gpb in section Package Repositories; Fix FIXME requesting internal links
+ </revremark>
+ </revision>
+ <revision>
+ <revnumber>1.2</revnumber>
+ <date>2013-10-25</date>
+ <authorinitials>PO</authorinitials>
+ <revremark>
+ Clarify rules regarding debian/changelog
+ </revremark>
</revision>
+
</revhistory>
</bookinfo>
<preface>
@@ -71,6 +72,20 @@
<title>Debian Control Files</title>
<para>The following sections describe the changes to the control files stored in the source package's <filename>debian/</filename> directory.</para>
<sect2>
+ <title><filename>debian/changelog</filename></title>
+ <para>Changes in the Debian version of the package should be briefly explained in the Debian changelog file.
+ The <filename>debian/changelog</filename> file consists in a series of entries detailing the changes. The format of the entries is described
+ in the <ulink url="http://www.debian.org/doc/debian-policy/ch-source.html#s-dpkgchangelog";>Debian Policy</ulink>.
+ </para>
+ <para>Not yet uploaded packages should have only a single changelog entry closing the <link linkend="itp-rfp-reports">ITP bug</link>. Indeed, when a package is submitted only
+ the latest paragraph is parsed by the Debian bug tracking system. Therefore do not add new changelog entries when updating an unrealeased
+ package, the VCS logs are enough to track the changes.
+ </para>
+ <para>When a sponsor is uploading a package for you, mark the package <varname>target</varname> as UNRELEASED. The sponsor will change it
+ as appropriate before uploading the package.
+ </para>
+ </sect2>
+ <sect2>
<title><filename>debian/control</filename></title>
<sect3>
<title><varname>Section</varname> and <filename>Priority</filename> Fields</title>
@@ -235,7 +250,7 @@ $ chmod 0775 hooks/post-receive
<title>Metapackages</title>
<para>&DebSci; is also managing the Debian-Science metapackages. Consequently, please update the appropriate metapackage with your new package as described in <link linkend="management-of-the-debian-science-metapackages">Chapter 2</link>.</para>
</sect1>
- <sect1>
+ <sect1 id="itp-rfp-reports">
<title>ITP/RFP reports</title>
<sect2>
<title>Intend To Package (ITP)</title>
--
1.8.4.rc3
Reply to: