Fix distribution of the two HOWTO files.
authorWerner Koch <wk@gnupg.org>
Mon, 2 Apr 2012 14:27:17 +0000 (16:27 +0200)
committerWerner Koch <wk@gnupg.org>
Mon, 2 Apr 2012 14:27:17 +0000 (16:27 +0200)
These HOWTOs prevented the use of make distcheck and they were not
included in the tarball.
* src/Makefile.am (gpg4win_howto_smime_ll): New.
(HOWTO_files): Set new variable.  Use as dependency for all
installers.
(CLEANFILES): add Howto files.
* src/gpg4win.mk.in (HOWTO_template): New.  Expand that.
* src/inst-gpg4win.nsi:
* doc/Makefile.am (EXTRA_DIST): Add howtos.
* doc/HOWTO-SMIME.de.txt: Reformat and suggest sha1sum instead of
openssl.
* doc/HOWTO-SMIME.en.txt: Ditto.

doc/HOWTO-SMIME.de.txt
doc/HOWTO-SMIME.en.txt
doc/Makefile.am
src/Makefile.am
src/gpg4win.mk.in
src/inst-gpg4win.nsi

index 71fbb07..fc9b1b7 100644 (file)
-(Um S/MIME-Zertifikate zum Signieren und Verschlüsseln zu verwenden, müssen Sie die\r
-Vertrauenswürdigkeit der X.509-Wurzelzertifikate festlegen.)\r
-\r
-Ein Wurzelzertifikat (auch: Root-CA) dient dazu, die Gültigkeit aller untergeordneten\r
-Zertifikate zu überprüfen. Wird dem Wurzelzertifikat vertraut, so vertraut man damit\r
-auch allen darunter liegenden Zertifikaten.\r
-\r
-Um zu vermeiden, dass jeder Anwender selbst die notwendigen Wurzelzertifikate suchen\r
-und installieren sowie deren Vertrauenswürdigkeit prüfen und beglaubigen muss, ist eine\r
-systemweite Vorbelegung der wichtigsten Wurzelzertifikate als Administrator wie folgt\r
-sinnvoll:\r
-\r
-1.  Ablegen der Wurzelzertifikate\r
-\r
-     Kopieren Sie eine Wurzelzertifikats-Datei nach:\r
-     [Windows XP]:\r
-        C:\Dokumente und Einstellungen\All Users\Anwendungsdaten\GNU\etc\\r
-        dirmngr\trusted-certs\\r
-     [Windows Vista/7]:\r
-        C:\ProgramData\GNU\etc\dirmngr\trusted-certs\r
-\r
-     Die Wurzelzertifikate müssen als Dateien im Format DER mit der \r
-     Dateinamens-Erweiterung .crt oder .der zu liegen kommen.\r
-\r
-     Sie bekommen die Wurzelzertifikate von den jeweiligen CA-Administratoren.\r
-     Oftmals bieten die CA-Betreiber ihre Wurzelzertifikate auch auf Webseiten\r
-     zum Download an.\r
-\r
-     Ist der o.g. Ordner nicht sichtbar? \r
-     Beachten Sie den Hinweis zu den Ansichtsoptionen [1].\r
-\r
-2.  Ultimativ vertrauenswürdig setzen\r
\r
-     a) Öffnen Sie die folgende Datei mit einem Texteditor:\r
-         [Windows XP]:\r
-           C:\Dokumente und Einstellungen\All Users\Anwendungsdaten\GNU\etc\\r
-           gnupg\trustlist.txt\r
-         [Windows Vista/7]:\r
-           C:\ProgramData\GNU\etc\gnupg\trustlist.txt\r
-\r
-     b) Pro Wurzelzertifikat erstellen Sie eine Zeile mit dem\r
-         zugehörigen Fingerabdruck, wie:\r
-         <FINGERABDRUCK> S \r
-\r
-         Den Fingerabdruck bekommen Sie direkt vom CA-Betreiber (oftmals verfügbar \r
-         über die Webseite, wo das Zertifikat zum Download angeboten wird). \r
-         Alternativ können sie den Fingerabdruck auch mit Hilfe des \r
-         Kommandozeilenwerkzeugs "openssl" (nicht in Gpg4win enthalten) aus der \r
-         Wurzelzertifikatsdatei herausbekommmen:\r
-           openssl x509 -in <root-certificate> -noout -fingerprint -sha1\r
-      \r
-         Wenn eine Zeile in der trustlist.txt mit einem "#"-Zeichen beginnt, ist \r
-         diese Zeile ein Kommentar.\r
-         Abschließend (am Ende der Datei) muss eine Leerzeile erfolgen.\r
-\r
-         Beispiel für zwei Einträge mit Kommentar:\r
-           # CN=Wurzel ZS 3,O=Intevation GmbH,C=DE, eintragen Bernhard 20101021\r
-           A6935DD34EF3087973C706FC311AA2CCF733765B S\r
-\r
-           # CN=PCA-1-Verwaltung-02/O=PKI-1-Verwaltung/C=DE\r
-           DC:BD:69:25:48:BD:BB:7E:31:6E:BB:80:D3:00:80:35:D4:F8:A6:CD S\r
-  \r
-         Es kann in einigen Fällen sinnvoll sein, die Kriterien bei der Überprüfung\r
-         der Wurzelzertifikate zu verringern. Sie können dazu hinter "S" eine weitere\r
-         Flagge "relax" setzen: <FINGERABDRUCK> S relax\r
-\r
-         Wichtig: Die Verwendung von relax setzt die Sicherheit herab, muss daher\r
-         individuell entschieden werden und sollte nur bei Problemen verwendet\r
-         werden.\r
-\r
-3.  Gpg4win-Installation abschließen und Rechner neu starten\r
-\r
-     a) Aktivieren Sie "Wurzelzertifikte festgelegt oder überspringen".\r
-\r
-     b) Beenden Sie den Gpg4win-Installationsassistenten regulär.\r
-\r
-     c) Starten Sie Ihren Rechner neu! (Erforderlich, damit der DirMngr\r
-        Ihre unter (1) abgelegten Wurzelzertifikate neu einliest.)\r
-\r
-     Damit haben Sie die Konfiguration von S/MIME erfolgreich abgeschlossen.\r
-\r
-4.  Überprüfung später in Kleopatra: Zertifikatsketten importieren\r
-\r
-     Öffnen Sie Kleopatra und importieren Sie Ihre X.509-Zertifikatsketten. \r
-     Die importierten Zertifikatsketten sollten unter dem Reiter \r
-     "Vertrauenswürdige Zertifikate" erscheinen. Damit erkennt Gpg4win Ihre\r
-     importierten Wurzelzertifikate als vertrauenswürdig an.\r
-\r
-     Probleme? Wird Ihr Wurzelzertifikat nicht als vertrauenswürdig angezeigt?\r
-     Lösungsvorschläge:\r
-     * Klicken Sie in Kleopatra einmal auf "Aktualisieren", um die \r
-        Zertifikatsansicht zu aktualisieren.\r
-     * Ergänzen Sie "relax" hinter dem betroffenen Wurzelzertifikat \r
-        in der trustlist.txt - siehe Schritt (2).\r
-\r
---\r
-Diese Anleitung finden Sie zum späteren Nachlesen im Gpg4win-Startmenü unter\r
-"Dokumentation".\r
-\r
-Weiterführende Informationen finden Sie im Gpg4win-Kompendium, Kapitel 22:\r
-     http://gpg4win.de/doc/de/gpg4win-compendium_28.html\r
-\r
-[1] Hinweis zu Ansichtsoptionen:\r
-     Stellen Sie sicher, dass Sie im Windows Explorer die nachfolgende\r
-     Ordneransichts-Option "Alle Dateien und Ordner anzeigen" aktiviert haben.\r
-     Sie erreichen diese Option unter:\r
-      [Windows XP]: Extras > Ordneroptionen > Ansicht\r
-      [Windows Vista/7]: Organisieren > Ordner- und Suchoptionen > Ansicht\r
+;; HOWTO-SMIME.de.txt                               -*- coding: latin-1; -*-
+;; This is a HOWTO installed with Gpg4win. Lines with a ; in the first
+;; column are considered a comment and not included in the actually
+;; installed version.  Certain keywords are replaced by the Makefile;
+;; those words are enclosed by exclamation marks.
+
+(Um S/MIME-Zertifikate zum Signieren und Verschlüsseln zu verwenden,
+müssen Sie die Vertrauenswürdigkeit der X.509-Wurzelzertifikate
+festlegen.)
+
+Ein Wurzelzertifikat (auch: Root-CA) dient dazu, die Gültigkeit aller
+untergeordneten Zertifikate zu überprüfen. Wird dem Wurzelzertifikat
+vertraut, so vertraut man damit auch allen darunter liegenden
+Zertifikaten.
+
+Um zu vermeiden, dass jeder Anwender selbst die notwendigen
+Wurzelzertifikate suchen und installieren sowie deren
+Vertrauenswürdigkeit prüfen und beglaubigen muss, ist eine systemweite
+Vorbelegung der wichtigsten Wurzelzertifikate als Administrator wie
+folgt sinnvoll:
+
+1.  Ablegen der Wurzelzertifikate
+
+     Kopieren Sie eine Wurzelzertifikats-Datei nach:
+     [Windows XP]:
+        C:\Dokumente und Einstellungen\All Users\Anwendungsdaten\GNU\etc\
+        dirmngr\trusted-certs\
+     [Windows Vista/7]:
+        C:\ProgramData\GNU\etc\dirmngr\trusted-certs
+
+     Die Wurzelzertifikate müssen als Dateien im Format DER mit der
+     Dateinamens-Erweiterung .crt oder .der zu liegen kommen.
+
+     Sie bekommen die Wurzelzertifikate von den jeweiligen CA-Administratoren.
+     Oftmals bieten die CA-Betreiber ihre Wurzelzertifikate auch auf Webseiten
+     zum Download an.
+
+     Ist der o.g. Ordner nicht sichtbar?
+     Beachten Sie den Hinweis zu den Ansichtsoptionen [1].
+
+2.  Ultimativ vertrauenswürdig setzen
+
+     a) Öffnen Sie die folgende Datei mit einem Texteditor:
+
+         [Windows XP]:
+           C:\Dokumente und Einstellungen\All Users\Anwendungsdaten\GNU\etc\
+           gnupg\trustlist.txt
+
+         [Windows Vista/7]:
+           C:\ProgramData\GNU\etc\gnupg\trustlist.txt
+
+     b) Pro Wurzelzertifikat erstellen Sie eine Zeile mit dem
+        zugehörigen Fingerabdruck, wie:
+
+         <FINGERABDRUCK> S
+
+         Den Fingerabdruck bekommen Sie direkt vom CA-Betreiber
+         (oftmals verfügbar über die Webseite, wo das Zertifikat zum
+         Download angeboten wird).  Alternativ können sie den
+         Fingerabdruck auch mit Hilfe des Kommandozeilenwerkzeugs
+         "sha1suml" aus der binären Datei mit dem Wurzelzertifikat
+         (diese Dateien haben üblicherweise eine Endung von ".crt:,
+         ".bin", ".cert" oder ".cer"):
+
+           sha1sum < <ROOT-CERTIFICATE-FILE>
+
+         Wenn eine Zeile in der trustlist.txt mit einem "#"-Zeichen
+         beginnt, ist diese Zeile ein Kommentar.  Abschließend (am
+         Ende der Datei) muss eine Leerzeile erfolgen.
+
+         Beispiel für zwei Einträge mit Kommentar:
+
+           # CN=Wurzel ZS 3,O=Intevation GmbH,C=DE, eintragen Bernhard 20101021
+           A6935DD34EF3087973C706FC311AA2CCF733765B S
+
+           # CN=PCA-1-Verwaltung-02/O=PKI-1-Verwaltung/C=DE
+           DC:BD:69:25:48:BD:BB:7E:31:6E:BB:80:D3:00:80:35:D4:F8:A6:CD S
+
+         Es kann in einigen Fällen sinnvoll sein, die Kriterien bei
+         der Überprüfung der Wurzelzertifikate zu verringern. Sie
+         können dazu hinter "S" eine weitere Flagge "relax" setzen:
+
+           <FINGERABDRUCK> S relax
+
+
+3.  Gpg4win-Installation abschließen und Rechner neu starten
+
+     a) Aktivieren Sie "Wurzelzertifikte festgelegt oder überspringen".
+
+     b) Beenden Sie den Gpg4win-Installationsassistenten regulär.
+
+     c) Starten Sie Ihren Rechner neu! (Erforderlich, damit der DirMngr
+        Ihre unter (1) abgelegten Wurzelzertifikate neu einliest.)
+
+     Damit haben Sie die Konfiguration von S/MIME erfolgreich abgeschlossen.
+
+4.  Überprüfung später in Kleopatra: Zertifikatsketten importieren
+
+     Öffnen Sie Kleopatra und importieren Sie Ihre X.509-Zertifikatsketten.
+     Die importierten Zertifikatsketten sollten unter dem Reiter
+     "Vertrauenswürdige Zertifikate" erscheinen. Damit erkennt Gpg4win Ihre
+     importierten Wurzelzertifikate als vertrauenswürdig an.
+
+     Probleme? Wird Ihr Wurzelzertifikat nicht als vertrauenswürdig angezeigt?
+     Lösungsvorschläge:
+
+     * Klicken Sie in Kleopatra einmal auf "Aktualisieren", um die
+       Zertifikatsansicht zu aktualisieren.
+
+     * Ergänzen Sie "relax" hinter dem betroffenen Wurzelzertifikat
+       in der trustlist.txt - siehe Schritt (2).
+
+--
+Diese Anleitung finden Sie zum späteren Nachlesen im Gpg4win-Startmenü unter
+"Dokumentation".
+
+Weiterführende Informationen finden Sie im Gpg4win-Kompendium, Kapitel 22:
+     http://gpg4win.de/doc/de/gpg4win-compendium_28.html
+
+[1] Hinweis zu Ansichtsoptionen:
+     Stellen Sie sicher, dass Sie im Windows Explorer die nachfolgende
+     Ordneransichts-Option "Alle Dateien und Ordner anzeigen" aktiviert haben.
+     Sie erreichen diese Option unter:
+      [Windows XP]: Extras > Ordneroptionen > Ansicht
+      [Windows Vista/7]: Organisieren > Ordner- und Suchoptionen > Ansicht
index 5a8e95b..96a1296 100644 (file)
-(To use S/MIME certificates for sign and encrypt, you have to define the trustability\r
-of X.509 root certificates.)\r
-\r
-A root certificate (root CA) is used to check the validity of all child certificates.\r
-If you trust the root certificate therby you trust also all underlying certificates.\r
-\r
-To avoid that each user must search and install the required root certificates, and\r
-also check and authenticate the trustworthiness of the same, it is useful to install\r
-a system-wide default of the most important root certificates:\r
-\r
-1.  Store the root certificates\r
-\r
-     Copy root certificate file to:\r
-     [Windows XP]:\r
-        C:\Documents and settings\All Users\Application data\GNU\etc\\r
-        dirmngr\trusted-certs\\r
-     [Windows Vista/7]:\r
-        C:\ProgramData\GNU\etc\dirmngr\trusted-certs\r
-\r
-     The corresponding root certificates must be available as files in DER\r
-     format in the above file folder, with the file extension .crt or .der. \r
-\r
-     You get the root certificates from the respective CA administrators.\r
-     CA operators often provide their root certificates also on websites\r
-     for download.\r
-\r
-     If the above folder is not visible? \r
-     Please read the reference note to the view options [1].\r
-\r
-2.  Set ultimate trusted\r
\r
-     a) Open the following file with a text editor:\r
-         [Windows XP]:\r
-           C:\Documents and settings\All Users\Application data\GNU\etc\\r
-           gnupg\trustlist.txt\r
-         [Windows Vista/7]:\r
-           C:\ProgramData\GNU\etc\gnupg\trustlist.txt\r
-\r
-     b) Create a new line per root certificate with the corresponding fingerprint,\r
-         such as:\r
-         <FINGERABDRUCK> S \r
-\r
-         You get the fingerprint from the CA operators (often available\r
-         from the website where you can download the root certificate). \r
-         Alternatively, you can get the fingerprint also via the command line tool\r
-         "openssl" (not included in Gpg4win) from the root certificate file:\r
-           openssl x509 -in <root-certificate> -noout -fingerprint -sha1\r
-      \r
-         A row that begins with # will be treated as a comment and ignored. \r
-         The end of the file must be followed by an empty row.\r
-\r
-         Example of two entries with comments:\r
-           # CN=Wurzel ZS 3,O=Intevation GmbH,C=DE\r
-           A6935DD34EF3087973C706FC311AA2CCF733765B S\r
-\r
-           # CN=PCA-1-Verwaltung-02/O=PKI-1-Verwaltung/C=DE\r
-           DC:BD:69:25:48:BD:BB:7E:31:6E:BB:80:D3:00:80:35:D4:F8:A6:CD S\r
-  \r
-         In some cases it is useful to reduce the criteria for checking the root \r
-         certificate. To do this, you can set an additional flag relax after the S: \r
-         <FINGERPRINT> S relax\r
-\r
-         Important: Using relax reduces the level of security, so it needs to be\r
-         decided on a case-by-case basis and should only be used in the case of\r
-         problems. \r
-\r
-3.  Complete Gpg4win installation and restart computer\r
-\r
-     a) Enable the option "Root certificate defined or skip configuration".\r
-\r
-     b) Complete the Gpg4win installation wizard regular.\r
-\r
-     c) Restart your computer! (Required because the DirMngr have to read your root \r
-         certificates from (1).)\r
-\r
-     Now, you have finished your S/MIME configuration successfully.\r
-\r
-4.  Review later in Kleopatra: Import and check certificate chains\r
-\r
-     Open Kleopatra and import your X.509 certificate chains. \r
-     The imported certificate chains should appear under the tab "Trusted\r
-     Certificates". Gpg4win recognizes your imported root certificates as\r
-     trusted.\r
-\r
-     Problems? Kleopatra doesn't shows your root certificate as trusted?\r
-     Solutions:\r
-     * Click on the "Redisplay" button in Kleopatra to update the certificate view.\r
-     * Add "relax" after the relevant root certificate in the trustlist.txt - see\r
-        step (2).\r
-\r
---\r
-You will find this S/MIME configuration instruction in the Gpg4win start menu\r
-"Documentation".\r
-\r
-For more information, see the Gpg4win Compendium, chapter 22:\r
-     http://gpg4win.org/doc/en/gpg4win-compendium_28.html\r
-\r
-[1] Note to view options in Windows Explorer:\r
-     Ensure that you have enabled the folder option "Show hidden files and folders"\r
-     You find this option under:\r
-      [Windows XP]: Tools > Folder Options > View\r
-      [Windows Vista/7]: Organize > Folder and Search Options > Ansicht\r
+;; HOWTO-SMIME.de.txt                               -*- coding: latin-1; -*-
+;; This is a HOWTO installed with Gpg4win. Lines with a ; in the first
+;; column are considered a comment and not included in the actually
+;; installed version.  Certain keywords are replaced by the Makefile;
+;; those words are enclosed by exclamation marks.
+
+(To use S/MIME certificates for sign and encrypt, you have to define
+the trustability of X.509 root certificates.)
+
+A root certificate (root CA) is used to check the validity of all
+child certificates.  If you trust the root certificate therby you
+trust also all underlying certificates.
+
+To avoid that each user must search and install the required root
+certificates, and also check and authenticate the trustworthiness of
+the same, it is useful to install a system-wide default of the most
+important root certificates:
+
+1.  Store the root certificates
+
+     Copy root certificate file to:
+
+     [Windows XP]:
+        C:\Documents and settings\All Users\Application data\GNU\etc\
+        dirmngr\trusted-certs\
+     [Windows Vista/7]:
+        C:\ProgramData\GNU\etc\dirmngr\trusted-certs
+
+     The corresponding root certificates must be available as files in DER
+     format in the above file folder, with the file extension .crt or .der.
+
+     You get the root certificates from the respective CA administrators.
+     CA operators often provide their root certificates also on websites
+     for download.
+
+     If the above folder is not visible?
+     Please read the reference note to the view options [1].
+
+2.  Set ultimate trusted
+
+     a) Open the following file with a text editor:
+
+         [Windows XP]:
+           C:\Documents and settings\All Users\Application data\GNU\etc\
+           gnupg\trustlist.txt
+         [Windows Vista/7]:
+           C:\ProgramData\GNU\etc\gnupg\trustlist.txt
+
+     b) Create a new line per root certificate with the corresponding
+        fingerprint, such as:
+
+         <FINGERPRINT> S
+
+         You get the fingerprint from the CA operators (often
+         available from the website where you can download the root
+         certificate).  Alternatively, you can get the fingerprint
+         also via the command line tool "sha1sum" from the binary root
+         certificate file (those files usually have a suffix of
+         ".crt:, ".bin", ".cert" or ".cer"):
+
+           sha1sum < <ROOT-CERTIFICATE-FILE>
+
+         A row that begins with # will be treated as a comment and ignored.
+         The end of the file must be followed by an empty row.
+
+         Example of two entries with comments:
+           # CN=Wurzel ZS 3,O=Intevation GmbH,C=DE
+           A6935DD34EF3087973C706FC311AA2CCF733765B S
+
+           # CN=PCA-1-Verwaltung-02/O=PKI-1-Verwaltung/C=DE
+           DC:BD:69:25:48:BD:BB:7E:31:6E:BB:80:D3:00:80:35:D4:F8:A6:CD S
+
+         In some cases it is useful to reduce the criteria for
+         checking the root certificate.  To do this, you can set an
+         additional flag relax after the S:
+
+         <FINGERPRINT> S relax
+
+
+3.  Complete Gpg4win installation and restart computer
+
+     a) Enable the option "Root certificate defined or skip configuration".
+
+     b) Complete the Gpg4win installation wizard regular.
+
+     c) Restart your computer! (Required because the DirMngr have to
+        read your root certificates from step (1).)
+
+     Now, you have finished your S/MIME configuration successfully.
+
+4.  Review later in Kleopatra: Import and check certificate chains
+
+     Open Kleopatra and import your X.509 certificate chains.  The
+     imported certificate chains should appear under the tab "Trusted
+     Certificates". Gpg4win recognizes your imported root certificates
+     as trusted.
+
+     Problems? Kleopatra doesn't shows your root certificate as
+     trusted?  Solutions:
+
+     * Click on the "Redisplay" button in Kleopatra to update the
+       certificate view.
+
+     * Add "relax" after the relevant root certificate in the
+       trustlist.txt - see step (2).
+
+--
+You will find this S/MIME configuration instruction in the Gpg4win
+start menu "Documentation".
+
+For more information, see the Gpg4win Compendium, chapter 22:
+     http://gpg4win.org/doc/en/gpg4win-compendium_28.html
+
+[1] Note to view options in Windows Explorer:
+
+    Ensure that you have enabled the folder option "Show hidden files
+    and folders".  You find this option under:
+
+      [Windows XP]: Tools > Folder Options > View
+      [Windows Vista/7]: Organize > Folder and Search Options > Ansicht
index d6ae481..3b10ba7 100644 (file)
@@ -19,7 +19,8 @@
 
 EXTRA_DIST = nsi-mode.el pkg-copyright.txt beta-warning.txt HACKING\
             README.ar.txt README.de.txt README.en.txt README.es.txt \
