diff options
author | Karl Berry <karl@freefriends.org> | 2007-01-14 17:55:59 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2007-01-14 17:55:59 +0000 |
commit | 5b0f67e0123dc2452238e374c3538c76651c20aa (patch) | |
tree | 301bd93b500b12aa7e67341c2c4b5d7b6d981f00 /Master/texmf/doc | |
parent | 01ec0c278b71c97980ee3631c793910b87fd0f60 (diff) |
do not install these utilities on Unix, so no need for man pages
git-svn-id: svn://tug.org/texlive/trunk@3466 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf/doc')
-rw-r--r-- | Master/texmf/doc/man/man1/bzip2.1 | 453 | ||||
-rw-r--r-- | Master/texmf/doc/man/man1/gzip.1 | 478 | ||||
-rw-r--r-- | Master/texmf/doc/man/man1/texshow.1 | 69 | ||||
-rw-r--r-- | Master/texmf/doc/man/man1/vlna.1 | 130 |
4 files changed, 0 insertions, 1130 deletions
diff --git a/Master/texmf/doc/man/man1/bzip2.1 b/Master/texmf/doc/man/man1/bzip2.1 deleted file mode 100644 index 623435c2427..00000000000 --- a/Master/texmf/doc/man/man1/bzip2.1 +++ /dev/null @@ -1,453 +0,0 @@ -.PU -.TH bzip2 1 -.SH NAME -bzip2, bunzip2 \- a block-sorting file compressor, v1.0.2 -.br -bzcat \- decompresses files to stdout -.br -bzip2recover \- recovers data from damaged bzip2 files - -.SH SYNOPSIS -.ll +8 -.B bzip2 -.RB [ " \-cdfkqstvzVL123456789 " ] -[ -.I "filenames \&..." -] -.ll -8 -.br -.B bunzip2 -.RB [ " \-fkvsVL " ] -[ -.I "filenames \&..." -] -.br -.B bzcat -.RB [ " \-s " ] -[ -.I "filenames \&..." -] -.br -.B bzip2recover -.I "filename" - -.SH DESCRIPTION -.I bzip2 -compresses files using the Burrows-Wheeler block sorting -text compression algorithm, and Huffman coding. Compression is -generally considerably better than that achieved by more conventional -LZ77/LZ78-based compressors, and approaches the performance of the PPM -family of statistical compressors. - -The command-line options are deliberately very similar to -those of -.I GNU gzip, -but they are not identical. - -.I bzip2 -expects a list of file names to accompany the -command-line flags. Each file is replaced by a compressed version of -itself, with the name "original_name.bz2". -Each compressed file -has the same modification date, permissions, and, when possible, -ownership as the corresponding original, so that these properties can -be correctly restored at decompression time. File name handling is -naive in the sense that there is no mechanism for preserving original -file names, permissions, ownerships or dates in filesystems which lack -these concepts, or have serious file name length restrictions, such as -MS-DOS. - -.I bzip2 -and -.I bunzip2 -will by default not overwrite existing -files. If you want this to happen, specify the \-f flag. - -If no file names are specified, -.I bzip2 -compresses from standard -input to standard output. In this case, -.I bzip2 -will decline to -write compressed output to a terminal, as this would be entirely -incomprehensible and therefore pointless. - -.I bunzip2 -(or -.I bzip2 \-d) -decompresses all -specified files. Files which were not created by -.I bzip2 -will be detected and ignored, and a warning issued. -.I bzip2 -attempts to guess the filename for the decompressed file -from that of the compressed file as follows: - - filename.bz2 becomes filename - filename.bz becomes filename - filename.tbz2 becomes filename.tar - filename.tbz becomes filename.tar - anyothername becomes anyothername.out - -If the file does not end in one of the recognised endings, -.I .bz2, -.I .bz, -.I .tbz2 -or -.I .tbz, -.I bzip2 -complains that it cannot -guess the name of the original file, and uses the original name -with -.I .out -appended. - -As with compression, supplying no -filenames causes decompression from -standard input to standard output. - -.I bunzip2 -will correctly decompress a file which is the -concatenation of two or more compressed files. The result is the -concatenation of the corresponding uncompressed files. Integrity -testing (\-t) -of concatenated -compressed files is also supported. - -You can also compress or decompress files to the standard output by -giving the \-c flag. Multiple files may be compressed and -decompressed like this. The resulting outputs are fed sequentially to -stdout. Compression of multiple files -in this manner generates a stream -containing multiple compressed file representations. Such a stream -can be decompressed correctly only by -.I bzip2 -version 0.9.0 or -later. Earlier versions of -.I bzip2 -will stop after decompressing -the first file in the stream. - -.I bzcat -(or -.I bzip2 -dc) -decompresses all specified files to -the standard output. - -.I bzip2 -will read arguments from the environment variables -.I BZIP2 -and -.I BZIP, -in that order, and will process them -before any arguments read from the command line. This gives a -convenient way to supply default arguments. - -Compression is always performed, even if the compressed -file is slightly -larger than the original. Files of less than about one hundred bytes -tend to get larger, since the compression mechanism has a constant -overhead in the region of 50 bytes. Random data (including the output -of most file compressors) is coded at about 8.05 bits per byte, giving -an expansion of around 0.5%. - -As a self-check for your protection, -.I -bzip2 -uses 32-bit CRCs to -make sure that the decompressed version of a file is identical to the -original. This guards against corruption of the compressed data, and -against undetected bugs in -.I bzip2 -(hopefully very unlikely). The -chances of data corruption going undetected is microscopic, about one -chance in four billion for each file processed. Be aware, though, that -the check occurs upon decompression, so it can only tell you that -something is wrong. It can't help you -recover the original uncompressed -data. You can use -.I bzip2recover -to try to recover data from -damaged files. - -Return values: 0 for a normal exit, 1 for environmental problems (file -not found, invalid flags, I/O errors, &c), 2 to indicate a corrupt -compressed file, 3 for an internal consistency error (eg, bug) which -caused -.I bzip2 -to panic. - -.SH OPTIONS -.TP -.B \-c --stdout -Compress or decompress to standard output. -.TP -.B \-d --decompress -Force decompression. -.I bzip2, -.I bunzip2 -and -.I bzcat -are -really the same program, and the decision about what actions to take is -done on the basis of which name is used. This flag overrides that -mechanism, and forces -.I bzip2 -to decompress. -.TP -.B \-z --compress -The complement to \-d: forces compression, regardless of the -invocation name. -.TP -.B \-t --test -Check integrity of the specified file(s), but don't decompress them. -This really performs a trial decompression and throws away the result. -.TP -.B \-f --force -Force overwrite of output files. Normally, -.I bzip2 -will not overwrite -existing output files. Also forces -.I bzip2 -to break hard links -to files, which it otherwise wouldn't do. - -bzip2 normally declines to decompress files which don't have the -correct magic header bytes. If forced (-f), however, it will pass -such files through unmodified. This is how GNU gzip behaves. -.TP -.B \-k --keep -Keep (don't delete) input files during compression -or decompression. -.TP -.B \-s --small -Reduce memory usage, for compression, decompression and testing. Files -are decompressed and tested using a modified algorithm which only -requires 2.5 bytes per block byte. This means any file can be -decompressed in 2300k of memory, albeit at about half the normal speed. - -During compression, \-s selects a block size of 200k, which limits -memory use to around the same figure, at the expense of your compression -ratio. In short, if your machine is low on memory (8 megabytes or -less), use \-s for everything. See MEMORY MANAGEMENT below. -.TP -.B \-q --quiet -Suppress non-essential warning messages. Messages pertaining to -I/O errors and other critical events will not be suppressed. -.TP -.B \-v --verbose -Verbose mode -- show the compression ratio for each file processed. -Further \-v's increase the verbosity level, spewing out lots of -information which is primarily of interest for diagnostic purposes. -.TP -.B \-L --license -V --version -Display the software version, license terms and conditions. -.TP -.B \-1 (or \-\-fast) to \-9 (or \-\-best) -Set the block size to 100 k, 200 k .. 900 k when compressing. Has no -effect when decompressing. See MEMORY MANAGEMENT below. -The \-\-fast and \-\-best aliases are primarily for GNU gzip -compatibility. In particular, \-\-fast doesn't make things -significantly faster. -And \-\-best merely selects the default behaviour. -.TP -.B \-- -Treats all subsequent arguments as file names, even if they start -with a dash. This is so you can handle files with names beginning -with a dash, for example: bzip2 \-- \-myfilename. -.TP -.B \--repetitive-fast --repetitive-best -These flags are redundant in versions 0.9.5 and above. They provided -some coarse control over the behaviour of the sorting algorithm in -earlier versions, which was sometimes useful. 0.9.5 and above have an -improved algorithm which renders these flags irrelevant. - -.SH MEMORY MANAGEMENT -.I bzip2 -compresses large files in blocks. The block size affects -both the compression ratio achieved, and the amount of memory needed for -compression and decompression. The flags \-1 through \-9 -specify the block size to be 100,000 bytes through 900,000 bytes (the -default) respectively. At decompression time, the block size used for -compression is read from the header of the compressed file, and -.I bunzip2 -then allocates itself just enough memory to decompress -the file. Since block sizes are stored in compressed files, it follows -that the flags \-1 to \-9 are irrelevant to and so ignored -during decompression. - -Compression and decompression requirements, -in bytes, can be estimated as: - - Compression: 400k + ( 8 x block size ) - - Decompression: 100k + ( 4 x block size ), or - 100k + ( 2.5 x block size ) - -Larger block sizes give rapidly diminishing marginal returns. Most of -the compression comes from the first two or three hundred k of block -size, a fact worth bearing in mind when using -.I bzip2 -on small machines. -It is also important to appreciate that the decompression memory -requirement is set at compression time by the choice of block size. - -For files compressed with the default 900k block size, -.I bunzip2 -will require about 3700 kbytes to decompress. To support decompression -of any file on a 4 megabyte machine, -.I bunzip2 -has an option to -decompress using approximately half this amount of memory, about 2300 -kbytes. Decompression speed is also halved, so you should use this -option only where necessary. The relevant flag is -s. - -In general, try and use the largest block size memory constraints allow, -since that maximises the compression achieved. Compression and -decompression speed are virtually unaffected by block size. - -Another significant point applies to files which fit in a single block --- that means most files you'd encounter using a large block size. The -amount of real memory touched is proportional to the size of the file, -since the file is smaller than a block. For example, compressing a file -20,000 bytes long with the flag -9 will cause the compressor to -allocate around 7600k of memory, but only touch 400k + 20000 * 8 = 560 -kbytes of it. Similarly, the decompressor will allocate 3700k but only -touch 100k + 20000 * 4 = 180 kbytes. - -Here is a table which summarises the maximum memory usage for different -block sizes. Also recorded is the total compressed size for 14 files of -the Calgary Text Compression Corpus totalling 3,141,622 bytes. This -column gives some feel for how compression varies with block size. -These figures tend to understate the advantage of larger block sizes for -larger files, since the Corpus is dominated by smaller files. - - Compress Decompress Decompress Corpus - Flag usage usage -s usage Size - - -1 1200k 500k 350k 914704 - -2 2000k 900k 600k 877703 - -3 2800k 1300k 850k 860338 - -4 3600k 1700k 1100k 846899 - -5 4400k 2100k 1350k 845160 - -6 5200k 2500k 1600k 838626 - -7 6100k 2900k 1850k 834096 - -8 6800k 3300k 2100k 828642 - -9 7600k 3700k 2350k 828642 - -.SH RECOVERING DATA FROM DAMAGED FILES -.I bzip2 -compresses files in blocks, usually 900kbytes long. Each -block is handled independently. If a media or transmission error causes -a multi-block .bz2 -file to become damaged, it may be possible to -recover data from the undamaged blocks in the file. - -The compressed representation of each block is delimited by a 48-bit -pattern, which makes it possible to find the block boundaries with -reasonable certainty. Each block also carries its own 32-bit CRC, so -damaged blocks can be distinguished from undamaged ones. - -.I bzip2recover -is a simple program whose purpose is to search for -blocks in .bz2 files, and write each block out into its own .bz2 -file. You can then use -.I bzip2 -\-t -to test the -integrity of the resulting files, and decompress those which are -undamaged. - -.I bzip2recover -takes a single argument, the name of the damaged file, -and writes a number of files "rec00001file.bz2", -"rec00002file.bz2", etc, containing the extracted blocks. -The output filenames are designed so that the use of -wildcards in subsequent processing -- for example, -"bzip2 -dc rec*file.bz2 > recovered_data" -- processes the files in -the correct order. - -.I bzip2recover -should be of most use dealing with large .bz2 -files, as these will contain many blocks. It is clearly -futile to use it on damaged single-block files, since a -damaged block cannot be recovered. If you wish to minimise -any potential data loss through media or transmission errors, -you might consider compressing with a smaller -block size. - -.SH PERFORMANCE NOTES -The sorting phase of compression gathers together similar strings in the -file. Because of this, files containing very long runs of repeated -symbols, like "aabaabaabaab ..." (repeated several hundred times) may -compress more slowly than normal. Versions 0.9.5 and above fare much -better than previous versions in this respect. The ratio between -worst-case and average-case compression time is in the region of 10:1. -For previous versions, this figure was more like 100:1. You can use the -\-vvvv option to monitor progress in great detail, if you want. - -Decompression speed is unaffected by these phenomena. - -.I bzip2 -usually allocates several megabytes of memory to operate -in, and then charges all over it in a fairly random fashion. This means -that performance, both for compressing and decompressing, is largely -determined by the speed at which your machine can service cache misses. -Because of this, small changes to the code to reduce the miss rate have -been observed to give disproportionately large performance improvements. -I imagine -.I bzip2 -will perform best on machines with very large caches. - -.SH CAVEATS -I/O error messages are not as helpful as they could be. -.I bzip2 -tries hard to detect I/O errors and exit cleanly, but the details of -what the problem is sometimes seem rather misleading. - -This manual page pertains to version 1.0.2 of -.I bzip2. -Compressed data created by this version is entirely forwards and -backwards compatible with the previous public releases, versions -0.1pl2, 0.9.0, 0.9.5, 1.0.0 and 1.0.1, but with the following -exception: 0.9.0 and above can correctly decompress multiple -concatenated compressed files. 0.1pl2 cannot do this; it will stop -after decompressing just the first file in the stream. - -.I bzip2recover -versions prior to this one, 1.0.2, used 32-bit integers to represent -bit positions in compressed files, so it could not handle compressed -files more than 512 megabytes long. Version 1.0.2 and above uses -64-bit ints on some platforms which support them (GNU supported -targets, and Windows). To establish whether or not bzip2recover was -built with such a limitation, run it without arguments. In any event -you can build yourself an unlimited version if you can recompile it -with MaybeUInt64 set to be an unsigned 64-bit integer. - - - -.SH AUTHOR -Julian Seward, jseward@acm.org. - -http://sources.redhat.com/bzip2 - -The ideas embodied in -.I bzip2 -are due to (at least) the following -people: Michael Burrows and David Wheeler (for the block sorting -transformation), David Wheeler (again, for the Huffman coder), Peter -Fenwick (for the structured coding model in the original -.I bzip, -and many refinements), and Alistair Moffat, Radford Neal and Ian Witten -(for the arithmetic coder in the original -.I bzip). -I am much -indebted for their help, support and advice. See the manual in the -source distribution for pointers to sources of documentation. Christian -von Roques encouraged me to look for faster sorting algorithms, so as to -speed up compression. Bela Lubkin encouraged me to improve the -worst-case compression performance. -The bz* scripts are derived from those of GNU gzip. -Many people sent patches, helped -with portability problems, lent machines, gave advice and were generally -helpful. diff --git a/Master/texmf/doc/man/man1/gzip.1 b/Master/texmf/doc/man/man1/gzip.1 deleted file mode 100644 index 6fa79862bfc..00000000000 --- a/Master/texmf/doc/man/man1/gzip.1 +++ /dev/null @@ -1,478 +0,0 @@ -.PU -.TH GZIP 1 local -.SH NAME -gzip, gunzip, zcat \- compress or expand files -.SH SYNOPSIS -.ll +8 -.B gzip -.RB [ " \-acdfhlLnNrtvV19 " ] -.RB [ \-S\ suffix ] -[ -.I "name \&..." -] -.ll -8 -.br -.B gunzip -.RB [ " \-acfhlLnNrtvV " ] -.RB [ \-S\ suffix ] -[ -.I "name \&..." -] -.br -.B zcat -.RB [ " \-fhLV " ] -[ -.I "name \&..." -] -.SH DESCRIPTION -.I Gzip -reduces the size of the named files using Lempel-Ziv coding (LZ77). -Whenever possible, -each file is replaced by one with the extension -.B "\&.gz," -while keeping the same ownership modes, access and modification times. -(The default extension is -.B "\-gz" -for VMS, -.B "z" -for MSDOS, OS/2 FAT, Windows NT FAT and Atari.) -If no files are specified, or if a file name is "-", the standard input is -compressed to the standard output. -.I Gzip -will only attempt to compress regular files. -In particular, it will ignore symbolic links. -.PP -If the compressed file name is too long for its file system, -.I gzip -truncates it. -.I Gzip -attempts to truncate only the parts of the file name longer than 3 characters. -(A part is delimited by dots.) If the name consists of small parts only, -the longest parts are truncated. For example, if file names are limited -to 14 characters, gzip.msdos.exe is compressed to gzi.msd.exe.gz. -Names are not truncated on systems which do not have a limit on file name -length. -.PP -By default, -.I gzip -keeps the original file name and timestamp in the compressed file. These -are used when decompressing the file with the -.B \-N -option. This is useful when the compressed file name was truncated or -when the time stamp was not preserved after a file transfer. -.PP -Compressed files can be restored to their original form using -.I gzip -d -or -.I gunzip -or -.I zcat. -If the original name saved in the compressed file is not suitable for its -file system, a new name is constructed from the original one to make it -legal. -.PP -.I gunzip -takes a list of files on its command line and replaces each -file whose name ends with .gz, -gz, .z, -z, _z or .Z -and which begins with the correct magic number with an uncompressed -file without the original extension. -.I gunzip -also recognizes the special extensions -.B "\&.tgz" -and -.B "\&.taz" -as shorthands for -.B "\&.tar.gz" -and -.B "\&.tar.Z" -respectively. -When compressing, -.I gzip -uses the -.B "\&.tgz" -extension if necessary instead of truncating a file with a -.B "\&.tar" -extension. -.PP -.I gunzip -can currently decompress files created by -.I gzip, zip, compress, compress -H -or -.I pack. -The detection of the input format is automatic. When using -the first two formats, -.I gunzip -checks a 32 bit CRC. For -.I pack, gunzip -checks the uncompressed length. The standard -.I compress -format was not designed to allow consistency checks. However -.I gunzip -is sometimes able to detect a bad .Z file. If you get an error -when uncompressing a .Z file, do not assume that the .Z file is -correct simply because the standard -.I uncompress -does not complain. This generally means that the standard -.I uncompress -does not check its input, and happily generates garbage output. -The SCO compress -H format (lzh compression method) does not include a CRC -but also allows some consistency checks. -.PP -Files created by -.I zip -can be uncompressed by gzip only if they have a single member compressed -with the 'deflation' method. This feature is only intended to help -conversion of tar.zip files to the tar.gz format. To extract zip files -with several members, use -.I unzip -instead of -.I gunzip. -.PP -.I zcat -is identical to -.I gunzip -.B \-c. -(On some systems, -.I zcat -may be installed as -.I gzcat -to preserve the original link to -.I compress.) -.I zcat -uncompresses either a list of files on the command line or its -standard input and writes the uncompressed data on standard output. -.I zcat -will uncompress files that have the correct magic number whether -they have a -.B "\&.gz" -suffix or not. -.PP -.I Gzip -uses the Lempel-Ziv algorithm used in -.I zip -and PKZIP. -The amount of compression obtained depends on the size of the -input and the distribution of common substrings. -Typically, text such as source code or English -is reduced by 60\-70%. -Compression is generally much better than that achieved by -LZW (as used in -.IR compress ), -Huffman coding (as used in -.IR pack ), -or adaptive Huffman coding -.RI ( compact ). -.PP -Compression is always performed, even if the compressed file is -slightly larger than the original. The worst case expansion is -a few bytes for the gzip file header, plus 5 bytes every 32K block, -or an expansion ratio of 0.015% for large files. Note that the actual -number of used disk blocks almost never increases. -.I gzip -preserves the mode, ownership and timestamps of files when compressing -or decompressing. - -.SH OPTIONS -.TP -.B \-a --ascii -Ascii text mode: convert end-of-lines using local conventions. This option -is supported only on some non-Unix systems. For MSDOS, CR LF is converted -to LF when compressing, and LF is converted to CR LF when decompressing. -.TP -.B \-c --stdout --to-stdout -Write output on standard output; keep original files unchanged. -If there are several input files, the output consists of a sequence of -independently compressed members. To obtain better compression, -concatenate all input files before compressing them. -.TP -.B \-d --decompress --uncompress -Decompress. -.TP -.B \-f --force -Force compression or decompression even if the file has multiple links -or the corresponding file already exists, or if the compressed data -is read from or written to a terminal. If the input data is not in -a format recognized by -.I gzip, -and if the option --stdout is also given, copy the input data without change -to the standard ouput: let -.I zcat -behave as -.I cat. -If -.B \-f -is not given, -and when not running in the background, -.I gzip -prompts to verify whether an existing file should be overwritten. -.TP -.B \-h --help -Display a help screen and quit. -.TP -.B \-l --list -For each compressed file, list the following fields: - - compressed size: size of the compressed file - uncompressed size: size of the uncompressed file - ratio: compression ratio (0.0% if unknown) - uncompressed_name: name of the uncompressed file - -The uncompressed size is given as -1 for files not in gzip format, -such as compressed .Z files. To get the uncompressed size for such a file, -you can use: - - zcat file.Z | wc -c - -In combination with the --verbose option, the following fields are also -displayed: - - method: compression method - crc: the 32-bit CRC of the uncompressed data - date & time: time stamp for the uncompressed file - -The compression methods currently supported are deflate, compress, lzh -(SCO compress -H) and pack. The crc is given as ffffffff for a file -not in gzip format. - -With --name, the uncompressed name, date and time are -those stored within the compress file if present. - -With --verbose, the size totals and compression ratio for all files -is also displayed, unless some sizes are unknown. With --quiet, -the title and totals lines are not displayed. -.TP -.B \-L --license -Display the -.I gzip -license and quit. -.TP -.B \-n --no-name -When compressing, do not save the original file name and time stamp by -default. (The original name is always saved if the name had to be -truncated.) When decompressing, do not restore the original file name -if present (remove only the -.I gzip -suffix from the compressed file name) and do not restore the original -time stamp if present (copy it from the compressed file). This option -is the default when decompressing. -.TP -.B \-N --name -When compressing, always save the original file name and time stamp; this -is the default. When decompressing, restore the original file name and -time stamp if present. This option is useful on systems which have -a limit on file name length or when the time stamp has been lost after -a file transfer. -.TP -.B \-q --quiet -Suppress all warnings. -.TP -.B \-r --recursive -Travel the directory structure recursively. If any of the file names -specified on the command line are directories, -.I gzip -will descend into the directory and compress all the files it finds there -(or decompress them in the case of -.I gunzip -). -.TP -.B \-S .suf --suffix .suf -Use suffix .suf instead of .gz. Any suffix can be given, but suffixes -other than .z and .gz should be avoided to avoid confusion when files -are transferred to other systems. A null suffix forces gunzip to try -decompression on all given files regardless of suffix, as in: - - gunzip -S "" * (*.* for MSDOS) - -Previous versions of gzip used -the .z suffix. This was changed to avoid a conflict with -.IR pack "(1)". -.TP -.B \-t --test -Test. Check the compressed file integrity. -.TP -.B \-v --verbose -Verbose. Display the name and percentage reduction for each file compressed -or decompressed. -.TP -.B \-V --version -Version. Display the version number and compilation options then quit. -.TP -.B \-# --fast --best -Regulate the speed of compression using the specified digit -.IR # , -where -.B \-1 -or -.B \-\-fast -indicates the fastest compression method (less compression) -and -.B \-9 -or -.B \-\-best -indicates the slowest compression method (best compression). -The default compression level is -.BR \-6 -(that is, biased towards high compression at expense of speed). -.SH "ADVANCED USAGE" -Multiple compressed files can be concatenated. In this case, -.I gunzip -will extract all members at once. For example: - - gzip -c file1 > foo.gz - gzip -c file2 >> foo.gz - -Then - gunzip -c foo - -is equivalent to - - cat file1 file2 - -In case of damage to one member of a .gz file, other members can -still be recovered (if the damaged member is removed). However, -you can get better compression by compressing all members at once: - - cat file1 file2 | gzip > foo.gz - -compresses better than - - gzip -c file1 file2 > foo.gz - -If you want to recompress concatenated files to get better compression, do: - - gzip -cd old.gz | gzip > new.gz - -If a compressed file consists of several members, the uncompressed -size and CRC reported by the --list option applies to the last member -only. If you need the uncompressed size for all members, you can use: - - gzip -cd file.gz | wc -c - -If you wish to create a single archive file with multiple members so -that members can later be extracted independently, use an archiver -such as tar or zip. GNU tar supports the -z option to invoke gzip -transparently. gzip is designed as a complement to tar, not as a -replacement. -.SH "ENVIRONMENT" -The environment variable -.B GZIP -can hold a set of default options for -.I gzip. -These options are interpreted first and can be overwritten by -explicit command line parameters. For example: - for sh: GZIP="-8v --name"; export GZIP - for csh: setenv GZIP "-8v --name" - for MSDOS: set GZIP=-8v --name - -On Vax/VMS, the name of the environment variable is GZIP_OPT, to -avoid a conflict with the symbol set for invocation of the program. -.SH "SEE ALSO" -znew(1), zcmp(1), zmore(1), zforce(1), gzexe(1), zip(1), unzip(1), compress(1), -pack(1), compact(1) -.SH "DIAGNOSTICS" -Exit status is normally 0; -if an error occurs, exit status is 1. If a warning occurs, exit status is 2. -.PP -Usage: gzip [-cdfhlLnNrtvV19] [-S suffix] [file ...] -.in +8 -Invalid options were specified on the command line. -.in -8 -.IR file : -not in gzip format -.in +8 -The file specified to -.I gunzip -has not been compressed. -.in -8 -.IR file: -Corrupt input. Use zcat to recover some data. -.in +8 -The compressed file has been damaged. The data up to the point of failure -can be recovered using -.in +8 -zcat file > recover -.in -16 -.IR file : -compressed with -.I xx -bits, can only handle -.I yy -bits -.in +8 -.I File -was compressed (using LZW) by a program that could deal with -more -.I bits -than the decompress code on this machine. -Recompress the file with gzip, which compresses better and uses -less memory. -.in -8 -.IR file : -already has .gz suffix -- no change -.in +8 -The file is assumed to be already compressed. -Rename the file and try again. -.in -8 -.I file -already exists; do you wish to overwrite (y or n)? -.in +8 -Respond "y" if you want the output file to be replaced; "n" if not. -.in -8 -gunzip: corrupt input -.in +8 -A SIGSEGV violation was detected which usually means that the input file has -been corrupted. -.in -8 -.I "xx.x%" -.in +8 -Percentage of the input saved by compression. -(Relevant only for -.BR \-v -and -.BR \-l \.) -.in -8 --- not a regular file or directory: ignored -.in +8 -When the input file is not a regular file or directory, -(e.g. a symbolic link, socket, FIFO, device file), it is -left unaltered. -.in -8 --- has -.I xx -other links: unchanged -.in +8 -The input file has links; it is left unchanged. See -.IR ln "(1)" -for more information. Use the -.B \-f -flag to force compression of multiply-linked files. -.in -8 -.SH CAVEATS -When writing compressed data to a tape, it is generally necessary to -pad the output with zeroes up to a block boundary. When the data is -read and the whole block is passed to -.I gunzip -for decompression, -.I gunzip -detects that there is extra trailing garbage after the compressed data -and emits a warning by default. You have to use the --quiet option to -suppress the warning. This option can be set in the -.B GZIP -environment variable as in: - for sh: GZIP="-q" tar -xfz --block-compress /dev/rst0 - for csh: (setenv GZIP -q; tar -xfz --block-compr /dev/rst0 - -In the above example, gzip is invoked implicitly by the -z option of -GNU tar. Make sure that the same block size (-b option of tar) is used -for reading and writing compressed data on tapes. (This example -assumes you are using the GNU version of tar.) -.SH BUGS -The --list option reports incorrect sizes if they exceed 2 gigabytes. -The --list option reports sizes as -1 and crc as ffffffff if the -compressed file is on a non seekable media. - -In some rare cases, the --best option gives worse compression than -the default compression level (-6). On some highly redundant files, -.I compress -compresses better than -.I gzip. diff --git a/Master/texmf/doc/man/man1/texshow.1 b/Master/texmf/doc/man/man1/texshow.1 deleted file mode 100644 index 1fda1f952c8..00000000000 --- a/Master/texmf/doc/man/man1/texshow.1 +++ /dev/null @@ -1,69 +0,0 @@ -.TH "texshow" "1" "Oct 2000" "ConTeXt" "CONTEXT" -.PP -.SH "NAME" -texshow \- ConTeXt command and parameter reference -.PP -.SH "SYNOPSIS" -\fBtexshow\fP [ \fIOPTION\fP ] [ \fICOMMAND\fP ] -[ \fILANGUAGE\fP ] -.PP -.SH "DESCRIPTION" -.PP -\fBtexshow\fP uses \fBperl\fP(1) and PerlTk (see \fBTk\fP(3pm)) to -show a overview of the commands and parameters of those\&. In the Tk -window you can search for a command and by switching the interface, -you can see the equivalent in another interface language\&. -.PP -\fICOMMAND\fP is a \fBConTeXt\fP command to search for in the -database\&. Note that Plain TeX commands are not (yet) in this database -although they can be used in \fBConTeXt\fP source files\&. -.PP -\fILANGUAGE\fP can be one of \fBcz\fP (Czech), \fBde\fP -(German), \fBen\fP (US-English) or \fBnl\fP (Dutch)\&. The default -language is Dutch\&. -.PP -You can also set the interface language with the -\fB--interface\fP switch\&. -.PP -.SH "OPTIONS" -.PP -.IP "\fB--help\fP" -Print a brief syntax summary -.IP "\fB--interface=\fP\fILANGUAGE\fP" -Primary interface language\&. -See DESCRIPTION for \fILANGUAGE\fP options\&. -.PP -.SH "FILES" -.PP -.IP "\fITEXMF/context/perltk/cont_mis\&.pm\fP" -Perl module for -formatting data -.IP "\fITEXMF/context/perltk/cont_set\&.pm\fP" -Perl module for -defining and constructing Tk interface -.IP "\fITEXMF/context/data/cont-\fIXX\fP\&.tws\fP" -The database -file\&. At this writing, \fIXX\fP can be one of \fBcz\fP (Czech), -\fBde\fP (German), \fBen\fP (English), \fBit\fP (Italian), or -\fBnl\fP (Dutch)\&. Which file is used is determined by the -\fILANGUAGE\fP specified on the command line\&. -.PP -.SH "SEE ALSO" -.PP -\fBtexexec\fP(1), \fBtexutil\fP(1), \fBpdfetex\fP(1), -\fBpdftex\fP(1)\&. -.PP -Web page: <http://www\&.pragma-ade\&.com/> -.PP -.SH "AUTHOR" -.PP -\fBtexshow\fP was written by Hans Hagen -<pragma@wxs\&.nl>\&. -.PP -This manpage was written by Tobias Burnus -<burnus@gmx\&.de> and C\&.M\&. Connelly -<c@eskimo\&.com>\&. -.PP -\fBtexshow\fP is part of \fBTeXWork\fP and \fBConTeXt\fP and is available -from <http://www\&.pragma-ade\&.com/pragma-ade/>\&. -.PP diff --git a/Master/texmf/doc/man/man1/vlna.1 b/Master/texmf/doc/man/man1/vlna.1 deleted file mode 100644 index 4bbe9f70ffc..00000000000 --- a/Master/texmf/doc/man/man1/vlna.1 +++ /dev/null @@ -1,130 +0,0 @@ -.\" $Id$ -.TH VLNA 1 "4. unora 1998" -.nh -.SH NAZEV -vlna \- pridani vlnek za neslabicne predlozky v TeXu -.SH POUZITI -.B vlna -[\fIvolby\fP] -[\fIsoubory\fP] -.SH POPIS -Program -.B vlna -pridava vlnky (misto puvodnich mezer) za neslabicne predlozky -ve vstupnich souborech pro TeX, coz zabrani zlomu radku v nezadoucich mistech. -.PP -Veskere aktivity programu je mozne vypnout sekvenci \fB%~-\fP a zapnout -sekvenci \fB%~+\fP (mezi uvedenymi znaky muze byt libovolne mnozstvi mezer). -.PP -Pred predlozkou se muze nachazet libovolne mnozstvi oteviracich zavorek, -pred kterymi se musi nachazet mezera nebo zacatek radku. Pred -oteviraci svorkou muze byt take misto mezery TeXova -\(lq\\sekvence\(rq (od verze 1.2). -Napr. za \(lq([{(V\(rq na pocatku radku bude vlnka pridana. -Stejne tak se text \(lq\\uv{V lese}\(rq promeni na -\(lq\\uv{V~lese}\(rq. -.PP -Program kontroluje konzistenci matematickych prostredi (neni-li uveden -parametr \fB\-m\fP). -Vstup do \fIdisplay\fP rezimu (\fB$$\fP) uvnitr \fItext\fP rezimu (\fB$\fP) -(napr. \fB$\fP...\fB$$\fP...\fB$\fP) znamena varovani a prechod do -\fIdisplay\fP. -Podobne prazdny radek uvnitr \fItext\fP nebo \fIdisplay\fP rezimu znamena -vypis varovani a prechod do nematematickeho (standardniho) rezimu. -Uvnitr rezimu \fIdisplay\fP se ignoruji vyskyty samostatneho znaku \fB$\fP, -jelikoz byva vetsinou soucasti konstrukce \fB\\hbox\fP. -.PP -Program kontroluje konzistenci verbatim rezimu na konci souboru. -Nebyl-li ukoncen, vypise se varovani. -Kontrola se neprovadi, pokud je pouzita volba \fB\-n\fP nebo \fB\-w\fP. -.PP -Program nedoplnuje vlnky za samostatna pismena, ktera jako predlozky vypadaji, -ale nasleduji bezprostredne za sekvencemi \fB\\TeX\fP nebo \fB\\LaTeX\fP. -Napr. do textu \(lq\fBVlastnosti \\TeX u jsou\fP\(rq nebude zadna vlnka -doplnena. -.SH VOLBY -Volby jsou nepovinne a mohou byt uvedeny v libovolnem poradi, ale nemohou -byt spojovany. -.TP -.B \-f -Filtr. Jmena souboru jsou interpretovana takto: -.RS -.TP 4 -.B vlna \-f \fIsoubor1 soubor2\fP -Vstup je \fIsoubor1\fP, vystup \fIsoubor2\fP. -.TP 4 -.B vlna \-f \fIsoubor1\fP -Vstup je \fIsoubor1\fP, vystup \fIstdout\fP. -.TP 4 -.B vlna \-f -Vstup je \fIstdin\fP, vystup \fIstdout\fP. -.TP 4 -\fBvlna\fP \fIsoubor1\fP [\fIsoubor2\fP [\fIsoubor3\fP ...]] -Neni-li uveden parametr \fB\-f\fP, kazdy soubor je zpracovavan samostatne. -.RE -.TP -.B \-s -Tichy rezim. Program potlaci vypis uvodni zpravy, varovnych zprav a -statistik o zmenach v souborech -(bez uvedeni parametru jsou zpravy vypisovany na \fIstderr\fP). -V tichem rezimu se vypise jen chyba, ktera predcasne ukonci -cinnost programu. -.TP -.B \-r -Nevytvaret (mazat) zalohy. -Parametr \fB\-r\fP nema vliv, pokud je uveden spolu s \fB\-f\fP. -V opacnem pripade se ke kazdemu souboru vytvari zaloha s vlnkou na konci jmena -a parametr \fB\-r\fP zpusobi, ze na konci zpracovani jsou tyto zalohy mazany. -.TP -.B \-v \fIznaky\fP -Znaky povazovane za neslabicne predlozky, za ktere ma byt pridavana -vlnka. Implicitni hodnota je \fB\-v\ KkSsVvZzOoUuAI\fP. (Mezi -\fB\-v\fP a skupinou znaku musi byt mezera.) -.TP -.B \-m -Ignorovani prechodu do matematickych prostredi -(\fB$\fP...\fB$\fP a \fB$$\fP...\fB$$\fP). -Parametr \fB\-m\fP zpusobi vlnkovani i v matematickych prostredich, ktera -se implicitne vynechavaji. -.TP -.B \-n -Ignorovani verbatim rezimu (\fB\\verb\fP\fI<znak>\fP...\fI<znak>\fP, -\fB\\begtt\fP...\fB\\endtt\fP). -Parametr \fB\-n\fP zpusobi vlnkovani i ve verbatim rezimu, ktery se -implicitne vynechava. -.TP -.B \-l -LaTeX. Pro rozpoznani matematickeho rezimu jsou pridana prostredi -\fB\\begin{display}\fP...\fB\\end{display}\fP a -\fB\\begin{equation}\fP...\fB\\end{equation}\fP. -Pro rozpoznani verbatim rezimu je pridano LaTeXove prostredi -\fB\\begin{verbatim}\fP...\fB\\end{verbatim}\fP. -.TP -.B \-w -Web. Pro rozpoznani verbatim rezimu jsou pridany sekvence -\fB@<\fP, \fB@d\fP...\fB@*\fP, \fB@\fP\fImezera\fP nebo \fB@>|\fP. -Ve zdrojovem kodu se tedy nevlnkuje program, ale jen komentare. -.SH PRIKLADY -.TP -.B vlna \-m \-n \-s \-r \fIsoubor\fP -Volani priblizne odpovida volani puvodniho programu \fBvlna\fP. -(Navic se neprovadi vlnkovani za sekvencemi \fB\\TeX\fP a \fB\\LaTeX\fP.) -.TP -.B vlna *.tex -Vlnkovani vsech souboru s priponou \fBtex\fP. -(Pouze na UNIXu.) -.TP -.B vlna \-f soubor > /dev/null -Test konzistence matematickeho a verbatim rezimu bez provedeni zmen. -(Pouze na UNIXu.) -.SH SOUBORY -.PD 0 -.TP -.I c:Program FilesTeXLivebinwin32/vlna -spustitelny program -.TP -.I c:Program FilesTeXLivetexmfdocman/vlna.1 -manualova stranka -.PD -.SH AUTOR -Petr Olsak <olsak@math.feld.cvut.cz>. Manualovou stranku a Makefile vytvoril Rulolf Cejka |