[SCM] libdvdcss-pkg/master: split user notes and implementation details between README.Debian and README.source

[onlyjob at users.alioth.debian.org]

The following commit has been merged in the master branch:
commit 66b32cb2b27a35e4f43e141d4c2b80231fdd8987
Author: Dmitry Smirnov <onlyjob at member.fsf.org>
Date:   Sun May 19 11:35:58 2013 +1000

    split user notes and implementation details between README.Debian and README.source

diff --git a/debian/README.Debian b/debian/README.Debian
index e92065d..5abe939 100644
--- a/debian/README.Debian
+++ b/debian/README.Debian
@@ -1,35 +1,5 @@
-Implementation:
+libdvd-pkg
+----------
 
- * Installer is implemented as shell script installed as DPKG post-invoke
-   handler.
-
- * Host package version meant to me an exact match of guest package
-   with debian/watch file inherited from guest package for notifications
-   about new upstream versions.
-
- * Package contains "guest" package sources, but not upstream sources.
-   Upstream sources will be fetched using "uscan".
-   After download orig.tar integrity is checked with known md5sum
-
- * When "guest" package is built, its debian revision number is changed by
-   appending "~local" to clearly mark generated packages.
-
- * During build of "guest" packages "Host" package is injected to Guest's
-   Depends to make sure generated packages will be removed on "host"
-   package remove/purge.
-
- * Host package uses debconf to warn user regarding possible
-   implications.
-
- * If user choose to remove "guest" package, debconf configuration
-   will be updated to prevent re-installation of "guest" packages.
-
- * "dpkg-reconfigure libdvd-pkg" may be used to build and install
-   guest packages. Otherwise guest package(s) will be built and installed
-   from DPKG post-invoke handler. Although automated, unfortunately this
-   will delay installation till next apt-get operation. Is there a better
-   way to hook into apt-get oparation?
-
- * Upgrades are gracefully handled i.e. if host package is updgraded it
-   will build and install guest packages automatically, if prior user
-   decision allows it. As mentioned above installation will be delayed.
+`dpkg-reconfigure libdvd-pkg` may be used to build and install
+ libdvdcss* package(s).
diff --git a/debian/README.source b/debian/README.source
new file mode 100644
index 0000000..433c30a
--- /dev/null
+++ b/debian/README.source
@@ -0,0 +1,44 @@
+Implementation:
+
+ * Package contains source of another "guest" package. Host package
+   named "guest-pkg".
+
+ * Package contains "guest" package sources, but not upstream sources.
+   Upstream sources will be fetched using "uscan". After download
+   orig.tar integrity is checked with known md5sum
+
+ * Host package version (without debian revision) meant to be an exact
+   match of guest package with debian/watch file inherited from guest
+   package for notifications about new upstream versions.
+
+ * Installer is implemented as shell script installed as DPKG
+   post-invoke handler.
+
+ * When "guest" package is built, its debian revision number is
+   changed by appending "~local" to clearly mark generated packages.
+
+ * During build of "guest" packages "host" package is injected to
+   Guest's Depends to make sure generated packages will be removed on
+   "host" package remove/purge.
+
+ * Host package uses debconf to confirm downloading and building with
+   user.
+
+ * If user choose to remove "guest" package, debconf configuration
+   will be updated to prevent re-installation of "guest" packages.
+
+ * Upgrades are gracefully handled i.e. if host package have bundled
+   guest package with version higher than installed then it will be
+   built into package and upgraded (semi-)automatically, if prior user
+   decision allows it. As mentioned above installation will be
+   delayed.
+
+ * To rebuild guest package on host package upgrade it is enough to
+   bump debian revision number of a guest package. Increment of debian
+   revision of host package will not rebuild guest.
+
+ * `dpkg-reconfigure guest-pkg` may be used to build and install guest
+   packages. Otherwise guest package(s) will be built and installed
+   from DPKG post-invoke handler. Although automated, unfortunately
+   this will delay installation till next apt-get operation. Is there
+   a better way to hook into apt-get operation?

-- 
libdvdcss-pkg packaging