[libtask-kensho-perl] 05/17: Add 0002-remove-manual-installation-details-from-pod.patch

[Nick Morrott]

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

nickm-guest pushed a commit to branch master
in repository libtask-kensho-perl.

commit 7f17012462d00248b7d8ccd93f908a16d3c31c60
Author: Nick Morrott <knowledgejunkie at gmail.com>
Date:   Fri May 27 07:00:28 2016 +0100

    Add 0002-remove-manual-installation-details-from-pod.patch
---
 ...move-manual-installation-details-from-pod.patch | 54 ++++++++++++++++++++++
 debian/patches/series                              |  1 +
 2 files changed, 55 insertions(+)

diff --git a/debian/patches/0002-remove-manual-installation-details-from-pod.patch b/debian/patches/0002-remove-manual-installation-details-from-pod.patch
new file mode 100644
index 0000000..5f7e8c2
--- /dev/null
+++ b/debian/patches/0002-remove-manual-installation-details-from-pod.patch
@@ -0,0 +1,54 @@
+Description: Remove cpan installation instructions; replace with
+ Debian package installation instructions.
+Author: Nick Morrott <knowledgejunkie at gmail.com>
+Forwarded: not-needed
+Last-Update: 2016-05-27
+---
+--- a/lib/Task/Kensho.pm
++++ b/lib/Task/Kensho.pm
+@@ -21,7 +21,7 @@
+ 
+ =head1 SYNOPSIS
+ 
+-    > cpanm --interactive Task::Kensho
++    # apt-get install libtask-kensho-perl
+ 
+ =head1 DESCRIPTION
+ 
+@@ -59,10 +59,11 @@
+ individually-installable tasks.  Each L<Task::Kensho> sub-task is listed at the
+ beginning of its section in this documentation.
+ 
+-When installing L<Task::Kensho> itself, you will be asked to install each
+-sub-task in turn, or you can install individual tasks separately. These
+-individual tasks will always install all their modules by default. This
+-facilitates the ease and simplicity the distribution aims to achieve.
++When installing L<Task::Kensho> in Debian GNU/Linux, you can install each
++sub-task metapackage separately (e.g. libtask-kensho-async-perl), or you
++can install all tasks at once by installing the libtask-kensho-perl metapackage.
++These metapackages facilitate the ease and simplicity the distribution aims
++to achieve whilst utilising the power of the Debian GNU/Linux package system.
+ 
+ =head1 RECOMMENDED MODULES
+ 
+@@ -488,13 +489,15 @@
+ 
+ =head1 INSTALLING
+ 
+-Since version 0.34, L<Task::Kensho> has made use of the C<optional_features> field
+-in distribution metadata. This allows CPAN clients to interact with you
+-regarding which modules you wish to install.
++To install all Task::Kensho tasks and their recommended modules on
++Debian GNU/Linux, install the libtask-kensho-perl metapackage:
+ 
+-The C<cpanm> client requires interactive mode to be enabled for this to work:
++    # apt-get install libtask-kensho-perl
+ 
+-    cpanm --interactive Task::Kensho
++Each Kensho task is itself a metapackage. To install a specific task,
++install the relevant metapackage. E.g. for Task::Kensho::Async:
++
++    # apt-get install libtask-kensho-async-perl
+ 
+ =head1 BUGS AND LIMITATIONS
+ 
diff --git a/debian/patches/series b/debian/patches/series
index 08f1150..f0b34a4 100644
--- a/debian/patches/series
+++ b/debian/patches/series
@@ -1 +1,2 @@
 0001-disable-makefile-subtask-installation.patch
+0002-remove-manual-installation-details-from-pod.patch

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