Source-Changes-HG archive

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]

[src/trunk]: src/crypto/external/bsd/netpgp/dist Manual page fixes from Antho...



details:   https://anonhg.NetBSD.org/src/rev/29b8372a9598
branches:  trunk
changeset: 326774:29b8372a9598
user:      agc <agc%NetBSD.org@localhost>
date:      Mon Feb 17 07:23:18 2014 +0000

description:
Manual page fixes from Anthony J. Bentley, with many thanks!

Addresses PR/48395

diffstat:

 crypto/external/bsd/netpgp/dist/configure                       |   2 +-
 crypto/external/bsd/netpgp/dist/src/hkpclient/hkpc.1            |  20 +++-
 crypto/external/bsd/netpgp/dist/src/lib/libnetpgp.3             |  19 ++--
 crypto/external/bsd/netpgp/dist/src/libbn/libnetpgpbn.3         |  20 ++--
 crypto/external/bsd/netpgp/dist/src/libdigest/tiger.3           |  11 +-
 crypto/external/bsd/netpgp/dist/src/libmj/libmj.3               |  24 +++---
 crypto/external/bsd/netpgp/dist/src/libverify/libnetpgpverify.3 |  19 +++-
 crypto/external/bsd/netpgp/dist/src/netpgp/netpgp.1             |  23 ++++--
 crypto/external/bsd/netpgp/dist/src/netpgpkeys/netpgpkeys.1     |  36 ++++++---
 crypto/external/bsd/netpgp/dist/src/netpgpverify/netpgpverify.1 |  17 +++-
 crypto/external/bsd/netpgp/dist/src/pgp2ssh/pgp2ssh.1           |  17 +++-
 11 files changed, 125 insertions(+), 83 deletions(-)

diffs (truncated from 637 to 300 lines):

diff -r 27b56a838858 -r 29b8372a9598 crypto/external/bsd/netpgp/dist/configure
--- a/crypto/external/bsd/netpgp/dist/configure Mon Feb 17 06:38:07 2014 +0000
+++ b/crypto/external/bsd/netpgp/dist/configure Mon Feb 17 07:23:18 2014 +0000
@@ -1,5 +1,5 @@
 #! /bin/sh
-# From configure.ac Revision: 1.39 .
+# From configure.ac Revision: 1.40 .
 # Guess values for system-dependent variables and create Makefiles.
 # Generated by GNU Autoconf 2.69 for netpgp 20140210.
 #
diff -r 27b56a838858 -r 29b8372a9598 crypto/external/bsd/netpgp/dist/src/hkpclient/hkpc.1
--- a/crypto/external/bsd/netpgp/dist/src/hkpclient/hkpc.1      Mon Feb 17 06:38:07 2014 +0000
+++ b/crypto/external/bsd/netpgp/dist/src/hkpclient/hkpc.1      Mon Feb 17 07:23:18 2014 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: hkpc.1,v 1.2 2013/07/20 21:39:55 wiz Exp $
+.\" $NetBSD: hkpc.1,v 1.3 2014/02/17 07:23:18 agc Exp $
 .\"
 .\" Copyright (c) 2010 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -27,7 +27,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd September 1, 2010
+.Dd February 16, 2014
 .Dt HKPC 1
 .Os
 .Sh NAME
@@ -86,8 +86,7 @@
 .Pp
 The
 .Dv netpgp
-suite of libraries and commands provides a copnvenient client
-in
+suite of libraries and commands provides a convenient client in
 .Xr hkpd 1 .
 .Pp
 The information is sent to the server in the form of
@@ -111,9 +110,16 @@
 .Xr libmj 3 ,
 .Xr libnetpgp 3
 .Sh STANDARDS
-The
-.Nm
-utility is designed to conform to IETF RFC 4880.
+.Rs
+.%A J. Callas
+.%A L. Donnerhacke
+.%A H. Finney
+.%A D. Shaw
+.%A R. Thayer
+.%D November 2007
+.%R RFC 4880
+.%T OpenPGP Message Format
+.Re
 .Sh HISTORY
 The
 .Nm
diff -r 27b56a838858 -r 29b8372a9598 crypto/external/bsd/netpgp/dist/src/lib/libnetpgp.3
--- a/crypto/external/bsd/netpgp/dist/src/lib/libnetpgp.3       Mon Feb 17 06:38:07 2014 +0000
+++ b/crypto/external/bsd/netpgp/dist/src/lib/libnetpgp.3       Mon Feb 17 07:23:18 2014 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: libnetpgp.3,v 1.15 2013/07/20 21:39:55 wiz Exp $
+.\" $NetBSD: libnetpgp.3,v 1.16 2014/02/17 07:23:18 agc Exp $
 .\"
 .\" Copyright (c) 2009,2010 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -27,7 +27,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd June 17, 2010
