cookutils annotate doc/cookopts.txt @ rev 847

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