cookutils 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 9dc64af5ba9c
files doc/cookopts.txt
line diff
     1.1 --- a/doc/cookopts.txt	Thu Nov 17 01:28:30 2016 +0200
     1.2 +++ b/doc/cookopts.txt	Thu Nov 17 18:58:21 2016 +0000
     1.3 @@ -11,94 +11,93 @@
     1.4  
     1.5  !pixmaps
     1.6      Default action is to copy icons from a /usr/share/pixmaps folder as well as
     1.7 -    from stuff folder (the same action that made obsolete option
     1.8 +    from the stuff folder (the same action that made obsolete option
     1.9      `GENERIC_PIXMAPS="no"`).
    1.10 -    The presence of this option overrides the default action: files will not be
    1.11 -    automatically copied.
    1.12 +    The presence of this option overrides the default action (files will not be
    1.13 +    automatically copied).
    1.14  
    1.15 -!menus
    1.16      Default action is to copy desktop files from a /usr/share/applications
    1.17      folder (the same action that made obsolete option `GENERIC_MENUS="no"`).
    1.18 -    The presence of this option overrides the default action: files will not be
    1.19 -    automatically copied.
    1.20 +    The presence of this option overrides the default action (files will not be
    1.21 +    automatically copied).
    1.22  
    1.23  !fixdesktops
    1.24      Default action is to fix common errors and warnings in the .desktop files.
    1.25 -    The presence of this option overrides the default action: .desktop files
    1.26 -    will not be changed.
    1.27 +    The presence of this option overrides the default action (.desktop files
    1.28 +    will not be changed).
    1.29  
    1.30  !i18nz
    1.31      1. Default action is to delete locales that are not currently supported by
    1.32 -    the SliTaz while processing desktop files.
    1.33 -    The presence of this option overrides the default action: .desktop files
    1.34 -    will contain the original set of locales.
    1.35 +    SliTaz while processing desktop files.
    1.36 +    The presence of this option overrides the default action (.desktop files
    1.37 +    will contain the original set of locales).
    1.38      Please note, this option does not have any action if the `!fixdesktops`
    1.39 -    option provided: desktop files in any way not change.
    1.40 +    option is provided (desktop files will not change in any way).
    1.41      2. Default action is to keep only supported translations provided by the
    1.42      *.mo files.
    1.43 -    The presence of this option overrides the default action: all existing *.mo
    1.44 -    files will remain.
    1.45 -    Please note, you can add all translations to the package, for example, using
    1.46 -    command: `cook_copy_files *.mo`, and then by default only supported locales
    1.47 -    will be left.
    1.48 +    The presence of this option overrides the default action (all existing *.mo
    1.49 +    files will remain).
    1.50 +    Please note, you can add all the translations to the package, for example, using
    1.51 +    the command: `cook_copy_files *.mo` (then by default only the supported locales
    1.52 +    will be left).
    1.53  
    1.54  !extradesktops
    1.55 -    Default action is to remove extra information from the desktop files: such
    1.56 -    entries as 'GenericName', 'X-GNOME-FullName' (all X-* are exposed),
    1.57 -    'Terminal=false', Keywords, other sections. This extra information just not
    1.58 +    Default action is to remove extra information from the desktop files: entries
    1.59 +    such as 'GenericName', 'X-GNOME-FullName' (all X-* are exposed),
    1.60 +    'Terminal=false', Keywords and other sections. This extra information just isn't
    1.61      supported in the current (LXDE) environment.
    1.62 -    The presence of this option overrides the default action: extra information
    1.63 -    will not be removed from the .desktop files.
    1.64 +    The presence of this option overrides the default action (extra information
    1.65 +    will not be removed from the .desktop files).
    1.66  
    1.67  !strip
    1.68      Default action is to strip executable files, shared and static libraries,
    1.69      as well as remove Python (*.pyc and *.pyo) and Perl (perllocal.pod and
    1.70      .packlist) files.
    1.71 -    The presence of this option overrides the default action: executable files
    1.72 -    and libraries will not be stripped, and Python and Perl files all will be
    1.73 -    left.
    1.74 +    The presence of this option overrides the default action (executable files
    1.75 +    and libraries will not be stripped, and Python and Perl files will all be
    1.76 +    left).
    1.77  
    1.78  !manz
    1.79      Default action is to compress all man pages.
    1.80 -    The presence of this option overrides the default action: all man pages will
    1.81 -    be left "as is". Please note that these files may be installed in compressed
    1.82 -    form.
    1.83 +    The presence of this option overrides the default action (all man pages will
    1.84 +    be left "as is"). Please note that these files may be installed in a compressed
    1.85 +    format.
    1.86  
    1.87  !pngz
    1.88      Default action is to compress all PNG images. Image compression allows you
    1.89      to save some space, but it takes a lot of time.
    1.90 -    The presence of this option overrides the default action: all PNG images
    1.91 -    will be left "as is".
    1.92 +    The presence of this option overrides the default action (all PNG images
    1.93 +    will be left "as is").
    1.94  
    1.95  !pngquant
    1.96      Default action is to use `pngquant` while compressing PNG images. Please
    1.97      note, `pngquant` produces indexed images (max 256 colors) which can be
    1.98 -    inappropriate in some cases: a few programs (such as SLiM) will not
    1.99 +    inappropriate in some cases, a few programs (such as SLiM) will not
   1.100      recognize this PNG file format.
   1.101 -    The presence of this option overrides the default action: `pngquant` will
   1.102 -    not be used.
   1.103 +    The presence of this option overrides the default action (`pngquant` will
   1.104 +    not be used).
   1.105  
   1.106  !optipng
   1.107      Default action is to use `optipng` to compress PNG images. Please note,
   1.108 -    `optipng` is lossless PNG compressor. Using `pngquant` and `optipng` in
   1.109 -    conjunction allows to save more space.
   1.110 -    The presence of this option overrides the default action: `optipng` will not
   1.111 -    be used.
   1.112 +    `optipng` is a lossless PNG compressor. Using `pngquant` and `optipng` in
   1.113 +    conjunction allows you to save more space.
   1.114 +    The presence of this option overrides the default action (`optipng` will not
   1.115 +    be used).
   1.116  
   1.117  op0 to op8
   1.118 -    Default action is to use opimization level 2 while processing PNG images by
   1.119 -    `optipng`. Using this option you can set desired `optipng` optimization
   1.120 -    level. The higher the level, the slower compression and the smaller file
   1.121 +    Default action is to use optimization level 2 while processing PNG images by
   1.122 +    `optipng`. Using this option you can set the desired `optipng` optimization
   1.123 +    level. The higher the level, the slower the compression and the smaller the file
   1.124      size. Please note that this option has no exclamation mark, because it means
   1.125      "don't do", and here, on the contrary, "to do".
   1.126  
   1.127  !svgz
   1.128      Default action is to compress all SVG images.
   1.129 -    The presence of this option overrides the default action: all SVG images
   1.130 -    will be left "as is".
   1.131 +    The presence of this option overrides the default action (all SVG images
   1.132 +    will be left "as is").
   1.133  
   1.134  !uiz
   1.135      Default action is to compress Glade UI files. Compression means the removal
   1.136      of insignificant spaces and comments.
   1.137 -    The presence of this option overrides the default action: all *.ui and
   1.138 -    *.glade files will be left "as is".
   1.139 +    The presence of this option overrides the default action (all *.ui and
   1.140 +    *.glade files will be left "as is").