patool/doc/patool.txt

PATOOL(1)                                                            PATOOL(1)


NAME
       patool - simple manager for file archives of various types

SYNOPSIS
        patool (extract|list|test) [options] <archive-file>...
        patool create [options] <archive-file> [files...]
        patool formats [options]

DESCRIPTION
       Various  archive  types can be created, extracted, tested and listed by
       patool. The advantage of patool is its simplicity in  handling  archive
       files without having to remember a myriad of programs and options.

       The  archive format is determined by the file(1) program and as a fall‐
       back by the archive file extension.

       patool supports 7z (.7z), ZIP (.zip, .jar), GZIP (.gz), compress  (.Z),
       BZIP2  (.bz2),  TAR  (.tar),  ARJ (.arj), CAB (.cab), CPIO (.cpio), RPM
       (.rpm), DEB (.deb), LZIP (.lz), LZOP (.lzo), LZMA (.lzma),  RAR  (.rar)
       and XZ (.xz) formats.  It relies on helper applications to handle those
       archive formats (for example bzip2 for BZIP2 archives).

EXAMPLES
         patool extract archive.zip
         patool test --verbose dist.tar.gz
         patool list package.deb
         patool create --verbose myfiles.zip file1.txt dir/

COMMANDS
       Several commands and options are available.

   extract
       Extract files from an archive. This is the default command if  no  com‐
       mand was given.
       Often  one  wants to extract all files in an archive to a single subdi‐
       rectory.  However, some archives contain multiple files in  their  root
       directories.  The  patool  program  overcomes  this  problem  by  first
       extracting files to a unique (temporary) directory, and then moving its
       contents  back  if  possible. This also prevents local files from being
       overwritten by mistake.

       -v, --verbose
              Be verbose when extracting (if the helper  application  supports
              it).

       --help Show help for this command.

   list
       List files in an archive.

       -v, --verbose
              Verbose archive listing (if the helper application supports it).

       --help Show help for this command.

   create
       Create  an  archive from given files. At least on of the given files to
       add to the archive has to exist.

       -v, --verbose
              Verbose operation (if the helper application supports it).

       --help Show help for this command.

   test
       Test files in an archive.

       -v, --verbose
              Verbose archive testing (if the helper application supports it).

       --help Show help for this command.

   formats
       Show all supported archive formats.

       --help Show help for this command.

AUTHOR
       Bastian Kleineidam <calvin@users.sourceforge.net>

COPYRIGHT
       Copyright © 2010 Bastian Kleineidam


patool                           February 2010                       PATOOL(1)
-												Format patool.txt with 80 columns width.

											
										
										
											2010-03-04 18:51:47 +00:00
+								PATOOL(1)                                                            PATOOL(1)
-												Initial commit

											
										
										
											2010-02-21 11:14:57 +00:00
 								NAME
 								       patool - simple manager for file archives of various types
 								SYNOPSIS
-												Added --verbose option to create command

											
										
										
											2010-03-06 13:01:02 +00:00
+								        patool (extract|list|test) [options] <archive-file>...
 								        patool create [options] <archive-file> [files...]
-												Added test archive command.

											
										
										
											2010-02-21 12:40:42 +00:00
+								        patool formats [options]
-												Initial commit

											
										
										
											2010-02-21 11:14:57 +00:00
 								DESCRIPTION
-												Format patool.txt with 80 columns width.

											
										
										
											2010-03-04 18:51:47 +00:00
+								       Various  archive  types can be created, extracted, tested and listed by
 								       patool. The advantage of patool is its simplicity in  handling  archive
 								       files without having to remember a myriad of programs and options.
-												Initial commit

											
										
										
											2010-02-21 11:14:57 +00:00
-												Format patool.txt with 80 columns width.

											
										
										
											2010-03-04 18:51:47 +00:00
+								       The  archive format is determined by the file(1) program and as a fall‐
 								       back by the archive file extension.
-												Updated documentation and version

											
										
										
											2010-02-22 17:28:07 +00:00
-												Format patool.txt with 80 columns width.

											
										
										
											2010-03-04 18:51:47 +00:00