-            README.fr.txt README.ru.txt README.pt.txt
+            README.fr.txt README.ru.txt README.pt.txt \
+            HOWTO-SMIME.en.txt HOWTO-SMIME.de.txt
 
 if BUILD_MANUALS
 manual = manual
index 2e08c8b..25fa538 100644 (file)
@@ -90,10 +90,15 @@ gpg4win_readme_ll = en de ar es fr ru pt
 
 README_files = $(addsuffix .txt,$(addprefix README.,$(gpg4win_readme_ll)))
 
+gpg4win_howto_smime_ll = en de
+
+HOWTO_files = $(addsuffix .txt, \
+                $(addprefix HOWTO-SMIME.,$(gpg4win_howto_smime_ll)))
+
 foosum_exe = sha1sum.exe md5sum.exe sha256sum.exe
 
 # Need to clean the dll because we bypassed automake.
-CLEANFILES = g4wihelp.dll versioninfo.txt $(README_files) \
+CLEANFILES = g4wihelp.dll versioninfo.txt $(README_files) $(HOWTO_files) \
              installer-options.ini NEWS.tmp versioninfo.tmp \
             gpgwrap.exe gpgwrap-2.exe kleowrap.exe $(foosum_exe)
 
@@ -503,14 +508,16 @@ installer-options.ini : $(top_srcdir)/src/installer-options.ini.in
 gpg4win-$(VERSION).exe: gpg4win.nsi $(common_nsi) stamps/stamp-final \
                         g4wihelp.dll gpgwrap.exe gpgwrap-2.exe kleowrap.exe \
                        $(foosum_exe) \
