[Gpg4win-commits] r1572 - trunk/doc

Fri Oct 8 14:48:11 CEST 2010

Author: emanuel
Date: 2010-10-08 14:48:10 +0200 (Fri, 08 Oct 2010)
New Revision: 1572

Modified:
   trunk/doc/ChangeLog
   trunk/doc/README.de.txt
   trunk/doc/README.en.txt
   trunk/doc/pkg-copyright.txt
Log:
Updated README files.


Modified: trunk/doc/ChangeLog
===================================================================

--- trunk/doc/ChangeLog	2010-10-04 12:37:44 UTC (rev 1571)
+++ trunk/doc/ChangeLog	2010-10-08 12:48:10 UTC (rev 1572)
@@ -1,3 +1,7 @@
+2010-10-08  Emanuel Schuetze <emanuel at intevation.de>
+
+	* README.de.txt, README.en.txt, pkg-copyright.txt: Update.
+
 2010-10-04  Emanuel Schuetze <emanuel at intevation.de>
 
 * website/donate.htm4, website/donate-de.htm4: Add new sponsor.

Modified: trunk/doc/README.de.txt
===================================================================
--- trunk/doc/README.de.txt	2010-10-04 12:37:44 UTC (rev 1571)
+++ trunk/doc/README.de.txt	2010-10-08 12:48:10 UTC (rev 1572)
@@ -15,76 +15,42 @@
      1. Wichtige Hinweise
      2. Änderungen
      3. Bekannte Probleme (und Abhilfe)
-     4. Versionshistorie
-     5. Versionsnummern der einzelnen Programmteile
-     6. Installer Optionen
+     4. Installation
+     5. Versionshistorie
+     6. Versionsnummern der einzelnen Programmteile
      7. Rechtliche Hinweise
 
 
 1. Wichtige Hinweise
 ====================
 
-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.
+Hilfe bei der Installation und Benutzung von Gpg4win bietet Ihnen das
+Gpg4win-Kompendium. Sie finden es nach der Installation im
+Gpg4win-Startmenü unter 'Dokumentation' oder direkt online unter: 
+http://www.gpg4win.de/doc/de/gpg4win-compendium.html
 
-Falls Sie eine ältere Version von Gpg4win benutzt haben, beachten Sie
-bitte die Migrationshinweise im Anhang des Gpg4win-Kompendiums.
+Falls Sie von Gpg4win 1.x oder einem andern Proramm auf Gpg4win 2.x
+umsteigen wollen, beachten Sie bitte die Migrationshinweise im Anhang
+des Gpg4win-Kompendiums:
+http://www.gpg4win.de/doc/de/gpg4win-compendium_36.html
 
-Bitte lesen Sie den Abschnitt "Bekannte Probleme", bevor Sie damit
-beginnen Gpg4win zu nutzen.
+Bitte lesen Sie den Abschnitt "3. Bekannte Probleme (und Abhilfe)",
+bevor Sie damit beginnen Gpg4win zu nutzen.
 
-- Unterstützung folgender Plattformen:
-  Betriebssystem: Windows 2000, XP (32/64), Vista (32/64)
-  MS Outlook: 2003, 2007
+Gpg4win unterstützt folgende Plattformen:
+ * Betriebssystem: Windows 2000, XP (32/64), Vista (32/64), 7 (32/64)
+ * MS Outlook: 2003, 2007
+ Beachten Sie: GpgEX bietet aktuell keine Unterstützung für 64-bit Explorer! 
+ (Details unter Abschnitt 3, Punkt "Probleme unter Windows x64")
 
 
 2. Änderungen
 =============
 
-Gpg4win2 bringt große Änderungen im Vergleich zu Gpg4win 1.x mit
-sich. Nachstehend die wichtigsten Änderungen:
+Änderungen gegenüber Version 2.0.4:
 
