Bug#445328: gnupg: man page formatting and other typos

2007-12-12 Thread Christer Andersson
Tags: patch

Please find enclosed a patch that fixes the problem reported (and solved) by
Kevin Ryde. The patch should be applied to the uncompressed man page (from its
directory), i.e.
 gunzip gpg.1.gz
 patch gpg.1  gpg.1.patch

I also took the liberty of fixing a few obvious typos by running aspell on the
man page, e.g. RETURN VAUE should be RETURN VALUE. See the patch for 
details.

Finally, I observed that a mixture of British and American spelling is used. In
particular, behaviour is used six times and behavior is used eight times. As
English is not my first language I chose not to do anything about it. The man
page has also undergone some changes for version 1.4.7 (see bug #452118) so
there seems to be little point in working too much on the current one.

/Christer
--- gpg.1	2007-03-07 22:16:09.0 +
+++ new.gpg.1	2007-12-12 12:07:04.0 +
@@ -31,7 +31,7 @@
 
 .SH COMMANDS
 
-Commands are not distinguished from options execpt for the fact that
+Commands are not distinguished from options except for the fact that
 only one command is allowed.
 
 \fBgpg\fR may be run with no commands, in which case it will
@@ -149,9 +149,7 @@
 signed stuff is expected in a file without the .sig or .asc
 extension.  With more than 1 argument, the first should be a detached
 signature and the remaining files are the signed stuff. To read the
-signed stuff from stdin, use 
-'-'
- as the second filename.  For
+signed stuff from stdin, use '-' as the second filename.  For
 security reasons a detached signature cannot read the signed material
 from stdin without denoting it in the above way.
 
@@ -770,7 +768,7 @@
 .SS  How to change the configuration
 \ 
 
-These options are used to change the configuraton and are usually found
+These options are used to change the configuration and are usually found
 in the option file.
 
 
@@ -2488,13 +2486,13 @@
 
 .TP
 .B  --gpgconf-list
-This command is simliar to \fB--list-config\fR but in general only
+This command is similar to \fB--list-config\fR but in general only
 internally used by the \fBgpgconf\fR tool.
 
 .TP
 .B  --gpgconf-test
 This is more or less dummy action.  However it parses the configuration
-file and returns with failure if the configuraion file would prevent
+file and returns with failure if the configuration file would prevent
 \fBgpg\fR from startup.  Thus it may be used to run a syntax check
 on the configuration file.
 
@@ -2728,7 +2726,7 @@
 
 .TP
 .B  By exact match on serial number and issuer's DN.
-This is indicated by a hash mark, followed by the hexadecmal
+This is indicated by a hash mark, followed by the hexadecimal
 representation of the serial number, the followed by a slash and the
 RFC-2253 encoded DN of the issuer. See note above.
 
@@ -2778,7 +2776,7 @@
 
 
 
-.SH RETURN VAUE
+.SH RETURN VALUE
 
 The program returns 0 if everything was fine, 1 if at least
 a signature was bad, and other error codes for fatal errors.
@@ -2850,7 +2848,7 @@
 into the directory `\fI/etc/skel/.gnupg/\fR' so that newly created users
 start up with a working configuration.
 
-For internal purposes \fBgpg\fR creates and maintaines a few other
+For internal purposes \fBgpg\fR creates and maintains a few other
 files; They all live in in the current home directory (see: [option
 --homedir]).  Only the \fBgpg\fR may modify these files.
 


Bug#445328: gnupg: man page formatting and other typos

2007-12-12 Thread Werner Koch
On Wed, 12 Dec 2007 13:37, [EMAIL PROTECTED] said:

 -signed stuff from stdin, use 
 -'-'
 - as the second filename.  For
 +signed stuff from stdin, use '-' as the second filename.  For

I fixed this too by using the yat2m tool from gnupg-2 where this
formatting problem has been fixed.  1.4.8 will be released in8 days.


Salam-Shalom,

   Werner

-- 
Die Gedanken sind frei.  Auschnahme regelt ein Bundeschgesetz.




-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of unsubscribe. Trouble? Contact [EMAIL PROTECTED]



Bug#445328: gnupg: man page formatting and other typos

2007-12-12 Thread Werner Koch
On Wed, 12 Dec 2007 13:37, [EMAIL PROTECTED] said:

 I also took the liberty of fixing a few obvious typos by running aspell on the
 man page, e.g. RETURN VAUE should be RETURN VALUE. See the patch for 
 details.


Thanks.  I applied the typo fixes to gpg.texi. 

Note that changing the man page is not a good idea because it is
generated from texinfo sources using the yat2m tool (part of gnupg).
Formatting problems should be solved in this tool and not in the
resulting man page.

gpg.texi is actually taken verbatim from gnupg2 and converted using
texinfo conditionals.


Shalom-Salam,

   Werner


-- 
Die Gedanken sind frei.  Auschnahme regelt ein Bundeschgesetz.




-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of unsubscribe. Trouble? Contact [EMAIL PROTECTED]