-                       $(README_files) installer-options.ini versioninfo.txt
+                       $(README_files) $(HOWTO_files) \
+                        installer-options.ini versioninfo.txt
        $(MAKENSIS) -V3 -DBUILD_DIR=`pwd` -DTOP_SRCDIR=$(top_srcdir) \
            -DSRCDIR=$(srcdir) $(EXTRA_MAKENSIS_FLAGS) $(srcdir)/gpg4win.nsi
 
 gpg4win-light-$(VERSION).exe: gpg4win.nsi $(common_nsi) stamps/stamp-final \
                         g4wihelp.dll gpgwrap.exe gpgwrap-2.exe kleowrap.exe \
                        $(foosum_exe) \
-                       $(README_files) installer-options.ini versioninfo.txt
+                       $(README_files) $(HOWTO_files) \
+                       installer-options.ini versioninfo.txt
        $(MAKENSIS) -V3 -DBUILD_DIR=`pwd` -DTOP_SRCDIR=$(top_srcdir) \
            -DSRCDIR=$(srcdir) $(EXTRA_MAKENSIS_FLAGS) \
            -DGPG4WIN_LIGHT=1 $(srcdir)/gpg4win.nsi
@@ -518,7 +525,8 @@ gpg4win-light-$(VERSION).exe: gpg4win.nsi $(common_nsi) stamps/stamp-final \
 gpg4win-vanilla-$(VERSION).exe: gpg4win.nsi $(common_nsi) stamps/stamp-final \
                         g4wihelp.dll gpgwrap.exe gpgwrap-2.exe \
                        $(foosum_exe) \
