* README-BETA-de.txt: Final update for 1.9.0 release.
authorJan-Oliver Wagner <jan@intevation.de>
Fri, 25 Apr 2008 14:34:32 +0000 (14:34 +0000)
committerJan-Oliver Wagner <jan@intevation.de>
Fri, 25 Apr 2008 14:34:32 +0000 (14:34 +0000)
* README-BETA-en.txt: New. English translation of the german file.

doc/ChangeLog
doc/README-BETA-de.txt
doc/README-BETA-en.txt [new file with mode: 0644]

index c3ef89c..adf9ed6 100644 (file)
@@ -1,3 +1,9 @@
+2008-04-25  Jan-Oliver Wagner  <jan-oliver.wagner@intevation.de>
+
+       * README-BETA-de.txt: Final update for 1.9.0 release.
+
+       * README-BETA-en.txt: New. English translation of the german file.
+
 2008-04-21  Jan-Oliver Wagner  <jan-oliver.wagner@intevation.de>
 
        * README-BETA-de.txt: General update/cleanup for start of
index 4e0302a..5d42de5 100644 (file)
@@ -1,7 +1,7 @@
 Wichtige Informationen zum Einsatz von Gpg4win 1.9-BETA
 #######################################################
 
-Stand: Gpg4win-1.9.0 (200804XX)
+Stand: Gpg4win-1.9.0 (20080423)
 
 Hier finden sich wichtige Informationen die bei der
 Entscheidung helfen sollen, ob Gpg4win 1.9 schon für
@@ -14,6 +14,16 @@ Gpg4win 2.0 an neuer Funktionalit
 Die 1.9er Versionen sind der Beta-Test-Zyklus. Ist er
 abgeschlossen wird Version 2.0 freigegeben.
 
+Rückmeldung erwünscht!
+  Bitte lassen Sie uns wissen ob sie Gpg4win 1.9
+  erfolgreich getestet haben oder auch ob Sie auch
+  Probleme (und welcher Gestalt) Sie getroffen sind.
+  Am besten auf der deutschen Anwender Mailing Liste
+  einschreiben und Berichte dorthin senden bzw. die
+  Berichte der anderen lesen:
+
+  http://lists.wald.intevation.org/mailman/listinfo/gpg4win-users-de
+
 
 Wichtige Hinweise zur vorliegenden Version
 ==========================================
@@ -26,7 +36,7 @@ Wichtige Hinweise zur vorliegenden Version
 
 - Installationpaket knapp 40 MByte:
   Derzeit sind die Programme mit umfangreichen
-  Debug-Informatioen ausgestattet, so dass bei auftauchen
+  Debug-Informationen ausgestattet, so dass bei auftauchen
   eines Fehlers unmittelbar eine Fehleranalyse
   durchgeführt werden kann. Für Version 2.0
   werden diese Debug-Informationen wieder entfernt
@@ -60,9 +70,17 @@ Wichtige Hinweise zur vorliegenden Version
     Es kann vorkommen, dass verschlüsselte E-Mails
     in entschlüsselter Form auf dem E-Mail-Server
     zu liegen kommen.
+    Betroffen sind nur eigentlichen "E-Mail-Bodies",
+    für Anhänge passiert das nicht.
+    Schaltet man die Voransicht von Outlook ab, so
+    verringert sich die Wahrscheinlichkeit dafür deutlich.
 
+  * E-Mails werden auf dem Server in Microsoft-spezifischen
+    Formaten gespeichert und können von anderen E-Mail-Programmen
+    dann nicht mehr interpretiert und die Inhalte angezeigt werden.
 
-Wichtige Hinweise zur verwendung von S/MIME
+
+Wichtige Hinweise zur Verwendung von S/MIME
 ===========================================
 
 S/MIME ist ein für Gpg4win 2.0 neu hinzukommendes
@@ -90,7 +108,7 @@ durchzuf
   über Kleopatra importieren (Menü Datei->Zertifikate
   importieren)
 
-- S/MIME-Zertifkatskette für persönlichen Schlüssel importieren:
+- S/MIME-Zertifikatskette für persönlichen Schlüssel importieren:
   Die zum geheimen Schlüssel zugehörige Zertifikatskette
   als P7C-Datei importieren. Es werden auch andere
   Suffixes für solche Dateien verwendet. Einfach über
@@ -112,8 +130,8 @@ durchzuf
   nun als Vertrauenswürdig einstufen wollen.
   Beachten Sie, dass der gpg-agent neu gestartet
   werden muss, z.B: durch ausloggen und wieder einloggen.