+								       patool supports 7z (.7z), ZIP (.zip, .jar), GZIP (.gz), compress  (.Z),
 								       BZIP2  (.bz2),  TAR  (.tar),  ARJ (.arj), CAB (.cab), CPIO (.cpio), RPM
 								       (.rpm), DEB (.deb), LZIP (.lz), LZOP (.lzo), LZMA (.lzma),  RAR  (.rar)
 								       and XZ (.xz) formats.  It relies on helper applications to handle those
 								       archive formats (for example bzip2 for BZIP2 archives).
-												Initial commit

											
										
										
											2010-02-21 11:14:57 +00:00
-												Added --verbose option to create command

											
										
										
											2010-03-06 13:01:02 +00:00
+								EXAMPLES
 								         patool extract archive.zip
 								         patool test --verbose dist.tar.gz
 								         patool list package.deb
 								         patool create --verbose myfiles.zip file1.txt dir/
-												Initial commit

											
										
										
											2010-02-21 11:14:57 +00:00
+								COMMANDS
 								       Several commands and options are available.
 								   extract
-												Make extract the default command; further improve parameter help.

											
										
										
											2010-03-06 10:29:25 +00:00
+								       Extract files from an archive. This is the default command if  no  com‐
 								       mand was given.
 								       Often  one  wants to extract all files in an archive to a single subdi‐
 								       rectory.  However, some archives contain multiple files in  their  root
 								       directories.  The  patool  program  overcomes  this  problem  by  first
 								       extracting files to a unique (temporary) directory, and then moving its
 								       contents  back  if  possible. This also prevents local files from being
 								       overwritten by mistake.
-												Initial commit

											
										
										
											2010-02-21 11:14:57 +00:00
-												Add -v short option.

											
										
										
											2010-03-06 10:38:29 +00:00
+								       -v, --verbose
-												Make extract the default command; further improve parameter help.

											
										
										
											2010-03-06 10:29:25 +00:00
+								              Be verbose when extracting (if the helper  application  supports
-												Format patool.txt with 80 columns width.

											
										
										
											2010-03-04 18:51:47 +00:00
+								              it).
-												Initial commit

											
										
										
											2010-02-21 11:14:57 +00:00
 								       --help Show help for this command.
 								   list
 								       List files in an archive.
-												Add -v short option.

											
										
										
											2010-03-06 10:38:29 +00:00
+								       -v, --verbose
-												Initial commit

											
										
										
											2010-02-21 11:14:57 +00:00
+								              Verbose archive listing (if the helper application supports it).
 								       --help Show help for this command.
-												Fixed old conflict patool.1 man page

											
										
										
											2010-02-21 18:04:13 +00:00
+								   create
-												Added --verbose option to create command

											
										
										
											2010-03-06 13:01:02 +00:00
+								       Create  an  archive from given files. At least on of the given files to
 								       add to the archive has to exist.
 								       -v, --verbose
 								              Verbose operation (if the helper application supports it).
-												Fixed old conflict patool.1 man page

											
										
										
											2010-02-21 18:04:13 +00:00
 								       --help Show help for this command.
-												Added test archive command.

											
										
										
											2010-02-21 12:40:42 +00:00
+								   test
 								       Test files in an archive.
-												Add -v short option.

											
										
										
											2010-03-06 10:38:29 +00:00
+								       -v, --verbose
-												Added test archive command.

											
										
										
											2010-02-21 12:40:42 +00:00
+								              Verbose archive testing (if the helper application supports it).
 								       --help Show help for this command.
-												Initial commit

											
										
										
											2010-02-21 11:14:57 +00:00
+								   formats
 								       Show all supported archive formats.
 								       --help Show help for this command.
 								AUTHOR
 								       Bastian Kleineidam <calvin@users.sourceforge.net>
 								COPYRIGHT
 								       Copyright © 2010 Bastian Kleineidam
-												Format patool.txt with 80 columns width.

											
										
										
											2010-03-04 18:51:47 +00:00
+								patool                           February 2010                       PATOOL(1)