[Reproducible-commits] [notes] 01/01: Open a new repository to record package status

[Jérémy Bobbio]

This is an automated email from the git hooks/post-receive script.

lunar pushed a commit to branch master
in repository notes.

commit 606c0df1c2b95256cb1e772344b6ffab68af3bc3
Author: Jérémy Bobbio <lunar at debian.org>
Date:   Mon Oct 6 19:30:09 2014 +0200

    Open a new repository to record package status
---
 .gitignore   |  1 +
 README       | 58 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 issues.yml   |  6 ++++++
 packages.yml | 16 ++++++++++++++++
 4 files changed, 81 insertions(+)

diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..adc837b
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1 @@
+*.sw[p-z]
diff --git a/README b/README
new file mode 100644
index 0000000..10784cd
--- /dev/null
+++ b/README
@@ -0,0 +1,58 @@
+Notes on build reproducibility of Debian packages
+=================================================
+
+This repository contains notes concerning the status of build
+reproducibility of Deban packages.
+
+packages.yml
+------------
+
+`packages.yml` is a YAML file with notes about source packages.
+
+A full entry looks like the following:
+
+    socat:
+      version: 1.7.2.4-1
+      issues:
+      - timestamps_from_cpp_macros
+      bugs:
+      - 764251
+      comments: |
+        Patch submitted.
+
+Every field is optional, although a version number might be useful
+to automate future cleanups.
+
+`version` is the Debian version number of the examined source package.
+
+`issues` is a list of tags as described in the `issues.yml`
+file.
+
+`bugs` is a list of Debian bug numbers reported about the
+package.
+
+`comments` is a free-form multi-line field to leave comments.
+
+issues.yml
+----------
+
+`issues.yml` is a YAML file with a description of common issues.
+
+A full entry looks like the following:
+
+    timestamps_from_cpp_macros:
+     description: |
+       The C pre-processor macros `__DATE__`, `__TIME__`, and `__TIMESTAMP__`
+       captures the current time, and thus will obviously make a build
+       unreproducible.
+     url: https://wiki.debian.org/ReproducibleBuilds/TimestampFromCPPMacros
+
+The name of the issue should contain underscores instead of hyphens as
+text editor autocompletion works better with the former.
+
+Every field is optional.
+
+`description` is a free-form multi-line description of the issue.
+
+`url` is a pointer to a page (ideally on the Debian wiki) describing the
+issue in more details.
diff --git a/issues.yml b/issues.yml
new file mode 100644
index 0000000..a035a3a
--- /dev/null
+++ b/issues.yml
@@ -0,0 +1,6 @@
+timestamps_from_cpp_macros:
+ description: |
+   The C pre-processor macros `__DATE__`, `__TIME__`, and `__TIMESTAMP__`
+   captures the current time, and thus will obviously make a build
+   unreproducible.
+ url: https://wiki.debian.org/ReproducibleBuilds/TimestampFromCPPMacros
diff --git a/packages.yml b/packages.yml
new file mode 100644
index 0000000..48bdf5a
--- /dev/null
+++ b/packages.yml
@@ -0,0 +1,16 @@
+socat:
+  version: 1.7.2.4-1
+  issues:
+  - timestamps_from_cpp_macros
+  bugs:
+  - 764251
+  comments: |
+    Patch submitted.
+mlpost:
+  version: 0.8.1-6
+  comments: |
+    Path to temporary filename in mlpost.a
+stgit:
+  version: 0.17.1-1
+  comments: |
+    Timestamp in HTML files

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/reproducible/notes.git