-                       $(README_files) installer-options.ini versioninfo.txt
+                       $(README_files) $(HOWTO_files) \
+                       installer-options.ini versioninfo.txt
        $(MAKENSIS) -V3 -DBUILD_DIR=`pwd` -DTOP_SRCDIR=$(top_srcdir) \
            -DSRCDIR=$(srcdir) $(EXTRA_MAKENSIS_FLAGS) \
            -DGPG4WIN_VANILLA=1 $(srcdir)/gpg4win.nsi
@@ -526,7 +534,8 @@ gpg4win-vanilla-$(VERSION).exe: gpg4win.nsi $(common_nsi) stamps/stamp-final \
 gpg4win-$(VERSION).wix: gpg4win.nsi $(common_nsi) stamps/stamp-final \
                        gpgwrap.exe gpgwrap-2.exe kleowrap.exe \
                        $(foosum_exe) \
-                       $(README_files) versioninfo.txt
+                       $(README_files) $(HOWTO_files) \
+                       versioninfo.txt
        perl make-msi.pl --guids $(srcdir)/make-msi.guids \
                --manifest gpg4win-$(VERSION).files \
                -DBUILD_DIR=. -DTOP_SRCDIR=$(top_srcdir) \
@@ -535,7 +544,8 @@ gpg4win-$(VERSION).wix: gpg4win.nsi $(common_nsi) stamps/stamp-final \
 gpg4win-light-$(VERSION).wix: gpg4win.nsi $(common_nsi) stamps/stamp-final \
                        gpgwrap.exe gpgwrap-2.exe kleowrap.exe \
                        $(foosum_exe) \
