Updated Readme files
authorEmanuel Schuetze <emanuel.schuetze@intevation.de>
Fri, 7 Aug 2009 15:06:14 +0000 (15:06 +0000)
committerEmanuel Schuetze <emanuel.schuetze@intevation.de>
Fri, 7 Aug 2009 15:06:14 +0000 (15:06 +0000)
doc/ChangeLog
doc/README.de.txt
doc/README.en.txt

index 0a60ea6..9c0f3b2 100644 (file)
@@ -1,3 +1,8 @@
+2009-08-07  Emanuel Schuetze  <emanuel.schuetze@intevation.de>
+
+       * README.en.txt: Update.
+       * README.de.txt: Translate into German.
+
 2009-08-07  Werner Koch  <wk@g10code.com>
 
        * README.en.txt: Change order of sections.
index 1e58cf0..e76ae0e 100644 (file)
 ;; replaced by the Makefile; those words are enclosed by exclamation
 ;; marks.
 
-                  Deutsche README Datei for Gpg4win
+                  Deutsche README Datei für Gpg4win
                   =================================
                                    
-Dies ist GnuPG for Windows, Version !VERSION!.
+Dies ist Gpg4win, Version !VERSION!.
 
 Inhalt:
 
      1. Wichtige Hinweise
      2. Änderungen
-     3. Versionsnummern
-     4. Installer Optionen
-     5. Rechtliche Hinweise
-
-
+     3. Bekannte Probleme (und Abhilfe)
+     4. Versionshistorie
+     5. Versionsnummern der einzelnen Programmteile
+     6. Installer Optionen
+     7. Rechtliche Hinweise
 
 
 1. Wichtige Hinweise
 ====================
 
-Informationen zur Benutzung sind den Handbüchern "Gpg4win für
-Einsteiger" und "Gpg4win für Durchblicker" zu entnehmen.  Diese können
-Sie auch, in einer möglicherweise bereits überarbeiteten Fassung,
-online unter http://www.gpg4win.de lesen.
+Hilfe bei der Benutzung von Gpg4win bietet Ihnen das
+Gpg4win-Kompendium. Sie finden es nach der Installation von
+Gpg4win2 im Gpg4win-Startmenü unter 'Dokumentation' oder
+(in aktueller Fassung) direkt online unter http://www.gpg4win.de.
+
+Falls Sie eine ältere Version von Gpg4win benutzt haben, beachten Sie
+bitte auch die Migrationshinweise im Anhang des Gpg4win-Kompendiums.
+
+Bitte lesen Sie den Abschnitt "Bekannte Probleme", bevor Sie damit
+beginnen Gpg4win zu nutzen.
+
+
+2. Änderungen
+=============
+
+Gpg4win2 bringt große Änderungen im Vergleich zu Gpg4win 1.x mit
+sich. Nachstehend die wichtigsten Änderungen:
+
+- Kleopatra ist der neue Zertifikatsmanager.  Kleopatra ist der
+  bisherige S/MIME Zertifikatsmanager von KDE (a desktop environment
+  used on many GNU/Linux systems).  Für die Verwendung in Gpg4win
+  ist Kleopatra um die Unterstützung von OpenPGP und um eine
+  vereinheitlichte grafische Oberfläche für alle kryptografischen
+  Operationen erweitert worden.  Kleopatra läuft in der Regel
+  permanent als Dienst (siehe Icon im System-Tray), sobald dessen
+  Dienste einmal im Verlauf der Sitzung abgefragt wurden.
+  Die Funktionalitäten von WinPT werden nun durch Kleopatra
+  abgedeckt. WinPT wurde aus Gpg4win2 entfernt.
 
+- GpgEX ist die neue Programmerweiterung für den Microsoft Explorer
+  and ersetzt GpgEE.
 
+- Das E-Mail-Programm Claws Mail wurde auf eine modernere Version
+  aktualisiert und unterstützt nun SSL, NNTP und IMAP.
 
+- GpgOL, die Programmerweiterung für Outlook 2003 und 2007, wurde
+  umfassend überarbeitet.  Es unterstützt nun PGP/MIME und macht
+  damit die Verwendung von verschlüsselten und signierten Anhängen
+  viel einfacher und standardkonformer.  Die Unterstützung von S/MIME
+  wurde ergänzt.  Für die grafischen Benutzerdialoge aller Krypto-
+  Operationen wird nun verwendet.
 
