diff options
| author | Konfekt <Konfekt@users.noreply.github.com> | 2021-01-05 18:53:29 +0100 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2021-01-05 18:53:29 +0100 |
| commit | 492f712df281e96d6d1aa9ebb53b1304284b19a0 (patch) | |
| tree | de3c0f0595a45b9dd8d3104158dc6b10df7d5a3c /plugins/universalarchive/README.md | |
| parent | 2118d35e017eb8c599f3c25863c8263aca307541 (diff) | |
| download | zsh-492f712df281e96d6d1aa9ebb53b1304284b19a0.tar.gz zsh-492f712df281e96d6d1aa9ebb53b1304284b19a0.tar.bz2 zsh-492f712df281e96d6d1aa9ebb53b1304284b19a0.zip | |
feat(plugins): add `universalarchive` plugin to conveniently compress files (#6846)
Co-authored-by: Marc Cornellà <marc.cornella@live.com>
Diffstat (limited to 'plugins/universalarchive/README.md')
| -rw-r--r-- | plugins/universalarchive/README.md | 46 |
1 files changed, 46 insertions, 0 deletions
diff --git a/plugins/universalarchive/README.md b/plugins/universalarchive/README.md new file mode 100644 index 000000000..93a1bd9fc --- /dev/null +++ b/plugins/universalarchive/README.md @@ -0,0 +1,46 @@ +# universalarchive plugin + +Lets you compress files by a command `ua <format> <files>`, supporting various +compression formats (e.g. 7z, tar.gz, lzma, ...). + +To enable it, add `universalarchive` to the plugins array in your zshrc file: + +```zsh +plugins=(... universalarchive) +``` + +## Usage + +Run `ua <format> <files>` to compress `<files>` into an archive file using `<format>`. +For example: + +```sh +ua xz *.html +``` + +this command will compress all `.html` files in directory `folder` into `folder.xz`. + +This plugin saves you from having to remember which command line arguments compress a file. + +## Supported compression formats + +| Extension | Description | +|:-----------------|:-------------------------------| +| `7z` | 7zip file | +| `bz2` | Bzip2 file | +| `gz` | Gzip file | +| `lzma` | LZMA archive | +| `lzo` | LZO archive | +| `rar` | WinRAR archive | +| `tar` | Tarball | +| `tbz`/`tar.bz2` | Tarball with bzip2 compression | +| `tgz`/`tar.gz` | Tarball with gzip compression | +| `tlz`/`tar.lzma` | Tarball with lzma compression | +| `txz`/`tar.xz` | Tarball with lzma2 compression | +| `tZ`/`tar.Z` | Tarball with LZW compression | +| `xz` | LZMA2 archive | +| `Z` | Z archive (LZW) | +| `zip` | Zip archive | +| `zst` | Zstd archive | + +See [list of archive formats](https://en.wikipedia.org/wiki/List_of_archive_formats) for more information regarding the archive formats. |