cookutils annotate doc/cookopts.txt @ rev 836

cook: add compress_ui()
author Aleksej Bobylev <al.bobylev@gmail.com>
date Mon Nov 14 16:58:35 2016 +0200 (2016-11-14)
parents 60a7e8dec37c
children d8bac8bb4eab
rev   line source
al@834 1 You can use a variable COOKOPTS in the receipts to adjust certain aspects of the
al@834 2 preparation of a package. Multiple options are allowed, that can be written
al@834 3 together or separated by spaces, tabs or any other symbols.
al@834 4
al@834 5 Example of use:
al@834 6
al@834 7 COOKOPTS="!menus !pngz"
al@834 8
al@834 9
al@834 10 Currently, the following options are recognized:
al@834 11
al@834 12 !pixmaps
al@834 13 Don't copy icons from a /usr/share/pixmaps folder as well as from stuff
al@834 14 folder (the same action that made obsolete option `GENERIC_PIXMAPS="no"`).
al@834 15
al@834 16 !menus
al@834 17 Don't copy desktop files from a /usr/share/applications folder (the same
al@834 18 action that made obsolete option `GENERIC_MENUS="no"`).
al@834 19
al@834 20 !fixdesktops
al@834 21 Don't fix common errors and warnings in the .desktop files.
al@834 22
al@834 23 !strip
al@834 24 Don't strip executable files, shared and static libraries, as well as remove
al@834 25 Python (*.pyc and *.pyo) and Perl (perllocal.pod and .packlist) files.
al@834 26
al@834 27 !manz
al@834 28 Don't compress all man pages.
al@834 29
al@834 30 !pngz
al@834 31 Don't compress all png images. Image compression allows you to save some
al@834 32 space, but it takes a lot of time.
al@834 33
al@834 34 !pngquant
al@834 35 Don't use `pngquant` to compress png images. Note, `pngquant` produces
al@834 36 indexed images (max 256 colors) which can be inappropriate in some cases:
al@834 37 a few programs (such as SLiM) will not recognize this compressed PNG file
al@834 38 format.
al@834 39
al@834 40 !optipng
al@834 41 Don't use `optipng` to compress png images. Note, `optipng` is lossless png
al@834 42 compressor. Using `pngquant` and `optipng` in conjunction allows to save
al@834 43 more space.
al@834 44
al@834 45 op0 to op8
al@834 46 Use specified `optipng` optimization level. The higher the level, the slower
al@834 47 compression. Note, this option does not have an exclamation mark, because it
al@834 48 means "don't" and here is "do" otherwise.
al@834 49
al@834 50 !svgz
al@834 51 Don't compress all svg images.
al@836 52
al@836 53 !uiz
al@836 54 Don't compress Glade UI files. Compression means the removal of
al@836 55 insignificant spaces and comments.