cookutils view doc/cookopts.txt @ rev 839
Tiny edits
| author | Paul Issott <paul@slitaz.org> |
|---|---|
| date | Thu Nov 17 18:58:21 2016 +0000 (2016-11-17) |
| parents | d8bac8bb4eab |
| children | 47cacd72d7ce |
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 Default action is to copy desktop files from a /usr/share/applications
20 folder (the same action that made obsolete option `GENERIC_MENUS="no"`).
21 The presence of this option overrides the default action (files will not be
22 automatically copied).
24 !fixdesktops
25 Default action is to fix common errors and warnings in the .desktop files.
26 The presence of this option overrides the default action (.desktop files
27 will not be changed).
29 !i18nz
30 1. Default action is to delete locales that are not currently supported by
31 SliTaz while processing desktop files.
32 The presence of this option overrides the default action (.desktop files
33 will contain the original set of locales).
34 Please note, this option does not have any action if the `!fixdesktops`
35 option is provided (desktop files will not change in any way).
36 2. Default action is to keep only supported translations provided by the
37 *.mo files.
38 The presence of this option overrides the default action (all existing *.mo
39 files will remain).
40 Please note, you can add all the translations to the package, for example, using
41 the command: `cook_copy_files *.mo` (then by default only the supported locales
42 will be left).
44 !extradesktops
45 Default action is to remove extra information from the desktop files: entries
46 such as 'GenericName', 'X-GNOME-FullName' (all X-* are exposed),
47 'Terminal=false', Keywords and other sections. This extra information just isn't
48 supported in the current (LXDE) environment.
49 The presence of this option overrides the default action (extra information
50 will not be removed from the .desktop files).
52 !strip
53 Default action is to strip executable files, shared and static libraries,
54 as well as remove Python (*.pyc and *.pyo) and Perl (perllocal.pod and
55 .packlist) files.
56 The presence of this option overrides the default action (executable files
57 and libraries will not be stripped, and Python and Perl files will all be
58 left).
60 !manz
61 Default action is to compress all man pages.
62 The presence of this option overrides the default action (all man pages will
63 be left "as is"). Please note that these files may be installed in a compressed
64 format.
66 !pngz
67 Default action is to compress all PNG images. Image compression allows you
68 to save some space, but it takes a lot of time.
69 The presence of this option overrides the default action (all PNG images
70 will be left "as is").
72 !pngquant
73 Default action is to use `pngquant` while compressing PNG images. Please
74 note, `pngquant` produces indexed images (max 256 colors) which can be
75 inappropriate in some cases, a few programs (such as SLiM) will not
76 recognize this PNG file format.
77 The presence of this option overrides the default action (`pngquant` will
78 not be used).
80 !optipng
81 Default action is to use `optipng` to compress PNG images. Please note,
82 `optipng` is a lossless PNG compressor. Using `pngquant` and `optipng` in
83 conjunction allows you to save more space.
84 The presence of this option overrides the default action (`optipng` will not
85 be used).
87 op0 to op8
88 Default action is to use optimization level 2 while processing PNG images by
89 `optipng`. Using this option you can set the desired `optipng` optimization
90 level. The higher the level, the slower the compression and the smaller the file
91 size. Please note that this option has no exclamation mark, because it means
92 "don't do", and here, on the contrary, "to do".
94 !svgz
95 Default action is to compress all SVG images.
96 The presence of this option overrides the default action (all SVG images
97 will be left "as is").
99 !uiz
100 Default action is to compress Glade UI files. Compression means the removal
101 of insignificant spaces and comments.
102 The presence of this option overrides the default action (all *.ui and
103 *.glade files will be left "as is").