################################################################################ This is TeX Live Package Manager for Windows, v1.02 Public Domain, P.Jackowski@gust.org.pl ################################################################################ TECHNICAL NOTES: TLPM bases on TeX Live 2004. It does NOT support upgrade or downgrade of other versions. All the configuration is beyond the scope of TLPM functionality. It does not perform any post-installation actions such as setting environment variables, building formats or updating fontmap files. Please read 'tlpm.winconf' file to learn how to make manual configuration. TLPM is Windows related. It simply ignores (binary) packages for other platforms since there are custom installers available. TLPM tries to detect the CD drive automatically unless you use '--source' command-line option or 'tl_source' environment variable. It may be useful while installing from local hard drive resources. Target directory can be initialized with '--directory' command-line option or 'tl_target' variable. If both are missing, you will be prompted for the target in runtime (interactive mode) or it will be initialized to current directory (batch mode). TLPM can be run in batch mode. In such a case, each not empty line of the batch file is treated as a command, unless starts with '%' character. The range of commands and options available in batch mode is the same as in interactive mode. TLPM respects quotations (both double quotes and single quotes) used in command line. Quotation is necessary while using path names with spaces (strongly not recommended!) or other strange characters that may conflict with the command syntax. If so, please quote the entire phrase. Whenever analysing the command, TLPM also resolves environment variables expressed as %variable%. TLPM fully bases on the information retrieved from TPM files (actually from text files stored in texmf/lists directory). If you don't trust TPMs, do NOT trust TLPM either! The history of installed and uninstalled packages is saved in tlpm.log file stored in TeX Live target directory. TLPM do not reuse the file and reads the current installation state each time requested. TLPM is temporary rather than final solution. However, I hope it is better than nothing. I've done my best to make it functional and reliable, but can NOT warrant anything. If you like TLPM, feel free to redistribute it without any restrictions. TLPM is Public Domain. Big THANK YOU to Jolanta Szelatyńska, Staszek Wawrykiewicz, Jacek Kmiecik, and all others nice souls for all the help! Please reports bugs to P.Jackowski@gust.org.pl HISTORY: 23.02.2005, 1.00beta -- first beta release 06.04.2005, 1.01beta -- ugly bug corrected; 'inst' function couldn't be executed twice because of mistaken error code returned. Shame on me... 06.05.2005, 1.02 -- bugfix; some of messages redirected to files were stored in texmf/lists instead of runtime directory. ################################################################################ COMMANDS IN DETAILS ################################################################################ ##################################### tlpm ##################################### USAGE: tlpm [-s ] [-d ] [-b ] DESCRIPTION: TLPM may help to search, install and uninstall TeX Live 2004 packages. COMMANDS: tlpm>list % list packages or files matching given phrase tlpm>incl % list packages or files included in given bundle tlpm>blng % show to which bundle given package or file belongs tlpm>inst % install package in specified target (TeX root) directory tlpm>uninst % uninstall package from specified target directory tlpm>check % check installation dependencies and consistency tlpm>info % show package info tlpm>help % show this help or given command description tlpm>cmd % execute system command tlpm>quit % leave the program Type 'help ' for details. OPTIONS: -s --source set default TeX Live source path -d --directory set default TeX Live target path -b --batch enter batch mode -h --help display this help -H --Help display the entire readme EXAMPLES: % start in interactive mode tlpm % start in batch mode reading commands from 'file.lst' tlpm -b file.lst % set TeX Live target directory (do not prompt in runtime) tlpm -d D:\TeX % set TeX Live source and target tlpm -s E:\ -d D:\Tex % execute just one echo | tlpm ##################################### list ##################################### USAGE: list [-pfe] [] [-d ] DESCRIPTION: Lists files or packages from TeX Live CD or installation directory. OPTIONS: -p --packages search for packages matching (default) -f --files search for files matching -e --expression treat as Perl regular expression -d --directory list packages or files installed in directory EXAMPLES: % display a list of all packages available on TeX Live CD list % the same via pager list -p * | more % write all PFB files from the CD into font.log list -f *.pfb >font.log % the same, but with regex instead of mask list -fe ^.*\.pfb$ >font.log % list package collections installed in D:\TeX list coll* -d D:\TeX % the same, assuming that target directory has been specified already list coll* -d ##################################### incl ##################################### USAGE: incl [-pferj] [] DESCRIPTION: Displays a list of requirements and contents. OPTIONS: -p --packages show required packages matching (default) -f --files show included files matching -e --expression treat as Perl regex -r --recurse follow dependencies recursively (default) -j --justone do not recurse EXAMPLES: % display all packages required by collection-basic (via pager) incl collection-basic | more % display packages directly required by collection-basic incl collection-basic -j % write all TFM files included in collection-basic to tfms.lst incl collection-basic -f *.tfm > tfms.lst % display a list of collections included in gust scheme incl scheme-gust.scheme -p coll ##################################### blng ##################################### USAGE: blng [-pf] DESCRIPTION: Shows parent bundle(s) of package or file given by (not ). OPTIONS: -p --package treat as package (default) -f --file treat as file EXAMPLES: % show bundles that include collection-context blng collection-context % show package that contains 'manfnt.tfm' file blng -f manfnt.tfm ##################################### inst ##################################### USAGE: inst [-rjou] [-d ] DESCRIPTION: Install in specified target directory. OPTIONS: -r --recurse follow dependencies recursively (default) -j --justone do not recurse -o --overwrite overwrite already installed packages -u --update replace older, create missing files (implies -o) -d --directory install packages in directory EXAMPLES: % install entire collection-basic in D:\TeX inst collection-basic -d D:\TeX % reinstall basic collection, prompt for target directory (if not given already) inst collection-basic -o % just update ComputerModern fonts package inst cm -ju #################################### uninst #################################### USAGE: uninst [-rjiI] [-d ] DESCRIPTION: Uninstalls from specified target directory. OPTIONS: -r --recurse follow dependencies recursively (default) -j --justone do not recurse -i --ignore ignore dependencies -I --Ignore ignore dependencies indeed -d --directory uninstall packages from directory EXAMPLES: % remove LaTeX collection with all components, unless required by others uninst collection-latex % force remove LaTeX collection but keep shared packages untouched uninst collection-latex -i % force remove LaTeX and all its components, even if shared (dangerous) uninst collection-latex -I % remove just 'ltxmisc' package from D:\TeX uninst ltxmisc -j -d D:\TeX #################################### check #################################### USAGE: check [-pf][-d ] DESCRIPTION: Check installation dependencies and consistency. OPTIONS: -p --packages check packages (default) -f --files check files -d --directory check given directory EXAMPLES: % display missing packages from D:\TeX check -d D:\TeX % almost the same (prompt for directory, if not specified already) check % display files that should exist but can't be found check -f ##################################### help ##################################### USAGE: help [command] DESCRIPTION: Displays general help or usage details of given command. EXAMPLES: % display general help (via pager) help | more % tell me more about 'inst' command help inst % exactly the same inst --help ##################################### info ##################################### USAGE: info DESCRIPTION: Displays information about given package. EXAMPLES: % tell me something about ConTeXt info context ##################################### cmd ##################################### USAGE: cmd DESCRIPTION: Executes system command without exiting TLPM session. EXAMPLES: % test TeX cmd tex \input story \end % clear screen cmd cls ##################################### quit ##################################### USAGE: quit DESCRIPTION: Leaves the program. EXAMPLES: % say goodbye quit ################################################################################