[openarena-data] 01/05: d/README.source: Document non-DEP-14 Debian packaging repository layout

[Simon McVittie]

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

smcv pushed a commit to branch master
in repository openarena-data.

commit 4a202f6eca05d7217da94bae6d2a586b5d27bee1
Author: Simon McVittie <smcv at debian.org>
Date:   Tue Jan 16 08:37:28 2018 +0000

    d/README.source: Document non-DEP-14 Debian packaging repository layout
---
 debian/README.source | 30 +++++++++++++++++++++++++++---
 debian/changelog     |  2 ++
 2 files changed, 29 insertions(+), 3 deletions(-)

diff --git a/debian/README.source b/debian/README.source
index e82536c..c9f6be6 100644
--- a/debian/README.source
+++ b/debian/README.source
@@ -58,8 +58,8 @@ chosen so that its CRC32 matches the one supplied by upstream. Debian's
 modified openarena engine detects the magic number 'NTVE' and loads a
 native-code equivalent of the original QVM file.
 
-Source code/build system (or lack of)
--------------------------------------
+Upstream source code/build system (or lack of)
+----------------------------------------------
 
 Upstream do not have an official source code release or build system for the
 assets. For some files (scripts, most sounds and some textures), the data in
@@ -78,8 +78,32 @@ It appears that upstream svn revision 901 corresponds to 0.8.1, revision
 but that's not relevant to obtaining sources), and revision 947 corresponds
 to 0.8.8.
 
+Debian packaging git repository
+-------------------------------
+
+This git repository deliberately does not follow the DEP-14 repository
+layout recommendation, because it contains multiple Debian source packages.
+Instead, packaging branches are named for the source package in question:
+
+    openarena-085-data
+    openarena-088-data
+    openarena-data
+    openarena-maps
+    openarena-misc
+    openarena-oacmp1
+    openarena-players
+    openarena-players-mature
+    openarena-textures
+
+and tags include the package name between "debian/" and the version:
+
+    debian/openarena-data/0.8.5split-11 (etc.)
+
+Changes that affect all source packages are made on the openarena-data
+branch and merged to all other branches.
+
 Assets from the PK3 files, and the source files for them, are not included in
-the pkg-games git repository due to their size; please obtain them from the
+the games team git repository due to their size; please obtain them from the
 orig tarball, or as described below, before building.
 
 How the orig.tar.* is constructed
diff --git a/debian/changelog b/debian/changelog
index 18d43ff..d618b0a 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,6 +1,8 @@
 openarena-data (0.8.5split-11) UNRELEASED; urgency=medium
 
   * Declare compliance with Debian Policy v4.1.2
+  * d/README.source: Document non-DEP-14 Debian packaging repository
+    layout
 
  -- Simon McVittie <smcv at debian.org>  Sun, 10 Dec 2017 18:58:10 +0000
 

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-games/openarena-data.git