+.Dd February 16, 2014
 .Dt LIBNETPGP 3
 .Os
 .Sh NAME
@@ -184,14 +184,14 @@
 in the
 .Pa .gnupg/pubring.gpg
 file in the user's home directory.
-Similarily, if no secret key ring file is set,
+Similarly, if no secret key ring file is set,
 initial values will be taken from those
 in the
 .Pa .gnupg/secring.gpg
 file in the user's home directory.
 The
 .Fn netpgp_init
-returns 1 on sucess, 0 on failure.
+function returns 1 on success, 0 on failure.
 .Pp
 To list all the keys in a keyring, the
 .Fn netpgp_list_keys
@@ -218,7 +218,7 @@
 .Pp
 To export a key, the
 .Fn netpgp_export_key
-is used.
+function is used.
 Output is sent to the standard output.
 .Pp
 To import a key onto the public keyring, the
@@ -244,12 +244,12 @@
 library.
 To encrypt a file, the
 .Fn netpgp_encrypt_file
-and the
+function is used, and the
 .Fn netpgp_decrypt_file
-is used to decrypt the results of the encryption.
+function is used to decrypt the results of the encryption.
 To sign a file, the
 .Fn netpgp_sign_file
-is used, and the resulting signed file can be verified
+function is used, and the resulting signed file can be verified
 using the
 .Fn netpgp_verify_file
 function.
@@ -310,7 +310,7 @@
 .Pp
 The
 .Fn netpgp_get_info
-returns the version or maintainer information depending upon the
+function returns the version or maintainer information depending upon the
 .Ar type
 argument.
 At the present time, two types are defined:
@@ -333,6 +333,7 @@
 library first appeared in
 .Nx 6.0 .
 .Sh AUTHORS
+.An -nosplit
 .An Ben Laurie ,
 .An Rachel Willmer .
 .An Alistair Crooks Aq Mt agc%NetBSD.org@localhost
diff -r 27b56a838858 -r 29b8372a9598 crypto/external/bsd/netpgp/dist/src/libbn/libnetpgpbn.3
--- a/crypto/external/bsd/netpgp/dist/src/libbn/libnetpgpbn.3   Mon Feb 17 06:38:07 2014 +0000
+++ b/crypto/external/bsd/netpgp/dist/src/libbn/libnetpgpbn.3   Mon Feb 17 07:23:18 2014 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: libnetpgpbn.3,v 1.3 2013/07/20 21:39:56 wiz Exp $
+.\" $NetBSD: libnetpgpbn.3,v 1.4 2014/02/17 07:23:18 agc Exp $
 .\"
 .\" Copyright (c) 2010 Alistair Crooks <agc%NetBSD.org@localhost>
 .\" All rights reserved.
@@ -23,7 +23,7 @@
 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd April 13, 2012
+.Dd February 16, 2014
 .Dt LIBNETPGPBN 3
 .Os
 .Sh NAME
@@ -246,21 +246,21 @@
 emulates the API of the openssl
 .Xr bn 3
 library.
-It is implemented using Tom St Denis
+It is implemented using Tom St Denis's
 .Dq libtommath
 library.
 .Sh EXAMPLES
-The follow code fragment will make a JSON object
+The following code fragment will make a JSON object
 out of the string
 .Dq Hello <USERNAME>\en
 in the
 buffer called
-.Dq buf
+.Va buf
 where
 .Dq USERNAME
 is the name of the user taken from the runtime environment.
 The encoded text will be in an allocated buffer called
-.Dq s
+.Va s .
 .Bd -literal -offset indent
 mj_t atom;
 char buf[BUFSIZ];
@@ -273,9 +273,9 @@
 cc = mj_asprint(\*[Am]s, \*[Am]atom, MJ_JSON_ENCODE);
 .Ed
 .Pp
-and the following example will take the (binary) text which has been encoded into
+Next, the following example will take the (binary) text which has been encoded into
 JSON and is in the buffer
-.Dq buf ,
+.Va buf ,
 such as in the previous example, and re-create the original text:
 .Bd -literal -offset indent
 int from, to, tok, cc;
@@ -290,7 +290,7 @@
 .Ed
 .Pp
 The
