[syrthes/master] debian/README.source: explain SCIENCE_EXPLICIT_VERSION

[Gilles Filippini]

---
 debian/README.source |   23 ++++++++++++++++++-----
 1 files changed, 18 insertions(+), 5 deletions(-)

diff --git a/debian/README.source b/debian/README.source
index c11aa9f..8b0b3dc 100644
--- a/debian/README.source
+++ b/debian/README.source
@@ -4,12 +4,25 @@ SYRTHES for Debian
 This file is used to keep track of packaging choices, known issues and TO-DOs.
 
 
-========
-0- TO-DO
-========
+===========================
+0- SCIENCE_EXPLICIT_VERSION
+===========================
 
-* manpage
-* make possible to install several syrthes releases on the same box?
+In some cases one wants to install several versionis of a software on the
+same box. This happens to my users at work with scientific software:
+* an oldstable version is available for a not yet finished long study
+* the stable version is there for new studies
+* and a release canditade version may undergoes some heavy testing
+
+One solution is to name the packages after the version, as it is done for
+gcc for instance. But it is not comfortable for the debian archive. In this
+source package I use the environement variable SCIENCE_EXPLICIT_VERSION at
+build time to produce binary packages named after the version or not:
+
+* if SCIENCE_EXPLICIT_VERSION=yes the binary package name is "syrthes-<version>"
+* else the binary package name is "syrthes"
+
+See debian/rules for the implementation details.
 
 
 ==============================
-- 
1.5.6.5