-                       $(README_files) versioninfo.txt
+                       $(README_files) $(HOWTO_files) \
+                       versioninfo.txt
        perl make-msi.pl --guids $(srcdir)/make-msi.guids \
                --manifest gpg4win-light-$(VERSION).files \
                -DBUILD_DIR=. -DTOP_SRCDIR=$(top_srcdir) \
@@ -544,7 +554,8 @@ gpg4win-light-$(VERSION).wix: gpg4win.nsi $(common_nsi) stamps/stamp-final \
 gpg4win-vanilla-$(VERSION).wix: gpg4win.nsi $(common_nsi) stamps/stamp-final \
                        gpgwrap.exe gpgwrap-2.exe kleowrap.exe \
                        $(foosum_exe) \
-                       $(README_files) versioninfo.txt
+                       $(README_files) $(HOWTO_files) \
+                        versioninfo.txt
        perl make-msi.pl --guids $(srcdir)/make-msi.guids \
                --manifest gpg4win-vanilla-$(VERSION).files \
                -DBUILD_DIR=. -DTOP_SRCDIR=$(top_srcdir) \
index dbfcebf..735d8ed 100644 (file)
@@ -309,6 +309,7 @@ stamps/stamp-final-$(1): stamps/stamp-directories $(call GETDEPS,$(1))
 endef
 
 # Template for README files