-3. Liste der Änderungen an Gpg4win
+- Das "Gpg4win-Kompendium" ist die neue deutschsprachige Dokumentation
+  zu Gpg4win. Es vereinigt die alten Handbücher "Einsteiger" und
+  "Durchblicker".  Desweiteren wurden sämtliche Kapitel für Gpg4win
+  Version 2.0 aktualisiert, also unter anderem angepasst auf
+  Kleopatra, GpgEX und PGP/MIME sowie ergänzt um S/MIME bzw. X.509.
+
+- Unterstützung folgender Plattformen:
+  Betriebssystem: Windows 2000, XP (32/64), Vista (32/64)
+  MS Outlook: 2003, 2007
+
+
+3. Bekannte Probleme (und Abhilfe)
 ==================================
 
-Eine aktuelle deutschsprachige Übersicht der Änderungen finden online
+- Smartcard-Nutzung mit Kleopatra...
+
+   * ... und einer OpenPGP Karte:
+     Verwenden Sie das gpg-Kommandozeilen-Werkzeug, um ein neues
+     OpenPGP-Zertifikat auf Ihrer Karte zu erzeugen.
+     - Karte einlegen.
+     - Führen Sie "gpg --card-edit" aus.
+     - Wechseln Sie in den Admin-Modus mit "admin".
+     - Geben Sie "generate" ein und folgen Sie den Anweisungen, um
+       ein neues Zertifiakt zu erzeugen.
+     Anschließend wird Ihr neues Zertifikat in Kleopatra angezeigt
+     (markiert mit einem Smartcard Icon).
+
+   * ... und einer Telesec Netkey 3 Karte:
+     Verwenden Sie das gpgsm-Kommandozeilen-Werkzeug, um Ihre Karte
+     (einmalig) zu initialisieren.
+     - Karte einlegen.
+     - Führen Sie "gpgsm --learn-card" aus.
+     Anschließend werden Ihr Zertifiakte von Ihrer Karte in Kleopatra
+     angezeigt (markiert mit einem Smartcard Icon).
+
+   Eine gute (grafische) Alternative ist GPA um Ihre Karte korrekt zu
+   konfigurieren und ggf. Ihre PIN zu ändern.
+
+- Verwendung der Outlook-Programmerweiterung "GpgOL":
+
+  * Sie sollten unbedingt Sicherheitskopien Ihrer alten
+    verschlüsselten/signierten E-Mails machen; z.B. in PST-Dateien!
+
+  * Verschlüsselte E-Mails unverschlüsselt auf E-Mail-Server:
+    Es kann vorkommen, dass Teile von verschlüsselten E-Mails
+    in entschlüsselter/unverschlüsselter Form auf dem E-Mail-Server
+    (IMAP oder MAPI) zu liegen kommen, wenn man sie erstellt/liest.
+    Betroffen sind nur der Inhalt des Anzeigefensters von Outlook,
+    also der "E-Mail-Body".  Anhänge sind nicht betroffen.
+    Schaltet man die Voransicht von Outlook ab, so
+    verringert sich die Wahrscheinlichkeit dafür deutlich,
+    aber es kann trotzdem noch passieren.
+    Eine Lösung hierfür ist in Arbeit.
+
+  * Senden von signierten oder verschlüsselten Nachrichten über ein
+    Exchange basiertes Konto funktioniert nicht.
+
+- Verwendung von GpgEX unter Windows x64:
+
+   * GpgEX ist eine (32bit) Erweiterung für den (32bit) Windows
+     Explorer und läuft _nicht_ in einem 64bit Explorer
+     (= voreingestellter Explorer in einem Windows 64bit System).
+
+     Abhilfe: Starten Sie den 32bit Explorer, um GpgEX nutzen zu können.
+     Klicken Sie auf "Start" -> "Ausführen" und geben Sie folgenden
+     Befehl ein:
+         C:\windows\syswow64\explorer.exe /separate
+     Beachten Sie, dass Sie ggf. den Pfad zu Ihrer x64-basierten 
+     Version von Windows anpassen müssen.
+
+
+4. Versionshistorie
+===================
+
+Eine aktuelle deutschsprachige Übersicht der Änderungen finden Sie online
 unter http://www.gpg4win.de/change-history-de.html .  Im weiteren
 finden Sie die Einträge aus der englischen NEWS Datei:
 
 !NEWSFILE!
 
 
