From 97c685034b125b5fa73e8af967875d8146c4eae7 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sun, 14 Oct 2007 01:00:38 +0000 Subject: more doc niglets (and not done yet) git-svn-id: svn://tug.org/texlive/trunk@5181 c570f23f-e606-0410-a88d-b1316a301751 --- Master/tlpkg/bin/tlpfiles | 30 +++++++++++++++++++++--------- 1 file changed, 21 insertions(+), 9 deletions(-) (limited to 'Master/tlpkg/bin/tlpfiles') 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... +Output the TeX Live packages in which each 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 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 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 -- cgit v1.2.3