README@b240777ae53e
README
Sat, 21 Apr 2007 13:09:58 -0400
- author
- brett
- date
- Sat, 21 Apr 2007 13:09:58 -0400
- branch
- trunk
- changeset 22
- b240777ae53e
- parent 19
- bb6e9f4af1a5
- child 24
- 60056f3e3e60
- permissions
- -rw-r--r--
[svn] Improve the way we check archive contents. If all the entries look like
they're in ., they really shouldn't count as being in the same directory;
look at the next piece of the path. If the archive only has one
non-directory item, report that more clearly. You'll be able to tell by
whether or not there's a trailing slash in the prompt.
Improve the tests for doing straight decompression, and seek to the
beginning of the archive before we start writing to the file -- otherwise,
we write 0-byte files.
Lots of new ideas in the TODO. I think I'll do another release once
recursion is interactive.
dtrx - Intelligent archive extraction ===================================== Introduction ------------ dtrx extracts archives in a number of different formats; it currently supports tar, zip, cpio, rpm, and deb. It can also decompress files compressed with gzip, bzip2, or compress. In addition to providing one command to handle many different archive types, dtrx also aids the user by extracting contents consistently. By default, everything will be written to a dedicated directory that's named after the archive. dtrx will also change the permissions to ensure that the owner can read and write all those files. Running dtrx ------------ To run dtrx, simply call it with the archive(s) you wish to extract as arguments. For example:: dtrx coreutils-5.*.tar.gz dtrx supports a number of options to mandate specific behavior: -r, --recursive With this option, dtrx will search inside the archives you specify to see if any of the contents are themselves archives, and extract those as well. -o, --overwrite Normally, dtrx will avoid extracting into a directory that already exists, and instead try to find an alternative name to use. If this option is listed, dtrx will use the default directory name no matter what. -f, --flat Extract archive contents into the current directory, instead of their own dedicated directory. This is handy if you have multiple archive files which all need to be extracted into the same directory structure. Note that existing files may be overwritten with this option. -l, -t, --list, --table Don't extract the archives; just list their contents on standard output. -q, --quiet Suppress warning messages. Listing this option twice will cause the dtrx to be silent if at all possible. -v, --verbose Print more information about x's behavior. You can list this option up to three times for more information. --help Display basic help. --version Display x's version, copyright, and license information. Other Useful Information ------------------------ dtrx 4.0 is copyright (c) 2006, 2007 `Brett Smith`_. Feel free to send comments, bug reports, patches, and so on. You can find the latest version of dtrx on `its home page`_. .. _`Brett Smith`: mailto:brettcsmith@brettcsmith.org .. _`its home page`: http://www.brettcsmith.org/2006/x/ dtrx is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, 5th Floor, Boston, MA, 02111.
