summaryrefslogtreecommitdiff
path: root/Master/tlpkg/etc/dev.usage-via-podselect.patch
blob: c51e6157ddc50eda27aa2ce66690717f4c051590 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
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