[SCM] mpd-sima/master: Add more comments, improved package description

[kaliko-guest at users.alioth.debian.org]

The following commit has been merged in the master branch:
commit 521f4564b4117703d6a43622a13af25db8e03604
Author: Geoffroy Youri Berret <efrim at azylum.org>
Date:   Sun Jun 19 15:25:14 2011 +0200

    Add more comments, improved package description

diff --git a/debian/control b/debian/control
index 6d6c3c0..58d5a74 100644
--- a/debian/control
+++ b/debian/control
@@ -18,11 +18,13 @@ Depends: ${misc:Depends}, ${python:Depends},
 Recommends:
 Suggests: mpd
 Provides: mpd-client
-Description: Automagically add title to mpd playlist
+Description: Automagically add titles to MPD playlist
  MPD_Sima is a Python script meant to feed MPD playlist with artist
  similar to your currently playing track, provided that this artist is
  found in MPD library. Similar artists are found through last.fm
  requests.
  .
+ MPD_sima can queue track, top track or whole album for similar artists.
+ .
  This Python code allows you to never run out of music when your
  playlist queue is getting short.
diff --git a/debian/mpd-sima.init b/debian/mpd-sima.init
index ee79fcf..57c7765 100755
--- a/debian/mpd-sima.init
+++ b/debian/mpd-sima.init
@@ -69,6 +69,8 @@ do_start()
     if [ ! -d "$PIDDIR" ]; then
         mkdir -m 0755 $PIDDIR
     fi
+
+    # Controling presence of $VARDIR
     if [ ! -d "$VARDIR" ]; then
         mkdir -m 0775 $VARDIR
         chown $USER:audio $VARDIR
diff --git a/debian/rules b/debian/rules
index 0ccbb97..5acfc0e 100755
--- a/debian/rules
+++ b/debian/rules
@@ -1,4 +1,5 @@
 #!/usr/bin/make -f
+#
 
 DB2MAN = /usr/share/xml/docbook/stylesheet/docbook-xsl-ns/manpages/docbook.xsl
 XP     = xsltproc --nonet --param make.year.ranges 1 --param make.single.year.ranges 1 --param man.charmap.use.subset 0 -o debian/
@@ -18,10 +19,17 @@ mpd-sima.cfg.1:
 override_dh_installchangelogs:
 	dh_installchangelogs doc/Changelog
 
+# Upstream does not guarantee to provide or to build latest versions of
+# manuals. We build them here to make sure to have proper manuals.
 override_dh_installman: mpd-sima.1 simadb_cli.1 mpd-sima.cfg.1
 	dh_installman
 
-# prevent calling upstream make targets
+# Previous version of MPD_sima (< 0.7) did not have any installation script.
+# With 0.7 appears a Makefile but I kept using dh to install the source.
+# This is why debian/rules overrides upstream Makefile calls (clean, install
+# and build)
+#
+# Prevent calling upstream make targets
 override_dh_auto_clean:
 override_dh_auto_install:
 override_dh_auto_build:

-- 
mpd-sima packaging