+# (The final awk command converts the file endings).
 
 define README_template
 README.$(1).txt : versioninfo.txt NEWS.tmp $(top_srcdir)/doc/README.$(1).txt \
@@ -326,6 +327,15 @@ README.$(1).txt : versioninfo.txt NEWS.tmp $(top_srcdir)/doc/README.$(1).txt \
            | awk '{printf "%s\r\n", $$$$0}' >README.$(1).txt
 endef
 
+define HOWTO_template
+HOWTO-$(1).$(2).txt : $(top_srcdir)/doc/HOWTO-$(1).$(2).txt
+       sed -e '/^;.*/d' \
+        -e 's,!VERSION!,$(VERSION),g' \
+       -e 's,!BUILD_ISODATE!,$(BUILD_ISODATE),g' \
+          < $(top_srcdir)/doc/HOWTO-$(1).$(2).txt \
+        | awk '{printf "%s\r\n", $$$$0}' > HOWTO-$(1).$(2).txt
+endef
+
 # Insert the template for each source package.
 $(foreach spkg, $(gpg4win_spkgs), $(eval $(call SPKG_template,$(spkg))))
 
@@ -338,9 +348,12 @@ $(foreach bpkg, $(gpg4win_bpkgs), $(eval $(call BPKG_template,$(bpkg))))
 # Insert the template for each internal package.
 $(foreach ipkg, $(gpg4win_ipkgs), $(eval $(call IPKG_template,$(ipkg))))
 
