diff options
| author | Eli Schwartz <eschwartz@archlinux.org> | 2018-05-03 00:10:21 -0400 |
|---|---|---|
| committer | Allan McRae <allan@archlinux.org> | 2018-05-14 09:59:17 +1000 |
| commit | 076b6184de2b20e9b26225d93f6f3a7030504109 (patch) | |
| tree | ca0e375b9fd89d6b6ce40026b732985c4b335841 /doc/pkgdelta.8.asciidoc | |
| parent | 860e4c4943ad062bd0eff99f28e7d64804b3c08e (diff) | |
| download | pacman-076b6184de2b20e9b26225d93f6f3a7030504109.tar.xz | |
Ensure better text editor automatic filetype detection
Since we no longer use vim-specific modelines, use the .asciidoc file
extension which is, well, reserved for asciidoc formatted files. This
should presumably work everywhere without needing editor-specific
workarounds and configuration.
Also add a shebang to makepkg.conf to indicate it contains bash content.
Signed-off-by: Eli Schwartz <eschwartz@archlinux.org>
Signed-off-by: Allan McRae <allan@archlinux.org>
Diffstat (limited to 'doc/pkgdelta.8.asciidoc')
| -rw-r--r-- | doc/pkgdelta.8.asciidoc | 53 |
1 files changed, 53 insertions, 0 deletions
diff --git a/doc/pkgdelta.8.asciidoc b/doc/pkgdelta.8.asciidoc new file mode 100644 index 00000000..412e607e --- /dev/null +++ b/doc/pkgdelta.8.asciidoc @@ -0,0 +1,53 @@ +pkgdelta(8) +========= + +Name +---- +pkgdelta - package delta generation utility + + +Synopsis +-------- +'pkgdelta' [options] <package1> <package2> + + +Description +----------- +'pkgdelta' is used to create package delta files between two versions of the +same package. These files are essentially binary patches. linkman:pacman[8] can +download deltas instead of full package upgrades, and use them with the +previous versions of packages (in the package cache) to synthesize the upgraded +version of the packages. This likely reduces download sizes for upgrades +significantly. + +'pkgdelta' requires linkman:xdelta3[1] to do its job. + + +Options +------- +*--max-delta-size <ratio>*:: + Only create delta files if the delta is smaller than ratio * package_size. + Possible values: 0.0 to 2.0. + Recommended values: 0.2 to 0.9. + Default value: 0.7 + +*--min-pkg-size <size>*:: + Minimal size of the package file in bytes to be considered for delta creation. + Default value: 1048576 bytes = 1 MiB. This may be any absolute size in bytes or + a human-readable value such as `4MiB` or `3.5MB`. + +*-q, \--quiet*:: + Be quiet. Do not output anything but warnings and errors. + + +Examples +-------- + + $ pkgdelta libreoffice-3.3.2-1-x86_64.pkg.tar.xz libreoffice-3.3.2-2-x86_64.pkg.tar.xz + + +See Also +-------- +linkman:pacman[8], linkman:xdelta3[1] + +include::footer.asciidoc[] |