From: Jameson Rollins <jrollins@finestructure.net>
Date: Tue, 28 Dec 2010 15:12:18 +0000 (-0500)
Subject: improve msva-query-agent man page
X-Git-Url: http://git.tremily.us/?a=commitdiff_plain;h=46837f6afc487e6da2679c23e1f5ce451d14c5ad;p=monkeysphere-validation-agent.git

improve msva-query-agent man page
---

diff --git a/msva-query-agent b/msva-query-agent
index 63f9e85..972037f 100755
--- a/msva-query-agent
+++ b/msva-query-agent
@@ -83,8 +83,7 @@ indicates the validity (as determined by the agent) of the certificate
 for the specified purpose.  The agent's return message (if any) is
 emitted on stdout.
 
-The first three command-line arguments are all required, supplied in
-order, as follows:
+The various arguments are:
 
 =over 4
 
@@ -103,18 +102,18 @@ service, supply the host's full DNS name (e.g.  'foo.example.net')
 The format of public key carrier data provided on standard input
 (e.g. 'x509der', 'x509pem', 'opensshpubkey', 'rfc4716', 'openpgp4fpr')
 
-=back
-
-The fourth argument is optional:
-
-=over 4
-
 =item PEER_TYPE
 
-The type of peer we are inquiring about (e.g. 'client', 'server')
+The type of peer we are inquiring about (e.g. 'client', 'server',
+'peer').  This argument is optional and defaults will be used (based
+on CONTEXT) if it is not supplied.
+
+=item PKC_DATA
 
-If 5 arguments are given, the 5th argument is interpreted to be the
-PKC_DATA itself.  This is likely only useful for supplying an OpenPGP
+This is the actual public key carrier data itself.  If less than five
+arguments are given, then the PKC_DATA is expected on stdin.  If five
+arguments are given, the fifth argument is interpreted as the
+PKC_DATA.  This is likely only useful for supplying an OpenPGP
 fingerprint with the 'openpgp4fpr' type.
 
 =back