cookutils view doc/cookopts.txt @ rev 864
cook: normalize file time (again)
| author | Aleksej Bobylev <al.bobylev@gmail.com> |
|---|---|
| date | Wed Jan 11 00:31:18 2017 +0200 (2017-01-11) |
| parents | 30c6b6064a50 |
| children | 111b6212516c |
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 !pngz
68 Default action is to compress all PNG images. Image compression allows you
69 to save some space, but it takes a lot of time.
70 The presence of this option overrides the default action (all PNG images
71 will be left "as is").
73 !pngquant
74 Default action is to use `pngquant` while compressing PNG images. Please
75 note, `pngquant` produces indexed images (max 256 colors) which can be
76 inappropriate in some cases, a few programs (such as SLiM) will not
77 recognize this PNG file format.
78 The presence of this option overrides the default action (`pngquant` will
79 not be used).
81 !optipng
82 Default action is to use `optipng` to compress PNG images. Please note,
83 `optipng` is a lossless PNG compressor. Using `pngquant` and `optipng` in
84 conjunction allows you to save more space.
85 The presence of this option overrides the default action (`optipng` will not
86 be used).
88 op0 to op8
89 Default action is to use optimization level 2 while processing PNG images by
90 `optipng`. Using this option you can set the desired `optipng` optimization
91 level. The higher the level, the slower the compression and the smaller the
92 file size. Please note that this option has no exclamation mark, because it
93 means "don't do", and here, on the contrary, "to do".
95 !svgz
96 Default action is to compress all SVG images.
97 The presence of this option overrides the default action (all SVG images
98 will be left "as is").
100 !uiz
101 Default action is to compress Glade UI files. Compression means the removal
102 of insignificant spaces and comments.
103 The presence of this option overrides the default action (all *.ui and
104 *.glade files will be left "as is").
106 !monorm
107 Default action is to normalize *.mo files. Normalization means the
108 unconditional conversion to UTF-8, removal of accidental duplicates and
109 most of the header lines as well as catalog entries that are not added to
110 the translation (when string in msgid equals to string in msgstr).
111 The presence of this option overrides the default action (all *.mo files
112 will be left "as is").