cookutils view doc/cookopts.txt @ rev 900
Tiny edits
| author | Paul Issott <paul@slitaz.org> |
|---|---|
| date | Thu May 11 20:04:44 2017 +0100 (2017-05-11) |
| parents | ea11d3c96873 |
| children | 0f4636284a32 |
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 !perlz
62 Default action is to strip POD (plain old documentation) from the Perl
63 modules (*.pm) and program (*.pl) files.
64 The presence of this option overrides the default action (Perl files will
65 not be stripped).
66 Note, if you disabled the cleaning by using the higher !strip option, Perl
67 files also will not be stripped.
69 !rmpod
70 Default action is to remove Perl's POD (plain old documentation) (*.pod)
71 files.
72 The presence of this option overrides the default action (*.pod files will
73 all be left).
74 Note, if you disabled the cleaning by using the higher !strip option, *.pod
75 files also will all be left.
77 !manz
78 Default action is to compress all man pages.
79 The presence of this option overrides the default action (all man pages will
80 be left "as is"). Please note that these files may be installed in a
81 compressed format.
83 !gz
84 Default action is to recompress all *.gz files (excluding man pages) with
85 the better compression ratio.
86 The presence of this option overrides the default action (all *.gzip files
87 will be left "as is").
89 !pngz
90 Default action is to compress all PNG images. Image compression allows you
91 to save some space, but it takes a lot of time.
92 The presence of this option overrides the default action (all PNG images
93 will be left "as is").
95 !pngquant
96 Default action is to use `pngquant` while compressing PNG images. Please
97 note, `pngquant` produces indexed images (max 256 colors) which can be
98 inappropriate in some cases, a few programs (such as SLiM) will not
99 recognize this PNG file format.
100 The presence of this option overrides the default action (`pngquant` will
101 not be used).
103 !optipng
104 Default action is to use `optipng` to compress PNG images. Please note,
105 `optipng` is a lossless PNG compressor. Using `pngquant` and `optipng` in
106 conjunction allows you to save more space.
107 The presence of this option overrides the default action (`optipng` will not
108 be used).
110 op0 to op8
111 Default action is to use optimization level 2 while processing PNG images by
112 `optipng`. Using this option you can set the desired `optipng` optimization
113 level. The higher the level, the slower the compression and the smaller the
114 file size. Please note that this option has no exclamation mark, because it
115 means "don't do", and here, on the contrary, "to do".
117 !svgz
118 Default action is to compress all SVG images.
119 The presence of this option overrides the default action (all SVG images
120 will be left "as is").
122 !uiz
123 Default action is to compress Glade UI files. Compression means the removal
124 of insignificant spaces and comments.
125 The presence of this option overrides the default action (all *.ui and
126 *.glade files will be left "as is").
128 !monorm
129 Default action is to normalize *.mo files. Normalization means the
130 unconditional conversion to UTF-8, removal of accidental duplicates and
131 most of the header lines as well as catalog entries that are not added to
132 the translation (when string in msgid equals to string in msgstr).
133 The presence of this option overrides the default action (all *.mo files
134 will be left "as is").