cookutils view doc/cookopts.txt @ rev 872
modules/compressor: recompress *.gz files
| author | Aleksej Bobylev <al.bobylev@gmail.com> |
|---|---|
| date | Thu Jan 26 18:10:16 2017 +0200 (2017-01-26) |
| parents | cc73035433ab |
| children | ea11d3c96873 |
line source
1 You can use a variable COOKOPTS in the receipts to adjust certain aspects of the
2 preparation of a package. Multiple options are allowed, that can be written
3 together or separated by spaces, tabs or any other symbols.
5 Example of use:
7 COOKOPTS="!menus !pngz"
10 Currently, the following options are recognized:
12 !pixmaps
13 Default action is to copy icons from a /usr/share/pixmaps folder as well as
14 from the stuff folder (the same action that made obsolete option
15 `GENERIC_PIXMAPS="no"`).
16 The presence of this option overrides the default action (files will not be
17 automatically copied).
19 !menus
20 Default action is to copy desktop files from a /usr/share/applications
21 folder (the same action that made obsolete option `GENERIC_MENUS="no"`).
22 The presence of this option overrides the default action (files will not be
23 automatically copied).
25 !fixdesktops
26 Default action is to fix common errors and warnings in the .desktop files.
27 The presence of this option overrides the default action (.desktop files
28 will not be changed).
30 !i18nz
31 1. Default action is to delete locales that are not currently supported by
32 SliTaz while processing desktop files.
33 The presence of this option overrides the default action (.desktop files
34 will contain the original set of locales).
35 Please note, this option does not have any action if the `!fixdesktops`
36 option is provided (desktop files will not change in any way).
37 2. Default action is to keep only supported translations provided by the
38 *.mo files.
39 The presence of this option overrides the default action (all existing *.mo
40 files will remain).
41 Please note, you can add all the translations to the package, for example,
42 using the command: `cook_copy_files *.mo` (then by default only the
43 supported locales will be left).
45 !extradesktops
46 Default action is to remove extra information from the desktop files:
47 entries such as 'GenericName', 'X-GNOME-FullName' (all X-* are exposed),
48 'Terminal=false', Keywords and other sections. This extra information just
49 isn't supported in the current (LXDE) environment.
50 The presence of this option overrides the default action (extra information
51 will not be removed from the .desktop files).
53 !strip
54 Default action is to strip executable files, shared and static libraries,
55 as well as remove Python (*.pyc and *.pyo) and Perl (perllocal.pod and
56 .packlist) files.
57 The presence of this option overrides the default action (executable files
58 and libraries will not be stripped, and Python and Perl files will all be
59 left).
61 !manz
62 Default action is to compress all man pages.
63 The presence of this option overrides the default action (all man pages will
64 be left "as is"). Please note that these files may be installed in a
65 compressed format.
67 !gz
68 Default action is to recompress all *.gz files (excluding man pages) with
69 the better compression ratio.
70 The presence of this option overrides the default action (all *.gzip files
71 will be left "as is").
73 !pngz
74 Default action is to compress all PNG images. Image compression allows you
75 to save some space, but it takes a lot of time.
76 The presence of this option overrides the default action (all PNG images
77 will be left "as is").
79 !pngquant
80 Default action is to use `pngquant` while compressing PNG images. Please
81 note, `pngquant` produces indexed images (max 256 colors) which can be
82 inappropriate in some cases, a few programs (such as SLiM) will not
83 recognize this PNG file format.
84 The presence of this option overrides the default action (`pngquant` will
85 not be used).
87 !optipng
88 Default action is to use `optipng` to compress PNG images. Please note,
89 `optipng` is a lossless PNG compressor. Using `pngquant` and `optipng` in
90 conjunction allows you to save more space.
91 The presence of this option overrides the default action (`optipng` will not
92 be used).
94 op0 to op8
95 Default action is to use optimization level 2 while processing PNG images by
96 `optipng`. Using this option you can set the desired `optipng` optimization
97 level. The higher the level, the slower the compression and the smaller the
98 file size. Please note that this option has no exclamation mark, because it
99 means "don't do", and here, on the contrary, "to do".
101 !svgz
102 Default action is to compress all SVG images.
103 The presence of this option overrides the default action (all SVG images
104 will be left "as is").
106 !uiz
107 Default action is to compress Glade UI files. Compression means the removal
108 of insignificant spaces and comments.
109 The presence of this option overrides the default action (all *.ui and
110 *.glade files will be left "as is").
112 !monorm
113 Default action is to normalize *.mo files. Normalization means the
114 unconditional conversion to UTF-8, removal of accidental duplicates and
115 most of the header lines as well as catalog entries that are not added to
116 the translation (when string in msgid equals to string in msgstr).
117 The presence of this option overrides the default action (all *.mo files
118 will be left "as is").