[Gpg4win-commits] r390 - in trunk/doc: . manual
scm-commit@wald.intevation.org
scm-commit at wald.intevation.org
Fri Apr 6 00:58:11 CEST 2007
Author: bernhard
Date: 2007-04-06 00:58:10 +0200 (Fri, 06 Apr 2007)
New Revision: 390
Modified:
trunk/doc/ChangeLog
trunk/doc/manual/novices.tex
Log:
* manual/novices.tex: A number of corrections by Brigitte Hamilton.
Also replaced "` and "' with English style ".
Modified: trunk/doc/ChangeLog
===================================================================
--- trunk/doc/ChangeLog 2007-04-02 18:43:18 UTC (rev 389)
+++ trunk/doc/ChangeLog 2007-04-05 22:58:10 UTC (rev 390)
@@ -1,3 +1,8 @@
+2007-04-06 Bernhard Reiter <bernhard.reiter at intevation.de>
+
+ * manual/novices.tex: A number of corrections by Brigitte Hamilton.
+ Also replaced "` and "' with English style ".
+
2007-04-02 Jan-Oliver Wagner <jan-oliver.wagner at intevation.de>
* website/candidates.htm4: Fixed wrong link and improved
@@ -3,4 +8,30 @@
Text (found and suggested by Florian Samson).
+2007-03-31 Bernhard Reiter <bernhard.reiter at intevation.de>
+
+ * manual/advanced.tex, manual/Makefile.am: Transfered
+ original page 47 and replaced the German screenshots
+ with new ones in English.
+ Added file: sc-en-gpa-gen-backup-warn.png
+
+ * manual/novices.tex, manual/Makefile.am:
+ Added new png files for screenshots in EN:
+ sc-en-gpa-gen-backup.png
+ sc-en-gpa-first-key.png
+ sc-en-gpa-gen-email.png
+ sc-en-gpa-gen-name.png
+ sc-en-gpa-gen-passwd.png
+ sc-en-gpa-ks-export-p.png
+ sc-en-gpa-nokey.png
+ sc-en-gpa-rungpa.png
+ sc-en-gpa-two-keys.png
+
+ * manual/Makefile.am: Added eps_files_png as prerequisites to
+ all html targets as the png files are actually needed for them.
+ Added eps_files_png to novices.dvi, because the eps files bbs
+ are not included in eps_files_bb and latex needs them.
+ Changed the dependency of novices and advanced to macros-en
+ instead of just "macros".
+
2007-03-27 Bernhard Reiter <bernhard.reiter at intevation.de>
Modified: trunk/doc/manual/novices.tex
===================================================================
--- trunk/doc/manual/novices.tex 2007-04-02 18:43:18 UTC (rev 389)
+++ trunk/doc/manual/novices.tex 2007-04-05 22:58:10 UTC (rev 390)
@@ -82,9 +82,9 @@
Permission is hereby granted to copy, distribute and/or modify this
document under the terms of the GNU Free Documentation License,
Version 1.2 (or newer) published by the Free Software Foundation;
-with the Invariant Sections being "`Impressum"', no Front-Cover Texts, and
+with the Invariant Sections being "Impressum", no Front-Cover Texts, and
no Back-Cover Texts. A copy of the license is included in the section
-entitled "`GNU Free Documentation License"'.
+entitled "GNU Free Documentation License".
%%\htmlonly{Die aktuelle PDF Version dieses Dokuments finden sie unter
%%\xlink{\EinsteigerPDFURL}{\EinsteigerPDFURL}.}
@@ -159,10 +159,10 @@
\begin{itemize}
-\item \textbf{an introductory guide called "`Gpg4win for Novices"',}
+\item \textbf{an introductory guide called "Gpg4win for Novices",}
which you are reading right now,
-\item \textbf{the manual "`Gpg4win for Advanced Users"'} in PDF-Format,
+\item \textbf{the manual "Gpg4win for Advanced Users"} in PDF-Format,
which can be found on your hard drive after you have installed Gpg4win,
\item \textbf{the exercise robot Adele,} which allows you to practice
@@ -171,11 +171,11 @@
\end{itemize}
-\textbf{"`Gpg4win for Novices"'} is a quick guide to installing and
-everyday use of the Gpg4win software. You will need about half and hour to work
+\textbf{"Gpg4win for Novices"} is a quick guide to the installation and
+everyday use of the Gpg4win software. You will need about half an hour to work
through this manual, depending on your knowledge of computers and Windows.
-\textbf{"`Gpg4win for Advanced Users"'} provides in-depth information
+\textbf{"Gpg4win for Advanced Users"} provides in-depth information
about the basic principles and mechanisms usbed by Gpg4win,
as well as its less commonly used capabilities.
@@ -194,7 +194,7 @@
to be fully familiar with the software.
Adele was developed as part of the older GnuPP project, where it is
-still used. "`Gpg4win for Novices"' also uses this very reliable
+still used. "Gpg4win for Novices" also uses this very reliable
practice robot and hereby wishes to express its gratitude to the owners
of gnupp.de for operating Adele.
@@ -272,7 +272,7 @@
Windows you want to install.
To assist you with your selection, a short description window appears
-when you hover the mouse over a selected item. At this point, you may
+when you move the mouse over a selected item. At this point, you may
want to check the available free space on your hard drive as well.
% sreenshot Auswahl zu installierender Komponenten
@@ -332,11 +332,10 @@
\clearpage
-During the installation, a progress bar will be displayed, as well as
-showing the file currently being installed. You can click on
-\Button{Show details} to get more information on the installation steps
-in progress.
+During the installation a progress bar displays the file being installed.
+You can click on \Button{Show details} to see a log of the installation.
+
% Screenshot: Ready page Installer
\begin{center}
\IncludeImage{sc-en-inst-ready}
@@ -382,17 +381,17 @@
\textbf{And that's it!}
-You have now installed Gpg4win and can use the program.
+You have now installed Gpg4win and are ready to use the program.
Prior to starting Gpg4win, we recommend reading Chapter 3 and 4 of the
-manual "`Gpg4win for Advanced Users"'
+manual "Gpg4win for Advanced Users"
(PDF-File). These chapters highlight the ingenious theory behind
Gpg4win's ability to encrypt \Email{}s in a safe and user-friendly
manner.
-Of course you do not need to know the insides of Gpg4win to be
-able to use it. However, you will use Gpg4win to handle your
-most sensitive correspondence and it seems a good idea to understand
+Of course you do not need to know all the technical details of Gpg4win to be
+able to use it. However, since you will use Gpg4win to handle your
+most sensitive correspondence and it probably iis a good idea to understand
the theory behind it.
$\ldots$
@@ -402,24 +401,25 @@
\textbf{
\OtherBook{} At this point, please read Chapter 3 and 4 in the manual
-"`\xlink{Gpg4win for Advanced Users}{durchblicker.html}"' before reading
+"\xlink{Gpg4win for Advanced Users}{durchblicker.html}" before reading
on.}
\clearpage
%% Original page 15
\section{Creating a key pair}
-After reading the information explaining the security features of
-Gpg4win, as well as creating good passphrase to protect your
+After reading the information explaining Gpg4win's security features
+and the creating of a good passphrase to protect your
private key, this section shows you how to create a key pair.
\textbf{
The processes of creating a key, encryption and decryption are very
-important; it is a good idea to practice these steps until you
-are very comfortable with the procedures. $\ldots$
+important - so important that it should be possible to practice $\ldots$
}
-Doing a "`dry-run"' helps you gain confidence in
+\textbf{And this is what you actually can do:}
+Run through the whole processes as often as you want.
+Those "dry-runs" help you gain confidence in
using the program, so that some of the more intricate steps in creating
keys will not pose any problems later on. You can use Adele to do this.
It is a test server which was developed as part of the GnuPP project.
@@ -451,7 +451,7 @@
%% Original page 17
\textbf{For practice purposes} you can enter any name in the window for
-now, e.g. "`Larry Smith"'.
+now, e.g. "Larry Smith".
% screenshot: Key generation wizard first page
\begin{center}
@@ -467,16 +467,16 @@
%% Original page 18
Now enter your \Email{} address.
-Again, if this is a test run, you can use an imaginary \Email{}address
+Again, if this is a test run, you can use an imaginary \Email{} address
such as
-"`\verb-larrys at gpg4win.de-"'
+"\verb-larrys at gpg4win.de-"
% screenshot: Wizard email address
\begin{center}
\IncludeImage[width=0.6\textwidth]{sc-en-gpa-gen-email}
\end{center}
-Or you can enter your real \Email{}address, and click on
+Or you can enter your real \Email{} address, and click on
\Button{Forward}.
%note by translator Brigitte: when I ran Gpg4win, the option outlined in
@@ -484,7 +484,7 @@
This option allows you to enter notes regarding your key. Usually this
field is empty; however, if you are creating a test key, you should make
-a note, such as "`test"'. The notes are a part of your User-ID and will
+a note, such as "test". The notes are a part of your User-ID and will
be made public along with your name and \Email{} address. Now click on
\Button{Forward}.
@@ -495,9 +495,9 @@
Entering a passphrase is one of the most important steps in the program,
as the program is only as good (and as secure) as your passphrase!
-Chapter 4 ("`The Passphrase"') from the manual "`Gpg4win for Advanced
-Users"' already provided you with suggestions on creating a secure
-passphrase. So, at this point you should have thought your own
+Chapter 4 ("The Passphrase") from the manual "Gpg4win for Advanced
+Users" already provided you with suggestions on creating a secure
+passphrase. So, at this point you should have come up with your own
passphrase - one that is private, easy to remember, and difficult to
crack.
@@ -508,8 +508,9 @@
\IncludeImage[width=0.6\textwidth]{sc-en-gpa-gen-passwd}
\end{center}
-If the passphrase you entered is not very secure, the program will warn
-you about it, allowing you to enter a more secure passphrase.
+If the passphrase you entered is not very secure,
+a warning will be displayed,
+allowing you to enter a more secure passphrase.
\textbf Again, you can enter a test passphrase for practice purposes, or
your real passphrase.
@@ -578,8 +579,8 @@
\textbf{ \OtherBook{} More information on this topic can be found in
-Chapter 5 "`More about keys"' in the manual "`\xlink{Gpg4win for
-Advanced Users}{durchblicker.html}"'.}
+Chapter 5 "More about keys" in the manual "\xlink{Gpg4win for
+Advanced Users}{durchblicker.html}".}
\clearpage
%% Original page 24
@@ -587,7 +588,7 @@
\section{Publishing your key per \Email{}}
One of the more practical aspects of Gpg4win is its ability to use a
-"`non-secret"' public key for the en- and decryption of data. As long
+"non-secret" public key for the en- and decryption of data. As long
as your key and its corresponding passphrase are secure, you have gone a
long way towards keeping your information confidential.
@@ -608,7 +609,7 @@
have your public key in order to encrypt the email being sent to you.
This is the reason that your public key should be made widely
-available. Depending on the number of communication partners,
+available. Depending on the number of correspondence partners,
can do this in two ways:
\begin{itemize}
@@ -619,7 +620,7 @@
The first way to distribute your public key is to send it by
\Email{} to one or more selected recipients.
-Alternatively you can make your \Email{}address available to anyone
+Alternatively you can make your \Email{} address available to anyone
in the Internet. The second option is somewhat risky, as it can
result in considerable SPAM activity on your email account. Therefore it
is a good idea to only use an address with a good SPAM filter.
@@ -629,7 +630,7 @@
%% Original page 25
You can use Adele to practice the following steps:
-Adele is a very good \Email{}robot for practicing secure correspondence.
+Adele is a very good \Email{} robot for practicing secure correspondence.
Because most people prefer to correspond with a real person rather
than with a piece of software (which is what Adele is, after all), we
developed the following scenario:
@@ -698,7 +699,7 @@
Start your email program. Open a new \Email{} message and paste
your public key (Windows users may use a shortcut key such as Ctrl-V).
-Before doing this, your should configure your email program to
+Before doing this, you should configure your email program to
send messages in text-only format rather than HTML.
Put \verb-adele at gnupp.de- into the address line of the \Email{}, and
@@ -727,10 +728,10 @@
\textbf{Summary:} You have now sent your public key by \Email{} to
someone else (e.g. Adele).
-\textbf{ \OtherBook{} The "`Copy \& Paste"'-method shown in this
+\textbf{ \OtherBook{} The "Copy \& Paste" method shown in this
example is easily understood by beginners.
-Chapter 7 of the manual "`\xlink{Gpg4win for Advanced
-Users}{durchblicker.html}"' describes how to send your key as a
+Chapter 7 of the manual "\xlink{Gpg4win for Advanced
+Users}{durchblicker.html}" describes how to send your key as a
file attachment, which is a more commonly used method.}
\clearpage
@@ -759,16 +760,16 @@
This window also displays a default key server. If you click on
\Button{Yes}, your key will be automatically sent to the server, from
where it is sent to a network of worldwide key servers. Now anyone can
-download your key, and use it to send you secure \Email{}.
+download your key, and use it to send you a secure \Email{}.
If this is a practice run, do NOT send your practice key to the key
-server because, once send, it cannot be removed.
+server because once sent, it cannot be removed.
\textbf{Summary:} You now know how to distribute your key via a key
server on the Internet.
-\textbf{ \OtherBook{} Chapter 6 of the manual"`\xlink{Gpg4win for
-Advanced Users}{durchblicker.html}"' explains how to find someone else's
+\textbf{ \OtherBook{} Chapter 6 of the manual"\xlink{Gpg4win for
+Advanced Users}{durchblicker.html}" explains how to find someone else's
key on a keyserver.}
\clearpage
@@ -816,7 +817,7 @@
\textbf{Using WinPT to decrypt this \Email{}.}
WinPT (Windows Privacy Tray key management tool) serves as PnuPG's
-"`front end"'. This program is used to encrypt and decrypt \Email{}s; it
+"front end". This program is used to encrypt and decrypt \Email{}s; it
also creates and verifies digital signatures. One of WinPT's advantages
is that it works with all email programs.
@@ -824,8 +825,8 @@
plug-ins which can encrypt and decrypt \Email{} directly within the program.
-\textbf{ \OtherBook{} Chapter 8 of the manual "`\xlink{Gpg4win for
-Advanced Users}{durchblicker.html}"' provides more information on this
+\textbf{ \OtherBook{} Chapter 8 of the manual "\xlink{Gpg4win for
+Advanced Users}{durchblicker.html}" provides more information on this
particular funtion.}
WinPT performs the en/decryption function using your computer's memory.
@@ -923,7 +924,7 @@
%% Original page 37
\section{Attaching a key to your key ring}
-You can store your friends' public keys on your "`key ring"' so they do
+You can store your friends' public keys on your "key ring" so they do
not have to send you their public key every time they write to you.
\textbf{First Option:}
@@ -961,8 +962,8 @@
and find later on, e.g. \Filename{My Documents}).
It does not matter whether you save the key as text or directly as an
-\Email{}attachment, as both methods import the key into your GnuPG-"`Key
-Ring"'.
+\Email{}attachment, as both methods import the key into your GnuPG-"Key
+Ring".
% screenshot: Startmenu, Auswahl GPA
@@ -993,14 +994,14 @@
name, therefore how do you know that the public key sent to you is
really Adele's key?
-\textbf{ \OtherBook{} Chapter 9 ("`Key Verification"') in the
-"`\xlink{Gpg4win for Advanced Users}{durchblicker.html}"' manual deals
+\textbf{ \OtherBook{} Chapter 9 ("Key Verification") in the
+"\xlink{Gpg4win for Advanced Users}{durchblicker.html}" manual deals
with this important question. You may want to read that section now
before continuing with this manual. }
\clearpage
%% Original page 40
-Chapter 9 of the manual "`Gpg4win for Advanced Users"' shows you how to
+Chapter 9 of the manual "Gpg4win for Advanced Users" shows you how to
validate a key as well as how to sign a message (i.e. attach a signature)
using your private key.
@@ -1010,9 +1011,9 @@
whether the \Email{} has been altered during transmission (and that it
came from you).
-The signature verification process is fairly simple. To do it, you
-need the sender's public key on your Gpg4win-"`key ring"' (see
-Chapter 8 of "`Gpg4win for Advanced Users"' for more information).
+The signature verification process is simple. For this, you
+need the sender's public key on your Gpg4win-"key ring" (see
+Chapter 8 of "Gpg4win for Advanced Users" for more information).
% cartoon: Müller mit Schlüssel
\begin{center}
@@ -1072,7 +1073,7 @@
through the Internet.
\textbf{ \OtherBook{} Before continuing, you may want to read Chapter 10
-of the manual "`\xlink{Gpg4win for Advanced Users}{durchblicker.html}"'
+of the manual "\xlink{Gpg4win for Advanced Users}{durchblicker.html}"
which contains additional information on how to deal with
invalid signatures.}
@@ -1082,8 +1083,8 @@
Encrypt an \Email{} and send it to Adele (or another person).
-Open your \Email{}program and write a message (if you are sending the
-message to Adele, any text will do)$\ldots$
+Open your \Email{} program and write a message (if you are sending the
+message to Adele, any text will do as Adele can not actually read $\ldots$)
Highlight the text and copy it onto your Clipboard (Windows) using the
copy function or the Ctrl-C shortcut.
@@ -1102,7 +1103,7 @@
You should now see a window containing the keys on your key ring. Using
the examples featured in this guide, you would see Adele's key (the one
she sent to you), as well as your own key, which you created in Chapter
-2.
+2 (FIXME: Use dynamic reference).
% screenshot: Winpt encryption key selection
\begin{center}
@@ -1194,15 +1195,15 @@
encryption!}
\textbf{
-\OtherBook{} We recommend you read Chapter 10 to 12 of the manual "`
-\xlink{Gpg4win for Advanced Users}{durchblicker.html}"'
+\OtherBook{} We recommend you read Chapter 10 to 12 of the manual "
+\xlink{Gpg4win for Advanced Users}{durchblicker.html}"
for additional information on adding signatures to \Email{}s, as well
as importing and using an existing private key in GnuPG.
}
\textbf{
\OtherBook{} Furthermore, Chapters 13 and 14 of the manual
-"`\xlink{Gpg4win for Advanced Users}{durchblicker.html}"' give you
+"\xlink{Gpg4win for Advanced Users}{durchblicker.html}" give you
additional information about the ideas behind GnuPG's security
features, as well as detailed insights into the mathematical
concepts used. These chapters are easy to read, they were
@@ -1265,11 +1266,11 @@
(and additionally) encrypted using your own key. This allows you to
later retrieve, decrypt and read messages in the Sent folder.
-The option "`Also decrypt in preview window"' is only feasible with very
+The option "Also decrypt in preview window" is only feasible with very
fast computers; at the present time it has only limited operational
capacity.
-The option "`Show HTML view if possible"' enables you to view a message
+The option "Show HTML view if possible" enables you to view a message
in HTML format. In most cases, or when an HTML format is not available,
it will be shown in text format.
@@ -1308,8 +1309,8 @@
GPGol lists the components and their associated file names as part of
the decryption or message signature verification. File names
-containing encrypted attachments are prefaced with "`E"', and signed
-attachments are marked with an "`S"'.
+containing encrypted attachments are prefaced with "E", and signed
+attachments are marked with an "S".
\item[Where can I locate information regarding the latest version
GPGol?]
@@ -1335,7 +1336,7 @@
sometimes it is necessary in order to properly display encrypted or
signed \Email{}s.
-GPGol is still "`in development"'. One outstanding issue is its
+GPGol is still "in development". One outstanding issue is its
registration as a trusted plugin. Future versions of GPGol should be able
to solve the issue of needing to confirm some or all \Email{}s.
@@ -1343,7 +1344,7 @@
At the present, there is no way of telling Outlook that a PGP/MIME
message is to be created. Outlook decides on its own which
-"`Content-Type"' is to be used, as the plugin is not able to preset a
+"Content-Type" is to be used, as the plugin is not able to preset a
certain type. You may want to contact Microsoft directly to talk about
this setting and/or missing documentation regarding this setup.
@@ -1380,8 +1381,8 @@
If the program does not list the existing keys, you must import them from
your backup file(s). For more information on this topic, refer to Chapter
-12 in the manual "`\xlink{Gpg4win for Avanced
-Users}{durchblicker.html}"'.
+12 in the manual "\xlink{Gpg4win for Avanced
+Users}{durchblicker.html}".
If your older system also includes GPA, you can use its back-up option,
which should be very similar to the operation of GPA in Gpg4win.
@@ -1398,7 +1399,7 @@
\section{History}
\begin{itemize}
-\item "`GnuPP for Beginners"', First Edition March 2002,\\
+\item "GnuPP for Beginners", First Edition March 2002,\\
Authors: Manfred J. Heinze, TextLab text+media\\
Consulting: Lutz Zolondz, G-N-U GmbH\\
Illustrations: Karl Bihlmeier, Bihlmeier \& Kramer GbR\\
@@ -1408,13 +1409,13 @@
Published by the German Federal Ministry for Industry \& Technology.\\
Available at
\verb-http://www.gnupp.de/pdf/einsteiger.pdf-.
-% Der Abschnitt "`History"' ist im Originaldokument nicht vorhanden
+% Der Abschnitt "History" ist im Originaldokument nicht vorhanden
% und wurde von Werner Koch beigefügt.
\item Revised unpublished version by TextLab text+media.
-\item "`Gpg4win for Beginners"', December 2005\\
+\item "Gpg4win for Beginners", December 2005\\
Authors: Werner Koch, g10 Code GmbH\\
Published as part of the Gpg4win project.
-\item "`Gpg4win for Novices"', November 2006\\
+\item "Gpg4win for Novices", November 2006\\
Translated by: Brigitte Hamilton\\
Published as part of the Gpg4win project.
More information about the Gpg4win-commits
mailing list