[libthread-tie-perl] 02/05: Filled in required info in debian/control, debian/copyright and debian/changelog

[Christopher Hoskin]

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

grinorcole-guest pushed a commit to branch master
in repository libthread-tie-perl.

commit 1146b218632aeddd36c5aff51bd7453e586a1115
Author: Christopher Hoskin <christopher.hoskin at gmail.com>
Date:   Sun Mar 1 09:36:59 2015 +0000

    Filled in required info in debian/control, debian/copyright and debian/changelog
---
 debian/changelog |  2 +-
 debian/control   | 55 ++++++++++++++++++++++++++++++++++++++-----------------
 debian/copyright | 14 +++-----------
 3 files changed, 42 insertions(+), 29 deletions(-)

diff --git a/debian/changelog b/debian/changelog
index 46482d0..44c6b39 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,5 +1,5 @@
 libthread-tie-perl (0.13-1) UNRELEASED; urgency=low
 
-  * Initial Release.
+  * Initial Release. Closes: #779481
 
  -- Christopher Hoskin <christopher.hoskin at gmail.com>  Sat, 28 Feb 2015 21:51:32 +0000
diff --git a/debian/control b/debian/control
index 0839b31..93687eb 100644
--- a/debian/control
+++ b/debian/control
@@ -4,8 +4,8 @@ Priority: optional
 Maintainer: Debian Perl Group <pkg-perl-maintainers at lists.alioth.debian.org>
 Uploaders: Christopher Hoskin <christopher.hoskin at gmail.com>
 Build-Depends: debhelper (>= 9)
-Build-Depends-Indep: libload-perl (>= 0.11),
- libthread-serialize-perl (>= 0.07),
+Build-Depends-Indep: libload-perl,
+ libthread-serialize-perl,
  perl
 Standards-Version: 3.9.6
 Vcs-Browser: https://anonscm.debian.org/cgit/pkg-perl/packages/libthread-tie-perl.git
@@ -16,25 +16,46 @@ Testsuite: autopkgtest-pkg-perl
 Package: libthread-tie-perl
 Architecture: all
 Depends: ${misc:Depends}, ${perl:Depends},
- libload-perl (>= 0.11),
- libthread-serialize-perl (>= 0.07)
-Description: tie variables into a thread of their own
- *** A note of CAUTION ***
+ libload-perl,
+ libthread-serialize-perl,
+ perl (>=5.8.0)
+Description: alternative separate thread implementation of shared variables
+ The standard shared variable scheme used by Perl, is based on tie-ing the
+ variable to some very special dark magic. This dark magic ensures that shared
+ variables, which are copied just as any other variable when a thread is 
+ started, update values in all of the threads where they exist as soon as the
+ value of a shared variable is changed.
  .
- Thread::Tie only functions on Perl versions 5.8.0 and later.
+ The Thread::Tie module is a proof-of-concept implementation of another approach
+ to shared variables. Instead of having shared variables exist in all the
+ threads from which they are accessible, shared variable exist as "normal",
+ unshared variables in a seperate thread. Only a tied object exists in each
+ thread from which the shared variable is accesible.
  .
- And then only when threads are enabled with -Dusethreads. It
+ Through the use of a client-server model, any thread can fetch and/or update
+ variables living in that thread. This client-server functionality is hidden
+ under the hood of tie(). So you could say that one dark magic (the current
+ shared variables implementation) is replaced by another dark magic.
  .
- is of no use with any version of Perl before 5.8.0 or without
+ The Thread::Tie approach has the following advantages:
  .
- threads enabled.
+ * Memory usage - This implementation circumvents the memory leak that currently
+   (threads::shared version 0.90) plagues any shared array or shared hash
+   access.
+ * Tieing shared variables - Because the current implementation uses tie-ing,
+   you can not tie a shared variable. The same applies for this implementation
+   you might say. However, it is possible to specify a non-standard tie
+   implementation for use within the thread. So with this implementation you can
+   tie() a shared variable. So you could tie a shared hash to a DBM file à la
+   dbmopen() with this module.
  .
- *************************
+ Of course there are disadvantages to this approach:
  .
- The standard shared variable scheme used by Perl, is based on tie-ing the
- variable to some very special dark magic. This dark magic ensures that shared
- variables, which are copied just as any other variable when a thread is
- started, update values in all of the threads where they exist as soon as the
- value of a shared variable is changed.
+ * Pure Perl implementation - This module is currently a pure Perl 
+   implementation. This is ok for a proof of concept, but may need re-
+   implementation in pure XS or in Inline::C for production use.
+ .
+ * Tradeoff between cpu and memory - This implementation currently uses (much)
+   more cpu than the standard shared variables implementation. Whether this 
+   would still be true when re-implemented in XS or Inline::C, remains to be seen.
  .
- This description was automagically extracted from the module by dh-make-perl.
diff --git a/debian/copyright b/debian/copyright
index 1c629ce..aaeb721 100644
--- a/debian/copyright
+++ b/debian/copyright
@@ -1,19 +1,11 @@
 Format: http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
 Source: https://metacpan.org/release/Thread-Tie
-Upstream-Contact: Elizabeth Mattijsen (liz at dijkmat.nl)
+Upstream-Contact: Elizabeth Mattijsen <liz at dijkmat.nl>
 Upstream-Name: Thread-Tie
-DISCLAIMER: This copyright info was automatically extracted 
- from the perl module. It may not be accurate, so you better 
- check the module sources in order to ensure the module for its 
- inclusion in Debian or for general legal information. Please, 
- if licensing information is incorrectly generated, file a bug 
- on dh-make-perl.
- NOTE: Don't forget to remove this disclaimer once you are happy
- with this file.
 
 Files: *
-Copyright: Elizabeth Mattijsen (liz at dijkmat.nl)
-License: 
+Copyright: 2002-2010, Elizabeth Mattijsen <liz at dijkmat.nl>
+License: Artistic or GPL-1+
 
 Files: debian/*
 Copyright: 2015, Christopher Hoskin <christopher.hoskin at gmail.com>

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-perl/packages/libthread-tie-perl.git