-# Insert the template for each README file.
+# Insert the template for the README and HOWTO files.
 $(foreach rll, $(gpg4win_readme_ll), $(eval $(call README_template,$(rll))))
 
+$(foreach rll, $(gpg4win_howto_smime_ll), \
+               $(eval $(call HOWTO_template,SMIME,$(rll))))
+
 stamps/stamp-final: stamps/stamp-directories
 stamps/stamp-final: $(addprefix stamps/stamp-final-,$(gpg4win_build_list))
        touch stamps/stamp-final
index 2b98144..cf92f6a 100644 (file)
@@ -1,18 +1,18 @@
 # inst-gpg4win.nsi - Hidden section for common files. -*- coding: latin-1; -*-
 # Copyright (C) 2006 g10 Code GmbH
-# 
+#
 # This file is part of GPG4Win.
-# 
+#
 # GPG4Win is free software; you can redistribute it and/or modify
 # it under the terms of the GNU General Public License as published by
 # the Free Software Foundation; either version 2 of the License, or
 # (at your option) any later version.
-# 
+#
 # GPG4Win is distributed in the hope that it will be useful,
 # but WITHOUT ANY WARRANTY; without even the implied warranty of
 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 # GNU General Public License for more details.
-# 
+#
 # You should have received a copy of the GNU General Public License
 # along with this program; if not, write to the Free Software
 # Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