-.Dv s
+.Va s
 pointer points to allocated storage with the original NUL-terminated string
 in it.
 .Sh SEE ALSO
@@ -301,4 +301,4 @@
 library first appeared in
 .Nx 7.0 .
 .Sh AUTHORS
-.An Alistair Crooks Aq Mt agc%NetBSD.org@localhost
+.An Alistair Crooks Aq Mt agc%NetBSD.org@localhost .
diff -r 27b56a838858 -r 29b8372a9598 crypto/external/bsd/netpgp/dist/src/libdigest/tiger.3
--- a/crypto/external/bsd/netpgp/dist/src/libdigest/tiger.3     Mon Feb 17 06:38:07 2014 +0000
+++ b/crypto/external/bsd/netpgp/dist/src/libdigest/tiger.3     Mon Feb 17 07:23:18 2014 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: tiger.3,v 1.3 2013/07/20 21:39:56 wiz Exp $
+.\" $NetBSD: tiger.3,v 1.4 2014/02/17 07:23:18 agc Exp $
 .\"
 .\" Copyright (c) 2011 Alistair Crooks <agc%NetBSD.org@localhost>
 .\" All rights reserved.
@@ -116,7 +116,7 @@
 .Pp
 The
 .Fn TIGER_End
-function is a front end for
+function is a frontend for
 .Fn TIGER_Final
 which converts the digest into an
 .Tn ASCII
@@ -156,7 +156,7 @@
 when it is no longer needed.
 .Sh EXAMPLES
 The follow code fragment will calculate the digest for the string
-"The quick brown fox jumps over the lazy dog"
+.Dq The quick brown fox jumps over the lazy dog ,
 which is
 .Dq 6d12a41e72e644f017b6f0e2f7b44c6285f06dd5d2c5b075 .
 .Bd -literal -offset indent
@@ -189,11 +189,10 @@
 .Sh SEE ALSO
 .Xr md5 3 ,
 .Xr sha1 3
-.Pp
 .Rs
 .%A Ross Anderson
 .%A Eli Biham
-.%T "Tiger - A Fast New Hash Function"
+.%T "Tiger \- A Fast New Hash Function"
 .%B Proceedings of Fast Software Encryption 3, Cambridge
 .%D 1996
 .Re
@@ -213,7 +212,7 @@
 .Fn TIGER_Data
 helper functions are derived from code written by Poul-Henning Kamp.
 .Sh BUGS
-All attempts have bene made to optimise for the underlying hardware,
+All attempts have been made to optimise for the underlying hardware,
 as well as to format the digest properly in an endian-neutral manner.
 The author has no VAX hardware on which to test, and so it is not known
 whether that platform is supported.
diff -r 27b56a838858 -r 29b8372a9598 crypto/external/bsd/netpgp/dist/src/libmj/libmj.3
--- a/crypto/external/bsd/netpgp/dist/src/libmj/libmj.3 Mon Feb 17 06:38:07 2014 +0000
+++ b/crypto/external/bsd/netpgp/dist/src/libmj/libmj.3 Mon Feb 17 07:23:18 2014 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: libmj.3,v 1.6 2013/07/20 21:39:55 wiz Exp $
+.\" $NetBSD: libmj.3,v 1.7 2014/02/17 07:23:18 agc Exp $
 .\"
 .\" Copyright (c) 2010 Alistair Crooks <agc%NetBSD.org@localhost>
 .\" All rights reserved.
@@ -23,7 +23,7 @@
 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd June 22, 2011
+.Dd February 16, 2014
 .Dt LIBMJ 3
 .Os
 .Sh NAME
@@ -98,7 +98,7 @@
 .Nm
 is a small library interface to allow JSON text to be created and parsed.
 JSON is the Java Script Object Notation,
-a lightweight data-interchange format, standardised in the ECMA standard.
+a lightweight data-interchange format, standardised by the ECMA.
 The library name
 .Nm
 is derived from a further acronym of
@@ -115,7 +115,7 @@
 .Pp
 JSON contains basic units called atoms, the two
 basic atoms being strings and numbers.
-Three other useful atomic values are provided,
+Three other useful atomic values are provided:
 .Dq null ,
 .Dq false ,
 and
@@ -127,7 +127,7 @@
 .Pp
 To create a new object, the
 .Fn mj_create
-is used.
+function is used.
 It can be deleted using the
 .Fn mj_delete
 function.



Home | Main Index | Thread Index | Old Index