-  Zusätzlich wird das Vetrauen in Wurzel-Zertifkate für den
-  DirMngr wie folgt ausgesprochen:
+
+- Vetrauen für Wurzel-Zertifkate für DirMngr aussprechen:
   Die entsprechenden Wurzel-Zertifikate müssen als DER-Dateien
   mit Dateinamen-Endung ".crt" im Verzeichnis
   %INSTALL_DIR%\etc\dirmngr\trusted-certs\
@@ -208,7 +226,7 @@ Neu:
 - Kleopatra: Der neue Zertifikatsmanager
 
   * Kleoaptra ist der bisherige S/MIME Zertifikatsmanager von KDE.
-    Es ist zum einen um parallele Unterstützung von OpenPGP erweitert
+    Er ist zum einen um parallele Unterstützung von OpenPGP erweitert
     worden. Zum anderen fungiert Kleopatra als Grafische Oberfläche
     für sämtliche Kryptografischen Operationen und vereinheitlich
     damit die grafische Benutzerführung.
diff --git a/doc/README-BETA-en.txt b/doc/README-BETA-en.txt
new file mode 100644 (file)
index 0000000..81f6781
--- /dev/null
@@ -0,0 +1,225 @@
+Important Hints for Using Gpg4win 1.9-BETA
+##########################################
+
+Status: Gpg4win-1.9.0 (20080423)
+
+This text covers information that are
+intended to help judging whether Gpg4win 1.9
+is already sufficient for your individual needs
+or you better wait for a first beta-test.
+
+Furthermore, this text lays out the new functionality
+of Gpg4win 2.0. The 1.9.X releases represent the
+beta-cycle. Once this cycle is finished, version
+2.0 will be released.
+
+Feedback welcome!
+  Please let us know whether your tests of Gpg4win 1.9
+  were successful or whether (and which) problems
+  occured.
+  We encourage you to subscribe to the english
+  users mailing list. Submit your reports there
+  or read the reports of other users:
+
+  http://lists.wald.intevation.org/mailman/listinfo/gpg4win-users-en
+
+
+Important hints for present version
+===================================
+
+- Firewall problems:
+  In case you are running a very strict firewall,
+  you might run into problems because Kleopatra
+  communicates with the other componentes via
+  a so-called port a "localhost".
+  Switching off the respective rule should help.
+
+- Installation package almost 40 MByte:
+  The tools curently contain comprehensive debug information.
+  This helps to analyse problems as they occur.
+  For version 2.0 this debug information will be skipped
+  and the installation package is expected to shrink
+  to 10 MByte or even less.
+
+- Manuals not updated:
+  The manuals "Gpg4win for Novices" and "Gpg4win für Durchblicker"
+  are not updated to the new tools yet.
+  However, the manuals that are installed with the 1.9 version
+  are more advanced than the downloadable version 2.0.2 of the manuals.
+
+- Encrypt to self:
+  It is highly recommended to configure your certificates for
+  OpenPGP and S/MIME so that emails are always also encrypted
+  for yourself.
+  For this, enter the GnuPG configuration dialog of Kleopatra
+  and insert the fingerprints of your certificates for
+  "GPG for S/MIME: encrypt to user ID NAME as well" and
+  "GPG for OpenPGP: encrypt to user ID NAME as well".
+
+- Using the Outlook Plugin "GpgOL":
+
+  * You defintely should create copies of your old
+    encrypted/signed emails, e.g. in the form of PST files.
+
+  * Encrypted E-Mails occuring decrypted on Server:
+    It can happend that encrypted emails will be copied
+    to your email server in decrypted form.
+    Affected are the so-called email bodies while
+    this will not happen for attachments.
+    Switching off the Outlook Preview will lower
+    the probability of this to happen.
+
+  * Emails will be stored on the server in Microsoft specific
+    forma and thus not be readable via other email programs.
+
+
+Important hints for using S/MIME
+================================
+
+The email encryption method S/MIME is added for
+Gpg4win 2.0.
+
+It is recommended to make yourself familiar with
+the concept of S/MIME before using it.
+
+Configuration of S/MIME:
+For making S/MIME ready to work, you need to follow
+these steps.
+
+- Enable S/MIME for GpgOL:
+  In Outlook menu Extras->Options, tab "GpgOL"
+  you have to explicitely enable S/MIME support.
+  Please consider the warning dialog seriously.
+
+- Create new S/MIME key:
+  The creation of a *new* S/MIME key is
+  not yet fully implemented Kleopatra.
+
+- Import secret S/MIME key:
+  The personal secret key can be imported as P12 file
+  via Kleopatra (menu File->Import certificates)
+
+- Import S/MIME certificate chain for personal key:
+  The certificate chain the belongs to your secret key
+  is to be imported as P7C file (other suffixes for
+  such files do occur as well).
+  Simply use the same menu item as for P12 import.
+  Typically the chain consists of a root certificate,
+  a CA certificate and your personal certificate.
+
+- Import S/MIME certificate of email receipient:
+  Now import the certificates of your email receipients
+  in the same way, ideally also always including the
+  complete chain.
+
+- Mark root certifactes as trusted:
+  If you activate "Gpg Agent: allow clients
+  to mark keys as trusted" in the GnuPG Backend configuration
+  reachable via Kleopatra menu, then you will be asked
+  whether you want to trust a root certificate at the moment
+  of use.
+  Please note that you need to restart gpg-agent to
+  get the configuration change into effect.
+  This is done e.g. by logging out an in again.
+
+- Mark root certificates as trusted for DirMngr:
+  Place the respective root certificates as DER files
+  (with filename suffix ".crt" into the directory
+  %INSTALL_DIR%\etc\dirmngr\trusted-certs\
+
+- Problems with certificate revocation lists (CRLs):
+  The S/MIME concept considers the use of recocation lists
+  to check validity of a certificate.
+
+  This check may fail due to various probelems which do not
+  all result in a helpul error report yet.
+
+  In case that a S/MIME operation does not work as expected,
+  you may switch of CRL checks temporarily and try again whether the
+  operation works now.
+  If so, please report your obervation to the Gpg4win development
+  team or the users mailing list.
+
+  CRL checks are switched this way:
+  Activate "GPG for S/MIME: never consult a CRL" in
+  "Configure GnuPG Backend" dialog of Kleopatra.
+  Then log out and in again to activate your change.
+
+
+Migration
+=========
+
+* From an older Gpg4win 1.9 Version:
+
+  If there was an older 1.9 version installed, then
+  it is mandadory to reboot the system in case the
+  installation routine suggested (via preselection) so.
+  Else you will run into major errors during cryptographic
+  operations.
+
+* From a Gpg4win 1.X or other GnuPG Version:
+
+  In case you have installed Gpg4win 1.x or any other
+  GnuPG Installation on your system, then you might need to
+  remove this registry entry:
+  HKCU\Software\GNU\GnuPG\gpgProgramm
+
+Most important changes in Gpg4win 1.9
+=====================================
+
+
+Removed:
+--------
+
+- GpgEE: This module is replaced by GpgEX (see below)
+
+
+Updated:
+--------
+
+- Claws Mail: Version 3.1.0cvs70
+  NNTP- and IMAP-Support has been further worked on
+  by Gg4win but is not yet available.
+  On the Claws Mail side, work has continued on the SSL support,
+  but there are still problems with the Windows version.
+  During 2008 it is expected to finalize the integration of SSL, NNTP and
+  IMAP for the Windows-Version of Claws Mail.
+
+- GpgOL: This component has been comprehensively updated.
+
+  * Main new features are:
+
+    - Support of OpenPGP/MIME:
+      So far, only the so-called "inline-PGP" was supported.
+      Now, it is even possible to handle attachments directly.
+
+    - Support of S/MIME
+      GpgOL now supports the X.509 based email encryption method
+      S/MIME.
+
+    - Use of Kleopatra for graphical user dialogs:
+      Instead of implementing dialogs of its own, GpgOL
+      uses the unified dialogs of Kleopatra (see below).
+
+Neu:
+----
+
+- GpgEX: The new plugin for Microsoft Explorer.
+
+- Kleopatra: The new certifacte manager
+
+  * Kleoaptra is the current S/MIME certificate manager of KDE.
+    On the one hand it has been extended for support of OpenPGP.
+    On the other hand, Kleopatra now acts as graphical user
+    interface for cryptographic operations and thus unifies the
+    user interaction.
+
+  * WinPT and GPA will eventually removed from Gpg4win as soon
+    as their functionality is fully replaced by Kleopatra.
+
+  * Kleopatra usually runs permanently as a service (see your system tray)
+    from the time one when its service has been requested in your session.
+
+  * Kleopatra is still in development:
+    Some functionalities for OpenPGP are still missing.
+    You can use GPA or WinPT for the missing functionality.