doc/README.fr.txt

   1 ;; README.en.txt                               -*- coding: latin-1; -*-
   2 ;; This is the README installed with Gpg4win. Lines with a ; in the first
   3 ;; column are considered a comment and not included in the actually
   4 ;; installed version.  Certain keywords are replaced by the Makefile;
   5 ;; those words are enclosed by exclamation marks.
   6
   7                    English README file for Gpg4win
   8                    ===============================
   9 !BETA-WARNING!
  10 +++ You are welcome to translate this file into French!
  11 Please contact the Gpg4win developer mailing list for contributing
  12 and look at http://gpg4win.de/localize-gpg4win.html +++
  13
  14
  15 This is Gpg4win, version !VERSION!.
  16
  17 Content:
  18
  19      1. Important Notes
  20      2. Changes
  21      3. Known Bugs (and Workarounds)
  22      4. Version History
  23      5. Version Numbers of Included Software
  24      6. Installer Options
  25      7. Legal Notices
  26
  27
  28 1. Important Notes
  29 ==================
  30
  31 Manuals describing the installation of Gpg4win are currently only
  32 available in German.  Check out http://www/gpg4win.org for latest
  33 news.
  34
  35 If you used an older version of Gpg4win in the past, please check
  36 out the migration hints in the Gpg4win Compendium's appendix.
  37
  38 Please read the "Known bugs" section before you start working with
  39 Gpg4win.
  40
  41
  42 2. Changes
  43 ==========
  44
  45 Gpg4win2 has major changes compared to Gpg4win 1.x.  Below is a list
  46 of the most important ones:
  47
  48 - Kleopatra is the new certificate manager.  Kleopatra is the S/MIME
  49   certificate manager of KDE (a desktop environment used on many
  50   GNU/Linux systems).  For use in Gpg4win it has been extended to
  51   support OpenPGP and to act as a graphical user interface for all
  52   cryptographic operations.  It is automatically started if another
  53   component requests its services and then runs permanently in your
  54   system tray.  WinPT has been dropped.
  55
  56 - GpgEX is the new plugin for the Microsoft Explorer and replaces GpgEE.
  57
  58 - The mail program Claws Mail has been updated to a modern version.
  59   It now supports SSL, NNTP and IMAP.
  60
  61 - GpgOL, the plugin for Outlook 2003 and 2007 has been comprehensively
  62   updated.  It now supports PGP/MIME and thus makes the use of
  63   encrypted or signed attachments much easier and standard conform.
  64   Support for S/MIME has been added.  Most dialogs are now provided by
  65   Kleopatra for graphical user dialogs.
  66
  67 - The German "Gpg4win-Kompendium" is the new documentation for Gpg4win.
  68   This combines the previous "Einsteiger" and "Durchblicker" manuals.
  69   All chapters were reworked and extended to describe the new Gpg4win
  70   Version 2.0. Among other things, this means adaption to Kleopatra,
  71   GpgEX and PGP/MIME and new texts for S/MIME and X.509.
  72
  73 - Support of these platforms:
  74   Operating System: Windows 2000, XP (32/64), Vista (32/64)
  75   Outlook: 2003, 2007
  76
  77 Short overview on changes compared to version 2.0.1:
  78 ----------------------------------------------------
  79 - Kleopatra:
  80   * New certificate wizard for OpenPGP and X.509 improved
  81   * Certificate selection dialog for sign/encrypt comes up in case of
  82     conflict only
  83   * Result dialog for sign/encrypt combined in one window
  84   * File crypto operations with GpgEX stabilized
  85   * SmartCard support for X.509 NetKey cards improved
  86   * Rekursive sign/encrypt of files/directory now possible; condition:
  87     external archive tool required (see README file for configuration)
  88   * new oxygen icons
  89   * Several minor and medium issues and errors were fixed
  90
  91 - GpgOL:
  92   * Symbol load mechanism improved to add new icons
  93     (now with crypto icons for the message list)
  94
  95 - Pinentry:
  96   * Change default: switch from GTK to QT4
  97     (GTK still enabled for gpg4win-light installer)
  98   * new icons for pinentry-qt4
  99   * Pinentry-qt4 dialog always comes up in foreground
 100
 101 - GnuPG-Backend:
 102   * Generate new certificate for OpenPGP/X.509: default key length
 103     updated (new Default: RSA, 2048 bit);
 104     furthermore select list of key length in Kleopatra updated
 105
 106 - Installer:
 107   * new images for NSIS installer
 108
 109 - Included components are:
 110     GnuPG:        2.0.14
 111     Kleopatra:    2.0.14-svn1098530 (20100303)
 112     GPA:          0.9.0
 113     GpgOL:        1.1.1
 114     GpgEX:        0.9.5
 115     Claws-Mail:   3.7.4cvs1
 116     Kompendium:   3.0.0-rc1
 117
 118
 119 3. Known Bugs (and Workarounds)
 120 ===============================
 121
 122 - Using smart card with Kleopatra
 123
 124    The initial setting of smart cards with Kleopatra is currently not
 125    yet possible. Please run the following steps one-time to use your
 126    smart card with Kleopatra.
 127
 128    * OpenPGP card
 129      Use the gpg command line tool to create a new OpenPGP certificate
 130      on your card (a) or to activate your existing certificate of
 131      your card (b):
 132
 133      (a) Create new certificate
 134        - Insert card.
 135        - Run "gpg --card-edit".
 136        - Switch to admin modus by enter: "admin".
 137        - Enter "generate" to create a new certificate.
 138
 139      (b) Activate existing certificate of your card
 140        - Import associated (public) certificate of your card (e.g.
 141          from certificate server or from a exported certificate file).
 142        - Insert card.
 143        - Run "gpg --card-status".
 144
 145    * X.509 Telesec Netkey 3 card
 146      Use Kleopatra to initializing your card:
 147      - Insert card.
 148      - Click at the Kleopatra systemtray icon (or use the context menu of
 149        the systemtray icon and run the learn card command).
 150
 151    After finishing these steps your OpenPGP / X.509 certificate
 152    from your smart card is shown in Kleopatra under the tab
 153    "My certificates" (marked with a smart card icon).
 154
 155    A good (graphical) alternative for setting up your smart
 156    card and changing PIN is GPA. A better smart card support for
 157    Kleopatra is in process.
 158
 159 - Using the Outlook Plugin "GpgOL":
 160
 161   * You defintely should create copies of your old encrypted/signed
 162     emails, e.g. in the form of PST files.
 163
 164   * Encrypted E-Mails occuring un-encrypted on the email server: It
 165     can happen that parts of encrypted emails are copied to your email
 166     server (IMAP or MAPI) in un-encrypted/decrypted form when creating
 167     or viewing them.  Affected is the content of the email view
 168     window, thus usually the so-called email body.  Attachments are
 169     not affected.  Switching off the Outlook preview will lower the
 170     probability of this to happen, but not eliminate the issue.
 171     A solution is being worked on.
 172
 173   * Sending signed or encrypted messages via an Exchange based account
 174     does not yet work.
 175
 176 - Using GpgEX with Windows x64:
 177
 178    * In some cases sign/encrypt or decrypt/verify via GpgEX doesn't work
 179      correctly (Kleopatra freezed). Then you should kill Kleopatra via
 180      task manager and run the file crypto operation directly in Kleopatra
 181      (see file menu).
 182
 183    * Problems with Windows x64:
 184      GpgEX is a (32bit) plugin for the (32bit) Windows
 185      Explorer and it does _not_ run in a 64bit Explorer
 186      (= default for a Windows 64bit system).
 187
 188      Workaround: Run the 32bit Explorer to use GpgEX.
 189      Click "Start" -> "Run", type the following in the box, and then
 190      click OK:
 191          C:\windows\syswow64\explorer.exe /separate
 192      Note: Adjust the path to your x64-based version of Windows if
 193      necessary.
 194      This separate command seems to be currently broken in Win7/64bit.
 195
 196 - sign/encrypt files with archive function:
 197
 198    * The new Kleopatra function to sign/encrypt files as archive
 199      is currently not full implemented. It's for testing for
 200      expert users only. An extra archive application is required.
 201      Configure the pack command in the config file of Kleopatra:
 202        C:\Programme\GNU\GnuPG\share\config\libkleopatrarc
 203      Here an exemple for the tool "7-ZIP" (http://www.7-zip.org):
 204         [Archive Definition #0]
 205         Name=TAR (via 7-ZIP)
 206         id=7zip
 207         extensions=tar
 208         pack-command=7z a dummy -ttar -so
 209
 210
 211 4. Version History
 212 ==================
 213
 214 Find below the changes as recorded in the source distribution's NEWS
 215 file.  An up-to-date list of changes is also available at
 216 http://www.gpg4win.de/change-history.html .
 217
 218 !NEWSFILE!
 219
 220
 221 5. Version Numbers of Included Software
 222 =======================================
 223
 224 !VERSIONINFO!
 225
 226
 227
 228 6. Installer Options
 229 ====================
 230
 231 The default installation path can be speficied with the /D=PATH
 232 option, which must be last on the command line.  The installer
 233 supports the options /S for unattended installation, and the option
 234 /C=INIFILE to specify an .ini file which should contain exactly one
 235 section "[gpg4win]".  This section contains various installer settings
 236 and absolute file paths to configuration files that should be
 237 preinstalled.  Most options just set a different default value.
 238 Excetions are documented below.  Here is an example file which shows
 239 all possible keys:
 240
 241 [gpg4win]
 242   ; Installer settings.  Do not define or leave empty for defaults.
 243   inst_gpgol = true
 244   inst_gpgex = true
 245   inst_kleopatra = true
 246   inst_gpa = true
 247   inst_claws_mail = false
 248   inst_compendium_de = true
 249   inst_man_novice_en = true
 250
 251   ; Where to install short-cuts.
 252   inst_start_menu = true
 253   inst_desktop = false
 254   inst_quick_launch_bar = false
 255
 256   ; Contrary to other settings in this file, the start menu folder
 257   ; setting here will override the user selection at installation
 258   ; time.
 259   inst_start_menu_folder = Gpg4win
 260
 261   ; Additional configuration files to install.
 262   gpg.conf = D:\config\gpg-site.conf
 263   gpg-agent.conf = D:\config\gpg-agent-site.conf
 264   trustlist.txt = D:\config\trustlist-site.txt
 265   dirmngr.conf = D:\config\dirmngr-site.conf
 266   dirmngr_ldapserver.conf = D:\config\dirmngr_ldapserver-site.conf
 267   scdaemon.conf = D:\config\scdaemon-site.txt
 268   gpa.conf = D:\config\gpa-site.conf
 269
 270 An example command for unattended installation could look like this:
 271
 272 gpg4win.exe /S /C=C:\TEMP\gpg4win.ini /D=D:\Programme\Gpg4win
 273
 274 For the MSI installer, the above also holds, with the following
 275 changes: Unattended installation is achieved as usual with the /qb-
 276 option to msiexec.  The control file must be called gpg4win.ini and
 277 reside in the system directory (C:\WINDOWS).  It is found
 278 automatically by the installer.  The installation directory can be
 279 specified with an entry for "instdir".  Also, each entry can be given
 280 in uppercase at the command line through INSTDIR=... and
 281 INST_GPA=FALSE etc. (the control file takes precedence, though).  The
 282 default config files as well as start menu directory and optional
 283 installation of short cuts are currently not supported through the MSI
 284 installer.
 285
 286
 287 7. Legal notices pertaining to the individual packets
 288 =====================================================
 289
 290 Gpg4win consist of several independent developed packages, available
 291 under different license conditions.  Most of these packages however
 292 are available under the GNU General Public License (GNU GPL).  Common
 293 to all is that they are free to use without restrictions, may be
 294 modified and that modifications may be distributed.  If the source
 295 files (i.e. gpg4win-src-x.y.z.exe) are distributed along with the
 296 binaries and the use of the GNU GPL has been pointed out, distribution
 297 is in in all cases possible.
 298
 299 What follows is a list of copyright statements.
 300
 301 !PKG-COPYRIGHT!
 302
 303
 304
 305
 306 Happy GiPiGing,
 307
 308   Your Gpg4win Team
 309
 310 ***end of file ***