@@ -23,7 +23,7 @@ Section "-gpg4win" SEC_gpg4win
 !ifdef SOURCES
   SetOutPath "$INSTDIR"
   File "${BUILD_DIR}/../gpg4win-${VERSION}.tar.bz2"
-!else 
+!else
   SetOutPath "$INSTDIR\share\gpg4win"
 
   File "${BUILD_DIR}/README.en.txt"
@@ -35,8 +35,8 @@ Section "-gpg4win" SEC_gpg4win
   File /oname=README.it.txt "${BUILD_DIR}/README.en.txt"
   File /oname=README.pt.txt "${BUILD_DIR}/README.en.txt"
   File /oname=README.ru.txt "${BUILD_DIR}/README.en.txt"
-  File "${BUILD_DIR}/../doc/HOWTO-SMIME.en.txt"
-  File "${BUILD_DIR}/../doc/HOWTO-SMIME.de.txt"
+  File "${BUILD_DIR}/HOWTO-SMIME.en.txt"
+  File "${BUILD_DIR}/HOWTO-SMIME.de.txt"
 
   File "${BUILD_DIR}/versioninfo.txt"
 
@@ -57,7 +57,7 @@ Section "-gpg4win" SEC_gpg4win
   # Although we don't want to delete the user's Lang Registry Setting
   # because he might have have selected a different language than his
   # default.  We delete the global Lang of the installation.
-  DeleteRegValue HKLM "Software\GNU\GnuPG" "Lang" 
+  DeleteRegValue HKLM "Software\GNU\GnuPG" "Lang"
 
   # This old key is required for GPGee.  Please do not use in new
   # applications.