[SCM] libdvd-pkg/master: Awesome description and template improvements by Justin B Rye.

[onlyjob at users.alioth.debian.org]

The following commit has been merged in the master branch:
commit bee536eef829419f68efbee4ee09e29f2510c71a
Author: Dmitry Smirnov <onlyjob at member.fsf.org>
Date:   Mon Aug 17 00:52:20 2015 +1000

    Awesome description and template improvements by Justin B Rye.

diff --git a/debian/control b/debian/control
index afb45bf..1c54992 100644
--- a/debian/control
+++ b/debian/control
@@ -16,7 +16,7 @@ Depends: ${misc:Depends} ,build-essential
         ,${guest:Build-Depends}
 Recommends: ${guest:Recommends} ,libcap2-bin
 Suggests: ${guest:Suggests}
-Description: download and install software necessary to play video DVDs
- This package fetches, compiles from source code and installs library
- packages that are necessary to play all video DVDs with any media
- player (such as VLC, SMplayer, Totem, etc.).
+Description: DVD-Video playing library - installer
+ This package fetches, compiles from source code, and installs library
+ packages necessary for playing video DVDs with media player
+ (such as VLC, SMplayer, Totem, etc.).
diff --git a/debian/templates b/debian/templates
index 092ff51..a7580b0 100644
--- a/debian/templates
+++ b/debian/templates
@@ -1,60 +1,66 @@
 Template: libdvd-pkg/first-install
 Type: note
 _Description:
- This package downloads the ${PKGG} source files from videolan.org,
- compiles them and installs the binary deb package(s)
- [${PKGG_ALL}].
+ This package automates the process of downloading of the source files for
+ ${PKGG} from videolan.org, compiling them and installing the
+ binary deb packages (${PKGG_ALL}).
  .
- Please remember to run "sudo dpkg-reconfigure ${PKGI}"
- to build and install guest package(s) for the first time.
+ Please run "sudo dpkg-reconfigure ${PKGI}" to launch this process for
+ the first time.
 
 Template: libdvd-pkg/title_b-i
 Type: title
-_Description: Build and install ${PKGG}${VER}
+_Description: Download, build and install ${PKGG}${VER}
 
 Template: libdvd-pkg/build
 Type: boolean
 Default: true
-_Description: Proceed with downloading and compiling ${PKGG}${VER}?
- The installation process is about to download the source files
- from videolan.org, compile them, and install the binary deb package(s)
- [${PKGG_ALL}].
+_Description: Download, build, and install ${PKGG}${VER}?
+ This package automates the process of downloading of the source files for
+ ${PKGG} from videolan.org, compiling them and installing the
+ binary deb packages (${PKGG_ALL}).
  .
  Please confirm whether you wish this to happen.
 
 Template: libdvd-pkg/title_u
 Type: title
-_Description: Upgrades available for guest package(s)
+_Description: Upgrade available for ${PKGG}
 
 Template: libdvd-pkg/upgrade
 Type: note
 _Description:
- An update to guest package(s) [${PKGG_ALL}] version ${VER} is available
- but automatic upgrade is disabled.
+ This package automates the process of downloading of the source files for
+ ${PKGG} from videolan.org, compiling them and installing the
+ binary deb packages (${PKGG_ALL}).
  .
- Please remember to run "sudo dpkg-reconfigure ${PKGI}" to build and
- install guest package(s) or consider installing the APT post-invoke hook.
+ An update to version ${VER} is available, but automatic upgrades are
+ disabled.
+ .
+ Please run "sudo dpkg-reconfigure ${PKGI}" to launch this process
+ manually and/or activate automatic upgrades in future.
 
 Template: libdvd-pkg/post-invoke_hook-install
 Type: boolean
 Default: true
-_Description: Install APT post-invoke hook for ${PKGI}?
+_Description: Enable automatic upgrades for ${PKGG}?
  If activated, the APT post-invoke hook takes care of future automatic
- upgrades of guest package(s) on host package upgrade. When an update
- is available, the hook will attempt to download and build the package(s),
- and (if "apt-get check" reports no errors) install them with "dpkg -i".
+ upgrades of ${PKGG} (which may be triggered by new versions of
+ ${PKGI}). When updates are available, the hook will launch the
+ process of downloading the source, recompiling it, and (if "apt-get check"
+ reports no errors) use "dpkg -i" to install the new versions.
  .
- Alternatively, guest package(s) can be built by manual invocation of
- "dpkg-reconfigure ${PKGI}".
+ Alternatively, the process can be launched manually by running
+ "sudo dpkg-reconfigure ${PKGI}".
 
 Template: libdvd-pkg/post-invoke_hook-remove
 Type: boolean
 Default: false
-_Description: Remove APT post-invoke hook for ${PKGI}?
+_Description: Disable automatic upgrades for ${PKGG}?
  If activated, the APT post-invoke hook takes care of future automatic
- upgrades of guest package(s) on host package upgrade. When an update
- is available, the hook will attempt to download and build the package(s),
- and (if "apt-get check" reports no errors) install them with "dpkg -i".
+ upgrades of ${PKGG} (which may be triggered by new versions of
+ ${PKGI}). When updates are available, the hook will launch the
+ process of downloading the source, recompiling it, and (if "apt-get check"
+ reports no errors) use "dpkg -i" to install the new versions.
  .
- Alternatively, guest package(s) can be built by manual invocation of
- "dpkg-reconfigure ${PKGI}".
+ Alternatively, the process can be launched manually by running
+ "sudo dpkg-reconfigure ${PKGI}".

-- 
libdvdcss-pkg packaging