-- Kleopatra ist der neue Zertifikatsmanager.  Kleopatra ist der
-  bisherige S/MIME Zertifikatsmanager von KDE (eine auf vielen
-  GNU/Linux-Systemen benutzte Arbeitsumgebung).  Für die Verwendung
-  in Gpg4win ist Kleopatra um die Unterstützung von OpenPGP und 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.
+[Die folgenden Fallnummern beziehen sich auf https://issues.kolab.org/.]
 
-- GpgEX ist die neue Programmerweiterung für den Microsoft Explorer
-  und 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 Kleopatra verwendet.
-
-- 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
-
- 
-Kurzübersicht zu Änderungen gegenüber Version 2.0.4:
-----------------------------------------------------
-[Die folgenden Fallnummer beziehen sich auf https://issues.kolab.org/.]
-
 - Kleopatra:
   * Konfliktdialog 
     - Zertifikatsauswahldialog nun kontextsensitiv (abhängig ob signiert,
@@ -215,7 +181,7 @@
      OpenPGP-Zertifikat auf Ihrer Karte zu erzeugen (a) oder Ihr
      vohandenes Zertifikat von Ihrer Karte zu aktivieren (b):
 
-     (a) Neue Zertifikat erzeugen
+     (a) Neues Zertifikat erzeugen
        - Karte einlegen.
        - Führen Sie "gpg --card-edit" auf der Kommandozeile aus.
        - Wechseln Sie in den Admin-Modus mit "admin".
@@ -253,7 +219,7 @@
 
   * Outlook2007 stürzt beim Öffnen von Anhängen einer
     verschlüsselten Nachricht ab
-    [see https://bugs.g10code.com/gnupg/issue1110]
+    [siehe https://bugs.g10code.com/gnupg/issue1110]
 
   * Verschlüsselte E-Mails unverschlüsselt auf E-Mail-Server:
     Es kann vorkommen, dass Teile von verschlüsselten E-Mails
@@ -287,9 +253,22 @@
      Beachten Sie, dass Sie ggf. den Pfad zu Ihrer x64-basierten 
      Version von Windows anpassen müssen.
      Dieser separate Aufruf scheint aktuell in Win7/64bit defekt zu sein.
+     Alternativ können Sie die Datei-Krypto-Operationen von GpgEX
+     auch direkt über das Datei-Menü von Kleopatra erreichen.
+ 
 
+4. Installation
+===============
 
-4. Versionshistorie
+Eine Anleitung zur Installation von Gpg4win finden Sie im Gpg4win-Kompendium:
+http://www.gpg4win.de/doc/de/gpg4win-compendium_11.html
+
+Hinweise zur automatisierten Installation (ohne Benutzerdialoge)
+finden Sie im Anhang des Gpg4win-Komendiums:
+http://www.gpg4win.de/doc/de/gpg4win-compendium_35.html
+
+
+5. Versionshistorie
 ===================
 
 Eine aktuelle deutschsprachige Übersicht der Änderungen finden Sie online
@@ -299,88 +278,16 @@
 !NEWSFILE!
 
 
-5. Versionsnummern der einzelnen Programmteile
+6. Versionsnummern der einzelnen Programmteile
 ==============================================
 
 Zur Übersicht sind hier die Prüfsummen sowie die Namen der einzelnen
-Bestandteile aufgelistet.  Sie finden dieselben Informationen auch in
-der Datei versioninfo.txt.
+Bestandteile aufgelistet. 
 
 !VERSIONINFO!
 
 
-6. Installer Optionen
-=====================
-
-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.
-
-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.
-
-Hier ist eine Beispieldatei, die zugleich alle erlaubten
-Schlüsselworte zeigt: 
-
-[gpg4win]
-  ; Installationseinstellungen. Weg- oder leerlassen für 
-  ; Voreinstellung
-  inst_gpgol = true
-  inst_gpgex = true
-  inst_kleopatra = true
-  inst_gpa = true
-  inst_claws_mail = false
-  inst_compendium_de = 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 Installationsassistenten.
-  inst_start_menu_folder = Gpg4win
-
-  ; Standard-Konfigurationsdateien.
-  gpg.conf = D:\config\gpg-site.conf
-  gpg-agent.conf = D:\config\gpg-agent-site.conf
-  trustlist.txt = D:\config\trustlist-site.txt
-  dirmngr.conf = D:\config\dirmngr-site.conf
-  dirmngr_ldapserver.conf = D:\config\dirmngr_ldapserver-site.conf
-  scdaemon.conf = D:\config\scdaemon-site.txt
-  gpa.conf = D:\config\gpa-site.conf
-
-Ein entsprechender Aufruf zur automatischen Installation könnte also
-wie folgt aussehen:
-
-gpg4win.exe /S /C=C:\TEMP\gpg4win.ini /D=D:\Programme\Gpg4win
-
-Für den MSI installer gilt entsprechendes, mit folgenden Änderungen:
-Automatischer Ablauf wird wie üblich mit der Option /qb- zu msiexec
-erreicht.  Die Steuerungsdatei muss gpg4win.ini heißen und im
-Systemverzeichnis (C:\WINDOWS) vorliegen.  Der Installationspfad kann
-mit dem Eintrag "instdir" festgelegt werden.  Ausserdem können die
-Einstellungen auch auf der Kommandozeile mittels INSTDIR=... und
-INST_GPA=FALSE etc. angegeben werden (die Steuerungsdatei geht
-allerdings vor).  Die Angabe von Standard-Konfigurationsdateien, sowie
-die Angabe des Start Menu Verzeichnisses und die optionale Auswahl der
-Verknüpfungen wird vom MSI installer momentan nicht unterstützt.
-
-
-5. Rechtliche Hinweise zu den einzelnen Bestandteilen der Software
+7. Rechtliche Hinweise zu den einzelnen Bestandteilen der Software
 ==================================================================
 
 Gpw4win besteht aus einer ganzen Reihe von unabhängig entwickelten
@@ -389,7 +296,7 @@
 Public License (GNU GPL).  Gemeinsam ist allen, daß die Software ohne
 Restriktionen benutzt werden kann, verändert werden darf und
 Änderungen weitergeben dürfen.  Wenn die Quelltexte (also
-gpg4win-src-x.y.z.exe) mit weitergegeben werden und auf die die GNU
+gpg4win-x.y.z.tar.bz2) mit weitergegeben werden und auf die die GNU
 GPL hingewiesen wird, ist die Weitergabe in jedem Fall möglich.
 
 Zur Übersicht folgt eine Liste der Copyright Erklärungen.

Modified: trunk/doc/README.en.txt
===================================================================
--- trunk/doc/README.en.txt	2010-10-04 12:37:44 UTC (rev 1571)
+++ trunk/doc/README.en.txt	2010-10-08 12:48:10 UTC (rev 1572)
@@ -14,64 +14,38 @@
      1. Important Notes
      2. Changes
      3. Known Bugs (and Workarounds)
-     4. Version History
-     5. Version Numbers of Included Software
-     6. Installer Options
+     4. Installation
+     5. Version History
+     6. Version Numbers of Included Software
      7. Legal Notices
 
 
 1. Important Notes
 ==================
 
-Manuals describing the installation of Gpg4win are currently only
-available in German.  Check out http://www/gpg4win.org for latest
-news.
+The Gpg4win Compendium describes the installation and use of Gpg4win.
+After installation it is available in the Gpg4win start menu or online:
+http://www.gpg4win.org/doc/en/gpg4win-compendium.html
 
-If you used an older version of Gpg4win in the past, please check
+If you used Gpg4win 1.x or another program in the past, please check
 out the migration hints in the Gpg4win Compendium's appendix.
+http://www.gpg4win.org/doc/en/gpg4win-compendium_36.html
 
-Please read the "Known bugs" section before you start working with
-Gpg4win.
+Please read the section "3. Known Bugs (and Workarounds)" before you
+start working with Gpg4win.
 
+Gpg4win supports these platforms:
+ * Operating System: Windows 2000, XP (32/64), Vista (32/64), 7 (32/64)
+ * MS Outlook: 2003, 2007
+ Note: Currently, there is no 64-bit support for GpgEX 
+ (see section 3, "Using GpgEX with Windows x64", for details)
 
+
 2. Changes
 ==========
 
-Gpg4win2 has major changes compared to Gpg4win 1.x.  Below is a list
-of the most important ones:
+Changes compared to version 2.0.4:
 
-- Kleopatra is the new certificate manager.  Kleopatra is the S/MIME
-  certificate manager of KDE (a desktop environment used on many
-  GNU/Linux systems).  For use in Gpg4win it has been extended to
-  support OpenPGP and to act as a graphical user interface for all
-  cryptographic operations.  It is automatically started if another
-  component requests its services and then runs permanently in your
-  system tray.  WinPT has been dropped.
-
-- 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.
-
-- GpgOL, the plugin for Outlook 2003 and 2007 has been comprehensively
-  updated.  It now supports PGP/MIME and thus makes the use of
-  encrypted or signed attachments much easier and standard conform.
-  Support for S/MIME has been added.  Most dialogs are now provided by
-  Kleopatra for graphical user dialogs.
-
-- The German "Gpg4win-Kompendium" is the new documentation for Gpg4win.
-  This combines the previous "Einsteiger" and "Durchblicker" manuals.
-  All chapters were reworked and extended to describe the new Gpg4win
-  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
-
-
-Short overview on changes compared to version 2.0.4:
-----------------------------------------------------
 [The following issue numbers reference to https://issues.kolab.org/.]
 
 - Kleopatra:
@@ -264,84 +238,36 @@
      Note: Adjust the path to your x64-based version of Windows if
      necessary. 
      This separate command seems to be currently broken in Win7/64bit.
+     Alternatively you can use the file crypto operations of GpgEX
+     directly via the file menu of Kleopatra.
 
 
-4. Version History
+4. Installation
+===============
+
+For installation instructions please read the new Gpg4win Compendium:
+http://www.gpg4win.org/doc/en/gpg4win-compendium_11.html
+
+Hints for automated installations (without user dialogs):
+http://www.gpg4win.org/doc/en/gpg4win-compendium_35.html
+
+
+5. Version History
 ==================
 
 Find below the changes as recorded in the source distribution's NEWS
 file.  An up-to-date list of changes is also available at
-http://www.gpg4win.de/change-history.html .
+http://www.gpg4win.org/change-history.html .
 
 !NEWSFILE!
 
 
-5. Version Numbers of Included Software
+6. Version Numbers of Included Software
 =======================================
 
 !VERSIONINFO!
 
 
-
-6. Installer Options
-====================
-
-The default installation path can be speficied with the /D=PATH
-option, which must be last on the command line.  The installer
-supports the options /S for unattended installation, and the option
-/C=INIFILE to specify an .ini file which should contain exactly one
-section "[gpg4win]".  This section contains various installer settings
-and absolute file paths to configuration files that should be
-preinstalled.  Most options just set a different default value.
-Excetions are documented below.  Here is an example file which shows
-all possible keys:
-
-[gpg4win]
-  ; Installer settings.  Do not define or leave empty for defaults.
-  inst_gpgol = true
-  inst_gpgex = true
-  inst_kleopatra = true
-  inst_gpa = true
-  inst_claws_mail = false
-  inst_compendium_de = true
-  inst_man_novice_en = true
-
-  ; Where to install short-cuts.
-  inst_start_menu = true
-  inst_desktop = false
-  inst_quick_launch_bar = false
-
-  ; 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 = Gpg4win
-
-  ; Additional configuration files to install.
-  gpg.conf = D:\config\gpg-site.conf
-  gpg-agent.conf = D:\config\gpg-agent-site.conf
-  trustlist.txt = D:\config\trustlist-site.txt
-  dirmngr.conf = D:\config\dirmngr-site.conf
-  dirmngr_ldapserver.conf = D:\config\dirmngr_ldapserver-site.conf
-  scdaemon.conf = D:\config\scdaemon-site.txt
-  gpa.conf = D:\config\gpa-site.conf
-
-An example command for unattended installation could look like this:
-
-gpg4win.exe /S /C=C:\TEMP\gpg4win.ini /D=D:\Programme\Gpg4win
-
-For the MSI installer, the above also holds, with the following
-changes: Unattended installation is achieved as usual with the /qb-
-option to msiexec.  The control file must be called gpg4win.ini and
-reside in the system directory (C:\WINDOWS).  It is found
-automatically by the installer.  The installation directory can be
-specified with an entry for "instdir".  Also, each entry can be given
-in uppercase at the command line through INSTDIR=... and
-INST_GPA=FALSE etc. (the control file takes precedence, though).  The
-default config files as well as start menu directory and optional
-installation of short cuts are currently not supported through the MSI
-installer.
-
-
 7. Legal notices pertaining to the individual packets
 =====================================================
 

Modified: trunk/doc/pkg-copyright.txt
===================================================================
--- trunk/doc/pkg-copyright.txt	2010-10-04 12:37:44 UTC (rev 1571)
+++ trunk/doc/pkg-copyright.txt	2010-10-08 12:48:10 UTC (rev 1572)
@@ -1,10 +1,10 @@
 Here is a list with collected copyright notices. For details see the
 description of each individual package.  [Compiled by wk 2006-02-15,
-last updated 2008-04-23]
+last updated 2010-10-08]
 
 Gpg4win is
 
-  Copyright (C) 2005, 2006, 2007, 2008, 2009 g10 Code GmbH
+  Copyright (C) 2005, 2006, 2007, 2008, 2009, 2010 g10 Code GmbH
   
   Gpg4win is free software; you can redistribute it and/or modify it
   under the terms of the GNU General Public License as published by
@@ -25,7 +25,7 @@
 GnuPG is
 
   Copyright 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005,
-            2006, 2007, 2008, 2009 Free Software Foundation, Inc.
+            2006, 2007, 2008, 2009, 2010 Free Software Foundation, Inc.
 
   GnuPG is free software; you can redistribute it and/or modify it
   under the terms of the GNU General Public License as published by
@@ -46,7 +46,7 @@
 
 NSIS is  
 
-  Copyright (C) 1999-2005 Nullsoft, Inc.
+  Copyright (C) 1999-2008 Nullsoft and Contributors
 
   This license applies to everything in the NSIS package, except where
   otherwise noted.