-
-
-3. Versionsnummern der einzenen Bestandteile
-============================================
+5. Versionsnummern der einzelnen Programmteile
+==============================================
 
 Zur Übersicht sind hier die Prüfsummen sowie die Namen der einzelnen
 Bestandteile aufgelistet.  Sie finden dieselben Informationen auch in
@@ -54,57 +157,50 @@ der Datei versioninfo.txt.
 !VERSIONINFO!
 
 
-
-
-4. Installer Optionen
+6. Installer Optionen
 =====================
 
-Hinweis: Dies ist eine kurze Zusammenfassung. Im Anhang des
-Handbuches "Gpg4win für Einsteiger" findet sich ein ähnlicher Text
-der ggf. für Anwender angepasst wurde.
+Hinweis: Dies ist eine kurze Zusammenfassung. Beachten Sie bitte
+auch die Hinweise zur Automatischen Installation im Anhang des
+Gpg4win-Kompendiums.
 
-In einigen Fällen wie zum Beispiel für Software-Verteilungssysteme ist
-es hilfreich, wenn die Installation von Gpg4win ohne Dialoge funktioniert,
-man aber trotzdem vorab alle Installationseinstellungen bestimmen kann.
+In einigen Fällen (wie zum Beispiel für Software-Verteilungssysteme)
+ist es hilfreich, wenn die Installation von Gpg4win ohne Dialoge
+funktioniert, man aber trotzdem vorab alle Installationseinstellungen
+bestimmen kann.
 
 Der Standard-Installationspfad kann mit der Option /D=PFAD angegeben
 werden, welche als letzte auf der Kommandozeile erscheinen muß.
 
+Der Gpg4win Installer unterstützt die Option /S für automatischen
+Ablauf der Installation, und die Option /C=INIFILE, durch welche eine
+Steuerungsdatei (Name endet üblicherweise auf .ini) angegeben werden
+kann.  Diese Datei sollte genau einen Abschnitt "[gpg4win]"
+enthalten, in der absolute Pfade für die zu installierenden
+Konfigurationsdateien vorgegeben werden.
 
-Der Gpg4win Installer unterstützt die Option /S für automatischen Ablauf der
-Installation, und die Option /C=INIFILE, durch welche eine Steuerungsdatei
-(Name endet üblicherweise auf .ini) angegeben werden kann.
-Diese Datei sollte genau einen Abschnitt "[gpg4win]" enthalten,
-in der absolute Pfade für die zu installierenden Konfigurationsdateien
-vorgegeben werden.
-
-Hier ist eine Beispieldatei, die
-zugleich alle erlaubten Schlüsselworte zeigt:
+Hier ist eine Beispieldatei, die zugleich alle erlaubten
+Schlüsselworte zeigt: 
 
 [gpg4win]
-  ; Installer Einstellungen.
-  ; Weg- oder leer-lassen bedeutet, dass die Voreinstellung
-  ; verwendet wird. 
+  ; Installationseinstellungen. Weg- oder leerlassen für 
+  ; Voreinstellung
   inst_gpgol = true
   inst_gpgex = true
   inst_kleopatra = true
   inst_gpa = true
-  inst_scute = true
   inst_claws_mail = false
   inst_compendium_de = true
-  inst_novice_manual_en = true
-  inst_novice_manual_de = true
-  inst_advanced_manual_de = true
-  inst_advanced_manual_en = true
+  inst_man_novice_en = true
 
   ; Die Stellen, an denen Verknüpfungen erzeugt werden sollen.
   inst_start_menu = true
   inst_desktop = false
   inst_quick_launch_bar = false
 
-  ; Im Gegensatz zu den anderen Optionen überschreibt diese Option die
-  ; Einstellung des Benutzers im Installer.
-  inst_start_menu_folder = GnuPG for Windows
+  ; Im Gegensatz zu den anderen Optionen überschreibt diese Option
+  ; die Einstellung des Benutzers im Installationsassistenten.
+  inst_start_menu_folder = Gpg4win
 
   ; Standard-Konfigurationsdateien.
   gpg.conf = D:\config\gpg-site.conf
