cookutils view doc/cookopts.txt @ rev 838
cook: strip unsupported translations. Rewrite the doc in cookopts.txt.
| author | Aleksej Bobylev <al.bobylev@gmail.com> |
|---|---|
| date | Thu Nov 17 01:28:30 2016 +0200 (2016-11-17) |
| parents | 11a3c021e563 |
| children | ab44ce9b38bb |
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 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 the 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 provided: desktop files in any way not change.
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 translations to the package, for example, using
42 command: `cook_copy_files *.mo`, and then by default only supported locales
43 will be left.
45 !extradesktops
46 Default action is to remove extra information from the desktop files: such
47 entries as 'GenericName', 'X-GNOME-FullName' (all X-* are exposed),
48 'Terminal=false', Keywords, other sections. This extra information just not
49 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 all will 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 compressed
65 form.
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 lossless PNG compressor. Using `pngquant` and `optipng` in
84 conjunction allows 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 opimization level 2 while processing PNG images by
90 `optipng`. Using this option you can set desired `optipng` optimization
91 level. The higher the level, the slower compression and the smaller file
92 size. Please note that this option has no exclamation mark, because it means
93 "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".