summaryrefslogtreecommitdiff
path: root/Master/tlpkg/etc/dev.usage-via-podselect.patch
diff options
context:
space:
mode:
Diffstat (limited to 'Master/tlpkg/etc/dev.usage-via-podselect.patch')
-rw-r--r--Master/tlpkg/etc/dev.usage-via-podselect.patch197
1 files changed, 197 insertions, 0 deletions
diff --git a/Master/tlpkg/etc/dev.usage-via-podselect.patch b/Master/tlpkg/etc/dev.usage-via-podselect.patch
new file mode 100644
index 00000000000..c51e6157ddc
--- /dev/null
+++ b/Master/tlpkg/etc/dev.usage-via-podselect.patch
@@ -0,0 +1,197 @@
+--- /src/TeX/texlive-svn/Master/texmf/scripts/texlive/tlmgr2.pl 2008-12-15 08:27:24.000000000 +0100
++++ tlmgr2.pl 2008-12-15 08:57:06.000000000 +0100
+@@ -71,6 +71,7 @@
+ mkdirhier merge_into copy log debug));
+ use Cwd qw/abs_path/;
+ use Pod::Usage;
++use Pod::Select;
+ use Getopt::Long qw(:config no_autoabbrev require_order);
+ use strict;
+
+@@ -245,6 +246,22 @@
+ $localtlpdb->save;
+ }
+ finish(0);
++ } elsif ($action =~ m/^pod-test$/i) {
++ # piping the output of that to pod2text (-t) works very nicely
++ #podselect( {-output => \*STDOUT, -sections => ['ACTIONS/update.*']},
++ # qw:/home/norbert/tlfoo/2008/texmf/scripts/texlive/tlmgr2.pl:);
++ #exit(0);
++ #
++ # that would be the perfect solution, but somehow it always creates
++ # a very strange output, I guess due to automatic resetting of
++ # verbose to 1 in Pod/Usage.pm code after selecting the sections
++ # I have no idea how to debug that ... maybe copy Pod/Usage.pm to
++ # tlpkg/TeXLive and use that instead?
++ pod2usage( {
++ -exitval => 0,
++ -verbose => 99,
++ -sections => 'ACTIONS/update.*'
++ });
+ } elsif ($action =~ m/^get-mirror$/i) {
+ my $loc = give_ctan_mirror();
+ print("$loc\n");
+@@ -2669,21 +2686,19 @@
+
+ =head1 ACTIONS
+
+-=over 4
+-
+-=item B<help>
++=head2 help
+
+ Gives this help information (same as C<--help>).
+
+-=item B<version>
++=head2 version
+
+ Gives version information (same as C<--version>).
+
+-=item B<gui>
++=head2 gui
+
+ Start the graphical user interface.
+
+-=item B<install> [I<option>]... I<pkg>...
++=head2 install [I<option>]... I<pkg>...
+
+ Install each I<pkg> given on the command line. By default this installs
+ all packages on which the given I<pkg>s are dependent, also. Options:
+@@ -2726,7 +2741,7 @@
+ =back
+
+
+-=item B<update> [I<option>] [I<pkg>]...
++=head2 update [I<option>] [I<pkg>]...
+
+ Updates the packages given as arguments to the latest version available
+ at the installation source. Either C<--all> or at least one I<pkg> name
+@@ -2814,7 +2829,7 @@
+ downgrade. Also, packages for uninstalled platforms are not installed.
+
+
+-=item B<backup> [--clean[=I<N>]] [--backupdir I<dir>] [B<--all>] [I<pkg>]...
++=head2 backup [--clean[=I<N>]] [--backupdir I<dir>] [B<--all>] [I<pkg>]...
+
+ If the B<--clean> option is not specified, this action makes a backup of
+ the given packages, or all packages given C<--all>. These backups are
+@@ -2855,7 +2870,7 @@
+ =back
+
+
+-=item B<restore --backupdir> I<dir> [I<pkg> [I<rev>]]
++=head2 restore [--backupdir I<dir>] [I<pkg> [I<rev>]]
+
+ Restore a package from a previously-made backup.
+
+@@ -2884,7 +2899,7 @@
+ =back
+
+
+-=item B<remove> [I<option>]... I<pkg>...
++=head2 remove [I<option>]... I<pkg>...
+
+ Remove each I<pkg> specified. Removing a collection removes all package
+ dependencies, but not collection dependencies, in that collection
+@@ -2915,9 +2930,9 @@
+ =back
+
+
+-=item B<option [show]>
++=head2 option [show]
+
+-=item B<option I<key> [I<value>]>
++=head2 option I<key> [I<value>]
+
+ The first form shows the global TeX Live settings currently saved in the
+ TLPDB.
+@@ -2956,11 +2971,11 @@
+ In the C<--clean> mode of the C<backup> action this option also
+ specifies the number to be kept.
+
+-=item B<paper a4>
++=head2 paper a4
+
+-=item B<paper letter>
++=head2 paper letter
+
+-=item B<[xdvi|dvips|pdftex|dvipdfm|dvipdfmx|context] paper [help|I<papersize>|--list]>
++=head2 [xdvi|dvips|pdftex|dvipdfm|dvipdfmx|context] paper [help|I<papersize>|--list]
+
+ Configures the system wide paper settings, either for all programs at
+ once (first two forms), or just for the specified program (third
+@@ -2968,7 +2983,7 @@
+ specified program.
+
+
+-=item B<arch list|add> I<arch>...
++=head2 arch list|add I<arch>...
+
+ C<arch list> lists the TeX Live names of all the architectures
+ (C<i386-linux>, ...) available at the default install location.
+@@ -2986,7 +3001,7 @@
+ =back
+
+
+-=item B<search [I<option>]... I<what>>
++=head2 search [I<option>]... I<what>
+
+ By default searches the names, short and long descriptions of all
+ locally installed packages for the given argument (interpreted as
+@@ -3006,7 +3021,7 @@
+ =back
+
+
+-=item B<show [--list] I<pkg>...>
++=head2 show [--list] I<pkg>...
+
+ Shows information about I<pkg>: the name, category, installation status,
+ short and long description. Searches in the remote installation source
+@@ -3016,7 +3031,7 @@
+ shown, including those for architecture specific dependencies.
+
+
+-=item B<list [collections|schemes|I<pkg>...]>
++=head2 list [collections|schemes|I<pkg>...]
+
+ With no argument, lists all packages available at the default install
+ location, prefixing those already installed with C<i>.
+@@ -3027,7 +3042,7 @@
+ With anything else as arguments, operates as the C<show> action.
+
+
+-=item B<check [I<option>]... [files|collections|all]>
++=head2 check [I<option>]... [files|collections|all]
+
+ Executes one (or all) check(s) on the consistency of the installation.
+
+@@ -3070,15 +3085,15 @@
+ =back
+
+
+-=item B<generate language>
++=head2 generate language
+
+-=item B<generate language.dat>
++=head2 generate language.dat
+
+-=item B<generate language.def>
++=head2 generate language.def
+
+-=item B<generate fmtutil>
++=head2 generate fmtutil
+
+-=item B<generate updmap>
++=head2 generate updmap
+
+ The I<generate> action overwrites any manual changes made in the
+ respective files: it recreates them from scratch.
+@@ -3135,8 +3150,6 @@
+ C<web2c/fmtutil.cnf> (and C<fmtutil-local.cnf>)
+ C<web2c/updmap.cfg> (and C<updmap-local.cfg>)
+
+-=back
+-
+
+ =head1 AUTHORS AND COPYRIGHT
+