lib/43259: security/netpgp: libnetpgp.3 doesn't match the sources

[xtraeme%gmail.com@localhost]

>Number:         43259
>Category:       lib
>Synopsis:       security/netpgp: libnetpgp.3 doesn't match the sources
>Confidential:   no
>Severity:       serious
>Priority:       high
>Responsible:    lib-bug-people
>State:          open
>Class:          change-request
>Submitter-Id:   net
>Arrival-Date:   Wed May 05 14:40:05 +0000 2010
>Originator:     Juan RP
>Release:        NULL
>Organization:
>Environment:
>Description:
libnetpgp.3 shows a wrong prototype and description for netpgp_init().

It would be nice to explain which options can be set via netpgp_setvar(), or 
received via netpgp_getvar() as well.
>How-To-Repeat:

>Fix:
--- src/lib/libnetpgp.3.orig    2010-05-05 16:20:23.884817816 +0200
+++ src/lib/libnetpgp.3 2010-05-05 16:24:13.922823314 +0200
@@ -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 March 13, 2010
+.Dd May 5, 2010
 .Dt LIBNETPGP 3
 .Os
 .Sh NAME
@@ -41,7 +41,7 @@
 The following functions relate to initialisations and finalisations:
 .Ft int
 .Fo netpgp_init
-.Fa "netpgp_t *netpgp" "char *userid" "char *pubringfile" "char *secringfile"
+.Fa "netpgp_t *netpgp"
 .Fc
 .Ft int
 .Fo netpgp_end
@@ -175,12 +175,14 @@ process be initialised using the
 function, which will set up the public and private keyrings, and set the
 user identity to the
 .Ar userid
-argument passed to the function.
-If no public key ring file is provided, initial values will be taken from those
+argument passed in via the
+.Fn netpgp_setvar
+function.
+If no public key ring file is set, initial values will be taken from those
 in the
 .Pa .gnupg/pubring.gpg
 file in the user's home directory.
-Similarily, if no secret key ring file is provided,
+Similarily, if no secret key ring file is set,
 initial values will be taken from those
 in the
 .Pa .gnupg/secring.gpg