diff options
author | Karl Berry <karl@freefriends.org> | 2007-10-14 01:00:38 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2007-10-14 01:00:38 +0000 |
commit | 97c685034b125b5fa73e8af967875d8146c4eae7 (patch) | |
tree | 521440fbfab501d290a040af858ce0b791bee852 /Master/tlpkg/bin/tlpfiles | |
parent | c78ee64259772594abfc6cbda052f056fc695617 (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-x | Master/tlpkg/bin/tlpfiles | 30 |
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 |