summaryrefslogtreecommitdiff
path: root/Master/tlpkg/bin/tlpfiles
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2007-10-14 01:00:38 +0000
committerKarl Berry <karl@freefriends.org>2007-10-14 01:00:38 +0000
commit97c685034b125b5fa73e8af967875d8146c4eae7 (patch)
tree521440fbfab501d290a040af858ce0b791bee852 /Master/tlpkg/bin/tlpfiles
parentc78ee64259772594abfc6cbda052f056fc695617 (diff)
more doc niglets (and not done yet)
git-svn-id: svn://tug.org/texlive/trunk@5181 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/tlpkg/bin/tlpfiles')
-rwxr-xr-xMaster/tlpkg/bin/tlpfiles30
1 files changed, 21 insertions, 9 deletions
diff --git a/Master/tlpkg/bin/tlpfiles b/Master/tlpkg/bin/tlpfiles
index 14a49e943fb..5bc00fe6ce8 100755
--- a/Master/tlpkg/bin/tlpfiles
+++ b/Master/tlpkg/bin/tlpfiles
@@ -4,7 +4,8 @@
# This file is licensed under the GNU General Public License version 2
# or any later version.
#
-# Return all files for a given TeX Live package.
+# Return all files for a given TeX Live package, or package name(s) for
+# a given set of files.
our $mydir;
@@ -24,7 +25,8 @@ our $opt_debug = 0;
my $man = 0;
my $help = 0;
-GetOptions("debug!", "help|?" => \$help, "man" => \$man) or pod2usage(2);
+GetOptions("pkgof" => \@opt_pkgof,
+ "debug!", "help|?" => \$help, "man" => \$man) or pod2usage(2);
pod2usage(1) if $help;
pod2usage(-exitstatus => 0, -verbose => 2) if $man;
@@ -57,21 +59,25 @@ exit 0;
=head1 NAME
-tlpfiles - list files contained in a TeX Live package
+tlpfiles - list files contained in a TeX Live package, or vice versa
=head1 SYNOPSIS
tlpfiles [OPTION]... TLPKG
+or: tlpfiles [OPTION]... -pkgof FILE...
=head1 OPTIONS
=over 8
+=item B<-pkgof> I<file>...
+Output the TeX Live packages in which each <file> is contained.
+
=item B<-help>
-Print brief help message and exit.
+Print a brief help message and exit.
=item B<-man>
-Print formatted manual page and exit.
+Print this documentation as a formatted manual page and exit.
=item B<-debug>
Give debug messages from the TeX Live modules.
@@ -80,14 +86,20 @@ Give debug messages from the TeX Live modules.
=head1 DESCRIPTION
-Return all the files contained in the given TeX Live package (as
-determined by reading the TeX Live package database). This includes
-any executables as well as runtime, documentation, and source files.
+In the first form, with just I<TLPKG> specified, return all the files
+contained in the given TeX Live package (as determined by reading the
+TeX Live package database). This includes any executables as well as
+runtime, documentation, and source files.
It does not include the C<.tlpsrc> file for the package, since that is
-necessarily part of the build infrastructure rather than the
+necessarily part of the build infrastructure, and not part of the
self-contained package.
+In the second form, with the C<-pkgof> option, return the TeX Live
+package in which each given I<FILE> is contained, or C<-> if no package
+can be found. The files may be given as a single whitespace-separated
+argument, or the C<-pkgof> option may be given more than once, or both.
+
=head1 AUTHORS AND COPYRIGHT
This script and its documentation were written for the TeX Live