index 0973f7f..650f0c3 100644 (file)
@@ -7,17 +7,17 @@
                    English README file for Gpg4win
                    ===============================
 
-This is GnuPG for Windows, version !VERSION!.
+This is Gpg4win, version !VERSION!.
 
 Content:
 
-     1. Important notes
+     1. Important Notes
      2. Changes
-     3. Known bugs
-     4. Version history
-     5. Version numbers
-     6. Installer options
-     7. Legal notices
+     3. Known Bugs (and Workarounds)
+     4. Version History
+     5. Version Numbers of Included Software
+     6. Installer Options
+     7. Legal Notices
 
 
 1. Important Notes
@@ -37,7 +37,7 @@ Gpg4win.
 2. Changes
 ==========
 
-Gpg4win/2 has major changes compared to Gpg4win 1.x.  Below is a list
+Gpg4win2 has major changes compared to Gpg4win 1.x.  Below is a list
 of the most important ones:
 
 - Kleopatra is the new certificate manager.  Kleopatra is the S/MIME
@@ -48,7 +48,7 @@ of the most important ones:
   component requests its services and then runs permanently in your
   system tray.  WinPT has been dropped.
 
-- GpgEX is the new plugin for the Explorer and replaces GpgEE.
+- GpgEX is the new plugin for the Microsoft Explorer and replaces GpgEE.
 
 - The mail program Claws Mail has been updated to a modern version.
   It now supports SSL, NNTP and IMAP.
@@ -65,27 +65,32 @@ of the most important ones:
   Version 2.0. Among other things, this means adaption to Kleopatra,
   GpgEX and PGP/MIME and new texts for S/MIME and X.509.
 
+- Support of these platforms:
+  Operating System: Windows 2000, XP (32/64), Vista (32/64)
+  Outlook: 2003, 2007
 
-3. Known Bugs
-=============
+
+3. Known Bugs (and Workarounds)
+===============================
 
 - Using smart card with Kleopatra...
 
    * ... and OpenPGP card:
      Use the gpg command line tool to create a new OpenPGP certificate
      on your card.
+     - Insert card.
      - Run "gpg --card-edit".
      - Switch to admin modus by enter: "admin".
      - Enter "generate" to create a new certificate.
      After finishing the process your new certificate is shown in
-     Kleopatra with a smart card icon.
+     Kleopatra (marked with a smart card icon).
 
    * ... and Telesec Netkey 3 card:
      Use the gpgsm command line tool to initializing your card.
-     - Insert your card.
+     - Insert card.
      - Run "gpgsm --learn-card".
      After this the certificates from your card are shown in
-     Kleopatra with a smart card icon.
+     Kleopatra (marked with a smart card icon).
 
    A good (graphical) alternative for setting up your smart
    card and changing PIN is GPA.
@@ -107,6 +112,19 @@ of the most important ones:
   * Sending signed or encrypted messages via an Exchange based account
     does not yet work.
 
+- Using GpgEX with Windows x64:
+
+   * GpgEX is a (32bit) plugin for the (32bit) Windows
+     Explorer and it does _not_ run in a 64bit Explorer
+     (= default for a Windows 64bit system).
+
+     Workaround: Run the 32bit Explorer to use GpgEX.
+     Click "Start" -> "Run", type the following in the box, and then
+     click OK:
+         C:\windows\syswow64\explorer.exe /separate
+     Note: Adjust the path to your x64-based version of Windows if
+     necessary.
+
 
 4. Version History
 ==================
@@ -144,13 +162,9 @@ all possible keys:
   inst_gpgex = true
   inst_kleopatra = true
   inst_gpa = true
-  inst_scute = true
   inst_claws_mail = false
   inst_compendium_de = true
-  inst_novice_manual_en = true
-  inst_novice_manual_de = true
-  inst_advanced_manual_de = true
-  inst_advanced_manual_en = true
+  inst_man_novice_en = true
 
   ; Where to install short-cuts.
   inst_start_menu = true
@@ -160,7 +174,7 @@ all possible keys:
   ; Contrary to other settings in this file, the start menu folder
   ; setting here will override the user selection at installation
   ; time.
-  inst_start_menu_folder = GnuPG for Windows
+  inst_start_menu_folder = Gpg4win
 
   ; Additional configuration files to install.
   gpg.conf = D:\config\gpg-site.conf