]> git.ipfire.org Git - thirdparty/ntp.git/commitdiff
NTP_4_2_7P358
authorHarlan Stenn <stenn@ntp.org>
Wed, 27 Feb 2013 11:39:54 +0000 (11:39 +0000)
committerHarlan Stenn <stenn@ntp.org>
Wed, 27 Feb 2013 11:39:54 +0000 (11:39 +0000)
bk: 512df08aDmgG9SZvTt0w4LkKB0-JBQ

68 files changed:
ChangeLog
ntpd/invoke-ntp.conf.texi
ntpd/invoke-ntp.keys.texi
ntpd/invoke-ntpd.texi
ntpd/ntp.conf.5man
ntpd/ntp.conf.5mdoc
ntpd/ntp.conf.html
ntpd/ntp.conf.man.in
ntpd/ntp.conf.mdoc.in
ntpd/ntp.keys.5man
ntpd/ntp.keys.5mdoc
ntpd/ntp.keys.html
ntpd/ntp.keys.man.in
ntpd/ntp.keys.mdoc.in
ntpd/ntpd-opts.c
ntpd/ntpd-opts.h
ntpd/ntpd.1ntpdman
ntpd/ntpd.1ntpdmdoc
ntpd/ntpd.html
ntpd/ntpd.man.in
ntpd/ntpd.mdoc.in
ntpdc/invoke-ntpdc.texi
ntpdc/ntpdc-opts.c
ntpdc/ntpdc-opts.h
ntpdc/ntpdc.1ntpdcman
ntpdc/ntpdc.1ntpdcmdoc
ntpdc/ntpdc.html
ntpdc/ntpdc.man.in
ntpdc/ntpdc.mdoc.in
ntpq/invoke-ntpq.texi
ntpq/ntpq-opts.c
ntpq/ntpq-opts.h
ntpq/ntpq.1ntpqman
ntpq/ntpq.1ntpqmdoc
ntpq/ntpq.html
ntpq/ntpq.man.in
ntpq/ntpq.mdoc.in
ntpsnmpd/invoke-ntpsnmpd.texi
ntpsnmpd/ntpsnmpd-opts.c
ntpsnmpd/ntpsnmpd-opts.h
ntpsnmpd/ntpsnmpd.1ntpsnmpdman
ntpsnmpd/ntpsnmpd.1ntpsnmpdmdoc
ntpsnmpd/ntpsnmpd.html
ntpsnmpd/ntpsnmpd.man.in
ntpsnmpd/ntpsnmpd.mdoc.in
packageinfo.sh
scripts/invoke-ntp-wait.texi
scripts/ntp-wait.1ntp-waitman
scripts/ntp-wait.1ntp-waitmdoc
scripts/ntp-wait.html
scripts/ntp-wait.man.in
scripts/ntp-wait.mdoc.in
sntp/invoke-sntp.texi
sntp/sntp-opts.c
sntp/sntp-opts.h
sntp/sntp.1sntpman
sntp/sntp.1sntpmdoc
sntp/sntp.html
sntp/sntp.man.in
sntp/sntp.mdoc.in
util/invoke-ntp-keygen.texi
util/ntp-keygen-opts.c
util/ntp-keygen-opts.h
util/ntp-keygen.1ntp-keygenman
util/ntp-keygen.1ntp-keygenmdoc
util/ntp-keygen.html
util/ntp-keygen.man.in
util/ntp-keygen.mdoc.in

index 48a216c6a5e1d29e3dcfb5026720de8c2721a9c8..d2b906d8c70d5aa12b64eeee997e2073e2574b43 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,4 @@
+(4.2.7p358) 2013/02/27 Released by Harlan Stenn <stenn@ntp.org>
 * Upgrade to autogen-5.17.3pre4 and libopts-38.0.13.
 * [Bug 2357] sntp/libopts/usage.c on NetBSD needs -lintl.
 (4.2.7p357) 2013/02/22 Released by Harlan Stenn <stenn@ntp.org>
index f78385c97b64ad488ac2f5f927bbcb3c4c7ed558..4ae6c10dc4f46454957a2eb42e31944110decd39 100644 (file)
@@ -6,7 +6,7 @@
 #
 # EDIT THIS FILE WITH CAUTION  (invoke-ntp.conf.texi)
 #
-# It has been AutoGen-ed  February 22, 2013 at 03:28:04 AM by AutoGen 5.17.2pre17
+# It has been AutoGen-ed  February 27, 2013 at 11:37:01 AM by AutoGen 5.17.3.pre2
 # From the definitions    ntp.conf.def
 # and the template file   agtexi-file.tpl
 @end ignore
index 40537ee18c71d41e92320cb2c42f8b0f4606e6c3..6f3ea3f7cea9347497c43cbf10b876426b70bd57 100644 (file)
@@ -6,7 +6,7 @@
 #
 # EDIT THIS FILE WITH CAUTION  (invoke-ntp.keys.texi)
 #
-# It has been AutoGen-ed  February 22, 2013 at 03:28:05 AM by AutoGen 5.17.2pre17
+# It has been AutoGen-ed  February 27, 2013 at 11:37:03 AM by AutoGen 5.17.3.pre2
 # From the definitions    ntp.keys.def
 # and the template file   agtexi-file.tpl
 @end ignore
index 57af66d2cca152d3e41f039b6a2b1566c6fbe609..175cb3858bda86a3c561793dad9afa95ae68a8da 100644 (file)
@@ -6,7 +6,7 @@
 #
 # EDIT THIS FILE WITH CAUTION  (invoke-ntpd.texi)
 #
-# It has been AutoGen-ed  February 21, 2013 at 10:46:22 PM by AutoGen 5.17.2pre17
+# It has been AutoGen-ed  February 27, 2013 at 11:37:04 AM by AutoGen 5.17.3.pre2
 # From the definitions    ntpd-opts.def
 # and the template file   agtexi-cmd.tpl
 @end ignore
@@ -141,7 +141,7 @@ with a status code of 0.
 
 @exampleindent 0
 @example
-ntpd - NTP daemon program - Ver. 4.2.7p357
+ntpd - NTP daemon program - Ver. 4.2.7p358
 Usage:  ntpd [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]... \
                 [ <server1> ... <serverN> ]
   Flg Arg Option-Name    Description
index efab3e0edfc7ee0c834ed9873cd89bfc8f810c11..693b862a479f245ff9fc24d7a33d186b597fed96 100644 (file)
@@ -1,8 +1,8 @@
-.TH ntp.conf 5man "22 Feb 2013" "4.2.7p357" "File Formats"
+.TH ntp.conf 5man "27 Feb 2013" "4.2.7p358" "File Formats"
 .\"
 .\"  EDIT THIS FILE WITH CAUTION  (ntp.man)
 .\"
-.\"  It has been AutoGen-ed  February 22, 2013 at 03:27:50 AM by AutoGen 5.17.2pre17
+.\"  It has been AutoGen-ed  February 27, 2013 at 11:36:47 AM by AutoGen 5.17.3.pre2
 .\"  From the definitions    ntp.conf.def
 .\"  and the template file   agman-cmd.tpl
 .\"
@@ -2976,7 +2976,7 @@ services when they become universally available.
 .PP
 Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
 .SH NOTES
-This document corresponds to version 4.2.7p357 of NTP.
+This document corresponds to version 4.2.7p358 of NTP.
 This document was derived from FreeBSD.
 .PP
 This manual page was \fIAutoGen\fP-erated from the \fBntp.conf\fP
index 4b34252f89ea30ebf2ee51ef4d36c5560f9ec500..4bb8d1d9729c62f59e431d2dc332e899bff1fcee 100644 (file)
@@ -1,9 +1,9 @@
-.Dd February 21 2013
+.Dd February 27 2013
 .Dt NTP_CONF 5mdoc File Formats
 .Os SunOS 5.10
 .\"  EDIT THIS FILE WITH CAUTION  (ntp.mdoc)
 .\"
-.\"  It has been AutoGen-ed  February 21, 2013 at 10:46:24 PM by AutoGen 5.17.2pre17
+.\"  It has been AutoGen-ed  February 27, 2013 at 11:37:07 AM by AutoGen 5.17.3.pre2
 .\"  From the definitions    ntp.conf.def
 .\"  and the template file   agmdoc-cmd.tpl
 .Sh NAME
@@ -2804,7 +2804,7 @@ services when they become universally available.
 .Pp
 Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
 .Sh NOTES
-This document corresponds to version 4.2.7p357 of NTP.
+This document corresponds to version 4.2.7p358 of NTP.
 This document was derived from FreeBSD.
 .Pp
 This manual page was \fIAutoGen\fP\-erated from the \fBntp.conf\fP
index 97fa5618ee1866261ede837cc7e7ceadf81ad405..3f87b5f85591b626adbad915d303e4842cc14a2f 100644 (file)
@@ -33,7 +33,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#dir">(dir)</a>
 <p>This document describes the configuration file for the NTP Project's
 <code>ntpd</code> program.
 
-  <p>This document applies to version 4.2.7p357 of <code>ntp.conf</code>.
+  <p>This document applies to version 4.2.7p358 of <code>ntp.conf</code>.
 
 <ul class="menu">
 <li><a accesskey="1" href="#ntp_002econf-Description">ntp.conf Description</a>
index ac99fc8c33cf4974aa2218d504a7bc47623d13ac..2d1811c85f5102d9ead96b1f95490d5afd29f0fb 100644 (file)
@@ -1,8 +1,8 @@
-.TH ntp.conf 5 "22 Feb 2013" "4.2.7p357" "File Formats"
+.TH ntp.conf 5 "27 Feb 2013" "4.2.7p358" "File Formats"
 .\"
 .\"  EDIT THIS FILE WITH CAUTION  (ntp.man)
 .\"
-.\"  It has been AutoGen-ed  February 22, 2013 at 03:27:50 AM by AutoGen 5.17.2pre17
+.\"  It has been AutoGen-ed  February 27, 2013 at 11:36:47 AM by AutoGen 5.17.3.pre2
 .\"  From the definitions    ntp.conf.def
 .\"  and the template file   agman-cmd.tpl
 .\"
@@ -2976,7 +2976,7 @@ services when they become universally available.
 .PP
 Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
 .SH NOTES
-This document corresponds to version 4.2.7p357 of NTP.
+This document corresponds to version 4.2.7p358 of NTP.
 This document was derived from FreeBSD.
 .PP
 This manual page was \fIAutoGen\fP-erated from the \fBntp.conf\fP
index 6ea28d8ce12dbb3ad8e2b477db7c72f76a93f632..2dc14d95f19db41eeb31016d8b11f363a880f9ff 100644 (file)
@@ -1,9 +1,9 @@
-.Dd February 21 2013
+.Dd February 27 2013
 .Dt NTP_CONF 5 File Formats
 .Os SunOS 5.10
 .\"  EDIT THIS FILE WITH CAUTION  (ntp.mdoc)
 .\"
-.\"  It has been AutoGen-ed  February 21, 2013 at 10:46:24 PM by AutoGen 5.17.2pre17
+.\"  It has been AutoGen-ed  February 27, 2013 at 11:37:07 AM by AutoGen 5.17.3.pre2
 .\"  From the definitions    ntp.conf.def
 .\"  and the template file   agmdoc-cmd.tpl
 .Sh NAME
@@ -2804,7 +2804,7 @@ services when they become universally available.
 .Pp
 Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
 .Sh NOTES
-This document corresponds to version 4.2.7p357 of NTP.
+This document corresponds to version 4.2.7p358 of NTP.
 This document was derived from FreeBSD.
 .Pp
 This manual page was \fIAutoGen\fP\-erated from the \fBntp.conf\fP
index e76104f8901258515c8f1807aa944d0cf2ebc6ef..960f7263314b8c240d4c07722fd753150613fc07 100644 (file)
@@ -1,8 +1,8 @@
-.TH ntp.keys 5man "22 Feb 2013" "4.2.7p357" "File Formats"
+.TH ntp.keys 5man "27 Feb 2013" "4.2.7p358" "File Formats"
 .\"
 .\"  EDIT THIS FILE WITH CAUTION  (ntp.man)
 .\"
-.\"  It has been AutoGen-ed  February 22, 2013 at 03:27:55 AM by AutoGen 5.17.2pre17
+.\"  It has been AutoGen-ed  February 27, 2013 at 11:36:52 AM by AutoGen 5.17.3.pre2
 .\"  From the definitions    ntp.keys.def
 .\"  and the template file   agman-file.tpl
 .\"
@@ -133,7 +133,7 @@ This program is released under the terms of the NTP license, <http://ntp.org/lic
 .SH "BUGS"
 Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
 .SH NOTES
-This document corresponds to version 4.2.7p357 of NTP.
+This document corresponds to version 4.2.7p358 of NTP.
 This document was derived from FreeBSD.
 .PP
 This manual page was \fIAutoGen\fP-erated from the \fBntp.keys\fP
index 34ed0f0c3db6261dad2a64f1c84267dd9f0ec81b..91bec42050a7b7be4fa0f4ea4f641f4830b36627 100644 (file)
@@ -1,9 +1,9 @@
-.Dd February 21 2013
+.Dd February 27 2013
 .Dt NTP_KEYS 5mdoc File Formats
 .Os SunOS 5.10
 .\"  EDIT THIS FILE WITH CAUTION  (ntp.mdoc)
 .\"
-.\"  It has been AutoGen-ed  February 21, 2013 at 10:46:28 PM by AutoGen 5.17.2pre17
+.\"  It has been AutoGen-ed  February 27, 2013 at 11:37:10 AM by AutoGen 5.17.3.pre2
 .\"  From the definitions    ntp.keys.def
 .\"  and the template file   agmdoc-file.tpl
 .Sh NAME
@@ -163,7 +163,7 @@ This program is released under the terms of the NTP license, <http://ntp.org/lic
 .Sh "BUGS"
 Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
 .Sh NOTES
-This document corresponds to version 4.2.7p357 of NTP.
+This document corresponds to version 4.2.7p358 of NTP.
 This document was derived from FreeBSD.
 .Pp
 This manual page was \fIAutoGen\fP\-erated from the \fBntp.keys\fP
index 4a41e6cc8fd2f536625e557f59d2befb428c8382..7e114fa552f79dc9b60a127c8512405967f3b0db 100644 (file)
@@ -33,7 +33,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#dir">(dir)</a>
 <p>This document describes the symmetric key file for the NTP Project's
 <code>ntpd</code> program.
 
-  <p>This document applies to version 4.2.7p357 of <code>ntp.keys</code>.
+  <p>This document applies to version 4.2.7p358 of <code>ntp.keys</code>.
 
   <div class="shortcontents">
 <h2>Short Contents</h2>
index 64d4e8afa59a92d3ec4a9f45bbc45643d96e5c66..d1c15be649f2668fce9aef15fa3e1a26206cc69b 100644 (file)
@@ -1,8 +1,8 @@
-.TH ntp.keys 5 "22 Feb 2013" "4.2.7p357" "File Formats"
+.TH ntp.keys 5 "27 Feb 2013" "4.2.7p358" "File Formats"
 .\"
 .\"  EDIT THIS FILE WITH CAUTION  (ntp.man)
 .\"
-.\"  It has been AutoGen-ed  February 22, 2013 at 03:27:55 AM by AutoGen 5.17.2pre17
+.\"  It has been AutoGen-ed  February 27, 2013 at 11:36:52 AM by AutoGen 5.17.3.pre2
 .\"  From the definitions    ntp.keys.def
 .\"  and the template file   agman-file.tpl
 .\"
@@ -133,7 +133,7 @@ This program is released under the terms of the NTP license, <http://ntp.org/lic
 .SH "BUGS"
 Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
 .SH NOTES
-This document corresponds to version 4.2.7p357 of NTP.
+This document corresponds to version 4.2.7p358 of NTP.
 This document was derived from FreeBSD.
 .PP
 This manual page was \fIAutoGen\fP-erated from the \fBntp.keys\fP
index dce48efb3f492d072c62d8651c7857d2d7896951..b0fe69255c3e017958f59aced7e399aa687ce86c 100644 (file)
@@ -1,9 +1,9 @@
-.Dd February 21 2013
+.Dd February 27 2013
 .Dt NTP_KEYS 5 File Formats
 .Os SunOS 5.10
 .\"  EDIT THIS FILE WITH CAUTION  (ntp.mdoc)
 .\"
-.\"  It has been AutoGen-ed  February 21, 2013 at 10:46:28 PM by AutoGen 5.17.2pre17
+.\"  It has been AutoGen-ed  February 27, 2013 at 11:37:10 AM by AutoGen 5.17.3.pre2
 .\"  From the definitions    ntp.keys.def
 .\"  and the template file   agmdoc-file.tpl
 .Sh NAME
@@ -163,7 +163,7 @@ This program is released under the terms of the NTP license, <http://ntp.org/lic
 .Sh "BUGS"
 Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
 .Sh NOTES
-This document corresponds to version 4.2.7p357 of NTP.
+This document corresponds to version 4.2.7p358 of NTP.
 This document was derived from FreeBSD.
 .Pp
 This manual page was \fIAutoGen\fP\-erated from the \fBntp.keys\fP
index 8f179242d17546cad52b8ff5179a8af5824baff8..05766549a9d93debe00542810d6f25bc27a1633e 100644 (file)
@@ -1,7 +1,7 @@
 /*
  *  EDIT THIS FILE WITH CAUTION  (ntpd-opts.c)
  *
- *  It has been AutoGen-ed  February 22, 2013 at 03:25:41 AM by AutoGen 5.17.2pre17
+ *  It has been AutoGen-ed  February 27, 2013 at 11:34:31 AM by AutoGen 5.17.3.pre2
  *  From the definitions    ntpd-opts.def
  *  and the template file   options
  *
@@ -71,11 +71,11 @@ extern FILE * option_usage_fp;
 #  define NULL 0
 #endif
 
-/*
- *  ntpd option static const strings
+/**
+ *  static const strings for ntpd options
  */
 static char const ntpd_opt_strs[2986] =
-/*     0 */ "ntpd 4.2.7p357\n"
+/*     0 */ "ntpd 4.2.7p358\n"
             "Copyright (C) 1970-2013 The University of Delaware, all rights reserved.\n"
             "This is free software. It is licensed for use, modification and\n"
             "redistribution under the terms of the NTP License, copies of which\n"
@@ -201,167 +201,236 @@ static char const ntpd_opt_strs[2986] =
 /*  2753 */ "output version information and exit\0"
 /*  2789 */ "version\0"
 /*  2797 */ "NTPD\0"
-/*  2802 */ "ntpd - NTP daemon program - Ver. 4.2.7p357\n"
+/*  2802 */ "ntpd - NTP daemon program - Ver. 4.2.7p358\n"
             "Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \\\n"
             "\t\t[ <server1> ... <serverN> ]\n\0"
 /*  2935 */ "http://bugs.ntp.org, bugs@ntp.org\0"
 /*  2969 */ "\n\0"
-/*  2971 */ "ntpd 4.2.7p357";
+/*  2971 */ "ntpd 4.2.7p358";
 
-/*
+/**
  *  ipv4 option description with
  *  "Must also have options" and "Incompatible options":
  */
+/** Descriptive text for the ipv4 option */
 #define IPV4_DESC      (ntpd_opt_strs+954)
+/** Upper-cased name for the ipv4 option */
 #define IPV4_NAME      (ntpd_opt_strs+985)
+/** Name string for the ipv4 option */
 #define IPV4_name      (ntpd_opt_strs+990)
+/** Other options that appear in conjunction with the ipv4 option */
 static int const aIpv4CantList[] = {
     INDEX_OPT_IPV6, NO_EQUIVALENT };
+/** Compiled in flag settings for the ipv4 option */
 #define IPV4_FLAGS     (OPTST_DISABLED)
 
-/*
+/**
  *  ipv6 option description with
  *  "Must also have options" and "Incompatible options":
  */
+/** Descriptive text for the ipv6 option */
 #define IPV6_DESC      (ntpd_opt_strs+995)
+/** Upper-cased name for the ipv6 option */
 #define IPV6_NAME      (ntpd_opt_strs+1026)
+/** Name string for the ipv6 option */
 #define IPV6_name      (ntpd_opt_strs+1031)
+/** Other options that appear in conjunction with the ipv6 option */
 static int const aIpv6CantList[] = {
     INDEX_OPT_IPV4, NO_EQUIVALENT };
+/** Compiled in flag settings for the ipv6 option */
 #define IPV6_FLAGS     (OPTST_DISABLED)
 
-/*
+/**
  *  authreq option description with
  *  "Must also have options" and "Incompatible options":
  */
+/** Descriptive text for the authreq option */
 #define AUTHREQ_DESC      (ntpd_opt_strs+1036)
+/** Upper-cased name for the authreq option */
 #define AUTHREQ_NAME      (ntpd_opt_strs+1066)
+/** Name string for the authreq option */
 #define AUTHREQ_name      (ntpd_opt_strs+1074)
+/** Other options that appear in conjunction with the authreq option */
 static int const aAuthreqCantList[] = {
     INDEX_OPT_AUTHNOREQ, NO_EQUIVALENT };
+/** Compiled in flag settings for the authreq option */
 #define AUTHREQ_FLAGS     (OPTST_DISABLED)
 
-/*
+/**
  *  authnoreq option description with
  *  "Must also have options" and "Incompatible options":
  */
+/** Descriptive text for the authnoreq option */
 #define AUTHNOREQ_DESC      (ntpd_opt_strs+1082)
+/** Upper-cased name for the authnoreq option */
 #define AUTHNOREQ_NAME      (ntpd_opt_strs+1119)
+/** Name string for the authnoreq option */
 #define AUTHNOREQ_name      (ntpd_opt_strs+1129)
+/** Other options that appear in conjunction with the authnoreq option */
 static int const aAuthnoreqCantList[] = {
     INDEX_OPT_AUTHREQ, NO_EQUIVALENT };
+/** Compiled in flag settings for the authnoreq option */
 #define AUTHNOREQ_FLAGS     (OPTST_DISABLED)
 
-/*
+/**
  *  bcastsync option description:
  */
+/** Descriptive text for the bcastsync option */
 #define BCASTSYNC_DESC      (ntpd_opt_strs+1139)
+/** Upper-cased name for the bcastsync option */
 #define BCASTSYNC_NAME      (ntpd_opt_strs+1177)
+/** Name string for the bcastsync option */
 #define BCASTSYNC_name      (ntpd_opt_strs+1187)
+/** Compiled in flag settings for the bcastsync option */
 #define BCASTSYNC_FLAGS     (OPTST_DISABLED)
 
-/*
+/**
  *  configfile option description:
  */
+/** Descriptive text for the configfile option */
 #define CONFIGFILE_DESC      (ntpd_opt_strs+1197)
+/** Upper-cased name for the configfile option */
 #define CONFIGFILE_NAME      (ntpd_opt_strs+1221)
+/** Name string for the configfile option */
 #define CONFIGFILE_name      (ntpd_opt_strs+1232)
+/** Compiled in flag settings for the configfile option */
 #define CONFIGFILE_FLAGS     (OPTST_DISABLED \
         | OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
 
-/*
+/**
  *  debug-level option description:
  */
+/** Descriptive text for the debug-level option */
 #define DEBUG_LEVEL_DESC      (ntpd_opt_strs+1243)
+/** Upper-cased name for the debug-level option */
 #define DEBUG_LEVEL_NAME      (ntpd_opt_strs+1274)
+/** Name string for the debug-level option */
 #define DEBUG_LEVEL_name      (ntpd_opt_strs+1286)
+/** Compiled in flag settings for the debug-level option */
 #define DEBUG_LEVEL_FLAGS     (OPTST_DISABLED)
 
-/*
+/**
  *  set-debug-level option description:
  */
+/** Descriptive text for the set-debug-level option */
 #define SET_DEBUG_LEVEL_DESC      (ntpd_opt_strs+1298)
+/** Upper-cased name for the set-debug-level option */
 #define SET_DEBUG_LEVEL_NAME      (ntpd_opt_strs+1328)
+/** Name string for the set-debug-level option */
 #define SET_DEBUG_LEVEL_name      (ntpd_opt_strs+1344)
+/** Compiled in flag settings for the set-debug-level option */
 #define SET_DEBUG_LEVEL_FLAGS     (OPTST_DISABLED \
         | OPTST_SET_ARGTYPE(OPARG_TYPE_NUMERIC))
 
-/*
+/**
  *  driftfile option description:
  */
+/** Descriptive text for the driftfile option */
 #define DRIFTFILE_DESC      (ntpd_opt_strs+1360)
+/** Upper-cased name for the driftfile option */
 #define DRIFTFILE_NAME      (ntpd_opt_strs+1386)
+/** Name string for the driftfile option */
 #define DRIFTFILE_name      (ntpd_opt_strs+1396)
+/** Compiled in flag settings for the driftfile option */
 #define DRIFTFILE_FLAGS     (OPTST_DISABLED \
         | OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
 
-/*
+/**
  *  panicgate option description:
  */
+/** Descriptive text for the panicgate option */
 #define PANICGATE_DESC      (ntpd_opt_strs+1406)
+/** Upper-cased name for the panicgate option */
 #define PANICGATE_NAME      (ntpd_opt_strs+1443)
+/** Name string for the panicgate option */
 #define PANICGATE_name      (ntpd_opt_strs+1453)
+/** Compiled in flag settings for the panicgate option */
 #define PANICGATE_FLAGS     (OPTST_DISABLED)
 
-/*
+/**
  *  jaildir option description:
  */
 #ifdef HAVE_DROPROOT
+/** Descriptive text for the jaildir option */
 #define JAILDIR_DESC      (ntpd_opt_strs+1463)
+/** Upper-cased name for the jaildir option */
 #define JAILDIR_NAME      (ntpd_opt_strs+1478)
+/** Name string for the jaildir option */
 #define JAILDIR_name      (ntpd_opt_strs+1486)
+/** Compiled in flag settings for the jaildir option */
 #define JAILDIR_FLAGS     (OPTST_DISABLED \
         | OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
 
 #else   /* disable jaildir */
 #define JAILDIR_FLAGS     (OPTST_OMITTED | OPTST_NO_INIT)
 #define JAILDIR_NAME      NULL
+/** Descriptive text for the jaildir option */
 #define JAILDIR_DESC      (ntpd_opt_strs+1494)
 #define JAILDIR_name      (ntpd_opt_strs+1486)
 #endif  /* HAVE_DROPROOT */
 
-/*
+/**
  *  interface option description:
  */
+/** Descriptive text for the interface option */
 #define INTERFACE_DESC      (ntpd_opt_strs+1548)
+/** Upper-cased name for the interface option */
 #define INTERFACE_NAME      (ntpd_opt_strs+1587)
+/** Name string for the interface option */
 #define INTERFACE_name      (ntpd_opt_strs+1597)
+/** Compiled in flag settings for the interface option */
 #define INTERFACE_FLAGS     (OPTST_DISABLED | OPTST_STACKED \
         | OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
 
-/*
+/**
  *  keyfile option description:
  */
+/** Descriptive text for the keyfile option */
 #define KEYFILE_DESC      (ntpd_opt_strs+1607)
+/** Upper-cased name for the keyfile option */
 #define KEYFILE_NAME      (ntpd_opt_strs+1630)
+/** Name string for the keyfile option */
 #define KEYFILE_name      (ntpd_opt_strs+1638)
+/** Compiled in flag settings for the keyfile option */
 #define KEYFILE_FLAGS     (OPTST_DISABLED \
         | OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
 
-/*
+/**
  *  logfile option description:
  */
+/** Descriptive text for the logfile option */
 #define LOGFILE_DESC      (ntpd_opt_strs+1646)
+/** Upper-cased name for the logfile option */
 #define LOGFILE_NAME      (ntpd_opt_strs+1667)
+/** Name string for the logfile option */
 #define LOGFILE_name      (ntpd_opt_strs+1675)
+/** Compiled in flag settings for the logfile option */
 #define LOGFILE_FLAGS     (OPTST_DISABLED \
         | OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
 
-/*
+/**
  *  novirtualips option description:
  */
+/** Descriptive text for the novirtualips option */
 #define NOVIRTUALIPS_DESC      (ntpd_opt_strs+1683)
+/** Upper-cased name for the novirtualips option */
 #define NOVIRTUALIPS_NAME      (ntpd_opt_strs+1719)
+/** Name string for the novirtualips option */
 #define NOVIRTUALIPS_name      (ntpd_opt_strs+1732)
+/** Compiled in flag settings for the novirtualips option */
 #define NOVIRTUALIPS_FLAGS     (OPTST_DISABLED)
 
-/*
+/**
  *  modifymmtimer option description:
  */
 #ifdef SYS_WINNT
+/** Descriptive text for the modifymmtimer option */
 #define MODIFYMMTIMER_DESC      (ntpd_opt_strs+1745)
+/** Upper-cased name for the modifymmtimer option */
 #define MODIFYMMTIMER_NAME      (ntpd_opt_strs+1784)
+/** Name string for the modifymmtimer option */
 #define MODIFYMMTIMER_name      (ntpd_opt_strs+1798)
+/** Compiled in flag settings for the modifymmtimer option */
 #define MODIFYMMTIMER_FLAGS     (OPTST_DISABLED)
 
 #else   /* disable modifymmtimer */
@@ -371,75 +440,106 @@ static int const aAuthnoreqCantList[] = {
 #define MODIFYMMTIMER_name      NULL
 #endif  /* SYS_WINNT */
 
-/*
+/**
  *  nofork option description with
  *  "Must also have options" and "Incompatible options":
  */
+/** Descriptive text for the nofork option */
 #define NOFORK_DESC      (ntpd_opt_strs+1812)
+/** Upper-cased name for the nofork option */
 #define NOFORK_NAME      (ntpd_opt_strs+1824)
+/** Name string for the nofork option */
 #define NOFORK_name      (ntpd_opt_strs+1831)
+/** Other options that appear in conjunction with the nofork option */
 static int const aNoforkCantList[] = {
     INDEX_OPT_WAIT_SYNC, NO_EQUIVALENT };
+/** Compiled in flag settings for the nofork option */
 #define NOFORK_FLAGS     (OPTST_DISABLED)
 
-/*
+/**
  *  nice option description:
  */
+/** Descriptive text for the nice option */
 #define NICE_DESC      (ntpd_opt_strs+1838)
+/** Upper-cased name for the nice option */
 #define NICE_NAME      (ntpd_opt_strs+1859)
+/** Name string for the nice option */
 #define NICE_name      (ntpd_opt_strs+1864)
+/** Compiled in flag settings for the nice option */
 #define NICE_FLAGS     (OPTST_DISABLED)
 
-/*
+/**
  *  pidfile option description:
  */
+/** Descriptive text for the pidfile option */
 #define PIDFILE_DESC      (ntpd_opt_strs+1869)
+/** Upper-cased name for the pidfile option */
 #define PIDFILE_NAME      (ntpd_opt_strs+1890)
+/** Name string for the pidfile option */
 #define PIDFILE_name      (ntpd_opt_strs+1898)
+/** Compiled in flag settings for the pidfile option */
 #define PIDFILE_FLAGS     (OPTST_DISABLED \
         | OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
 
-/*
+/**
  *  priority option description:
  */
+/** Descriptive text for the priority option */
 #define PRIORITY_DESC      (ntpd_opt_strs+1906)
+/** Upper-cased name for the priority option */
 #define PRIORITY_NAME      (ntpd_opt_strs+1923)
+/** Name string for the priority option */
 #define PRIORITY_name      (ntpd_opt_strs+1932)
+/** Compiled in flag settings for the priority option */
 #define PRIORITY_FLAGS     (OPTST_DISABLED \
         | OPTST_SET_ARGTYPE(OPARG_TYPE_NUMERIC))
 
-/*
+/**
  *  quit option description with
  *  "Must also have options" and "Incompatible options":
  */
+/** Descriptive text for the quit option */
 #define QUIT_DESC      (ntpd_opt_strs+1941)
+/** Upper-cased name for the quit option */
 #define QUIT_NAME      (ntpd_opt_strs+1963)
+/** Name string for the quit option */
 #define QUIT_name      (ntpd_opt_strs+1968)
+/** Other options that appear in conjunction with the quit option */
 static int const aQuitCantList[] = {
     INDEX_OPT_SAVECONFIGQUIT,
     INDEX_OPT_WAIT_SYNC, NO_EQUIVALENT };
+/** Compiled in flag settings for the quit option */
 #define QUIT_FLAGS     (OPTST_DISABLED)
 
-/*
+/**
  *  propagationdelay option description:
  */
+/** Descriptive text for the propagationdelay option */
 #define PROPAGATIONDELAY_DESC      (ntpd_opt_strs+1973)
+/** Upper-cased name for the propagationdelay option */
 #define PROPAGATIONDELAY_NAME      (ntpd_opt_strs+2001)
+/** Name string for the propagationdelay option */
 #define PROPAGATIONDELAY_name      (ntpd_opt_strs+2018)
+/** Compiled in flag settings for the propagationdelay option */
 #define PROPAGATIONDELAY_FLAGS     (OPTST_DISABLED \
         | OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
 
-/*
+/**
  *  saveconfigquit option description with
  *  "Must also have options" and "Incompatible options":
  */
 #ifdef SAVECONFIG
+/** Descriptive text for the saveconfigquit option */
 #define SAVECONFIGQUIT_DESC      (ntpd_opt_strs+2035)
+/** Upper-cased name for the saveconfigquit option */
 #define SAVECONFIGQUIT_NAME      (ntpd_opt_strs+2070)
+/** Name string for the saveconfigquit option */
 #define SAVECONFIGQUIT_name      (ntpd_opt_strs+2085)
+/** Other options that appear in conjunction with the saveconfigquit option */
 static int const aSaveconfigquitCantList[] = {
     INDEX_OPT_QUIT,
     INDEX_OPT_WAIT_SYNC, NO_EQUIVALENT };
+/** Compiled in flag settings for the saveconfigquit option */
 #define SAVECONFIGQUIT_FLAGS     (OPTST_DISABLED \
         | OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
 
@@ -451,80 +551,110 @@ static int const aSaveconfigquitCantList[] = {
 #define SAVECONFIGQUIT_name      NULL
 #endif  /* SAVECONFIG */
 
-/*
+/**
  *  statsdir option description:
  */
+/** Descriptive text for the statsdir option */
 #define STATSDIR_DESC      (ntpd_opt_strs+2100)
+/** Upper-cased name for the statsdir option */
 #define STATSDIR_NAME      (ntpd_opt_strs+2125)
+/** Name string for the statsdir option */
 #define STATSDIR_name      (ntpd_opt_strs+2134)
+/** Compiled in flag settings for the statsdir option */
 #define STATSDIR_FLAGS     (OPTST_DISABLED \
         | OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
 
-/*
+/**
  *  trustedkey option description:
  */
+/** Descriptive text for the trustedkey option */
 #define TRUSTEDKEY_DESC      (ntpd_opt_strs+2143)
+/** Upper-cased name for the trustedkey option */
 #define TRUSTEDKEY_NAME      (ntpd_opt_strs+2162)
+/** Name string for the trustedkey option */
 #define TRUSTEDKEY_name      (ntpd_opt_strs+2173)
+/** Compiled in flag settings for the trustedkey option */
 #define TRUSTEDKEY_FLAGS     (OPTST_DISABLED | OPTST_STACKED \
         | OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
 
-/*
+/**
  *  user option description:
  */
 #ifdef HAVE_DROPROOT
+/** Descriptive text for the user option */
 #define USER_DESC      (ntpd_opt_strs+2184)
+/** Upper-cased name for the user option */
 #define USER_NAME      (ntpd_opt_strs+2218)
+/** Name string for the user option */
 #define USER_name      (ntpd_opt_strs+2223)
+/** Compiled in flag settings for the user option */
 #define USER_FLAGS     (OPTST_DISABLED \
         | OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
 
 #else   /* disable user */
 #define USER_FLAGS     (OPTST_OMITTED | OPTST_NO_INIT)
 #define USER_NAME      NULL
+/** Descriptive text for the user option */
 #define USER_DESC      (ntpd_opt_strs+1494)
 #define USER_name      (ntpd_opt_strs+2223)
 #endif  /* HAVE_DROPROOT */
 
-/*
+/**
  *  updateinterval option description:
  */
+/** Descriptive text for the updateinterval option */
 #define UPDATEINTERVAL_DESC      (ntpd_opt_strs+2228)
+/** Upper-cased name for the updateinterval option */
 #define UPDATEINTERVAL_NAME      (ntpd_opt_strs+2292)
+/** Name string for the updateinterval option */
 #define UPDATEINTERVAL_name      (ntpd_opt_strs+2307)
+/** Compiled in flag settings for the updateinterval option */
 #define UPDATEINTERVAL_FLAGS     (OPTST_DISABLED \
         | OPTST_SET_ARGTYPE(OPARG_TYPE_NUMERIC))
 
-/*
+/**
  *  var option description:
  */
+/** Descriptive text for the var option */
 #define VAR_DESC      (ntpd_opt_strs+2322)
+/** Upper-cased name for the var option */
 #define VAR_NAME      (ntpd_opt_strs+2352)
+/** Name string for the var option */
 #define VAR_name      (ntpd_opt_strs+2356)
+/** Compiled in flag settings for the var option */
 #define VAR_FLAGS     (OPTST_DISABLED | OPTST_STACKED \
         | OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
 
-/*
+/**
  *  dvar option description:
  */
+/** Descriptive text for the dvar option */
 #define DVAR_DESC      (ntpd_opt_strs+2360)
+/** Upper-cased name for the dvar option */
 #define DVAR_NAME      (ntpd_opt_strs+2394)
+/** Name string for the dvar option */
 #define DVAR_name      (ntpd_opt_strs+2399)
+/** Compiled in flag settings for the dvar option */
 #define DVAR_FLAGS     (OPTST_DISABLED | OPTST_STACKED \
         | OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
 
-/*
+/**
  *  wait-sync option description with
  *  "Must also have options" and "Incompatible options":
  */
 #ifdef HAVE_WORKING_FORK
+/** Descriptive text for the wait-sync option */
 #define WAIT_SYNC_DESC      (ntpd_opt_strs+2404)
+/** Upper-cased name for the wait-sync option */
 #define WAIT_SYNC_NAME      (ntpd_opt_strs+2441)
+/** Name string for the wait-sync option */
 #define WAIT_SYNC_name      (ntpd_opt_strs+2451)
+/** Other options that appear in conjunction with the wait-sync option */
 static int const aWait_SyncCantList[] = {
     INDEX_OPT_NOFORK,
     INDEX_OPT_QUIT,
     INDEX_OPT_SAVECONFIGQUIT, NO_EQUIVALENT };
+/** Compiled in flag settings for the wait-sync option */
 #define WAIT_SYNC_FLAGS     (OPTST_DISABLED \
         | OPTST_SET_ARGTYPE(OPARG_TYPE_NUMERIC))
 
@@ -536,21 +666,29 @@ static int const aWait_SyncCantList[] = {
 #define WAIT_SYNC_name      NULL
 #endif  /* HAVE_WORKING_FORK */
 
-/*
+/**
  *  slew option description:
  */
+/** Descriptive text for the slew option */
 #define SLEW_DESC      (ntpd_opt_strs+2461)
+/** Upper-cased name for the slew option */
 #define SLEW_NAME      (ntpd_opt_strs+2484)
+/** Name string for the slew option */
 #define SLEW_name      (ntpd_opt_strs+2489)
+/** Compiled in flag settings for the slew option */
 #define SLEW_FLAGS     (OPTST_DISABLED)
 
-/*
+/**
  *  usepcc option description:
  */
 #ifdef SYS_WINNT
+/** Descriptive text for the usepcc option */
 #define USEPCC_DESC      (ntpd_opt_strs+2494)
+/** Upper-cased name for the usepcc option */
 #define USEPCC_NAME      (ntpd_opt_strs+2531)
+/** Name string for the usepcc option */
 #define USEPCC_name      (ntpd_opt_strs+2538)
+/** Compiled in flag settings for the usepcc option */
 #define USEPCC_FLAGS     (OPTST_DISABLED)
 
 #else   /* disable usepcc */
@@ -560,13 +698,17 @@ static int const aWait_SyncCantList[] = {
 #define USEPCC_name      NULL
 #endif  /* SYS_WINNT */
 
-/*
+/**
  *  pccfreq option description:
  */
 #ifdef SYS_WINNT
+/** Descriptive text for the pccfreq option */
 #define PCCFREQ_DESC      (ntpd_opt_strs+2545)
+/** Upper-cased name for the pccfreq option */
 #define PCCFREQ_NAME      (ntpd_opt_strs+2588)
+/** Name string for the pccfreq option */
 #define PCCFREQ_name      (ntpd_opt_strs+2596)
+/** Compiled in flag settings for the pccfreq option */
 #define PCCFREQ_FLAGS     (OPTST_DISABLED \
         | OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
 
@@ -577,13 +719,17 @@ static int const aWait_SyncCantList[] = {
 #define PCCFREQ_name      NULL
 #endif  /* SYS_WINNT */
 
-/*
+/**
  *  mdns option description:
  */
 #ifdef HAVE_DNSREGISTRATION
+/** Descriptive text for the mdns option */
 #define MDNS_DESC      (ntpd_opt_strs+2604)
+/** Upper-cased name for the mdns option */
 #define MDNS_NAME      (ntpd_opt_strs+2639)
+/** Name string for the mdns option */
 #define MDNS_name      (ntpd_opt_strs+2644)
+/** Compiled in flag settings for the mdns option */
 #define MDNS_FLAGS     (OPTST_DISABLED)
 
 #else   /* disable mdns */
@@ -615,7 +761,7 @@ static int const aWait_SyncCantList[] = {
 #endif
 #define VER_DESC        (ntpd_opt_strs+2753)
 #define VER_name        (ntpd_opt_strs+2789)
-/*
+/**
  *  Declare option callback procedures
  */
 #if defined(TEST_NTPD_OPTS)
@@ -644,7 +790,7 @@ extern tOptProc
 static tOptProc
     doOptDebug_Level, doUsageOpt;
 
-/*
+/**
  *  #define map the "normal" callout procs
  */
 #define DEBUG_LEVEL_OPT_PROC doOptDebug_Level
@@ -1107,19 +1253,24 @@ static tOptDesc optDesc[OPTION_CT] = {
 };
 
 
-/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
- *
- *  Define the ntpd Option Environment
- */
+/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
+/** Reference to the upper cased version of ntpd. */
 #define zPROGNAME       (ntpd_opt_strs+2797)
+/** Reference to the title line for ntpd usage. */
 #define zUsageTitle     (ntpd_opt_strs+2802)
+/** There is no ntpd configuration file. */
 #define zRcName         NULL
+/** There are no directories to search for ntpd config files. */
 #define apzHomeList     NULL
+/** The ntpd program bug email address. */
 #define zBugsAddr       (ntpd_opt_strs+2935)
+/** Clarification/explanation of what ntpd does. */
 #define zExplain        (ntpd_opt_strs+2969)
+/** Extra detail explaining what ntpd does. */
 #define zDetail         (NULL)
+/** The full version string for ntpd. */
 #define zFullVersion    (ntpd_opt_strs+2971)
-/* extracted from optcode.tlib near line 364 */
+/* extracted from optcode.tlib near line 371 */
 
 #if defined(ENABLE_NLS)
 # define OPTPROC_BASE OPTPROC_TRANSLATE
@@ -1140,8 +1291,8 @@ static tOptDesc optDesc[OPTION_CT] = {
 /**
  * The callout function that invokes the optionUsage function.
  *
- * @param pOptions the AutoOpts option description structure
- * @param pOptDesc the descriptor for the "help" (usage) option.
+ * @param[in] pOptions the AutoOpts option description structure
+ * @param[in] pOptDesc the descriptor for the "help" (usage) option.
  * @noreturn
  */
 static void
@@ -1159,8 +1310,8 @@ doUsageOpt(tOptions * pOptions, tOptDesc * pOptDesc)
 /**
  * Code to handle the debug-level option.
  *
- * @param pOptions the ntpd options data structure
- * @param pOptDesc the option descriptor for this option.
+ * @param[in] pOptions the ntpd options data structure
+ * @param[in,out] pOptDesc the option descriptor for this option.
  */
 static void
 doOptDebug_Level(tOptions* pOptions, tOptDesc* pOptDesc)
@@ -1187,8 +1338,8 @@ extern void optionPutShell(tOptions*);
  * Generated main procedure.  This will emit text that a Bourne shell can
  * process to handle its command line arguments.
  *
- * @param argc argument count
- * @param argv argument vector
+ * @param[in] argc argument count
+ * @param[in] argv argument vector
  * @returns program exit code
  */
 int
@@ -1219,6 +1370,7 @@ main(int argc, char ** argv)
 #ifndef  WITH_PACKAGER
 # define ntpd_packager_info NULL
 #else
+/** Packager information for ntpd. */
 static char const ntpd_packager_info[] =
     "Packaged by " WITH_PACKAGER
 
@@ -1272,7 +1424,7 @@ tOptions ntpdOptions = {
 };
 
 #if ENABLE_NLS
-/*
+/**
  * This code is designed to translate translatable option text for the
  * ntpd program.  These translations happen upon entry
  * to optionProcess().
@@ -1381,6 +1533,7 @@ translate_option_strings(void)
 #endif /* ENABLE_NLS */
 
 #ifdef DO_NOT_COMPILE_THIS_CODE_IT_IS_FOR_GETTEXT
+/** I18N function strictly for xgettext.  Do not compile. */
 static void bogus_function(void) {
   /* TRANSLATORS:
 
@@ -1399,7 +1552,7 @@ static void bogus_function(void) {
      translate option names.
    */
   /* referenced via ntpdOptions.pzCopyright */
-  puts(_("ntpd 4.2.7p357\n\
+  puts(_("ntpd 4.2.7p358\n\
 Copyright (C) 1970-2013 The University of Delaware, all rights reserved.\n\
 This is free software. It is licensed for use, modification and\n\
 redistribution under the terms of the NTP License, copies of which\n\
@@ -1536,7 +1689,7 @@ provided \"as is\" without express or implied warranty.\n"));
   puts(_("output version information and exit"));
 
   /* referenced via ntpdOptions.pzUsageTitle */
-  puts(_("ntpd - NTP daemon program - Ver. 4.2.7p357\n\
+  puts(_("ntpd - NTP daemon program - Ver. 4.2.7p358\n\
 Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \\\n\
 \t\t[ <server1> ... <serverN> ]\n"));
 
@@ -1544,7 +1697,7 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \\\n\
   puts(_("\n"));
 
   /* referenced via ntpdOptions.pzFullVersion */
-  puts(_("ntpd 4.2.7p357"));
+  puts(_("ntpd 4.2.7p358"));
 
   /* referenced via ntpdOptions.pzFullUsage */
   puts(_("<<<NOT-FOUND>>>"));
@@ -1579,7 +1732,7 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \\\n\
   puts(_("could not locate the 'help' option"));
 #line 351 "../autoopts.c"
   puts(_("optionProcess() was called with invalid data"));
-#line 770 "../usage.c"
+#line 783 "../usage.c"
   puts(_("invalid argument type specified"));
 #line 589 "../find.c"
   puts(_("defaulted to option with optional arg"));
@@ -1628,9 +1781,9 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \\\n\
   puts(_("  or an integer from %d through %d\n"));
 #line 164 "../enum.c"
   puts(_("  or an integer from %d through %d\n"));
-#line 769 "../usage.c"
+#line 782 "../usage.c"
   puts(_("%s error:  invalid option descriptor for %s\n"));
-#line 1097 "../usage.c"
+#line 1110 "../usage.c"
   puts(_("%s error:  invalid option descriptor for %s\n"));
 #line 379 "../find.c"
   puts(_("%s: invalid option name: %s\n"));
@@ -1638,7 +1791,7 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \\\n\
   puts(_("%s: The '%s' option requires an argument.\n"));
 #line 171 "../autoopts.c"
   puts(_("(AutoOpts bug):  Equivalenced option '%s' was equivalenced to both\n"
-       "\t'%s' and '%s'"));
+       "\t'%s' and '%s'."));
 #line 94 "../check.c"
   puts(_("%s error:  The %s option is required\n"));
 #line 623 "../find.c"
@@ -1666,7 +1819,7 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \\\n\
 #line 53 "../time.c"
   puts(_("%s error:  '%s' is not a recognizable time duration.\n"));
 #line 92 "../check.c"
-  puts(_("%s error:  The %s option must appear %d times\n"));
+  puts(_("%s error:  The %s option must appear %d times.\n"));
 #line 157 "../numeric.c"
   puts(_("%s error:  '%s' is not a recognizable number.\n"));
 #line 195 "../enum.c"
@@ -1683,7 +1836,7 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \\\n\
   puts(_("standard output"));
 #line 451 "../usage.c"
   puts(_("standard output"));
-#line 647 "../usage.c"
+#line 660 "../usage.c"
   puts(_("standard output"));
 #line 175 "../version.c"
   puts(_("standard output"));
@@ -1691,7 +1844,7 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \\\n\
   puts(_("standard error"));
 #line 451 "../usage.c"
   puts(_("standard error"));
-#line 647 "../usage.c"
+#line 660 "../usage.c"
   puts(_("standard error"));
 #line 175 "../version.c"
   puts(_("standard error"));
@@ -1703,7 +1856,7 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \\\n\
   puts(_("write"));
 #line 450 "../usage.c"
   puts(_("write"));
-#line 646 "../usage.c"
+#line 659 "../usage.c"
   puts(_("write"));
 #line 174 "../version.c"
   puts(_("write"));
@@ -1724,23 +1877,23 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \\\n\
   /* END-LIBOPTS-MESSAGES */
 
   /* USAGE-TEXT: */
-#line 895 "../usage.c"
+#line 908 "../usage.c"
   puts(_("\t\t\t\t- an alternate for '%s'\n"));
-#line 1164 "../usage.c"
+#line 1177 "../usage.c"
   puts(_("Version, usage and configuration options:"));
-#line 946 "../usage.c"
+#line 959 "../usage.c"
   puts(_("\t\t\t\t- default option for unnamed options\n"));
-#line 859 "../usage.c"
+#line 872 "../usage.c"
   puts(_("\t\t\t\t- disabled as '--%s'\n"));
-#line 1133 "../usage.c"
+#line 1146 "../usage.c"
   puts(_(" --- %-14s %s\n"));
-#line 1131 "../usage.c"
+#line 1144 "../usage.c"
   puts(_("This option has been disabled"));
-#line 886 "../usage.c"
+#line 899 "../usage.c"
   puts(_("\t\t\t\t- enabled by default\n"));
 #line 40 "../alias.c"
   puts(_("%s error:  only "));
-#line 1208 "../usage.c"
+#line 1221 "../usage.c"
   puts(_(" - examining environment variables named %s_*\n"));
 #line 168 "../file.c"
   puts(_("\t\t\t\t- file must not pre-exist\n"));
@@ -1756,31 +1909,31 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \\\n\
        "a shell script to parse the options for %s:\n\n"));
 #line 161 "../enum.c"
   puts(_("  or an integer mask with any of the lower %d bits set\n"));
-#line 919 "../usage.c"
+#line 932 "../usage.c"
   puts(_("\t\t\t\t- is a set membership option\n"));
-#line 940 "../usage.c"
+#line 953 "../usage.c"
   puts(_("\t\t\t\t- must appear between %d and %d times\n"));
 #line 418 "../usage.c"
   puts(_("Options are specified by single or double hyphens and their name.\n"));
-#line 926 "../usage.c"
+#line 939 "../usage.c"
   puts(_("\t\t\t\t- may appear multiple times\n"));
-#line 913 "../usage.c"
+#line 926 "../usage.c"
   puts(_("\t\t\t\t- may not be preset\n"));
-#line 1323 "../usage.c"
+#line 1336 "../usage.c"
   puts(_("   Arg Option-Name    Description\n"));
-#line 1259 "../usage.c"
+#line 1272 "../usage.c"
   puts(_("  Flg Arg Option-Name    Description\n"));
-#line 1317 "../usage.c"
+#line 1330 "../usage.c"
   puts(_("  Flg Arg Option-Name    Description\n"));
-#line 1318 "../usage.c"
+#line 1331 "../usage.c"
   puts(_(" %3s %s"));
-#line 1324 "../usage.c"
+#line 1337 "../usage.c"
   puts(_(" %3s %s"));
 #line 423 "../usage.c"
   puts(_("The '-#<number>' option may omit the hash char\n"));
 #line 419 "../usage.c"
   puts(_("All arguments are named options.\n"));
-#line 993 "../usage.c"
+#line 1006 "../usage.c"
   puts(_(" - reading file %s"));
 #line 445 "../usage.c"
   puts(_("\n"
@@ -1791,17 +1944,17 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \\\n\
 #line 129 "../version.c"
   puts(_("\n"
        "please send bug reports to:  <%s>\n"));
-#line 925 "../usage.c"
+#line 938 "../usage.c"
   puts(_("\t\t\t\t- may NOT appear - preset only\n"));
-#line 965 "../usage.c"
+#line 978 "../usage.c"
   puts(_("\n"
        "The following option preset mechanisms are supported:\n"));
-#line 1206 "../usage.c"
+#line 1219 "../usage.c"
   puts(_("\n"
        "The following option preset mechanisms are supported:\n"));
-#line 704 "../usage.c"
+#line 717 "../usage.c"
   puts(_("prohibits these options:\n"));
-#line 699 "../usage.c"
+#line 712 "../usage.c"
   puts(_("prohibits the option '%s'\n"));
 #line 81 "../numeric.c"
   puts(_("%s%ld to %ld"));
@@ -1821,26 +1974,26 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \\\n\
   puts(_("%sless than or equal to %ld"));
 #line 426 "../usage.c"
   puts(_("Operands and options may be intermixed.  They will be reordered.\n"));
-#line 674 "../usage.c"
+#line 687 "../usage.c"
   puts(_("requires the option '%s'\n"));
-#line 677 "../usage.c"
+#line 690 "../usage.c"
   puts(_("requires these options:\n"));
-#line 1335 "../usage.c"
+#line 1348 "../usage.c"
   puts(_("   Arg Option-Name   Req?  Description\n"));
-#line 1329 "../usage.c"
+#line 1342 "../usage.c"
   puts(_("  Flg Arg Option-Name   Req?  Description\n"));
 #line 162 "../enum.c"
   puts(_("or you may use a numeric representation.  Preceding these with a '!'\n"
        "will clear the bits, specifying 'none' will clear all bits, and 'all'\n"
        "will set them all.  Multiple entries may be passed as an option\n"
        "argument list.\n"));
-#line 932 "../usage.c"
+#line 945 "../usage.c"
   puts(_("\t\t\t\t- may appear up to %d times\n"));
 #line 72 "../enum.c"
   puts(_("The valid \"%s\" option keywords are:\n"));
-#line 1168 "../usage.c"
+#line 1181 "../usage.c"
   puts(_("The next option supports vendor supported extra options:"));
-#line 795 "../usage.c"
+#line 808 "../usage.c"
   puts(_("These additional options are:"));
   /* END-USAGE-TEXT */
 }
index cfe076b43843d64734be5d236c7faa802e8b56c4..380236e796b5aa834bdfaf52e858b86762384749 100644 (file)
@@ -1,7 +1,7 @@
 /*
  *  EDIT THIS FILE WITH CAUTION  (ntpd-opts.h)
  *
- *  It has been AutoGen-ed  February 22, 2013 at 03:25:39 AM by AutoGen 5.17.2pre17
+ *  It has been AutoGen-ed  February 27, 2013 at 11:34:30 AM by AutoGen 5.17.3.pre2
  *  From the definitions    ntpd-opts.def
  *  and the template file   options
  *
@@ -35,7 +35,7 @@
  *  representations about the suitability this software for any purpose. It
  *  is provided "as is" without express or implied warranty.
  */
-/*
+/**
  *  This file contains the programmatic interface to the Automated
  *  Options generated for the ntpd program.
  *  These macros are documented in the AutoGen info file in the
@@ -46,7 +46,7 @@
 #include "config.h"
 #include <autoopts/options.h>
 
-/*
+/**
  *  Ensure that the library used for compiling this generated header is at
  *  least as new as the version current when the header template was released
  *  (not counting patch version increments).  Also ensure that the oldest
@@ -60,8 +60,8 @@
   Choke Me.
 #endif
 
-/*
- *  Enumeration of each option:
+/**
+ *  Enumeration of each option type for ntpd
  */
 typedef enum {
     INDEX_OPT_IPV4              =  0,
@@ -102,34 +102,51 @@ typedef enum {
     INDEX_OPT_HELP              = 35,
     INDEX_OPT_MORE_HELP         = 36
 } teOptIndex;
-
+/** count of all options for ntpd */
 #define OPTION_CT    37
-#define NTPD_VERSION       "4.2.7p357"
-#define NTPD_FULL_VERSION  "ntpd 4.2.7p357"
+/** ntpd version */
+#define NTPD_VERSION       "4.2.7p358"
+/** Full ntpd version text */
+#define NTPD_FULL_VERSION  "ntpd 4.2.7p358"
 
-/*
+/**
  *  Interface defines for all options.  Replace "n" with the UPPER_CASED
  *  option name (as in the teOptIndex enumeration above).
  *  e.g. HAVE_OPT(IPV4)
  */
 #define         DESC(n) (ntpdOptions.pOptDesc[INDEX_OPT_## n])
+/** 'true' if an option has been specified in any way */
 #define     HAVE_OPT(n) (! UNUSED_OPT(& DESC(n)))
+/** The string argument to an option. The argument type must be "string". */
 #define      OPT_ARG(n) (DESC(n).optArg.argString)
+/** Mask the option state revealing how an option was specified.
+ *  It will be one and only one of \a OPTST_SET, \a OPTST_PRESET,
+ * \a OPTST_DEFINED, \a OPTST_RESET or zero.
+ */
 #define    STATE_OPT(n) (DESC(n).fOptState & OPTST_SET_MASK)
+/** Count of option's occurrances *on the command line*. */
 #define    COUNT_OPT(n) (DESC(n).optOccCt)
+/** mask of \a OPTST_SET and \a OPTST_DEFINED. */
 #define    ISSEL_OPT(n) (SELECTED_OPT(&DESC(n)))
+/** 'true' if \a HAVE_OPT would yield 'false'. */
 #define ISUNUSED_OPT(n) (UNUSED_OPT(& DESC(n)))
+/** 'true' if OPTST_DISABLED bit not set. */
 #define  ENABLED_OPT(n) (! DISABLED_OPT(& DESC(n)))
+/** number of stacked option arguments.
+ *  Valid only for stacked option arguments. */
 #define  STACKCT_OPT(n) (((tArgList*)(DESC(n).optCookie))->useCt)
+/** stacked argument vector.
+ *  Valid only for stacked option arguments. */
 #define STACKLST_OPT(n) (((tArgList*)(DESC(n).optCookie))->apzArgs)
+/** Reset an option. */
 #define    CLEAR_OPT(n) STMTS( \
                 DESC(n).fOptState &= OPTST_PERSISTENT_MASK;   \
                 if ((DESC(n).fOptState & OPTST_INITENABLED) == 0) \
                     DESC(n).fOptState |= OPTST_DISABLED; \
                 DESC(n).optCookie = NULL )
 
-/* * * * * *
- *
+/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
+/**
  *  Enumeration of ntpd exit codes
  */
 typedef enum {
@@ -138,7 +155,8 @@ typedef enum {
     NTPD_EXIT_USAGE_ERROR           = 64,
     NTPD_EXIT_LIBOPTS_FAILURE       = 70
 } ntpd_exit_code_t;
-/*
+/** @} */
+/**
  *  Make sure there are no #define name conflicts with the option names
  */
 #ifndef     NO_OPTION_NAME_WARNINGS
@@ -315,9 +333,10 @@ typedef enum {
 # undef MDNS
 #endif  /*  NO_OPTION_NAME_WARNINGS */
 
-/* * * * * *
- *
+/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
+/**
  *  Interface defines for specific options.
+ * @{
  */
 #define VALUE_OPT_IPV4           '4'
 #define VALUE_OPT_IPV6           '6'
@@ -362,8 +381,11 @@ typedef enum {
 #define VALUE_OPT_USEPCC         31
 #define VALUE_OPT_PCCFREQ        32
 #define VALUE_OPT_MDNS           'm'
+/** option flag (value) for " (get "val-name") " option */
 #define VALUE_OPT_HELP          '?'
+/** option flag (value) for " (get "val-name") " option */
 #define VALUE_OPT_MORE_HELP     '!'
+/** option flag (value) for " (get "val-name") " option */
 #define VALUE_OPT_VERSION       INDEX_OPT_VERSION
 /*
  *  Interface defines not associated with particular options
@@ -375,7 +397,7 @@ typedef enum {
                 ntpdOptions.pzCurOpt  = NULL)
 #define START_OPT       RESTART_OPT(1)
 #define USAGE(c)        (*ntpdOptions.pUsageProc)(&ntpdOptions, c)
-/* extracted from opthead.tlib near line 498 */
+/* extracted from opthead.tlib near line 538 */
 
 #ifdef  __cplusplus
 extern "C" {
index bf72c99175baacf432214ba5d1105429da79d292..eecc53745288efcae902742ddae3059961aa22fd 100644 (file)
@@ -1,8 +1,8 @@
-.TH ntpd 1ntpdman "22 Feb 2013" "4.2.7p357" "User Commands"
+.TH ntpd 1ntpdman "27 Feb 2013" "4.2.7p358" "User Commands"
 .\"
 .\"  EDIT THIS FILE WITH CAUTION  (ntpd-opts.man)
 .\"
-.\"  It has been AutoGen-ed  February 22, 2013 at 03:27:59 AM by AutoGen 5.17.2pre17
+.\"  It has been AutoGen-ed  February 27, 2013 at 11:36:56 AM by AutoGen 5.17.3.pre2
 .\"  From the definitions    ntpd-opts.def
 .\"  and the template file   agman-cmd.tpl
 .\"
@@ -928,7 +928,7 @@ mind.
 .PP
 Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
 .SH NOTES
-This document corresponds to version 4.2.7p357 of NTP.
+This document corresponds to version 4.2.7p358 of NTP.
 Portions of this document came from FreeBSD.
 .PP
 This manual page was \fIAutoGen\fP-erated from the \fBntpd\fP
index bc2aaf7f84071f9c4b8855bcd08b247bbe8297a2..0f9254047a322ac04ef920fb64e352f932140cf8 100644 (file)
@@ -1,9 +1,9 @@
-.Dd February 21 2013
+.Dd February 27 2013
 .Dt NTPD 1ntpdmdoc User Commands
 .Os SunOS 5.10
 .\"  EDIT THIS FILE WITH CAUTION  (ntpd-opts.mdoc)
 .\"
-.\"  It has been AutoGen-ed  February 21, 2013 at 10:46:30 PM by AutoGen 5.17.2pre17
+.\"  It has been AutoGen-ed  February 27, 2013 at 11:37:12 AM by AutoGen 5.17.3.pre2
 .\"  From the definitions    ntpd-opts.def
 .\"  and the template file   agmdoc-cmd.tpl
 .Sh NAME
@@ -895,7 +895,7 @@ mind.
 .Pp
 Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
 .Sh NOTES
-This document corresponds to version 4.2.7p357 of NTP.
+This document corresponds to version 4.2.7p358 of NTP.
 Portions of this document came from FreeBSD.
 .Pp
 This manual page was \fIAutoGen\fP\-erated from the \fBntpd\fP
index 2a99a447e173ec8150d5a41de6043c5ab4a24ee0..3f4babb031ceb86c22dbdf5b265b501937d24ec4 100644 (file)
@@ -39,7 +39,7 @@ The program can operate in any of several modes, including client/server,
 symmetric and broadcast modes, and with both symmetric-key and public-key
 cryptography.
 
-  <p>This document applies to version 4.2.7p357 of <code>ntpd</code>.
+  <p>This document applies to version 4.2.7p358 of <code>ntpd</code>.
 
 <ul class="menu">
 <li><a accesskey="1" href="#ntpd-Description">ntpd Description</a>:             Description
@@ -219,7 +219,7 @@ the usage text by passing it through a pager program.
 used to select the program, defaulting to <span class="file">more</span>.  Both will exit
 with a status code of 0.
 
-<pre class="example">ntpd - NTP daemon program - Ver. 4.2.7p356
+<pre class="example">ntpd - NTP daemon program - Ver. 4.2.7p357
 Usage:  ntpd [ -&lt;flag&gt; [&lt;val&gt;] | --&lt;name&gt;[{=| }&lt;val&gt;] ]... \
                 [ &lt;server1&gt; ... &lt;serverN&gt; ]
   Flg Arg Option-Name    Description
index 0f04fcf9dcb2b2a2cb5ff7c5f65e4aa77c0f7ed7..abff3a97a5f36a2888ac48d9aed98d5d4fd9334a 100644 (file)
@@ -1,8 +1,8 @@
-.TH ntpd @NTPD_MS@ "22 Feb 2013" "4.2.7p357" "User Commands"
+.TH ntpd @NTPD_MS@ "27 Feb 2013" "4.2.7p358" "User Commands"
 .\"
 .\"  EDIT THIS FILE WITH CAUTION  (ntpd-opts.man)
 .\"
-.\"  It has been AutoGen-ed  February 22, 2013 at 03:27:59 AM by AutoGen 5.17.2pre17
+.\"  It has been AutoGen-ed  February 27, 2013 at 11:36:56 AM by AutoGen 5.17.3.pre2
 .\"  From the definitions    ntpd-opts.def
 .\"  and the template file   agman-cmd.tpl
 .\"
@@ -928,7 +928,7 @@ mind.
 .PP
 Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
 .SH NOTES
-This document corresponds to version 4.2.7p357 of NTP.
+This document corresponds to version 4.2.7p358 of NTP.
 Portions of this document came from FreeBSD.
 .PP
 This manual page was \fIAutoGen\fP-erated from the \fBntpd\fP
index cb3e9bd855e61401564a65ddc9224c986e89916c..e3022608046bb3c9b8507bf6a4d357449d40847a 100644 (file)
@@ -1,9 +1,9 @@
-.Dd February 21 2013
+.Dd February 27 2013
 .Dt NTPD @NTPD_MS@ User Commands
 .Os SunOS 5.10
 .\"  EDIT THIS FILE WITH CAUTION  (ntpd-opts.mdoc)
 .\"
-.\"  It has been AutoGen-ed  February 21, 2013 at 10:46:30 PM by AutoGen 5.17.2pre17
+.\"  It has been AutoGen-ed  February 27, 2013 at 11:37:12 AM by AutoGen 5.17.3.pre2
 .\"  From the definitions    ntpd-opts.def
 .\"  and the template file   agmdoc-cmd.tpl
 .Sh NAME
@@ -895,7 +895,7 @@ mind.
 .Pp
 Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
 .Sh NOTES
-This document corresponds to version 4.2.7p357 of NTP.
+This document corresponds to version 4.2.7p358 of NTP.
 Portions of this document came from FreeBSD.
 .Pp
 This manual page was \fIAutoGen\fP\-erated from the \fBntpd\fP
index d2b333a5d022aeaa0272cd9d0f0ec5a1202dd51b..85cf4cd356f3596eaf6df0c2a563406c101f3c04 100644 (file)
@@ -6,7 +6,7 @@
 #
 # EDIT THIS FILE WITH CAUTION  (invoke-ntpdc.texi)
 #
-# It has been AutoGen-ed  February 21, 2013 at 10:46:57 PM by AutoGen 5.17.2pre17
+# It has been AutoGen-ed  February 27, 2013 at 11:37:41 AM by AutoGen 5.17.3.pre2
 # From the definitions    ntpdc-opts.def
 # and the template file   agtexi-cmd.tpl
 @end ignore
@@ -69,7 +69,7 @@ with a status code of 0.
 
 @exampleindent 0
 @example
-ntpdc - vendor-specific NTPD control program - Ver. 4.2.7p357
+ntpdc - vendor-specific NTPD control program - Ver. 4.2.7p358
 Usage:  ntpdc [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]... [ host ...]
   Flg Arg Option-Name    Description
    -4 no  ipv4           Force IPv4 DNS name resolution
index f9bf1e4c32cb82d94233a790b4a871df1ce1a00e..aed77aca8003e6267bf828243f3407b22999da93 100644 (file)
@@ -1,7 +1,7 @@
 /*
  *  EDIT THIS FILE WITH CAUTION  (ntpdc-opts.c)
  *
- *  It has been AutoGen-ed  February 21, 2013 at 10:46:41 PM by AutoGen 5.17.2pre17
+ *  It has been AutoGen-ed  February 27, 2013 at 11:37:25 AM by AutoGen 5.17.3.pre2
  *  From the definitions    ntpdc-opts.def
  *  and the template file   options
  *
@@ -65,11 +65,11 @@ extern FILE * option_usage_fp;
 #  define NULL 0
 #endif
 
-/*
- *  ntpdc option static const strings
+/**
+ *  static const strings for ntpdc options
  */
 static char const ntpdc_opt_strs[1861] =
-/*     0 */ "ntpdc 4.2.7p357\n"
+/*     0 */ "ntpdc 4.2.7p358\n"
             "Copyright (C) 1970-2013 The University of Delaware, all rights reserved.\n"
             "This is free software. It is licensed for use, modification and\n"
             "redistribution under the terms of the NTP License, copies of which\n"
@@ -127,116 +127,162 @@ static char const ntpdc_opt_strs[1861] =
 /*  1640 */ "no-load-opts\0"
 /*  1653 */ "no\0"
 /*  1656 */ "NTPDC\0"
-/*  1662 */ "ntpdc - vendor-specific NTPD control program - Ver. 4.2.7p357\n"
+/*  1662 */ "ntpdc - vendor-specific NTPD control program - Ver. 4.2.7p358\n"
             "Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ host ...]\n\0"
 /*  1794 */ "$HOME\0"
 /*  1800 */ ".\0"
 /*  1802 */ ".ntprc\0"
 /*  1809 */ "http://bugs.ntp.org, bugs@ntp.org\0"
 /*  1843 */ "\n\0"
-/*  1845 */ "ntpdc 4.2.7p357";
+/*  1845 */ "ntpdc 4.2.7p358";
 
-/*
+/**
  *  ipv4 option description with
  *  "Must also have options" and "Incompatible options":
  */
+/** Descriptive text for the ipv4 option */
 #define IPV4_DESC      (ntpdc_opt_strs+955)
+/** Upper-cased name for the ipv4 option */
 #define IPV4_NAME      (ntpdc_opt_strs+986)
+/** Name string for the ipv4 option */
 #define IPV4_name      (ntpdc_opt_strs+991)
+/** Other options that appear in conjunction with the ipv4 option */
 static int const aIpv4CantList[] = {
     INDEX_OPT_IPV6, NO_EQUIVALENT };
+/** Compiled in flag settings for the ipv4 option */
 #define IPV4_FLAGS     (OPTST_DISABLED)
 
-/*
+/**
  *  ipv6 option description with
  *  "Must also have options" and "Incompatible options":
  */
+/** Descriptive text for the ipv6 option */
 #define IPV6_DESC      (ntpdc_opt_strs+996)
+/** Upper-cased name for the ipv6 option */
 #define IPV6_NAME      (ntpdc_opt_strs+1027)
+/** Name string for the ipv6 option */
 #define IPV6_name      (ntpdc_opt_strs+1032)
+/** Other options that appear in conjunction with the ipv6 option */
 static int const aIpv6CantList[] = {
     INDEX_OPT_IPV4, NO_EQUIVALENT };
+/** Compiled in flag settings for the ipv6 option */
 #define IPV6_FLAGS     (OPTST_DISABLED)
 
-/*
+/**
  *  command option description:
  */
+/** Descriptive text for the command option */
 #define COMMAND_DESC      (ntpdc_opt_strs+1037)
+/** Upper-cased name for the command option */
 #define COMMAND_NAME      (ntpdc_opt_strs+1060)
+/** Name string for the command option */
 #define COMMAND_name      (ntpdc_opt_strs+1068)
+/** Compiled in flag settings for the command option */
 #define COMMAND_FLAGS     (OPTST_DISABLED | OPTST_STACKED \
         | OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
 
-/*
+/**
  *  debug-level option description:
  */
+/** Descriptive text for the debug-level option */
 #define DEBUG_LEVEL_DESC      (ntpdc_opt_strs+1076)
+/** Upper-cased name for the debug-level option */
 #define DEBUG_LEVEL_NAME      (ntpdc_opt_strs+1107)
+/** Name string for the debug-level option */
 #define DEBUG_LEVEL_name      (ntpdc_opt_strs+1119)
+/** Compiled in flag settings for the debug-level option */
 #define DEBUG_LEVEL_FLAGS     (OPTST_DISABLED)
 
-/*
+/**
  *  set-debug-level option description:
  */
+/** Descriptive text for the set-debug-level option */
 #define SET_DEBUG_LEVEL_DESC      (ntpdc_opt_strs+1131)
+/** Upper-cased name for the set-debug-level option */
 #define SET_DEBUG_LEVEL_NAME      (ntpdc_opt_strs+1161)
+/** Name string for the set-debug-level option */
 #define SET_DEBUG_LEVEL_name      (ntpdc_opt_strs+1177)
+/** Compiled in flag settings for the set-debug-level option */
 #define SET_DEBUG_LEVEL_FLAGS     (OPTST_DISABLED \
         | OPTST_SET_ARGTYPE(OPARG_TYPE_NUMERIC))
 
-/*
+/**
  *  interactive option description with
  *  "Must also have options" and "Incompatible options":
  */
+/** Descriptive text for the interactive option */
 #define INTERACTIVE_DESC      (ntpdc_opt_strs+1193)
+/** Upper-cased name for the interactive option */
 #define INTERACTIVE_NAME      (ntpdc_opt_strs+1235)
+/** Name string for the interactive option */
 #define INTERACTIVE_name      (ntpdc_opt_strs+1247)
+/** Other options that appear in conjunction with the interactive option */
 static int const aInteractiveCantList[] = {
     INDEX_OPT_COMMAND,
     INDEX_OPT_LISTPEERS,
     INDEX_OPT_PEERS,
     INDEX_OPT_SHOWPEERS, NO_EQUIVALENT };
+/** Compiled in flag settings for the interactive option */
 #define INTERACTIVE_FLAGS     (OPTST_DISABLED)
 
-/*
+/**
  *  listpeers option description with
  *  "Must also have options" and "Incompatible options":
  */
+/** Descriptive text for the listpeers option */
 #define LISTPEERS_DESC      (ntpdc_opt_strs+1259)
+/** Upper-cased name for the listpeers option */
 #define LISTPEERS_NAME      (ntpdc_opt_strs+1285)
+/** Name string for the listpeers option */
 #define LISTPEERS_name      (ntpdc_opt_strs+1295)
+/** Other options that appear in conjunction with the listpeers option */
 static int const aListpeersCantList[] = {
     INDEX_OPT_COMMAND, NO_EQUIVALENT };
+/** Compiled in flag settings for the listpeers option */
 #define LISTPEERS_FLAGS     (OPTST_DISABLED)
 
-/*
+/**
  *  numeric option description:
  */
+/** Descriptive text for the numeric option */
 #define NUMERIC_DESC      (ntpdc_opt_strs+1305)
+/** Upper-cased name for the numeric option */
 #define NUMERIC_NAME      (ntpdc_opt_strs+1328)
+/** Name string for the numeric option */
 #define NUMERIC_name      (ntpdc_opt_strs+1336)
+/** Compiled in flag settings for the numeric option */
 #define NUMERIC_FLAGS     (OPTST_DISABLED)
 
-/*
+/**
  *  peers option description with
  *  "Must also have options" and "Incompatible options":
  */
+/** Descriptive text for the peers option */
 #define PEERS_DESC      (ntpdc_opt_strs+1259)
+/** Upper-cased name for the peers option */
 #define PEERS_NAME      (ntpdc_opt_strs+1344)
+/** Name string for the peers option */
 #define PEERS_name      (ntpdc_opt_strs+1350)
+/** Other options that appear in conjunction with the peers option */
 static int const aPeersCantList[] = {
     INDEX_OPT_COMMAND, NO_EQUIVALENT };
+/** Compiled in flag settings for the peers option */
 #define PEERS_FLAGS     (OPTST_DISABLED)
 
-/*
+/**
  *  showpeers option description with
  *  "Must also have options" and "Incompatible options":
  */
+/** Descriptive text for the showpeers option */
 #define SHOWPEERS_DESC      (ntpdc_opt_strs+1356)
+/** Upper-cased name for the showpeers option */
 #define SHOWPEERS_NAME      (ntpdc_opt_strs+1381)
+/** Name string for the showpeers option */
 #define SHOWPEERS_name      (ntpdc_opt_strs+1391)
+/** Other options that appear in conjunction with the showpeers option */
 static int const aShowpeersCantList[] = {
     INDEX_OPT_COMMAND, NO_EQUIVALENT };
+/** Compiled in flag settings for the showpeers option */
 #define SHOWPEERS_FLAGS     (OPTST_DISABLED)
 
 /*
@@ -268,7 +314,7 @@ static int const aShowpeersCantList[] = {
 #define NO_LOAD_OPTS_name  (ntpdc_opt_strs+1640)
 #define LOAD_OPTS_pfx      (ntpdc_opt_strs+1653)
 #define LOAD_OPTS_name     (NO_LOAD_OPTS_name + 3)
-/*
+/**
  *  Declare option callback procedures
  */
 #if defined(TEST_NTPDC_OPTS)
@@ -297,7 +343,7 @@ extern tOptProc
 static tOptProc
     doOptDebug_Level, doUsageOpt;
 
-/*
+/**
  *  #define map the "normal" callout procs
  */
 #define DEBUG_LEVEL_OPT_PROC doOptDebug_Level
@@ -498,22 +544,27 @@ static tOptDesc optDesc[OPTION_CT] = {
 };
 
 
-/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
- *
- *  Define the ntpdc Option Environment
- */
+/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
+/** Reference to the upper cased version of ntpdc. */
 #define zPROGNAME       (ntpdc_opt_strs+1656)
+/** Reference to the title line for ntpdc usage. */
 #define zUsageTitle     (ntpdc_opt_strs+1662)
+/** ntpdc configuration file name. */
 #define zRcName         (ntpdc_opt_strs+1802)
+/** Directories to search for ntpdc config files. */
 static char const * const apzHomeList[3] = {
     ntpdc_opt_strs+1794,
     ntpdc_opt_strs+1800,
     NULL };
+/** The ntpdc program bug email address. */
 #define zBugsAddr       (ntpdc_opt_strs+1809)
+/** Clarification/explanation of what ntpdc does. */
 #define zExplain        (ntpdc_opt_strs+1843)
+/** Extra detail explaining what ntpdc does. */
 #define zDetail         (NULL)
+/** The full version string for ntpdc. */
 #define zFullVersion    (ntpdc_opt_strs+1845)
-/* extracted from optcode.tlib near line 364 */
+/* extracted from optcode.tlib near line 371 */
 
 #if defined(ENABLE_NLS)
 # define OPTPROC_BASE OPTPROC_TRANSLATE
@@ -534,8 +585,8 @@ static char const * const apzHomeList[3] = {
 /**
  * The callout function that invokes the optionUsage function.
  *
- * @param pOptions the AutoOpts option description structure
- * @param pOptDesc the descriptor for the "help" (usage) option.
+ * @param[in] pOptions the AutoOpts option description structure
+ * @param[in] pOptDesc the descriptor for the "help" (usage) option.
  * @noreturn
  */
 static void
@@ -553,8 +604,8 @@ doUsageOpt(tOptions * pOptions, tOptDesc * pOptDesc)
 /**
  * Code to handle the debug-level option.
  *
- * @param pOptions the ntpdc options data structure
- * @param pOptDesc the option descriptor for this option.
+ * @param[in] pOptions the ntpdc options data structure
+ * @param[in,out] pOptDesc the option descriptor for this option.
  */
 static void
 doOptDebug_Level(tOptions* pOptions, tOptDesc* pOptDesc)
@@ -581,8 +632,8 @@ extern void optionPutShell(tOptions*);
  * Generated main procedure.  This will emit text that a Bourne shell can
  * process to handle its command line arguments.
  *
- * @param argc argument count
- * @param argv argument vector
+ * @param[in] argc argument count
+ * @param[in] argv argument vector
  * @returns program exit code
  */
 int
@@ -613,6 +664,7 @@ main(int argc, char ** argv)
 #ifndef  WITH_PACKAGER
 # define ntpdc_packager_info NULL
 #else
+/** Packager information for ntpdc. */
 static char const ntpdc_packager_info[] =
     "Packaged by " WITH_PACKAGER
 
@@ -666,7 +718,7 @@ tOptions ntpdcOptions = {
 };
 
 #if ENABLE_NLS
-/*
+/**
  * This code is designed to translate translatable option text for the
  * ntpdc program.  These translations happen upon entry
  * to optionProcess().
@@ -775,6 +827,7 @@ translate_option_strings(void)
 #endif /* ENABLE_NLS */
 
 #ifdef DO_NOT_COMPILE_THIS_CODE_IT_IS_FOR_GETTEXT
+/** I18N function strictly for xgettext.  Do not compile. */
 static void bogus_function(void) {
   /* TRANSLATORS:
 
@@ -793,7 +846,7 @@ static void bogus_function(void) {
      translate option names.
    */
   /* referenced via ntpdcOptions.pzCopyright */
-  puts(_("ntpdc 4.2.7p357\n\
+  puts(_("ntpdc 4.2.7p358\n\
 Copyright (C) 1970-2013 The University of Delaware, all rights reserved.\n\
 This is free software. It is licensed for use, modification and\n\
 redistribution under the terms of the NTP License, copies of which\n\
@@ -858,14 +911,14 @@ provided \"as is\" without express or implied warranty.\n"));
   puts(_("load options from a config file"));
 
   /* referenced via ntpdcOptions.pzUsageTitle */
-  puts(_("ntpdc - vendor-specific NTPD control program - Ver. 4.2.7p357\n\
+  puts(_("ntpdc - vendor-specific NTPD control program - Ver. 4.2.7p358\n\
 Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ host ...]\n"));
 
   /* referenced via ntpdcOptions.pzExplain */
   puts(_("\n"));
 
   /* referenced via ntpdcOptions.pzFullVersion */
-  puts(_("ntpdc 4.2.7p357"));
+  puts(_("ntpdc 4.2.7p358"));
 
   /* referenced via ntpdcOptions.pzFullUsage */
   puts(_("<<<NOT-FOUND>>>"));
@@ -900,7 +953,7 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ host ...]\n"));
   puts(_("could not locate the 'help' option"));
 #line 351 "../autoopts.c"
   puts(_("optionProcess() was called with invalid data"));
-#line 770 "../usage.c"
+#line 783 "../usage.c"
   puts(_("invalid argument type specified"));
 #line 589 "../find.c"
   puts(_("defaulted to option with optional arg"));
@@ -949,9 +1002,9 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ host ...]\n"));
   puts(_("  or an integer from %d through %d\n"));
 #line 164 "../enum.c"
   puts(_("  or an integer from %d through %d\n"));
-#line 769 "../usage.c"
+#line 782 "../usage.c"
   puts(_("%s error:  invalid option descriptor for %s\n"));
-#line 1097 "../usage.c"
+#line 1110 "../usage.c"
   puts(_("%s error:  invalid option descriptor for %s\n"));
 #line 379 "../find.c"
   puts(_("%s: invalid option name: %s\n"));
@@ -959,7 +1012,7 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ host ...]\n"));
   puts(_("%s: The '%s' option requires an argument.\n"));
 #line 171 "../autoopts.c"
   puts(_("(AutoOpts bug):  Equivalenced option '%s' was equivalenced to both\n"
-       "\t'%s' and '%s'"));
+       "\t'%s' and '%s'."));
 #line 94 "../check.c"
   puts(_("%s error:  The %s option is required\n"));
 #line 623 "../find.c"
@@ -987,7 +1040,7 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ host ...]\n"));
 #line 53 "../time.c"
   puts(_("%s error:  '%s' is not a recognizable time duration.\n"));
 #line 92 "../check.c"
-  puts(_("%s error:  The %s option must appear %d times\n"));
+  puts(_("%s error:  The %s option must appear %d times.\n"));
 #line 157 "../numeric.c"
   puts(_("%s error:  '%s' is not a recognizable number.\n"));
 #line 195 "../enum.c"
@@ -1004,7 +1057,7 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ host ...]\n"));
   puts(_("standard output"));
 #line 451 "../usage.c"
   puts(_("standard output"));
-#line 647 "../usage.c"
+#line 660 "../usage.c"
   puts(_("standard output"));
 #line 175 "../version.c"
   puts(_("standard output"));
@@ -1012,7 +1065,7 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ host ...]\n"));
   puts(_("standard error"));
 #line 451 "../usage.c"
   puts(_("standard error"));
-#line 647 "../usage.c"
+#line 660 "../usage.c"
   puts(_("standard error"));
 #line 175 "../version.c"
   puts(_("standard error"));
@@ -1024,7 +1077,7 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ host ...]\n"));
   puts(_("write"));
 #line 450 "../usage.c"
   puts(_("write"));
-#line 646 "../usage.c"
+#line 659 "../usage.c"
   puts(_("write"));
 #line 174 "../version.c"
   puts(_("write"));
@@ -1045,23 +1098,23 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ host ...]\n"));
   /* END-LIBOPTS-MESSAGES */
 
   /* USAGE-TEXT: */
-#line 895 "../usage.c"
+#line 908 "../usage.c"
   puts(_("\t\t\t\t- an alternate for '%s'\n"));
-#line 1164 "../usage.c"
+#line 1177 "../usage.c"
   puts(_("Version, usage and configuration options:"));
-#line 946 "../usage.c"
+#line 959 "../usage.c"
   puts(_("\t\t\t\t- default option for unnamed options\n"));
-#line 859 "../usage.c"
+#line 872 "../usage.c"
   puts(_("\t\t\t\t- disabled as '--%s'\n"));
-#line 1133 "../usage.c"
+#line 1146 "../usage.c"
   puts(_(" --- %-14s %s\n"));
-#line 1131 "../usage.c"
+#line 1144 "../usage.c"
   puts(_("This option has been disabled"));
-#line 886 "../usage.c"
+#line 899 "../usage.c"
   puts(_("\t\t\t\t- enabled by default\n"));
 #line 40 "../alias.c"
   puts(_("%s error:  only "));
-#line 1208 "../usage.c"
+#line 1221 "../usage.c"
   puts(_(" - examining environment variables named %s_*\n"));
 #line 168 "../file.c"
   puts(_("\t\t\t\t- file must not pre-exist\n"));
@@ -1077,31 +1130,31 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ host ...]\n"));
        "a shell script to parse the options for %s:\n\n"));
 #line 161 "../enum.c"
   puts(_("  or an integer mask with any of the lower %d bits set\n"));
-#line 919 "../usage.c"
+#line 932 "../usage.c"
   puts(_("\t\t\t\t- is a set membership option\n"));
-#line 940 "../usage.c"
+#line 953 "../usage.c"
   puts(_("\t\t\t\t- must appear between %d and %d times\n"));
 #line 418 "../usage.c"
   puts(_("Options are specified by single or double hyphens and their name.\n"));
-#line 926 "../usage.c"
+#line 939 "../usage.c"
   puts(_("\t\t\t\t- may appear multiple times\n"));
-#line 913 "../usage.c"
+#line 926 "../usage.c"
   puts(_("\t\t\t\t- may not be preset\n"));
-#line 1323 "../usage.c"
+#line 1336 "../usage.c"
   puts(_("   Arg Option-Name    Description\n"));
-#line 1259 "../usage.c"
+#line 1272 "../usage.c"
   puts(_("  Flg Arg Option-Name    Description\n"));
-#line 1317 "../usage.c"
+#line 1330 "../usage.c"
   puts(_("  Flg Arg Option-Name    Description\n"));
-#line 1318 "../usage.c"
+#line 1331 "../usage.c"
   puts(_(" %3s %s"));
-#line 1324 "../usage.c"
+#line 1337 "../usage.c"
   puts(_(" %3s %s"));
 #line 423 "../usage.c"
   puts(_("The '-#<number>' option may omit the hash char\n"));
 #line 419 "../usage.c"
   puts(_("All arguments are named options.\n"));
-#line 993 "../usage.c"
+#line 1006 "../usage.c"
   puts(_(" - reading file %s"));
 #line 445 "../usage.c"
   puts(_("\n"
@@ -1112,17 +1165,17 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ host ...]\n"));
 #line 129 "../version.c"
   puts(_("\n"
        "please send bug reports to:  <%s>\n"));
-#line 925 "../usage.c"
+#line 938 "../usage.c"
   puts(_("\t\t\t\t- may NOT appear - preset only\n"));
-#line 965 "../usage.c"
+#line 978 "../usage.c"
   puts(_("\n"
        "The following option preset mechanisms are supported:\n"));
-#line 1206 "../usage.c"
+#line 1219 "../usage.c"
   puts(_("\n"
        "The following option preset mechanisms are supported:\n"));
-#line 704 "../usage.c"
+#line 717 "../usage.c"
   puts(_("prohibits these options:\n"));
-#line 699 "../usage.c"
+#line 712 "../usage.c"
   puts(_("prohibits the option '%s'\n"));
 #line 81 "../numeric.c"
   puts(_("%s%ld to %ld"));
@@ -1142,26 +1195,26 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ host ...]\n"));
   puts(_("%sless than or equal to %ld"));
 #line 426 "../usage.c"
   puts(_("Operands and options may be intermixed.  They will be reordered.\n"));
-#line 674 "../usage.c"
+#line 687 "../usage.c"
   puts(_("requires the option '%s'\n"));
-#line 677 "../usage.c"
+#line 690 "../usage.c"
   puts(_("requires these options:\n"));
-#line 1335 "../usage.c"
+#line 1348 "../usage.c"
   puts(_("   Arg Option-Name   Req?  Description\n"));
-#line 1329 "../usage.c"
+#line 1342 "../usage.c"
   puts(_("  Flg Arg Option-Name   Req?  Description\n"));
 #line 162 "../enum.c"
   puts(_("or you may use a numeric representation.  Preceding these with a '!'\n"
        "will clear the bits, specifying 'none' will clear all bits, and 'all'\n"
        "will set them all.  Multiple entries may be passed as an option\n"
        "argument list.\n"));
-#line 932 "../usage.c"
+#line 945 "../usage.c"
   puts(_("\t\t\t\t- may appear up to %d times\n"));
 #line 72 "../enum.c"
   puts(_("The valid \"%s\" option keywords are:\n"));
-#line 1168 "../usage.c"
+#line 1181 "../usage.c"
   puts(_("The next option supports vendor supported extra options:"));
-#line 795 "../usage.c"
+#line 808 "../usage.c"
   puts(_("These additional options are:"));
   /* END-USAGE-TEXT */
 }
index c6c8748a10cbc24155a0c3a8722792a4ebb52580..5afdc019e215a28481581add49787c22dddd48bd 100644 (file)
@@ -1,7 +1,7 @@
 /*
  *  EDIT THIS FILE WITH CAUTION  (ntpdc-opts.h)
  *
- *  It has been AutoGen-ed  February 21, 2013 at 10:46:41 PM by AutoGen 5.17.2pre17
+ *  It has been AutoGen-ed  February 27, 2013 at 11:37:25 AM by AutoGen 5.17.3.pre2
  *  From the definitions    ntpdc-opts.def
  *  and the template file   options
  *
@@ -35,7 +35,7 @@
  *  representations about the suitability this software for any purpose. It
  *  is provided "as is" without express or implied warranty.
  */
-/*
+/**
  *  This file contains the programmatic interface to the Automated
  *  Options generated for the ntpdc program.
  *  These macros are documented in the AutoGen info file in the
@@ -46,7 +46,7 @@
 #include "config.h"
 #include <autoopts/options.h>
 
-/*
+/**
  *  Ensure that the library used for compiling this generated header is at
  *  least as new as the version current when the header template was released
  *  (not counting patch version increments).  Also ensure that the oldest
@@ -60,8 +60,8 @@
   Choke Me.
 #endif
 
-/*
- *  Enumeration of each option:
+/**
+ *  Enumeration of each option type for ntpdc
  */
 typedef enum {
     INDEX_OPT_IPV4             =  0,
@@ -80,34 +80,51 @@ typedef enum {
     INDEX_OPT_SAVE_OPTS        = 13,
     INDEX_OPT_LOAD_OPTS        = 14
 } teOptIndex;
-
+/** count of all options for ntpdc */
 #define OPTION_CT    15
-#define NTPDC_VERSION       "4.2.7p357"
-#define NTPDC_FULL_VERSION  "ntpdc 4.2.7p357"
+/** ntpdc version */
+#define NTPDC_VERSION       "4.2.7p358"
+/** Full ntpdc version text */
+#define NTPDC_FULL_VERSION  "ntpdc 4.2.7p358"
 
-/*
+/**
  *  Interface defines for all options.  Replace "n" with the UPPER_CASED
  *  option name (as in the teOptIndex enumeration above).
  *  e.g. HAVE_OPT(IPV4)
  */
 #define         DESC(n) (ntpdcOptions.pOptDesc[INDEX_OPT_## n])
+/** 'true' if an option has been specified in any way */
 #define     HAVE_OPT(n) (! UNUSED_OPT(& DESC(n)))
+/** The string argument to an option. The argument type must be "string". */
 #define      OPT_ARG(n) (DESC(n).optArg.argString)
+/** Mask the option state revealing how an option was specified.
+ *  It will be one and only one of \a OPTST_SET, \a OPTST_PRESET,
+ * \a OPTST_DEFINED, \a OPTST_RESET or zero.
+ */
 #define    STATE_OPT(n) (DESC(n).fOptState & OPTST_SET_MASK)
+/** Count of option's occurrances *on the command line*. */
 #define    COUNT_OPT(n) (DESC(n).optOccCt)
+/** mask of \a OPTST_SET and \a OPTST_DEFINED. */
 #define    ISSEL_OPT(n) (SELECTED_OPT(&DESC(n)))
+/** 'true' if \a HAVE_OPT would yield 'false'. */
 #define ISUNUSED_OPT(n) (UNUSED_OPT(& DESC(n)))
+/** 'true' if OPTST_DISABLED bit not set. */
 #define  ENABLED_OPT(n) (! DISABLED_OPT(& DESC(n)))
+/** number of stacked option arguments.
+ *  Valid only for stacked option arguments. */
 #define  STACKCT_OPT(n) (((tArgList*)(DESC(n).optCookie))->useCt)
+/** stacked argument vector.
+ *  Valid only for stacked option arguments. */
 #define STACKLST_OPT(n) (((tArgList*)(DESC(n).optCookie))->apzArgs)
+/** Reset an option. */
 #define    CLEAR_OPT(n) STMTS( \
                 DESC(n).fOptState &= OPTST_PERSISTENT_MASK;   \
                 if ((DESC(n).fOptState & OPTST_INITENABLED) == 0) \
                     DESC(n).fOptState |= OPTST_DISABLED; \
                 DESC(n).optCookie = NULL )
 
-/* * * * * *
- *
+/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
+/**
  *  Enumeration of ntpdc exit codes
  */
 typedef enum {
@@ -117,7 +134,8 @@ typedef enum {
     NTPDC_EXIT_NO_CONFIG_INPUT      = 66,
     NTPDC_EXIT_LIBOPTS_FAILURE      = 70
 } ntpdc_exit_code_t;
-/*
+/** @} */
+/**
  *  Make sure there are no #define name conflicts with the option names
  */
 #ifndef     NO_OPTION_NAME_WARNINGS
@@ -174,9 +192,10 @@ typedef enum {
 # undef SHOWPEERS
 #endif  /*  NO_OPTION_NAME_WARNINGS */
 
-/* * * * * *
- *
+/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
+/**
  *  Interface defines for specific options.
+ * @{
  */
 #define VALUE_OPT_IPV4           '4'
 #define VALUE_OPT_IPV6           '6'
@@ -190,10 +209,15 @@ typedef enum {
 #define VALUE_OPT_NUMERIC        'n'
 #define VALUE_OPT_PEERS          'p'
 #define VALUE_OPT_SHOWPEERS      's'
+/** option flag (value) for " (get "val-name") " option */
 #define VALUE_OPT_HELP          '?'
+/** option flag (value) for " (get "val-name") " option */
 #define VALUE_OPT_MORE_HELP     '!'
+/** option flag (value) for " (get "val-name") " option */
 #define VALUE_OPT_VERSION       INDEX_OPT_VERSION
+/** option flag (value) for " (get "val-name") " option */
 #define VALUE_OPT_SAVE_OPTS     '>'
+/** option flag (value) for " (get "val-name") " option */
 #define VALUE_OPT_LOAD_OPTS     '<'
 #define SET_OPT_SAVE_OPTS(a)   STMTS( \
         DESC(SAVE_OPTS).fOptState &= OPTST_PERSISTENT_MASK; \
@@ -209,7 +233,7 @@ typedef enum {
                 ntpdcOptions.pzCurOpt  = NULL)
 #define START_OPT       RESTART_OPT(1)
 #define USAGE(c)        (*ntpdcOptions.pUsageProc)(&ntpdcOptions, c)
-/* extracted from opthead.tlib near line 498 */
+/* extracted from opthead.tlib near line 538 */
 
 #ifdef  __cplusplus
 extern "C" {
index e1e23f8e368d4edce340567bc30700c0d0d14174..2d36c3e72718c4f715877893db3875f893b3f8cc 100644 (file)
@@ -1,8 +1,8 @@
-.TH ntpdc 1ntpdcman "21 Feb 2013" "4.2.7p357" "User Commands"
+.TH ntpdc 1ntpdcman "27 Feb 2013" "4.2.7p358" "User Commands"
 .\"
 .\"  EDIT THIS FILE WITH CAUTION  (ntpdc-opts.man)
 .\"
-.\"  It has been AutoGen-ed  February 21, 2013 at 10:46:52 PM by AutoGen 5.17.2pre17
+.\"  It has been AutoGen-ed  February 27, 2013 at 11:37:37 AM by AutoGen 5.17.3.pre2
 .\"  From the definitions    ntpdc-opts.def
 .\"  and the template file   agman-cmd.tpl
 .\"
index ef61e8d3385abfe01a8cfc304f13b19d09c37a10..410276e5cc5f8818fee54abc4ebf0c223bca1737 100644 (file)
@@ -1,9 +1,9 @@
-.Dd February 21 2013
+.Dd February 27 2013
 .Dt NTPDC 1ntpdcmdoc User Commands
 .Os SunOS 5.10
 .\"  EDIT THIS FILE WITH CAUTION  (ntpdc-opts.mdoc)
 .\"
-.\"  It has been AutoGen-ed  February 21, 2013 at 10:46:59 PM by AutoGen 5.17.2pre17
+.\"  It has been AutoGen-ed  February 27, 2013 at 11:37:43 AM by AutoGen 5.17.3.pre2
 .\"  From the definitions    ntpdc-opts.def
 .\"  and the template file   agmdoc-cmd.tpl
 .Sh NAME
index 523dd95bd508207b43e9acd0aa628f037ce41674..64ffc80ba8de654e8729f23a38a478dbf138a5eb 100644 (file)
@@ -36,7 +36,7 @@ display the time offset of the system clock relative to the server
 clock.  Run as root, it can correct the system clock to this offset as
 well.  It can be run as an interactive command or from a cron job.
 
-  <p>This document applies to version 4.2.7p357 of <code>ntpdc</code>.
+  <p>This document applies to version 4.2.7p358 of <code>ntpdc</code>.
 
   <p>The program implements the SNTP protocol as defined by RFC 5905, the NTPv4
 IETF specification.
@@ -145,7 +145,7 @@ the usage text by passing it through a pager program.
 used to select the program, defaulting to <span class="file">more</span>.  Both will exit
 with a status code of 0.
 
-<pre class="example">ntpdc - vendor-specific NTPD control program - Ver. 4.2.7p357
+<pre class="example">ntpdc - vendor-specific NTPD control program - Ver. 4.2.7p358
 Usage:  ntpdc [ -&lt;flag&gt; [&lt;val&gt;] | --&lt;name&gt;[{=| }&lt;val&gt;] ]... [ host ...]
   Flg Arg Option-Name    Description
    -4 no  ipv4           Force IPv4 DNS name resolution
index 8070de4cccf4cc5906b63f2cca27dfd9447bb67d..307f3378f12a8dbb694f9fa722dacf1560fd9c94 100644 (file)
@@ -1,8 +1,8 @@
-.TH ntpdc @NTPDC_MS@ "21 Feb 2013" "4.2.7p357" "User Commands"
+.TH ntpdc @NTPDC_MS@ "27 Feb 2013" "4.2.7p358" "User Commands"
 .\"
 .\"  EDIT THIS FILE WITH CAUTION  (ntpdc-opts.man)
 .\"
-.\"  It has been AutoGen-ed  February 21, 2013 at 10:46:52 PM by AutoGen 5.17.2pre17
+.\"  It has been AutoGen-ed  February 27, 2013 at 11:37:37 AM by AutoGen 5.17.3.pre2
 .\"  From the definitions    ntpdc-opts.def
 .\"  and the template file   agman-cmd.tpl
 .\"
index 1a4b793a9b7dd27235371476e96402725a37999a..acd46b467bd8b57af4466576ea1fb964fecf5480 100644 (file)
@@ -1,9 +1,9 @@
-.Dd February 21 2013
+.Dd February 27 2013
 .Dt NTPDC @NTPDC_MS@ User Commands
 .Os SunOS 5.10
 .\"  EDIT THIS FILE WITH CAUTION  (ntpdc-opts.mdoc)
 .\"
-.\"  It has been AutoGen-ed  February 21, 2013 at 10:46:59 PM by AutoGen 5.17.2pre17
+.\"  It has been AutoGen-ed  February 27, 2013 at 11:37:43 AM by AutoGen 5.17.3.pre2
 .\"  From the definitions    ntpdc-opts.def
 .\"  and the template file   agmdoc-cmd.tpl
 .Sh NAME
index a5e7271614d5bdd266632b4d4fb07c1f2c8bb591..1a484a8d9f754d1ba78a6bbbc849d32911f1b884 100644 (file)
@@ -6,7 +6,7 @@
 #
 # EDIT THIS FILE WITH CAUTION  (invoke-ntpq.texi)
 #
-# It has been AutoGen-ed  February 21, 2013 at 10:47:28 PM by AutoGen 5.17.2pre17
+# It has been AutoGen-ed  February 27, 2013 at 11:38:12 AM by AutoGen 5.17.3.pre2
 # From the definitions    ntpq-opts.def
 # and the template file   agtexi-cmd.tpl
 @end ignore
@@ -290,7 +290,7 @@ with a status code of 0.
 
 @exampleindent 0
 @example
-ntpq - standard NTP query program - Ver. 4.2.7p357
+ntpq - standard NTP query program - Ver. 4.2.7p358
 Usage:  ntpq [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]... [ host ...]
   Flg Arg Option-Name    Description
    -4 no  ipv4           Force IPv4 DNS name resolution
index 43b3c32d19c9ed269c1e306d2c76ac66851cd5ef..bc9000a477d806bab7cf64f5da463eff3fa13921 100644 (file)
@@ -1,7 +1,7 @@
 /*
  *  EDIT THIS FILE WITH CAUTION  (ntpq-opts.c)
  *
- *  It has been AutoGen-ed  February 21, 2013 at 10:47:02 PM by AutoGen 5.17.2pre17
+ *  It has been AutoGen-ed  February 27, 2013 at 11:37:46 AM by AutoGen 5.17.3.pre2
  *  From the definitions    ntpq-opts.def
  *  and the template file   options
  *
@@ -65,11 +65,11 @@ extern FILE * option_usage_fp;
 #  define NULL 0
 #endif
 
-/*
- *  ntpq option static const strings
+/**
+ *  static const strings for ntpq options
  */
 static char const ntpq_opt_strs[1833] =
-/*     0 */ "ntpq 4.2.7p357\n"
+/*     0 */ "ntpq 4.2.7p358\n"
             "Copyright (C) 1970-2013 The University of Delaware, all rights reserved.\n"
             "This is free software. It is licensed for use, modification and\n"
             "redistribution under the terms of the NTP License, copies of which\n"
@@ -125,99 +125,139 @@ static char const ntpq_opt_strs[1833] =
 /*  1627 */ "no-load-opts\0"
 /*  1640 */ "no\0"
 /*  1643 */ "NTPQ\0"
-/*  1648 */ "ntpq - standard NTP query program - Ver. 4.2.7p357\n"
+/*  1648 */ "ntpq - standard NTP query program - Ver. 4.2.7p358\n"
             "Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ host ...]\n\0"
 /*  1769 */ "$HOME\0"
 /*  1775 */ ".\0"
 /*  1777 */ ".ntprc\0"
 /*  1784 */ "http://bugs.ntp.org, bugs@ntp.org\0"
-/*  1818 */ "ntpq 4.2.7p357";
+/*  1818 */ "ntpq 4.2.7p358";
 
-/*
+/**
  *  ipv4 option description with
  *  "Must also have options" and "Incompatible options":
  */
+/** Descriptive text for the ipv4 option */
 #define IPV4_DESC      (ntpq_opt_strs+954)
+/** Upper-cased name for the ipv4 option */
 #define IPV4_NAME      (ntpq_opt_strs+985)
+/** Name string for the ipv4 option */
 #define IPV4_name      (ntpq_opt_strs+990)
+/** Other options that appear in conjunction with the ipv4 option */
 static int const aIpv4CantList[] = {
     INDEX_OPT_IPV6, NO_EQUIVALENT };
+/** Compiled in flag settings for the ipv4 option */
 #define IPV4_FLAGS     (OPTST_DISABLED)
 
-/*
+/**
  *  ipv6 option description with
  *  "Must also have options" and "Incompatible options":
  */
+/** Descriptive text for the ipv6 option */
 #define IPV6_DESC      (ntpq_opt_strs+995)
+/** Upper-cased name for the ipv6 option */
 #define IPV6_NAME      (ntpq_opt_strs+1026)
+/** Name string for the ipv6 option */
 #define IPV6_name      (ntpq_opt_strs+1031)
+/** Other options that appear in conjunction with the ipv6 option */
 static int const aIpv6CantList[] = {
     INDEX_OPT_IPV4, NO_EQUIVALENT };
+/** Compiled in flag settings for the ipv6 option */
 #define IPV6_FLAGS     (OPTST_DISABLED)
 
-/*
+/**
  *  command option description:
  */
+/** Descriptive text for the command option */
 #define COMMAND_DESC      (ntpq_opt_strs+1036)
+/** Upper-cased name for the command option */
 #define COMMAND_NAME      (ntpq_opt_strs+1059)
+/** Name string for the command option */
 #define COMMAND_name      (ntpq_opt_strs+1067)
+/** Compiled in flag settings for the command option */
 #define COMMAND_FLAGS     (OPTST_DISABLED \
         | OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
 
-/*
+/**
  *  debug-level option description:
  */
+/** Descriptive text for the debug-level option */
 #define DEBUG_LEVEL_DESC      (ntpq_opt_strs+1075)
+/** Upper-cased name for the debug-level option */
 #define DEBUG_LEVEL_NAME      (ntpq_opt_strs+1106)
+/** Name string for the debug-level option */
 #define DEBUG_LEVEL_name      (ntpq_opt_strs+1118)
+/** Compiled in flag settings for the debug-level option */
 #define DEBUG_LEVEL_FLAGS     (OPTST_DISABLED)
 
-/*
+/**
  *  set-debug-level option description:
  */
+/** Descriptive text for the set-debug-level option */
 #define SET_DEBUG_LEVEL_DESC      (ntpq_opt_strs+1130)
+/** Upper-cased name for the set-debug-level option */
 #define SET_DEBUG_LEVEL_NAME      (ntpq_opt_strs+1160)
+/** Name string for the set-debug-level option */
 #define SET_DEBUG_LEVEL_name      (ntpq_opt_strs+1176)
+/** Compiled in flag settings for the set-debug-level option */
 #define SET_DEBUG_LEVEL_FLAGS     (OPTST_DISABLED \
         | OPTST_SET_ARGTYPE(OPARG_TYPE_NUMERIC))
 
-/*
+/**
  *  peers option description with
  *  "Must also have options" and "Incompatible options":
  */
+/** Descriptive text for the peers option */
 #define PEERS_DESC      (ntpq_opt_strs+1192)
+/** Upper-cased name for the peers option */
 #define PEERS_NAME      (ntpq_opt_strs+1218)
+/** Name string for the peers option */
 #define PEERS_name      (ntpq_opt_strs+1224)
+/** Other options that appear in conjunction with the peers option */
 static int const aPeersCantList[] = {
     INDEX_OPT_INTERACTIVE, NO_EQUIVALENT };
+/** Compiled in flag settings for the peers option */
 #define PEERS_FLAGS     (OPTST_DISABLED)
 
-/*
+/**
  *  interactive option description with
  *  "Must also have options" and "Incompatible options":
  */
+/** Descriptive text for the interactive option */
 #define INTERACTIVE_DESC      (ntpq_opt_strs+1230)
+/** Upper-cased name for the interactive option */
 #define INTERACTIVE_NAME      (ntpq_opt_strs+1272)
+/** Name string for the interactive option */
 #define INTERACTIVE_name      (ntpq_opt_strs+1284)
+/** Other options that appear in conjunction with the interactive option */
 static int const aInteractiveCantList[] = {
     INDEX_OPT_COMMAND,
     INDEX_OPT_PEERS, NO_EQUIVALENT };
+/** Compiled in flag settings for the interactive option */
 #define INTERACTIVE_FLAGS     (OPTST_DISABLED)
 
-/*
+/**
  *  numeric option description:
  */
+/** Descriptive text for the numeric option */
 #define NUMERIC_DESC      (ntpq_opt_strs+1296)
+/** Upper-cased name for the numeric option */
 #define NUMERIC_NAME      (ntpq_opt_strs+1319)
+/** Name string for the numeric option */
 #define NUMERIC_name      (ntpq_opt_strs+1327)
+/** Compiled in flag settings for the numeric option */
 #define NUMERIC_FLAGS     (OPTST_DISABLED)
 
-/*
+/**
  *  old-rv option description:
  */
+/** Descriptive text for the old-rv option */
 #define OLD_RV_DESC      (ntpq_opt_strs+1335)
+/** Upper-cased name for the old-rv option */
 #define OLD_RV_NAME      (ntpq_opt_strs+1374)
+/** Name string for the old-rv option */
 #define OLD_RV_name      (ntpq_opt_strs+1381)
+/** Compiled in flag settings for the old-rv option */
 #define OLD_RV_FLAGS     (OPTST_DISABLED)
 
 /*
@@ -249,7 +289,7 @@ static int const aInteractiveCantList[] = {
 #define NO_LOAD_OPTS_name  (ntpq_opt_strs+1627)
 #define LOAD_OPTS_pfx      (ntpq_opt_strs+1640)
 #define LOAD_OPTS_name     (NO_LOAD_OPTS_name + 3)
-/*
+/**
  *  Declare option callback procedures
  */
 #if defined(TEST_NTPQ_OPTS)
@@ -283,7 +323,7 @@ extern tOptProc
 static tOptProc
     doOptDebug_Level, doUsageOpt;
 
-/*
+/**
  *  #define map the "normal" callout procs
  */
 #define COMMAND_OPT_PROC ntpq_custom_opt_handler
@@ -474,22 +514,27 @@ static tOptDesc optDesc[OPTION_CT] = {
 };
 
 
-/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
- *
- *  Define the ntpq Option Environment
- */
+/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
+/** Reference to the upper cased version of ntpq. */
 #define zPROGNAME       (ntpq_opt_strs+1643)
+/** Reference to the title line for ntpq usage. */
 #define zUsageTitle     (ntpq_opt_strs+1648)
+/** ntpq configuration file name. */
 #define zRcName         (ntpq_opt_strs+1777)
+/** Directories to search for ntpq config files. */
 static char const * const apzHomeList[3] = {
     ntpq_opt_strs+1769,
     ntpq_opt_strs+1775,
     NULL };
+/** The ntpq program bug email address. */
 #define zBugsAddr       (ntpq_opt_strs+1784)
+/** Clarification/explanation of what ntpq does. */
 #define zExplain        (NULL)
+/** Extra detail explaining what ntpq does. */
 #define zDetail         (NULL)
+/** The full version string for ntpq. */
 #define zFullVersion    (ntpq_opt_strs+1818)
-/* extracted from optcode.tlib near line 364 */
+/* extracted from optcode.tlib near line 371 */
 
 #if defined(ENABLE_NLS)
 # define OPTPROC_BASE OPTPROC_TRANSLATE
@@ -510,8 +555,8 @@ static char const * const apzHomeList[3] = {
 /**
  * The callout function that invokes the optionUsage function.
  *
- * @param pOptions the AutoOpts option description structure
- * @param pOptDesc the descriptor for the "help" (usage) option.
+ * @param[in] pOptions the AutoOpts option description structure
+ * @param[in] pOptDesc the descriptor for the "help" (usage) option.
  * @noreturn
  */
 static void
@@ -529,8 +574,8 @@ doUsageOpt(tOptions * pOptions, tOptDesc * pOptDesc)
 /**
  * Code to handle the debug-level option.
  *
- * @param pOptions the ntpq options data structure
- * @param pOptDesc the option descriptor for this option.
+ * @param[in] pOptions the ntpq options data structure
+ * @param[in,out] pOptDesc the option descriptor for this option.
  */
 static void
 doOptDebug_Level(tOptions* pOptions, tOptDesc* pOptDesc)
@@ -557,8 +602,8 @@ extern void optionPutShell(tOptions*);
  * Generated main procedure.  This will emit text that a Bourne shell can
  * process to handle its command line arguments.
  *
- * @param argc argument count
- * @param argv argument vector
+ * @param[in] argc argument count
+ * @param[in] argv argument vector
  * @returns program exit code
  */
 int
@@ -589,6 +634,7 @@ main(int argc, char ** argv)
 #ifndef  WITH_PACKAGER
 # define ntpq_packager_info NULL
 #else
+/** Packager information for ntpq. */
 static char const ntpq_packager_info[] =
     "Packaged by " WITH_PACKAGER
 
@@ -642,7 +688,7 @@ tOptions ntpqOptions = {
 };
 
 #if ENABLE_NLS
-/*
+/**
  * This code is designed to translate translatable option text for the
  * ntpq program.  These translations happen upon entry
  * to optionProcess().
@@ -751,6 +797,7 @@ translate_option_strings(void)
 #endif /* ENABLE_NLS */
 
 #ifdef DO_NOT_COMPILE_THIS_CODE_IT_IS_FOR_GETTEXT
+/** I18N function strictly for xgettext.  Do not compile. */
 static void bogus_function(void) {
   /* TRANSLATORS:
 
@@ -769,7 +816,7 @@ static void bogus_function(void) {
      translate option names.
    */
   /* referenced via ntpqOptions.pzCopyright */
-  puts(_("ntpq 4.2.7p357\n\
+  puts(_("ntpq 4.2.7p358\n\
 Copyright (C) 1970-2013 The University of Delaware, all rights reserved.\n\
 This is free software. It is licensed for use, modification and\n\
 redistribution under the terms of the NTP License, copies of which\n\
@@ -831,11 +878,11 @@ provided \"as is\" without express or implied warranty.\n"));
   puts(_("load options from a config file"));
 
   /* referenced via ntpqOptions.pzUsageTitle */
-  puts(_("ntpq - standard NTP query program - Ver. 4.2.7p357\n\
+  puts(_("ntpq - standard NTP query program - Ver. 4.2.7p358\n\
 Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ host ...]\n"));
 
   /* referenced via ntpqOptions.pzFullVersion */
-  puts(_("ntpq 4.2.7p357"));
+  puts(_("ntpq 4.2.7p358"));
 
   /* referenced via ntpqOptions.pzFullUsage */
   puts(_("<<<NOT-FOUND>>>"));
@@ -870,7 +917,7 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ host ...]\n"));
   puts(_("could not locate the 'help' option"));
 #line 351 "../autoopts.c"
   puts(_("optionProcess() was called with invalid data"));
-#line 770 "../usage.c"
+#line 783 "../usage.c"
   puts(_("invalid argument type specified"));
 #line 589 "../find.c"
   puts(_("defaulted to option with optional arg"));
@@ -919,9 +966,9 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ host ...]\n"));
   puts(_("  or an integer from %d through %d\n"));
 #line 164 "../enum.c"
   puts(_("  or an integer from %d through %d\n"));
-#line 769 "../usage.c"
+#line 782 "../usage.c"
   puts(_("%s error:  invalid option descriptor for %s\n"));
-#line 1097 "../usage.c"
+#line 1110 "../usage.c"
   puts(_("%s error:  invalid option descriptor for %s\n"));
 #line 379 "../find.c"
   puts(_("%s: invalid option name: %s\n"));
@@ -929,7 +976,7 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ host ...]\n"));
   puts(_("%s: The '%s' option requires an argument.\n"));
 #line 171 "../autoopts.c"
   puts(_("(AutoOpts bug):  Equivalenced option '%s' was equivalenced to both\n"
-       "\t'%s' and '%s'"));
+       "\t'%s' and '%s'."));
 #line 94 "../check.c"
   puts(_("%s error:  The %s option is required\n"));
 #line 623 "../find.c"
@@ -957,7 +1004,7 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ host ...]\n"));
 #line 53 "../time.c"
   puts(_("%s error:  '%s' is not a recognizable time duration.\n"));
 #line 92 "../check.c"
-  puts(_("%s error:  The %s option must appear %d times\n"));
+  puts(_("%s error:  The %s option must appear %d times.\n"));
 #line 157 "../numeric.c"
   puts(_("%s error:  '%s' is not a recognizable number.\n"));
 #line 195 "../enum.c"
@@ -974,7 +1021,7 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ host ...]\n"));
   puts(_("standard output"));
 #line 451 "../usage.c"
   puts(_("standard output"));
-#line 647 "../usage.c"
+#line 660 "../usage.c"
   puts(_("standard output"));
 #line 175 "../version.c"
   puts(_("standard output"));
@@ -982,7 +1029,7 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ host ...]\n"));
   puts(_("standard error"));
 #line 451 "../usage.c"
   puts(_("standard error"));
-#line 647 "../usage.c"
+#line 660 "../usage.c"
   puts(_("standard error"));
 #line 175 "../version.c"
   puts(_("standard error"));
@@ -994,7 +1041,7 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ host ...]\n"));
   puts(_("write"));
 #line 450 "../usage.c"
   puts(_("write"));
-#line 646 "../usage.c"
+#line 659 "../usage.c"
   puts(_("write"));
 #line 174 "../version.c"
   puts(_("write"));
@@ -1015,23 +1062,23 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ host ...]\n"));
   /* END-LIBOPTS-MESSAGES */
 
   /* USAGE-TEXT: */
-#line 895 "../usage.c"
+#line 908 "../usage.c"
   puts(_("\t\t\t\t- an alternate for '%s'\n"));
-#line 1164 "../usage.c"
+#line 1177 "../usage.c"
   puts(_("Version, usage and configuration options:"));
-#line 946 "../usage.c"
+#line 959 "../usage.c"
   puts(_("\t\t\t\t- default option for unnamed options\n"));
-#line 859 "../usage.c"
+#line 872 "../usage.c"
   puts(_("\t\t\t\t- disabled as '--%s'\n"));
-#line 1133 "../usage.c"
+#line 1146 "../usage.c"
   puts(_(" --- %-14s %s\n"));
-#line 1131 "../usage.c"
+#line 1144 "../usage.c"
   puts(_("This option has been disabled"));
-#line 886 "../usage.c"
+#line 899 "../usage.c"
   puts(_("\t\t\t\t- enabled by default\n"));
 #line 40 "../alias.c"
   puts(_("%s error:  only "));
-#line 1208 "../usage.c"
+#line 1221 "../usage.c"
   puts(_(" - examining environment variables named %s_*\n"));
 #line 168 "../file.c"
   puts(_("\t\t\t\t- file must not pre-exist\n"));
@@ -1047,31 +1094,31 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ host ...]\n"));
        "a shell script to parse the options for %s:\n\n"));
 #line 161 "../enum.c"
   puts(_("  or an integer mask with any of the lower %d bits set\n"));
-#line 919 "../usage.c"
+#line 932 "../usage.c"
   puts(_("\t\t\t\t- is a set membership option\n"));
-#line 940 "../usage.c"
+#line 953 "../usage.c"
   puts(_("\t\t\t\t- must appear between %d and %d times\n"));
 #line 418 "../usage.c"
   puts(_("Options are specified by single or double hyphens and their name.\n"));
-#line 926 "../usage.c"
+#line 939 "../usage.c"
   puts(_("\t\t\t\t- may appear multiple times\n"));
-#line 913 "../usage.c"
+#line 926 "../usage.c"
   puts(_("\t\t\t\t- may not be preset\n"));
-#line 1323 "../usage.c"
+#line 1336 "../usage.c"
   puts(_("   Arg Option-Name    Description\n"));
-#line 1259 "../usage.c"
+#line 1272 "../usage.c"
   puts(_("  Flg Arg Option-Name    Description\n"));
-#line 1317 "../usage.c"
+#line 1330 "../usage.c"
   puts(_("  Flg Arg Option-Name    Description\n"));
-#line 1318 "../usage.c"
+#line 1331 "../usage.c"
   puts(_(" %3s %s"));
-#line 1324 "../usage.c"
+#line 1337 "../usage.c"
   puts(_(" %3s %s"));
 #line 423 "../usage.c"
   puts(_("The '-#<number>' option may omit the hash char\n"));
 #line 419 "../usage.c"
   puts(_("All arguments are named options.\n"));
-#line 993 "../usage.c"
+#line 1006 "../usage.c"
   puts(_(" - reading file %s"));
 #line 445 "../usage.c"
   puts(_("\n"
@@ -1082,17 +1129,17 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ host ...]\n"));
 #line 129 "../version.c"
   puts(_("\n"
        "please send bug reports to:  <%s>\n"));
-#line 925 "../usage.c"
+#line 938 "../usage.c"
   puts(_("\t\t\t\t- may NOT appear - preset only\n"));
-#line 965 "../usage.c"
+#line 978 "../usage.c"
   puts(_("\n"
        "The following option preset mechanisms are supported:\n"));
-#line 1206 "../usage.c"
+#line 1219 "../usage.c"
   puts(_("\n"
        "The following option preset mechanisms are supported:\n"));
-#line 704 "../usage.c"
+#line 717 "../usage.c"
   puts(_("prohibits these options:\n"));
-#line 699 "../usage.c"
+#line 712 "../usage.c"
   puts(_("prohibits the option '%s'\n"));
 #line 81 "../numeric.c"
   puts(_("%s%ld to %ld"));
@@ -1112,26 +1159,26 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ host ...]\n"));
   puts(_("%sless than or equal to %ld"));
 #line 426 "../usage.c"
   puts(_("Operands and options may be intermixed.  They will be reordered.\n"));
-#line 674 "../usage.c"
+#line 687 "../usage.c"
   puts(_("requires the option '%s'\n"));
-#line 677 "../usage.c"
+#line 690 "../usage.c"
   puts(_("requires these options:\n"));
-#line 1335 "../usage.c"
+#line 1348 "../usage.c"
   puts(_("   Arg Option-Name   Req?  Description\n"));
-#line 1329 "../usage.c"
+#line 1342 "../usage.c"
   puts(_("  Flg Arg Option-Name   Req?  Description\n"));
 #line 162 "../enum.c"
   puts(_("or you may use a numeric representation.  Preceding these with a '!'\n"
        "will clear the bits, specifying 'none' will clear all bits, and 'all'\n"
        "will set them all.  Multiple entries may be passed as an option\n"
        "argument list.\n"));
-#line 932 "../usage.c"
+#line 945 "../usage.c"
   puts(_("\t\t\t\t- may appear up to %d times\n"));
 #line 72 "../enum.c"
   puts(_("The valid \"%s\" option keywords are:\n"));
-#line 1168 "../usage.c"
+#line 1181 "../usage.c"
   puts(_("The next option supports vendor supported extra options:"));
-#line 795 "../usage.c"
+#line 808 "../usage.c"
   puts(_("These additional options are:"));
   /* END-USAGE-TEXT */
 }
index 82ba3cbb332303baa990d9ef3e4b50a5fe58afec..3aec6eb09b65693f957d9f3d53cc06abc9d4ec47 100644 (file)
@@ -1,7 +1,7 @@
 /*
  *  EDIT THIS FILE WITH CAUTION  (ntpq-opts.h)
  *
- *  It has been AutoGen-ed  February 21, 2013 at 10:47:01 PM by AutoGen 5.17.2pre17
+ *  It has been AutoGen-ed  February 27, 2013 at 11:37:45 AM by AutoGen 5.17.3.pre2
  *  From the definitions    ntpq-opts.def
  *  and the template file   options
  *
@@ -35,7 +35,7 @@
  *  representations about the suitability this software for any purpose. It
  *  is provided "as is" without express or implied warranty.
  */
-/*
+/**
  *  This file contains the programmatic interface to the Automated
  *  Options generated for the ntpq program.
  *  These macros are documented in the AutoGen info file in the
@@ -46,7 +46,7 @@
 #include "config.h"
 #include <autoopts/options.h>
 
-/*
+/**
  *  Ensure that the library used for compiling this generated header is at
  *  least as new as the version current when the header template was released
  *  (not counting patch version increments).  Also ensure that the oldest
@@ -60,8 +60,8 @@
   Choke Me.
 #endif
 
-/*
- *  Enumeration of each option:
+/**
+ *  Enumeration of each option type for ntpq
  */
 typedef enum {
     INDEX_OPT_IPV4             =  0,
@@ -79,34 +79,51 @@ typedef enum {
     INDEX_OPT_SAVE_OPTS        = 12,
     INDEX_OPT_LOAD_OPTS        = 13
 } teOptIndex;
-
+/** count of all options for ntpq */
 #define OPTION_CT    14
-#define NTPQ_VERSION       "4.2.7p357"
-#define NTPQ_FULL_VERSION  "ntpq 4.2.7p357"
+/** ntpq version */
+#define NTPQ_VERSION       "4.2.7p358"
+/** Full ntpq version text */
+#define NTPQ_FULL_VERSION  "ntpq 4.2.7p358"
 
-/*
+/**
  *  Interface defines for all options.  Replace "n" with the UPPER_CASED
  *  option name (as in the teOptIndex enumeration above).
  *  e.g. HAVE_OPT(IPV4)
  */
 #define         DESC(n) (ntpqOptions.pOptDesc[INDEX_OPT_## n])
+/** 'true' if an option has been specified in any way */
 #define     HAVE_OPT(n) (! UNUSED_OPT(& DESC(n)))
+/** The string argument to an option. The argument type must be "string". */
 #define      OPT_ARG(n) (DESC(n).optArg.argString)
+/** Mask the option state revealing how an option was specified.
+ *  It will be one and only one of \a OPTST_SET, \a OPTST_PRESET,
+ * \a OPTST_DEFINED, \a OPTST_RESET or zero.
+ */
 #define    STATE_OPT(n) (DESC(n).fOptState & OPTST_SET_MASK)
+/** Count of option's occurrances *on the command line*. */
 #define    COUNT_OPT(n) (DESC(n).optOccCt)
+/** mask of \a OPTST_SET and \a OPTST_DEFINED. */
 #define    ISSEL_OPT(n) (SELECTED_OPT(&DESC(n)))
+/** 'true' if \a HAVE_OPT would yield 'false'. */
 #define ISUNUSED_OPT(n) (UNUSED_OPT(& DESC(n)))
+/** 'true' if OPTST_DISABLED bit not set. */
 #define  ENABLED_OPT(n) (! DISABLED_OPT(& DESC(n)))
+/** number of stacked option arguments.
+ *  Valid only for stacked option arguments. */
 #define  STACKCT_OPT(n) (((tArgList*)(DESC(n).optCookie))->useCt)
+/** stacked argument vector.
+ *  Valid only for stacked option arguments. */
 #define STACKLST_OPT(n) (((tArgList*)(DESC(n).optCookie))->apzArgs)
+/** Reset an option. */
 #define    CLEAR_OPT(n) STMTS( \
                 DESC(n).fOptState &= OPTST_PERSISTENT_MASK;   \
                 if ((DESC(n).fOptState & OPTST_INITENABLED) == 0) \
                     DESC(n).fOptState |= OPTST_DISABLED; \
                 DESC(n).optCookie = NULL )
 
-/* * * * * *
- *
+/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
+/**
  *  Enumeration of ntpq exit codes
  */
 typedef enum {
@@ -116,7 +133,8 @@ typedef enum {
     NTPQ_EXIT_NO_CONFIG_INPUT       = 66,
     NTPQ_EXIT_LIBOPTS_FAILURE       = 70
 } ntpq_exit_code_t;
-/*
+/** @} */
+/**
  *  Make sure there are no #define name conflicts with the option names
  */
 #ifndef     NO_OPTION_NAME_WARNINGS
@@ -168,9 +186,10 @@ typedef enum {
 # undef OLD_RV
 #endif  /*  NO_OPTION_NAME_WARNINGS */
 
-/* * * * * *
- *
+/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
+/**
  *  Interface defines for specific options.
+ * @{
  */
 #define VALUE_OPT_IPV4           '4'
 #define VALUE_OPT_IPV6           '6'
@@ -183,10 +202,15 @@ typedef enum {
 #define VALUE_OPT_INTERACTIVE    'i'
 #define VALUE_OPT_NUMERIC        'n'
 #define VALUE_OPT_OLD_RV         8
+/** option flag (value) for " (get "val-name") " option */
 #define VALUE_OPT_HELP          '?'
+/** option flag (value) for " (get "val-name") " option */
 #define VALUE_OPT_MORE_HELP     '!'
+/** option flag (value) for " (get "val-name") " option */
 #define VALUE_OPT_VERSION       INDEX_OPT_VERSION
+/** option flag (value) for " (get "val-name") " option */
 #define VALUE_OPT_SAVE_OPTS     '>'
+/** option flag (value) for " (get "val-name") " option */
 #define VALUE_OPT_LOAD_OPTS     '<'
 #define SET_OPT_SAVE_OPTS(a)   STMTS( \
         DESC(SAVE_OPTS).fOptState &= OPTST_PERSISTENT_MASK; \
@@ -202,7 +226,7 @@ typedef enum {
                 ntpqOptions.pzCurOpt  = NULL)
 #define START_OPT       RESTART_OPT(1)
 #define USAGE(c)        (*ntpqOptions.pUsageProc)(&ntpqOptions, c)
-/* extracted from opthead.tlib near line 498 */
+/* extracted from opthead.tlib near line 538 */
 
 #ifdef  __cplusplus
 extern "C" {
index 62b3825f66eb3a982195720c527d1986104b5d3c..b927a622d9177767281af90ca6cb47f6133b5ec7 100644 (file)
@@ -1,8 +1,8 @@
-.TH ntpq 1ntpqman "21 Feb 2013" "4.2.7p357" "User Commands"
+.TH ntpq 1ntpqman "27 Feb 2013" "4.2.7p358" "User Commands"
 .\"
 .\"  EDIT THIS FILE WITH CAUTION  (ntpq-opts.man)
 .\"
-.\"  It has been AutoGen-ed  February 21, 2013 at 10:47:24 PM by AutoGen 5.17.2pre17
+.\"  It has been AutoGen-ed  February 27, 2013 at 11:38:08 AM by AutoGen 5.17.3.pre2
 .\"  From the definitions    ntpq-opts.def
 .\"  and the template file   agman-cmd.tpl
 .\"
index b4b04741a502997617cbb2b575dc2a73a37d3692..5ee3ffe6924ef31c7e9cb0de961ac85052528471 100644 (file)
@@ -1,9 +1,9 @@
-.Dd February 21 2013
+.Dd February 27 2013
 .Dt NTPQ 1ntpqmdoc User Commands
 .Os SunOS 5.10
 .\"  EDIT THIS FILE WITH CAUTION  (ntpq-opts.mdoc)
 .\"
-.\"  It has been AutoGen-ed  February 21, 2013 at 10:47:30 PM by AutoGen 5.17.2pre17
+.\"  It has been AutoGen-ed  February 27, 2013 at 11:38:14 AM by AutoGen 5.17.3.pre2
 .\"  From the definitions    ntpq-opts.def
 .\"  and the template file   agmdoc-cmd.tpl
 .Sh NAME
index 9cdfa54265e9faccb974920bce1767a3d497743e..a0ebe0522c20efd4c4dacf02055ae1d350904985 100644 (file)
@@ -44,7 +44,7 @@ monitor the operational status
 and determine the performance of
 <code>ntpd</code>, the NTP daemon.
 
-  <p>This document applies to version 4.2.7p357 of <code>ntpq</code>.
+  <p>This document applies to version 4.2.7p358 of <code>ntpq</code>.
 
 <ul class="menu">
 <li><a accesskey="1" href="#ntpq-Description">ntpq Description</a>
@@ -377,7 +377,7 @@ the usage text by passing it through a pager program.
 used to select the program, defaulting to <span class="file">more</span>.  Both will exit
 with a status code of 0.
 
-<pre class="example">ntpq - standard NTP query program - Ver. 4.2.7p356
+<pre class="example">ntpq - standard NTP query program - Ver. 4.2.7p357
 Usage:  ntpq [ -&lt;flag&gt; [&lt;val&gt;] | --&lt;name&gt;[{=| }&lt;val&gt;] ]... [ host ...]
   Flg Arg Option-Name    Description
    -4 no  ipv4           Force IPv4 DNS name resolution
index 17a5dfd226b979bc81635a2e95abc78492051e3a..3c002dda9fdc553b2f5411cd540010e0e4e6aee2 100644 (file)
@@ -1,8 +1,8 @@
-.TH ntpq @NTPQ_MS@ "21 Feb 2013" "4.2.7p357" "User Commands"
+.TH ntpq @NTPQ_MS@ "27 Feb 2013" "4.2.7p358" "User Commands"
 .\"
 .\"  EDIT THIS FILE WITH CAUTION  (ntpq-opts.man)
 .\"
-.\"  It has been AutoGen-ed  February 21, 2013 at 10:47:24 PM by AutoGen 5.17.2pre17
+.\"  It has been AutoGen-ed  February 27, 2013 at 11:38:08 AM by AutoGen 5.17.3.pre2
 .\"  From the definitions    ntpq-opts.def
 .\"  and the template file   agman-cmd.tpl
 .\"
index 7abc9bb7a7ff8f7b83f4005a5fb8ddaabcf1848e..633783a2b2f38b8a8d34a06a44888ca44a201b0b 100644 (file)
@@ -1,9 +1,9 @@
-.Dd February 21 2013
+.Dd February 27 2013
 .Dt NTPQ @NTPQ_MS@ User Commands
 .Os SunOS 5.10
 .\"  EDIT THIS FILE WITH CAUTION  (ntpq-opts.mdoc)
 .\"
-.\"  It has been AutoGen-ed  February 21, 2013 at 10:47:30 PM by AutoGen 5.17.2pre17
+.\"  It has been AutoGen-ed  February 27, 2013 at 11:38:14 AM by AutoGen 5.17.3.pre2
 .\"  From the definitions    ntpq-opts.def
 .\"  and the template file   agmdoc-cmd.tpl
 .Sh NAME
index 3d5a170ae3863b10fbcc72f53b99a9fd5a0358b4..e2b6f59c6e2312ea81adadae9ccc087967c5c1cb 100644 (file)
@@ -6,7 +6,7 @@
 #
 # EDIT THIS FILE WITH CAUTION  (invoke-ntpsnmpd.texi)
 #
-# It has been AutoGen-ed  February 21, 2013 at 10:47:46 PM by AutoGen 5.17.2pre17
+# It has been AutoGen-ed  February 27, 2013 at 11:38:29 AM by AutoGen 5.17.3.pre2
 # From the definitions    ntpsnmpd-opts.def
 # and the template file   agtexi-cmd.tpl
 @end ignore
@@ -47,7 +47,7 @@ with a status code of 0.
 
 @exampleindent 0
 @example
-ntpsnmpd - NTP SNMP MIB agent - Ver. 4.2.7p357
+ntpsnmpd - NTP SNMP MIB agent - Ver. 4.2.7p358
 Usage:  ntpsnmpd [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]...
   Flg Arg Option-Name    Description
    -n no  nofork         Do not fork
index 93fb4795bb23e8281cb682117a4b006874e0f3d1..8f081b4a863c0d92f9a88f609bbe0d40fcfd12a9 100644 (file)
@@ -1,7 +1,7 @@
 /*
  *  EDIT THIS FILE WITH CAUTION  (ntpsnmpd-opts.c)
  *
- *  It has been AutoGen-ed  February 21, 2013 at 10:47:32 PM by AutoGen 5.17.2pre17
+ *  It has been AutoGen-ed  February 27, 2013 at 11:38:16 AM by AutoGen 5.17.3.pre2
  *  From the definitions    ntpsnmpd-opts.def
  *  and the template file   options
  *
@@ -57,11 +57,11 @@ extern FILE * option_usage_fp;
 #  define NULL 0
 #endif
 
-/*
- *  ntpsnmpd option static const strings
+/**
+ *  static const strings for ntpsnmpd options
  */
 static char const ntpsnmpd_opt_strs[1560] =
-/*     0 */ "ntpsnmpd 4.2.7p357\n"
+/*     0 */ "ntpsnmpd 4.2.7p358\n"
             "Copyright (C) 1970-2013 The University of Delaware, all rights reserved.\n"
             "This is free software. It is licensed for use, modification and\n"
             "redistribution under the terms of the NTP License, copies of which\n"
@@ -100,38 +100,51 @@ static char const ntpsnmpd_opt_strs[1560] =
 /*  1360 */ "no-load-opts\0"
 /*  1373 */ "no\0"
 /*  1376 */ "NTPSNMPD\0"
-/*  1385 */ "ntpsnmpd - NTP SNMP MIB agent - Ver. 4.2.7p357\n"
+/*  1385 */ "ntpsnmpd - NTP SNMP MIB agent - Ver. 4.2.7p358\n"
             "Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]...\n\0"
 /*  1490 */ "$HOME\0"
 /*  1496 */ ".\0"
 /*  1498 */ ".ntprc\0"
 /*  1505 */ "http://bugs.ntp.org, bugs@ntp.org\0"
 /*  1539 */ "\n\0"
-/*  1541 */ "ntpsnmpd 4.2.7p357";
+/*  1541 */ "ntpsnmpd 4.2.7p358";
 
-/*
+/**
  *  nofork option description:
  */
+/** Descriptive text for the nofork option */
 #define NOFORK_DESC      (ntpsnmpd_opt_strs+958)
+/** Upper-cased name for the nofork option */
 #define NOFORK_NAME      (ntpsnmpd_opt_strs+970)
+/** Name string for the nofork option */
 #define NOFORK_name      (ntpsnmpd_opt_strs+977)
+/** Compiled in flag settings for the nofork option */
 #define NOFORK_FLAGS     (OPTST_DISABLED)
 
-/*
+/**
  *  syslog option description:
  */
+/** Descriptive text for the syslog option */
 #define SYSLOG_DESC      (ntpsnmpd_opt_strs+984)
+/** Upper-cased name for the syslog option */
 #define SYSLOG_NAME      (ntpsnmpd_opt_strs+1000)
+/** Name string for the syslog option */
 #define SYSLOG_name      (ntpsnmpd_opt_strs+1007)
+/** Compiled in flag settings for the syslog option */
 #define SYSLOG_FLAGS     (OPTST_DISABLED)
 
-/*
+/**
  *  agentXSocket option description:
  */
+/** Descriptive text for the agentXSocket option */
 #define AGENTXSOCKET_DESC      (ntpsnmpd_opt_strs+1014)
+/** Upper-cased name for the agentXSocket option */
 #define AGENTXSOCKET_NAME      (ntpsnmpd_opt_strs+1071)
+/** Name string for the agentXSocket option */
 #define AGENTXSOCKET_name      (ntpsnmpd_opt_strs+1084)
+/** The compiled in default value for the agentXSocket option argument */
 #define AGENTXSOCKET_DFT_ARG   (ntpsnmpd_opt_strs+1097)
+/** Compiled in flag settings for the agentXSocket option */
 #define AGENTXSOCKET_FLAGS     (OPTST_DISABLED \
         | OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
 
@@ -164,7 +177,7 @@ static char const ntpsnmpd_opt_strs[1560] =
 #define NO_LOAD_OPTS_name  (ntpsnmpd_opt_strs+1360)
 #define LOAD_OPTS_pfx      (ntpsnmpd_opt_strs+1373)
 #define LOAD_OPTS_name     (NO_LOAD_OPTS_name + 3)
-/*
+/**
  *  Declare option callback procedures
  */
 #if defined(TEST_NTPSNMPD_OPTS)
@@ -298,22 +311,27 @@ static tOptDesc optDesc[OPTION_CT] = {
 };
 
 
-/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
- *
- *  Define the ntpsnmpd Option Environment
- */
+/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
+/** Reference to the upper cased version of ntpsnmpd. */
 #define zPROGNAME       (ntpsnmpd_opt_strs+1376)
+/** Reference to the title line for ntpsnmpd usage. */
 #define zUsageTitle     (ntpsnmpd_opt_strs+1385)
+/** ntpsnmpd configuration file name. */
 #define zRcName         (ntpsnmpd_opt_strs+1498)
+/** Directories to search for ntpsnmpd config files. */
 static char const * const apzHomeList[3] = {
     ntpsnmpd_opt_strs+1490,
     ntpsnmpd_opt_strs+1496,
     NULL };
+/** The ntpsnmpd program bug email address. */
 #define zBugsAddr       (ntpsnmpd_opt_strs+1505)
+/** Clarification/explanation of what ntpsnmpd does. */
 #define zExplain        (ntpsnmpd_opt_strs+1539)
+/** Extra detail explaining what ntpsnmpd does. */
 #define zDetail         (NULL)
+/** The full version string for ntpsnmpd. */
 #define zFullVersion    (ntpsnmpd_opt_strs+1541)
-/* extracted from optcode.tlib near line 364 */
+/* extracted from optcode.tlib near line 371 */
 
 #if defined(ENABLE_NLS)
 # define OPTPROC_BASE OPTPROC_TRANSLATE
@@ -334,8 +352,8 @@ static char const * const apzHomeList[3] = {
 /**
  * The callout function that invokes the optionUsage function.
  *
- * @param pOptions the AutoOpts option description structure
- * @param pOptDesc the descriptor for the "help" (usage) option.
+ * @param[in] pOptions the AutoOpts option description structure
+ * @param[in] pOptDesc the descriptor for the "help" (usage) option.
  * @noreturn
  */
 static void
@@ -356,8 +374,8 @@ extern void optionPutShell(tOptions*);
  * Generated main procedure.  This will emit text that a Bourne shell can
  * process to handle its command line arguments.
  *
- * @param argc argument count
- * @param argv argument vector
+ * @param[in] argc argument count
+ * @param[in] argv argument vector
  * @returns program exit code
  */
 int
@@ -388,6 +406,7 @@ main(int argc, char ** argv)
 #ifndef  WITH_PACKAGER
 # define ntpsnmpd_packager_info NULL
 #else
+/** Packager information for ntpsnmpd. */
 static char const ntpsnmpd_packager_info[] =
     "Packaged by " WITH_PACKAGER
 
@@ -442,7 +461,7 @@ tOptions ntpsnmpdOptions = {
 };
 
 #if ENABLE_NLS
-/*
+/**
  * This code is designed to translate translatable option text for the
  * ntpsnmpd program.  These translations happen upon entry
  * to optionProcess().
@@ -551,6 +570,7 @@ translate_option_strings(void)
 #endif /* ENABLE_NLS */
 
 #ifdef DO_NOT_COMPILE_THIS_CODE_IT_IS_FOR_GETTEXT
+/** I18N function strictly for xgettext.  Do not compile. */
 static void bogus_function(void) {
   /* TRANSLATORS:
 
@@ -569,7 +589,7 @@ static void bogus_function(void) {
      translate option names.
    */
   /* referenced via ntpsnmpdOptions.pzCopyright */
-  puts(_("ntpsnmpd 4.2.7p357\n\
+  puts(_("ntpsnmpd 4.2.7p358\n\
 Copyright (C) 1970-2013 The University of Delaware, all rights reserved.\n\
 This is free software. It is licensed for use, modification and\n\
 redistribution under the terms of the NTP License, copies of which\n\
@@ -613,14 +633,14 @@ provided \"as is\" without express or implied warranty.\n"));
   puts(_("load options from a config file"));
 
   /* referenced via ntpsnmpdOptions.pzUsageTitle */
-  puts(_("ntpsnmpd - NTP SNMP MIB agent - Ver. 4.2.7p357\n\
+  puts(_("ntpsnmpd - NTP SNMP MIB agent - Ver. 4.2.7p358\n\
 Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]...\n"));
 
   /* referenced via ntpsnmpdOptions.pzExplain */
   puts(_("\n"));
 
   /* referenced via ntpsnmpdOptions.pzFullVersion */
-  puts(_("ntpsnmpd 4.2.7p357"));
+  puts(_("ntpsnmpd 4.2.7p358"));
 
   /* referenced via ntpsnmpdOptions.pzFullUsage */
   puts(_("<<<NOT-FOUND>>>"));
@@ -655,7 +675,7 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]...\n"));
   puts(_("could not locate the 'help' option"));
 #line 351 "../autoopts.c"
   puts(_("optionProcess() was called with invalid data"));
-#line 770 "../usage.c"
+#line 783 "../usage.c"
   puts(_("invalid argument type specified"));
 #line 589 "../find.c"
   puts(_("defaulted to option with optional arg"));
@@ -704,9 +724,9 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]...\n"));
   puts(_("  or an integer from %d through %d\n"));
 #line 164 "../enum.c"
   puts(_("  or an integer from %d through %d\n"));
-#line 769 "../usage.c"
+#line 782 "../usage.c"
   puts(_("%s error:  invalid option descriptor for %s\n"));
-#line 1097 "../usage.c"
+#line 1110 "../usage.c"
   puts(_("%s error:  invalid option descriptor for %s\n"));
 #line 379 "../find.c"
   puts(_("%s: invalid option name: %s\n"));
@@ -714,7 +734,7 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]...\n"));
   puts(_("%s: The '%s' option requires an argument.\n"));
 #line 171 "../autoopts.c"
   puts(_("(AutoOpts bug):  Equivalenced option '%s' was equivalenced to both\n"
-       "\t'%s' and '%s'"));
+       "\t'%s' and '%s'."));
 #line 94 "../check.c"
   puts(_("%s error:  The %s option is required\n"));
 #line 623 "../find.c"
@@ -742,7 +762,7 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]...\n"));
 #line 53 "../time.c"
   puts(_("%s error:  '%s' is not a recognizable time duration.\n"));
 #line 92 "../check.c"
-  puts(_("%s error:  The %s option must appear %d times\n"));
+  puts(_("%s error:  The %s option must appear %d times.\n"));
 #line 157 "../numeric.c"
   puts(_("%s error:  '%s' is not a recognizable number.\n"));
 #line 195 "../enum.c"
@@ -759,7 +779,7 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]...\n"));
   puts(_("standard output"));
 #line 451 "../usage.c"
   puts(_("standard output"));
-#line 647 "../usage.c"
+#line 660 "../usage.c"
   puts(_("standard output"));
 #line 175 "../version.c"
   puts(_("standard output"));
@@ -767,7 +787,7 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]...\n"));
   puts(_("standard error"));
 #line 451 "../usage.c"
   puts(_("standard error"));
-#line 647 "../usage.c"
+#line 660 "../usage.c"
   puts(_("standard error"));
 #line 175 "../version.c"
   puts(_("standard error"));
@@ -779,7 +799,7 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]...\n"));
   puts(_("write"));
 #line 450 "../usage.c"
   puts(_("write"));
-#line 646 "../usage.c"
+#line 659 "../usage.c"
   puts(_("write"));
 #line 174 "../version.c"
   puts(_("write"));
@@ -800,23 +820,23 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]...\n"));
   /* END-LIBOPTS-MESSAGES */
 
   /* USAGE-TEXT: */
-#line 895 "../usage.c"
+#line 908 "../usage.c"
   puts(_("\t\t\t\t- an alternate for '%s'\n"));
-#line 1164 "../usage.c"
+#line 1177 "../usage.c"
   puts(_("Version, usage and configuration options:"));
-#line 946 "../usage.c"
+#line 959 "../usage.c"
   puts(_("\t\t\t\t- default option for unnamed options\n"));
-#line 859 "../usage.c"
+#line 872 "../usage.c"
   puts(_("\t\t\t\t- disabled as '--%s'\n"));
-#line 1133 "../usage.c"
+#line 1146 "../usage.c"
   puts(_(" --- %-14s %s\n"));
-#line 1131 "../usage.c"
+#line 1144 "../usage.c"
   puts(_("This option has been disabled"));
-#line 886 "../usage.c"
+#line 899 "../usage.c"
   puts(_("\t\t\t\t- enabled by default\n"));
 #line 40 "../alias.c"
   puts(_("%s error:  only "));
-#line 1208 "../usage.c"
+#line 1221 "../usage.c"
   puts(_(" - examining environment variables named %s_*\n"));
 #line 168 "../file.c"
   puts(_("\t\t\t\t- file must not pre-exist\n"));
@@ -832,31 +852,31 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]...\n"));
        "a shell script to parse the options for %s:\n\n"));
 #line 161 "../enum.c"
   puts(_("  or an integer mask with any of the lower %d bits set\n"));
-#line 919 "../usage.c"
+#line 932 "../usage.c"
   puts(_("\t\t\t\t- is a set membership option\n"));
-#line 940 "../usage.c"
+#line 953 "../usage.c"
   puts(_("\t\t\t\t- must appear between %d and %d times\n"));
 #line 418 "../usage.c"
   puts(_("Options are specified by single or double hyphens and their name.\n"));
-#line 926 "../usage.c"
+#line 939 "../usage.c"
   puts(_("\t\t\t\t- may appear multiple times\n"));
-#line 913 "../usage.c"
+#line 926 "../usage.c"
   puts(_("\t\t\t\t- may not be preset\n"));
-#line 1323 "../usage.c"
+#line 1336 "../usage.c"
   puts(_("   Arg Option-Name    Description\n"));
-#line 1259 "../usage.c"
+#line 1272 "../usage.c"
   puts(_("  Flg Arg Option-Name    Description\n"));
-#line 1317 "../usage.c"
+#line 1330 "../usage.c"
   puts(_("  Flg Arg Option-Name    Description\n"));
-#line 1318 "../usage.c"
+#line 1331 "../usage.c"
   puts(_(" %3s %s"));
-#line 1324 "../usage.c"
+#line 1337 "../usage.c"
   puts(_(" %3s %s"));
 #line 423 "../usage.c"
   puts(_("The '-#<number>' option may omit the hash char\n"));
 #line 419 "../usage.c"
   puts(_("All arguments are named options.\n"));
-#line 993 "../usage.c"
+#line 1006 "../usage.c"
   puts(_(" - reading file %s"));
 #line 445 "../usage.c"
   puts(_("\n"
@@ -867,17 +887,17 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]...\n"));
 #line 129 "../version.c"
   puts(_("\n"
        "please send bug reports to:  <%s>\n"));
-#line 925 "../usage.c"
+#line 938 "../usage.c"
   puts(_("\t\t\t\t- may NOT appear - preset only\n"));
-#line 965 "../usage.c"
+#line 978 "../usage.c"
   puts(_("\n"
        "The following option preset mechanisms are supported:\n"));
-#line 1206 "../usage.c"
+#line 1219 "../usage.c"
   puts(_("\n"
        "The following option preset mechanisms are supported:\n"));
-#line 704 "../usage.c"
+#line 717 "../usage.c"
   puts(_("prohibits these options:\n"));
-#line 699 "../usage.c"
+#line 712 "../usage.c"
   puts(_("prohibits the option '%s'\n"));
 #line 81 "../numeric.c"
   puts(_("%s%ld to %ld"));
@@ -897,26 +917,26 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]...\n"));
   puts(_("%sless than or equal to %ld"));
 #line 426 "../usage.c"
   puts(_("Operands and options may be intermixed.  They will be reordered.\n"));
-#line 674 "../usage.c"
+#line 687 "../usage.c"
   puts(_("requires the option '%s'\n"));
-#line 677 "../usage.c"
+#line 690 "../usage.c"
   puts(_("requires these options:\n"));
-#line 1335 "../usage.c"
+#line 1348 "../usage.c"
   puts(_("   Arg Option-Name   Req?  Description\n"));
-#line 1329 "../usage.c"
+#line 1342 "../usage.c"
   puts(_("  Flg Arg Option-Name   Req?  Description\n"));
 #line 162 "../enum.c"
   puts(_("or you may use a numeric representation.  Preceding these with a '!'\n"
        "will clear the bits, specifying 'none' will clear all bits, and 'all'\n"
        "will set them all.  Multiple entries may be passed as an option\n"
        "argument list.\n"));
-#line 932 "../usage.c"
+#line 945 "../usage.c"
   puts(_("\t\t\t\t- may appear up to %d times\n"));
 #line 72 "../enum.c"
   puts(_("The valid \"%s\" option keywords are:\n"));
-#line 1168 "../usage.c"
+#line 1181 "../usage.c"
   puts(_("The next option supports vendor supported extra options:"));
-#line 795 "../usage.c"
+#line 808 "../usage.c"
   puts(_("These additional options are:"));
   /* END-USAGE-TEXT */
 }
index d7bfc175b22443d29df09d45ce60e28176c0ab86..845adcba00651aa665d460c9ec6ee9417ebf697c 100644 (file)
@@ -1,7 +1,7 @@
 /*
  *  EDIT THIS FILE WITH CAUTION  (ntpsnmpd-opts.h)
  *
- *  It has been AutoGen-ed  February 21, 2013 at 10:47:32 PM by AutoGen 5.17.2pre17
+ *  It has been AutoGen-ed  February 27, 2013 at 11:38:16 AM by AutoGen 5.17.3.pre2
  *  From the definitions    ntpsnmpd-opts.def
  *  and the template file   options
  *
@@ -35,7 +35,7 @@
  *  representations about the suitability this software for any purpose. It
  *  is provided "as is" without express or implied warranty.
  */
-/*
+/**
  *  This file contains the programmatic interface to the Automated
  *  Options generated for the ntpsnmpd program.
  *  These macros are documented in the AutoGen info file in the
@@ -46,7 +46,7 @@
 #include "config.h"
 #include <autoopts/options.h>
 
-/*
+/**
  *  Ensure that the library used for compiling this generated header is at
  *  least as new as the version current when the header template was released
  *  (not counting patch version increments).  Also ensure that the oldest
@@ -60,8 +60,8 @@
   Choke Me.
 #endif
 
-/*
- *  Enumeration of each option:
+/**
+ *  Enumeration of each option type for ntpsnmpd
  */
 typedef enum {
     INDEX_OPT_NOFORK        =  0,
@@ -73,34 +73,51 @@ typedef enum {
     INDEX_OPT_SAVE_OPTS     =  6,
     INDEX_OPT_LOAD_OPTS     =  7
 } teOptIndex;
-
+/** count of all options for ntpsnmpd */
 #define OPTION_CT    8
-#define NTPSNMPD_VERSION       "4.2.7p357"
-#define NTPSNMPD_FULL_VERSION  "ntpsnmpd 4.2.7p357"
+/** ntpsnmpd version */
+#define NTPSNMPD_VERSION       "4.2.7p358"
+/** Full ntpsnmpd version text */
+#define NTPSNMPD_FULL_VERSION  "ntpsnmpd 4.2.7p358"
 
-/*
+/**
  *  Interface defines for all options.  Replace "n" with the UPPER_CASED
  *  option name (as in the teOptIndex enumeration above).
  *  e.g. HAVE_OPT(NOFORK)
  */
 #define         DESC(n) (ntpsnmpdOptions.pOptDesc[INDEX_OPT_## n])
+/** 'true' if an option has been specified in any way */
 #define     HAVE_OPT(n) (! UNUSED_OPT(& DESC(n)))
+/** The string argument to an option. The argument type must be "string". */
 #define      OPT_ARG(n) (DESC(n).optArg.argString)
+/** Mask the option state revealing how an option was specified.
+ *  It will be one and only one of \a OPTST_SET, \a OPTST_PRESET,
+ * \a OPTST_DEFINED, \a OPTST_RESET or zero.
+ */
 #define    STATE_OPT(n) (DESC(n).fOptState & OPTST_SET_MASK)
+/** Count of option's occurrances *on the command line*. */
 #define    COUNT_OPT(n) (DESC(n).optOccCt)
+/** mask of \a OPTST_SET and \a OPTST_DEFINED. */
 #define    ISSEL_OPT(n) (SELECTED_OPT(&DESC(n)))
+/** 'true' if \a HAVE_OPT would yield 'false'. */
 #define ISUNUSED_OPT(n) (UNUSED_OPT(& DESC(n)))
+/** 'true' if OPTST_DISABLED bit not set. */
 #define  ENABLED_OPT(n) (! DISABLED_OPT(& DESC(n)))
+/** number of stacked option arguments.
+ *  Valid only for stacked option arguments. */
 #define  STACKCT_OPT(n) (((tArgList*)(DESC(n).optCookie))->useCt)
+/** stacked argument vector.
+ *  Valid only for stacked option arguments. */
 #define STACKLST_OPT(n) (((tArgList*)(DESC(n).optCookie))->apzArgs)
+/** Reset an option. */
 #define    CLEAR_OPT(n) STMTS( \
                 DESC(n).fOptState &= OPTST_PERSISTENT_MASK;   \
                 if ((DESC(n).fOptState & OPTST_INITENABLED) == 0) \
                     DESC(n).fOptState |= OPTST_DISABLED; \
                 DESC(n).optCookie = NULL )
 
-/* * * * * *
- *
+/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
+/**
  *  Enumeration of ntpsnmpd exit codes
  */
 typedef enum {
@@ -110,7 +127,8 @@ typedef enum {
     NTPSNMPD_EXIT_NO_CONFIG_INPUT   = 66,
     NTPSNMPD_EXIT_LIBOPTS_FAILURE   = 70
 } ntpsnmpd_exit_code_t;
-/*
+/** @} */
+/**
  *  Make sure there are no #define name conflicts with the option names
  */
 #ifndef     NO_OPTION_NAME_WARNINGS
@@ -132,17 +150,23 @@ typedef enum {
 # undef AGENTXSOCKET
 #endif  /*  NO_OPTION_NAME_WARNINGS */
 
-/* * * * * *
- *
+/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
+/**
  *  Interface defines for specific options.
+ * @{
  */
 #define VALUE_OPT_NOFORK         'n'
 #define VALUE_OPT_SYSLOG         'p'
 #define VALUE_OPT_AGENTXSOCKET   2
+/** option flag (value) for " (get "val-name") " option */
 #define VALUE_OPT_HELP          '?'
+/** option flag (value) for " (get "val-name") " option */
 #define VALUE_OPT_MORE_HELP     '!'
+/** option flag (value) for " (get "val-name") " option */
 #define VALUE_OPT_VERSION       INDEX_OPT_VERSION
+/** option flag (value) for " (get "val-name") " option */
 #define VALUE_OPT_SAVE_OPTS     '>'
+/** option flag (value) for " (get "val-name") " option */
 #define VALUE_OPT_LOAD_OPTS     '<'
 #define SET_OPT_SAVE_OPTS(a)   STMTS( \
         DESC(SAVE_OPTS).fOptState &= OPTST_PERSISTENT_MASK; \
@@ -158,7 +182,7 @@ typedef enum {
                 ntpsnmpdOptions.pzCurOpt  = NULL)
 #define START_OPT       RESTART_OPT(1)
 #define USAGE(c)        (*ntpsnmpdOptions.pUsageProc)(&ntpsnmpdOptions, c)
-/* extracted from opthead.tlib near line 498 */
+/* extracted from opthead.tlib near line 538 */
 
 #ifdef  __cplusplus
 extern "C" {
index 325f10c5e61b3c51503baa20dc2ccc61416aaa99..df5243fad102825582bb8d680b03bdc12838ffa7 100644 (file)
@@ -1,8 +1,8 @@
-.TH ntpsnmpd 1ntpsnmpdman "21 Feb 2013" "4.2.7p357" "User Commands"
+.TH ntpsnmpd 1ntpsnmpdman "27 Feb 2013" "4.2.7p358" "User Commands"
 .\"
 .\"  EDIT THIS FILE WITH CAUTION  (ntpsnmpd-opts.man)
 .\"
-.\"  It has been AutoGen-ed  February 21, 2013 at 10:47:42 PM by AutoGen 5.17.2pre17
+.\"  It has been AutoGen-ed  February 27, 2013 at 11:38:25 AM by AutoGen 5.17.3.pre2
 .\"  From the definitions    ntpsnmpd-opts.def
 .\"  and the template file   agman-cmd.tpl
 .\"
@@ -169,7 +169,7 @@ please fill me in...
 .BR Li ntpEntTimeDistance
 please fill me in...
 .PP
-This document corresponds to version 4.2.7p357 of NTP.
+This document corresponds to version 4.2.7p358 of NTP.
 .PP
 This manual page was \fIAutoGen\fP-erated from the \fBntpsnmpd\fP
 option definitions.
index 383a7de890c8cb84c83aa456b19aabe0f07f25a9..ad0623bb7ffb68c27d70cc9e05a6be4314091b88 100644 (file)
@@ -1,9 +1,9 @@
-.Dd February 21 2013
+.Dd February 27 2013
 .Dt NTPSNMPD 1ntpsnmpdmdoc User Commands
 .Os SunOS 5.10
 .\"  EDIT THIS FILE WITH CAUTION  (ntpsnmpd-opts.mdoc)
 .\"
-.\"  It has been AutoGen-ed  February 21, 2013 at 10:47:48 PM by AutoGen 5.17.2pre17
+.\"  It has been AutoGen-ed  February 27, 2013 at 11:38:31 AM by AutoGen 5.17.3.pre2
 .\"  From the definitions    ntpsnmpd-opts.def
 .\"  and the template file   agmdoc-cmd.tpl
 .Sh NAME
@@ -156,7 +156,7 @@ please fill me in...
 please fill me in...
 .El
 .Pp
-This document corresponds to version 4.2.7p357 of NTP.
+This document corresponds to version 4.2.7p358 of NTP.
 .Pp
 This manual page was \fIAutoGen\fP\-erated from the \fBntpsnmpd\fP
 option definitions.
index 45e7a641c28c198784f3eec71b1ab1e99093daf1..6a28010e2bc967d9e1953324ed9e767926e98850 100644 (file)
@@ -42,7 +42,7 @@ Up:&nbsp;<a rel="up" accesskey="u" href="#dir">(dir)</a>
 <p>The <code>ntpsnmpd</code> utility program is used to monitor NTP daemon <code>ntpd</code>
 operations and determine performance.  It uses the standard NTP mode 6 control
 
-  <p>This document applies to version 4.2.7p357 of <code>ntpsnmpd</code>.
+  <p>This document applies to version 4.2.7p358 of <code>ntpsnmpd</code>.
 
 <ul class="menu">
 <li><a accesskey="1" href="#ntpsnmpd-Description">ntpsnmpd Description</a>:             Description
index a03eab023fd0ed8548b5ebb02aae167d4a61c1d6..edf16744fd60d13e8569d85a0112104cc53cfd1f 100644 (file)
@@ -1,8 +1,8 @@
-.TH ntpsnmpd @NTPSNMPD_MS@ "21 Feb 2013" "4.2.7p357" "User Commands"
+.TH ntpsnmpd @NTPSNMPD_MS@ "27 Feb 2013" "4.2.7p358" "User Commands"
 .\"
 .\"  EDIT THIS FILE WITH CAUTION  (ntpsnmpd-opts.man)
 .\"
-.\"  It has been AutoGen-ed  February 21, 2013 at 10:47:42 PM by AutoGen 5.17.2pre17
+.\"  It has been AutoGen-ed  February 27, 2013 at 11:38:25 AM by AutoGen 5.17.3.pre2
 .\"  From the definitions    ntpsnmpd-opts.def
 .\"  and the template file   agman-cmd.tpl
 .\"
@@ -169,7 +169,7 @@ please fill me in...
 .BR Li ntpEntTimeDistance
 please fill me in...
 .PP
-This document corresponds to version 4.2.7p357 of NTP.
+This document corresponds to version 4.2.7p358 of NTP.
 .PP
 This manual page was \fIAutoGen\fP-erated from the \fBntpsnmpd\fP
 option definitions.
index 7848ea837c5685f394fe916c214f8b4fecab73cf..7edad65d5e67ad475398163bc5f83b37cfcc8d60 100644 (file)
@@ -1,9 +1,9 @@
-.Dd February 21 2013
+.Dd February 27 2013
 .Dt NTPSNMPD @NTPSNMPD_MS@ User Commands
 .Os SunOS 5.10
 .\"  EDIT THIS FILE WITH CAUTION  (ntpsnmpd-opts.mdoc)
 .\"
-.\"  It has been AutoGen-ed  February 21, 2013 at 10:47:48 PM by AutoGen 5.17.2pre17
+.\"  It has been AutoGen-ed  February 27, 2013 at 11:38:31 AM by AutoGen 5.17.3.pre2
 .\"  From the definitions    ntpsnmpd-opts.def
 .\"  and the template file   agmdoc-cmd.tpl
 .Sh NAME
@@ -156,7 +156,7 @@ please fill me in...
 please fill me in...
 .El
 .Pp
-This document corresponds to version 4.2.7p357 of NTP.
+This document corresponds to version 4.2.7p358 of NTP.
 .Pp
 This manual page was \fIAutoGen\fP\-erated from the \fBntpsnmpd\fP
 option definitions.
index 9ca4443eb17f34cddfd85d4c6a5e24fad585c005..184334c1fb30d31b8db7a8953afe3831c073519b 100644 (file)
@@ -70,7 +70,7 @@ CLTAG=NTP_4_2_0
 # - Numeric values increment
 # - empty 'increments' to 1
 # - NEW 'increments' to empty
-point=357
+point=358
 
 ### betapoint is normally modified by script.
 # ntp-stable Beta number (betapoint)
index b41916dc403407300fcc72217a4107ce7f67918b..adb417f0a5b6f44a240966177f6d074710c75439 100644 (file)
@@ -6,7 +6,7 @@
 #
 # EDIT THIS FILE WITH CAUTION  (invoke-ntp-wait.texi)
 #
-# It has been AutoGen-ed  February 22, 2013 at 03:24:10 AM by AutoGen 5.17.2pre17
+# It has been AutoGen-ed  February 27, 2013 at 11:32:23 AM by AutoGen 5.17.3.pre2
 # From the definitions    ntp-wait-opts.def
 # and the template file   agtexi-cmd.tpl
 @end ignore
index 7cd7f93fcbd30948fda2d7dda8ca061e359dbaf6..f661ff568b9744ffddb9338d2b3047298e88e2d2 100644 (file)
@@ -1,8 +1,8 @@
-.TH ntp-wait 1ntp-waitman "22 Feb 2013" "ntp (4.2.7p357)" "User Commands"
+.TH ntp-wait 1ntp-waitman "27 Feb 2013" "ntp (4.2.7p358)" "User Commands"
 .\"
 .\"  EDIT THIS FILE WITH CAUTION  (ntp-wait-opts.man)
 .\"
-.\"  It has been AutoGen-ed  February 22, 2013 at 03:24:06 AM by AutoGen 5.17.2pre17
+.\"  It has been AutoGen-ed  February 27, 2013 at 11:32:19 AM by AutoGen 5.17.3.pre2
 .\"  From the definitions    ntp-wait-opts.def
 .\"  and the template file   agman-cmd.tpl
 .\"
@@ -117,7 +117,7 @@ This program is released under the terms of the NTP license, <http://ntp.org/lic
 .SH "BUGS"
 Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
 .SH NOTES
-This document corresponds to version 4.2.7p357 of NTP.
+This document corresponds to version 4.2.7p358 of NTP.
 .PP
 This manual page was \fIAutoGen\fP-erated from the \fBntp-wait\fP
 option definitions.
index ad8ccd3fbbef6cb58fc05ba8aa66856f2459ea63..a6ddf22715669868aa2234c1a2ac3a8a58062c66 100644 (file)
@@ -1,9 +1,9 @@
-.Dd February 22 2013
+.Dd February 27 2013
 .Dt NTP_WAIT 1ntp-waitmdoc User Commands
 .Os SunOS 5.10
 .\"  EDIT THIS FILE WITH CAUTION  (ntp-wait-opts.mdoc)
 .\"
-.\"  It has been AutoGen-ed  February 22, 2013 at 03:24:12 AM by AutoGen 5.17.2pre17
+.\"  It has been AutoGen-ed  February 27, 2013 at 11:32:26 AM by AutoGen 5.17.3.pre2
 .\"  From the definitions    ntp-wait-opts.def
 .\"  and the template file   agmdoc-cmd.tpl
 .Sh NAME
@@ -115,7 +115,7 @@ This program is released under the terms of the NTP license, <http://ntp.org/lic
 .Sh "BUGS"
 Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
 .Sh NOTES
-This document corresponds to version 4.2.7p357 of NTP.
+This document corresponds to version 4.2.7p358 of NTP.
 .Pp
 This manual page was \fIAutoGen\fP\-erated from the \fBntp\-wait\fP
 option definitions.
index 3854f038540cefd187fbc4175a906dd0aa63d544..26739217afc410a4e12c10d441a58350570397e5 100644 (file)
@@ -41,7 +41,7 @@ until the system's time has stabilized and synchronized,
 and only then start any applicaitons (like database servers) that require
 accurate and stable time.
 
-  <p>This document applies to version 4.2.7p357 of <code>ntp-wait</code>.
+  <p>This document applies to version 4.2.7p358 of <code>ntp-wait</code>.
 
 <div class="shortcontents">
 <h2>Short Contents</h2>
index 6e9b55c28f086ebdd8b4a941ba438588cae5bff3..07054c2ede1573e1c5a36c847bbcb3c3f9217d19 100644 (file)
@@ -1,8 +1,8 @@
-.TH ntp-wait @NTP_WAIT_MS@ "22 Feb 2013" "ntp (4.2.7p357)" "User Commands"
+.TH ntp-wait @NTP_WAIT_MS@ "27 Feb 2013" "ntp (4.2.7p358)" "User Commands"
 .\"
 .\"  EDIT THIS FILE WITH CAUTION  (ntp-wait-opts.man)
 .\"
-.\"  It has been AutoGen-ed  February 22, 2013 at 03:24:06 AM by AutoGen 5.17.2pre17
+.\"  It has been AutoGen-ed  February 27, 2013 at 11:32:19 AM by AutoGen 5.17.3.pre2
 .\"  From the definitions    ntp-wait-opts.def
 .\"  and the template file   agman-cmd.tpl
 .\"
@@ -117,7 +117,7 @@ This program is released under the terms of the NTP license, <http://ntp.org/lic
 .SH "BUGS"
 Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
 .SH NOTES
-This document corresponds to version 4.2.7p357 of NTP.
+This document corresponds to version 4.2.7p358 of NTP.
 .PP
 This manual page was \fIAutoGen\fP-erated from the \fBntp-wait\fP
 option definitions.
index 0951a2d425ed76e108a08c271147cc95ff487129..c0a7cd0a29a0facec1d1f1bb3426762d81631f30 100644 (file)
@@ -1,9 +1,9 @@
-.Dd February 22 2013
+.Dd February 27 2013
 .Dt NTP_WAIT @NTP_WAIT_MS@ User Commands
 .Os SunOS 5.10
 .\"  EDIT THIS FILE WITH CAUTION  (ntp-wait-opts.mdoc)
 .\"
-.\"  It has been AutoGen-ed  February 22, 2013 at 03:24:12 AM by AutoGen 5.17.2pre17
+.\"  It has been AutoGen-ed  February 27, 2013 at 11:32:26 AM by AutoGen 5.17.3.pre2
 .\"  From the definitions    ntp-wait-opts.def
 .\"  and the template file   agmdoc-cmd.tpl
 .Sh NAME
@@ -115,7 +115,7 @@ This program is released under the terms of the NTP license, <http://ntp.org/lic
 .Sh "BUGS"
 Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
 .Sh NOTES
-This document corresponds to version 4.2.7p357 of NTP.
+This document corresponds to version 4.2.7p358 of NTP.
 .Pp
 This manual page was \fIAutoGen\fP\-erated from the \fBntp\-wait\fP
 option definitions.
index ace16e6b1257833b5bd6276daecd7ada55f7b67d..22142775597c82d2c25f2d1c9353a5fddaf5ce21 100644 (file)
@@ -6,7 +6,7 @@
 #
 # EDIT THIS FILE WITH CAUTION  (invoke-sntp.texi)
 #
-# It has been AutoGen-ed  February 21, 2013 at 10:48:40 PM by AutoGen 5.17.2pre17
+# It has been AutoGen-ed  February 27, 2013 at 11:39:32 AM by AutoGen 5.17.3.pre2
 # From the definitions    sntp-opts.def
 # and the template file   agtexi-cmd.tpl
 @end ignore
@@ -101,7 +101,7 @@ with a status code of 0.
 
 @exampleindent 0
 @example
-sntp - standard Simple Network Time Protocol client program - Ver. 4.2.7p357
+sntp - standard Simple Network Time Protocol client program - Ver. 4.2.7p358
 Usage:  sntp [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]... \
                 [ hostname-or-IP ...]
   Flg Arg Option-Name    Description
@@ -152,7 +152,7 @@ The following option preset mechanisms are supported:
  - reading file ./.ntprc
  - examining environment variables named SNTP_*
 
-please send bug reports to:  <http://bugs.ntp.org, bugs@@ntp.org>
+Please send bug reports to:  <http://bugs.ntp.org, bugs@@ntp.org>
 @end example
 @exampleindent 4
 
index 7d5cc2b6e6f05fce61462e656a19ba3f51766fb3..e460f4c51c17957e37be4536af2170f8efe5340f 100644 (file)
@@ -1,7 +1,7 @@
 /*
  *  EDIT THIS FILE WITH CAUTION  (sntp-opts.c)
  *
- *  It has been AutoGen-ed  February 22, 2013 at 03:21:03 AM by AutoGen 5.17.2pre17
+ *  It has been AutoGen-ed  February 27, 2013 at 11:25:07 AM by AutoGen 5.17.3.pre2
  *  From the definitions    sntp-opts.def
  *  and the template file   options
  *
@@ -66,11 +66,11 @@ extern FILE * option_usage_fp;
 #  define NULL 0
 #endif
 
-/*
- *  sntp option static const strings
+/**
+ *  static const strings for sntp options
  */
 static char const sntp_opt_strs[2499] =
-/*     0 */ "sntp 4.2.7p357\n"
+/*     0 */ "sntp 4.2.7p358\n"
             "Copyright (C) 1970-2013 The University of Delaware, all rights reserved.\n"
             "This is free software. It is licensed for use, modification and\n"
             "redistribution under the terms of the NTP License, copies of which\n"
@@ -154,7 +154,7 @@ static char const sntp_opt_strs[2499] =
 /*  2244 */ "LOAD_OPTS\0"
 /*  2254 */ "no-load-opts\0"
 /*  2267 */ "SNTP\0"
-/*  2272 */ "sntp - standard Simple Network Time Protocol client program - Ver. 4.2.7p357\n"
+/*  2272 */ "sntp - standard Simple Network Time Protocol client program - Ver. 4.2.7p358\n"
             "Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \\\n"
             "\t\t[ hostname-or-IP ...]\n\0"
 /*  2433 */ "$HOME\0"
@@ -162,173 +162,253 @@ static char const sntp_opt_strs[2499] =
 /*  2441 */ ".ntprc\0"
 /*  2448 */ "http://bugs.ntp.org, bugs@ntp.org\0"
 /*  2482 */ "\n\0"
-/*  2484 */ "sntp 4.2.7p357";
+/*  2484 */ "sntp 4.2.7p358";
 
-/*
+/**
  *  ipv4 option description with
  *  "Must also have options" and "Incompatible options":
  */
+/** Descriptive text for the ipv4 option */
 #define IPV4_DESC      (sntp_opt_strs+954)
+/** Upper-cased name for the ipv4 option */
 #define IPV4_NAME      (sntp_opt_strs+985)
+/** Name string for the ipv4 option */
 #define IPV4_name      (sntp_opt_strs+990)
+/** Other options that appear in conjunction with the ipv4 option */
 static int const aIpv4CantList[] = {
     INDEX_OPT_IPV6, NO_EQUIVALENT };
+/** Compiled in flag settings for the ipv4 option */
 #define IPV4_FLAGS     (OPTST_DISABLED)
 
-/*
+/**
  *  ipv6 option description with
  *  "Must also have options" and "Incompatible options":
  */
+/** Descriptive text for the ipv6 option */
 #define IPV6_DESC      (sntp_opt_strs+995)
+/** Upper-cased name for the ipv6 option */
 #define IPV6_NAME      (sntp_opt_strs+1026)
+/** Name string for the ipv6 option */
 #define IPV6_name      (sntp_opt_strs+1031)
+/** Other options that appear in conjunction with the ipv6 option */
 static int const aIpv6CantList[] = {
     INDEX_OPT_IPV4, NO_EQUIVALENT };
+/** Compiled in flag settings for the ipv6 option */
 #define IPV6_FLAGS     (OPTST_DISABLED)
 
-/*
+/**
  *  authentication option description:
  */
+/** Descriptive text for the authentication option */
 #define AUTHENTICATION_DESC      (sntp_opt_strs+1036)
+/** Upper-cased name for the authentication option */
 #define AUTHENTICATION_NAME      (sntp_opt_strs+1086)
+/** Name string for the authentication option */
 #define AUTHENTICATION_name      (sntp_opt_strs+1101)
+/** Compiled in flag settings for the authentication option */
 #define AUTHENTICATION_FLAGS     (OPTST_DISABLED \
         | OPTST_SET_ARGTYPE(OPARG_TYPE_NUMERIC))
 
-/*
+/**
  *  broadcast option description:
  */
+/** Descriptive text for the broadcast option */
 #define BROADCAST_DESC      (sntp_opt_strs+1116)
+/** Upper-cased name for the broadcast option */
 #define BROADCAST_NAME      (sntp_opt_strs+1172)
+/** Name string for the broadcast option */
 #define BROADCAST_name      (sntp_opt_strs+1182)
+/** Compiled in flag settings for the broadcast option */
 #define BROADCAST_FLAGS     (OPTST_DISABLED | OPTST_STACKED \
         | OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
 
-/*
+/**
  *  concurrent option description:
  */
+/** Descriptive text for the concurrent option */
 #define CONCURRENT_DESC      (sntp_opt_strs+1192)
+/** Upper-cased name for the concurrent option */
 #define CONCURRENT_NAME      (sntp_opt_strs+1242)
+/** Name string for the concurrent option */
 #define CONCURRENT_name      (sntp_opt_strs+1253)
+/** Compiled in flag settings for the concurrent option */
 #define CONCURRENT_FLAGS     (OPTST_DISABLED | OPTST_STACKED \
         | OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
 
-/*
+/**
  *  debug-level option description:
  */
+/** Descriptive text for the debug-level option */
 #define DEBUG_LEVEL_DESC      (sntp_opt_strs+1264)
+/** Upper-cased name for the debug-level option */
 #define DEBUG_LEVEL_NAME      (sntp_opt_strs+1295)
+/** Name string for the debug-level option */
 #define DEBUG_LEVEL_name      (sntp_opt_strs+1307)
+/** Compiled in flag settings for the debug-level option */
 #define DEBUG_LEVEL_FLAGS     (OPTST_DISABLED)
 
-/*
+/**
  *  set-debug-level option description:
  */
+/** Descriptive text for the set-debug-level option */
 #define SET_DEBUG_LEVEL_DESC      (sntp_opt_strs+1319)
+/** Upper-cased name for the set-debug-level option */
 #define SET_DEBUG_LEVEL_NAME      (sntp_opt_strs+1349)
+/** Name string for the set-debug-level option */
 #define SET_DEBUG_LEVEL_name      (sntp_opt_strs+1365)
+/** Compiled in flag settings for the set-debug-level option */
 #define SET_DEBUG_LEVEL_FLAGS     (OPTST_DISABLED \
         | OPTST_SET_ARGTYPE(OPARG_TYPE_NUMERIC))
 
-/*
+/**
  *  gap option description:
  */
+/** Descriptive text for the gap option */
 #define GAP_DESC      (sntp_opt_strs+1381)
+/** Upper-cased name for the gap option */
 #define GAP_NAME      (sntp_opt_strs+1429)
+/** Name string for the gap option */
 #define GAP_name      (sntp_opt_strs+1433)
+/** The compiled in default value for the gap option argument */
 #define GAP_DFT_ARG   ((char const*)50)
+/** Compiled in flag settings for the gap option */
 #define GAP_FLAGS     (OPTST_DISABLED \
         | OPTST_SET_ARGTYPE(OPARG_TYPE_NUMERIC))
 
-/*
+/**
  *  kod option description:
  */
+/** Descriptive text for the kod option */
 #define KOD_DESC      (sntp_opt_strs+1437)
+/** Upper-cased name for the kod option */
 #define KOD_NAME      (sntp_opt_strs+1458)
+/** Name string for the kod option */
 #define KOD_name      (sntp_opt_strs+1462)
+/** The compiled in default value for the kod option argument */
 #define KOD_DFT_ARG   (sntp_opt_strs+1466)
+/** Compiled in flag settings for the kod option */
 #define KOD_FLAGS     (OPTST_DISABLED \
         | OPTST_SET_ARGTYPE(OPARG_TYPE_FILE))
 
-/*
+/**
  *  keyfile option description:
  */
+/** Descriptive text for the keyfile option */
 #define KEYFILE_DESC      (sntp_opt_strs+1482)
+/** Upper-cased name for the keyfile option */
 #define KEYFILE_NAME      (sntp_opt_strs+1530)
+/** Name string for the keyfile option */
 #define KEYFILE_name      (sntp_opt_strs+1538)
+/** Compiled in flag settings for the keyfile option */
 #define KEYFILE_FLAGS     (OPTST_DISABLED \
         | OPTST_SET_ARGTYPE(OPARG_TYPE_FILE))
 
-/*
+/**
  *  logfile option description:
  */
+/** Descriptive text for the logfile option */
 #define LOGFILE_DESC      (sntp_opt_strs+1546)
+/** Upper-cased name for the logfile option */
 #define LOGFILE_NAME      (sntp_opt_strs+1571)
+/** Name string for the logfile option */
 #define LOGFILE_name      (sntp_opt_strs+1579)
+/** Compiled in flag settings for the logfile option */
 #define LOGFILE_FLAGS     (OPTST_DISABLED \
         | OPTST_SET_ARGTYPE(OPARG_TYPE_FILE))
 
-/*
+/**
  *  steplimit option description:
  */
+/** Descriptive text for the steplimit option */
 #define STEPLIMIT_DESC      (sntp_opt_strs+1587)
+/** Upper-cased name for the steplimit option */
 #define STEPLIMIT_NAME      (sntp_opt_strs+1639)
+/** Name string for the steplimit option */
 #define STEPLIMIT_name      (sntp_opt_strs+1649)
+/** Compiled in flag settings for the steplimit option */
 #define STEPLIMIT_FLAGS     (OPTST_DISABLED \
         | OPTST_SET_ARGTYPE(OPARG_TYPE_NUMERIC))
 
-/*
+/**
  *  ntpversion option description:
  */
+/** Descriptive text for the ntpversion option */
 #define NTPVERSION_DESC      (sntp_opt_strs+1659)
+/** Upper-cased name for the ntpversion option */
 #define NTPVERSION_NAME      (sntp_opt_strs+1696)
+/** Name string for the ntpversion option */
 #define NTPVERSION_name      (sntp_opt_strs+1707)
+/** The compiled in default value for the ntpversion option argument */
 #define NTPVERSION_DFT_ARG   ((char const*)4)
+/** Compiled in flag settings for the ntpversion option */
 #define NTPVERSION_FLAGS     (OPTST_DISABLED \
         | OPTST_SET_ARGTYPE(OPARG_TYPE_NUMERIC))
 
-/*
+/**
  *  usereservedport option description:
  */
+/** Descriptive text for the usereservedport option */
 #define USERESERVEDPORT_DESC      (sntp_opt_strs+1718)
+/** Upper-cased name for the usereservedport option */
 #define USERESERVEDPORT_NAME      (sntp_opt_strs+1755)
+/** Name string for the usereservedport option */
 #define USERESERVEDPORT_name      (sntp_opt_strs+1771)
+/** Compiled in flag settings for the usereservedport option */
 #define USERESERVEDPORT_FLAGS     (OPTST_DISABLED)
 
-/*
+/**
  *  step option description:
  */
+/** Descriptive text for the step option */
 #define STEP_DESC      (sntp_opt_strs+1787)
+/** Upper-cased name for the step option */
 #define STEP_NAME      (sntp_opt_strs+1830)
+/** Name string for the step option */
 #define STEP_name      (sntp_opt_strs+1835)
+/** Compiled in flag settings for the step option */
 #define STEP_FLAGS     (OPTST_DISABLED)
 
-/*
+/**
  *  slew option description:
  */
+/** Descriptive text for the slew option */
 #define SLEW_DESC      (sntp_opt_strs+1840)
+/** Upper-cased name for the slew option */
 #define SLEW_NAME      (sntp_opt_strs+1878)
+/** Name string for the slew option */
 #define SLEW_name      (sntp_opt_strs+1883)
+/** Compiled in flag settings for the slew option */
 #define SLEW_FLAGS     (OPTST_DISABLED)
 
-/*
+/**
  *  timeout option description:
  */
+/** Descriptive text for the timeout option */
 #define TIMEOUT_DESC      (sntp_opt_strs+1888)
+/** Upper-cased name for the timeout option */
 #define TIMEOUT_NAME      (sntp_opt_strs+1932)
+/** Name string for the timeout option */
 #define TIMEOUT_name      (sntp_opt_strs+1940)
+/** The compiled in default value for the timeout option argument */
 #define TIMEOUT_DFT_ARG   ((char const*)5)
+/** Compiled in flag settings for the timeout option */
 #define TIMEOUT_FLAGS     (OPTST_DISABLED \
         | OPTST_SET_ARGTYPE(OPARG_TYPE_NUMERIC))
 
-/*
+/**
  *  wait option description:
  */
+/** Descriptive text for the wait option */
 #define WAIT_DESC      (sntp_opt_strs+1948)
+/** Upper-cased name for the wait option */
 #define WAIT_NAME      (sntp_opt_strs+1999)
+/** disablement name for the wait option */
 #define NOT_WAIT_name  (sntp_opt_strs+2004)
+/** disablement prefix for the wait option */
 #define NOT_WAIT_PFX   (sntp_opt_strs+2012)
+/** Name string for the wait option */
 #define WAIT_name      (NOT_WAIT_name + 3)
+/** Compiled in flag settings for the wait option */
 #define WAIT_FLAGS     (OPTST_INITENABLED)
 
 /*
@@ -360,7 +440,7 @@ static int const aIpv6CantList[] = {
 #define NO_LOAD_OPTS_name  (sntp_opt_strs+2254)
 #define LOAD_OPTS_pfx      (sntp_opt_strs+2012)
 #define LOAD_OPTS_name     (NO_LOAD_OPTS_name + 3)
-/*
+/**
  *  Declare option callback procedures
  */
 #if defined(TEST_SNTP_OPTS)
@@ -391,7 +471,7 @@ static tOptProc
     doOptDebug_Level, doOptKeyfile,     doOptKod,         doOptLogfile,
     doOptNtpversion,  doOptSteplimit,   doUsageOpt;
 
-/*
+/**
  *  #define map the "normal" callout procs
  */
 #define DEBUG_LEVEL_OPT_PROC doOptDebug_Level
@@ -688,22 +768,27 @@ static tOptDesc optDesc[OPTION_CT] = {
 };
 
 
-/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
- *
- *  Define the sntp Option Environment
- */
+/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
+/** Reference to the upper cased version of sntp. */
 #define zPROGNAME       (sntp_opt_strs+2267)
+/** Reference to the title line for sntp usage. */
 #define zUsageTitle     (sntp_opt_strs+2272)
+/** sntp configuration file name. */
 #define zRcName         (sntp_opt_strs+2441)
+/** Directories to search for sntp config files. */
 static char const * const apzHomeList[3] = {
     sntp_opt_strs+2433,
     sntp_opt_strs+2439,
     NULL };
+/** The sntp program bug email address. */
 #define zBugsAddr       (sntp_opt_strs+2448)
+/** Clarification/explanation of what sntp does. */
 #define zExplain        (sntp_opt_strs+2482)
+/** Extra detail explaining what sntp does. */
 #define zDetail         (NULL)
+/** The full version string for sntp. */
 #define zFullVersion    (sntp_opt_strs+2484)
-/* extracted from optcode.tlib near line 364 */
+/* extracted from optcode.tlib near line 371 */
 
 #if defined(ENABLE_NLS)
 # define OPTPROC_BASE OPTPROC_TRANSLATE
@@ -724,8 +809,8 @@ static char const * const apzHomeList[3] = {
 /**
  * The callout function that invokes the optionUsage function.
  *
- * @param pOptions the AutoOpts option description structure
- * @param pOptDesc the descriptor for the "help" (usage) option.
+ * @param[in] pOptions the AutoOpts option description structure
+ * @param[in] pOptDesc the descriptor for the "help" (usage) option.
  * @noreturn
  */
 static void
@@ -743,8 +828,8 @@ doUsageOpt(tOptions * pOptions, tOptDesc * pOptDesc)
 /**
  * Code to handle the debug-level option.
  *
- * @param pOptions the sntp options data structure
- * @param pOptDesc the option descriptor for this option.
+ * @param[in] pOptions the sntp options data structure
+ * @param[in,out] pOptDesc the option descriptor for this option.
  */
 static void
 doOptDebug_Level(tOptions* pOptions, tOptDesc* pOptDesc)
@@ -765,9 +850,10 @@ OPT_VALUE_SET_DEBUG_LEVEL++;
 /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
 /**
  * Code to handle the kod option.
- *
- * @param pOptions the sntp options data structure
- * @param pOptDesc the option descriptor for this option.
+ * Specifies the filename to be used for the persistent history of KoD
+ * responses received from servers.
+ * @param[in] pOptions the sntp options data structure
+ * @param[in,out] pOptDesc the option descriptor for this option.
  */
 static void
 doOptKod(tOptions* pOptions, tOptDesc* pOptDesc)
@@ -789,9 +875,12 @@ doOptKod(tOptions* pOptions, tOptDesc* pOptDesc)
 /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
 /**
  * Code to handle the keyfile option.
- *
- * @param pOptions the sntp options data structure
- * @param pOptDesc the option descriptor for this option.
+ * This option specifies the keyfile.
+ * @code{sntp} will search for the key specified with @option{-a}
+ * @file{keyno} in this file.  See @command{ntp.keys(5)} for more
+ * information.
+ * @param[in] pOptions the sntp options data structure
+ * @param[in,out] pOptDesc the option descriptor for this option.
  */
 static void
 doOptKeyfile(tOptions* pOptions, tOptDesc* pOptDesc)
@@ -813,9 +902,10 @@ doOptKeyfile(tOptions* pOptions, tOptDesc* pOptDesc)
 /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
 /**
  * Code to handle the logfile option.
- *
- * @param pOptions the sntp options data structure
- * @param pOptDesc the option descriptor for this option.
+ * This option causes the client to write log messages to the specified
+ * @file{logfile}.
+ * @param[in] pOptions the sntp options data structure
+ * @param[in,out] pOptDesc the option descriptor for this option.
  */
 static void
 doOptLogfile(tOptions* pOptions, tOptDesc* pOptDesc)
@@ -837,9 +927,11 @@ doOptLogfile(tOptions* pOptions, tOptDesc* pOptDesc)
 /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
 /**
  * Code to handle the steplimit option.
- *
- * @param pOptions the sntp options data structure
- * @param pOptDesc the option descriptor for this option.
+ * If the time adjustment is less than @file{steplimit} milliseconds,
+ * slew the amount using @command{adjtime(2)}.  Otherwise, step the
+ * correction using @command{settimeofday(2)}.
+ * @param[in] pOptions the sntp options data structure
+ * @param[in,out] pOptDesc the option descriptor for this option.
  */
 static void
 doOptSteplimit(tOptions* pOptions, tOptDesc* pOptDesc)
@@ -872,9 +964,10 @@ doOptSteplimit(tOptions* pOptions, tOptDesc* pOptDesc)
 /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
 /**
  * Code to handle the ntpversion option.
- *
- * @param pOptions the sntp options data structure
- * @param pOptDesc the option descriptor for this option.
+ * When sending requests to a remote server, tell them we are running
+ * NTP protocol version @file{ntpversion} .
+ * @param[in] pOptions the sntp options data structure
+ * @param[in,out] pOptDesc the option descriptor for this option.
  */
 static void
 doOptNtpversion(tOptions* pOptions, tOptDesc* pOptDesc)
@@ -913,8 +1006,8 @@ extern void optionPutShell(tOptions*);
  * Generated main procedure.  This will emit text that a Bourne shell can
  * process to handle its command line arguments.
  *
- * @param argc argument count
- * @param argv argument vector
+ * @param[in] argc argument count
+ * @param[in] argv argument vector
  * @returns program exit code
  */
 int
@@ -945,6 +1038,7 @@ main(int argc, char ** argv)
 #ifndef  WITH_PACKAGER
 # define sntp_packager_info NULL
 #else
+/** Packager information for sntp. */
 static char const sntp_packager_info[] =
     "Packaged by " WITH_PACKAGER
 
@@ -999,7 +1093,7 @@ tOptions sntpOptions = {
 };
 
 #if ENABLE_NLS
-/*
+/**
  * This code is designed to translate translatable option text for the
  * sntp program.  These translations happen upon entry
  * to optionProcess().
@@ -1108,6 +1202,7 @@ translate_option_strings(void)
 #endif /* ENABLE_NLS */
 
 #ifdef DO_NOT_COMPILE_THIS_CODE_IT_IS_FOR_GETTEXT
+/** I18N function strictly for xgettext.  Do not compile. */
 static void bogus_function(void) {
   /* TRANSLATORS:
 
@@ -1126,7 +1221,7 @@ static void bogus_function(void) {
      translate option names.
    */
   /* referenced via sntpOptions.pzCopyright */
-  puts(_("sntp 4.2.7p357\n\
+  puts(_("sntp 4.2.7p358\n\
 Copyright (C) 1970-2013 The University of Delaware, all rights reserved.\n\
 This is free software. It is licensed for use, modification and\n\
 redistribution under the terms of the NTP License, copies of which\n\
@@ -1215,7 +1310,7 @@ provided \"as is\" without express or implied warranty.\n"));
   puts(_("load options from a config file"));
 
   /* referenced via sntpOptions.pzUsageTitle */
-  puts(_("sntp - standard Simple Network Time Protocol client program - Ver. 4.2.7p357\n\
+  puts(_("sntp - standard Simple Network Time Protocol client program - Ver. 4.2.7p358\n\
 Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \\\n\
 \t\t[ hostname-or-IP ...]\n"));
 
@@ -1223,7 +1318,7 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \\\n\
   puts(_("\n"));
 
   /* referenced via sntpOptions.pzFullVersion */
-  puts(_("sntp 4.2.7p357"));
+  puts(_("sntp 4.2.7p358"));
 
   /* referenced via sntpOptions.pzFullUsage */
   puts(_("<<<NOT-FOUND>>>"));
@@ -1258,7 +1353,7 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \\\n\
   puts(_("could not locate the 'help' option"));
 #line 351 "../autoopts.c"
   puts(_("optionProcess() was called with invalid data"));
-#line 770 "../usage.c"
+#line 783 "../usage.c"
   puts(_("invalid argument type specified"));
 #line 589 "../find.c"
   puts(_("defaulted to option with optional arg"));
@@ -1307,9 +1402,9 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \\\n\
   puts(_("  or an integer from %d through %d\n"));
 #line 164 "../enum.c"
   puts(_("  or an integer from %d through %d\n"));
-#line 769 "../usage.c"
+#line 782 "../usage.c"
   puts(_("%s error:  invalid option descriptor for %s\n"));
-#line 1097 "../usage.c"
+#line 1110 "../usage.c"
   puts(_("%s error:  invalid option descriptor for %s\n"));
 #line 379 "../find.c"
   puts(_("%s: invalid option name: %s\n"));
@@ -1317,7 +1412,7 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \\\n\
   puts(_("%s: The '%s' option requires an argument.\n"));
 #line 171 "../autoopts.c"
   puts(_("(AutoOpts bug):  Equivalenced option '%s' was equivalenced to both\n"
-       "\t'%s' and '%s'"));
+       "\t'%s' and '%s'."));
 #line 94 "../check.c"
   puts(_("%s error:  The %s option is required\n"));
 #line 623 "../find.c"
@@ -1345,7 +1440,7 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \\\n\
 #line 53 "../time.c"
   puts(_("%s error:  '%s' is not a recognizable time duration.\n"));
 #line 92 "../check.c"
-  puts(_("%s error:  The %s option must appear %d times\n"));
+  puts(_("%s error:  The %s option must appear %d times.\n"));
 #line 157 "../numeric.c"
   puts(_("%s error:  '%s' is not a recognizable number.\n"));
 #line 195 "../enum.c"
@@ -1362,7 +1457,7 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \\\n\
   puts(_("standard output"));
 #line 451 "../usage.c"
   puts(_("standard output"));
-#line 647 "../usage.c"
+#line 660 "../usage.c"
   puts(_("standard output"));
 #line 175 "../version.c"
   puts(_("standard output"));
@@ -1370,7 +1465,7 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \\\n\
   puts(_("standard error"));
 #line 451 "../usage.c"
   puts(_("standard error"));
-#line 647 "../usage.c"
+#line 660 "../usage.c"
   puts(_("standard error"));
 #line 175 "../version.c"
   puts(_("standard error"));
@@ -1382,7 +1477,7 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \\\n\
   puts(_("write"));
 #line 450 "../usage.c"
   puts(_("write"));
-#line 646 "../usage.c"
+#line 659 "../usage.c"
   puts(_("write"));
 #line 174 "../version.c"
   puts(_("write"));
@@ -1403,23 +1498,23 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \\\n\
   /* END-LIBOPTS-MESSAGES */
 
   /* USAGE-TEXT: */
-#line 895 "../usage.c"
+#line 908 "../usage.c"
   puts(_("\t\t\t\t- an alternate for '%s'\n"));
-#line 1164 "../usage.c"
+#line 1177 "../usage.c"
   puts(_("Version, usage and configuration options:"));
-#line 946 "../usage.c"
+#line 959 "../usage.c"
   puts(_("\t\t\t\t- default option for unnamed options\n"));
-#line 859 "../usage.c"
+#line 872 "../usage.c"
   puts(_("\t\t\t\t- disabled as '--%s'\n"));
-#line 1133 "../usage.c"
+#line 1146 "../usage.c"
   puts(_(" --- %-14s %s\n"));
-#line 1131 "../usage.c"
+#line 1144 "../usage.c"
   puts(_("This option has been disabled"));
-#line 886 "../usage.c"
+#line 899 "../usage.c"
   puts(_("\t\t\t\t- enabled by default\n"));
 #line 40 "../alias.c"
   puts(_("%s error:  only "));
-#line 1208 "../usage.c"
+#line 1221 "../usage.c"
   puts(_(" - examining environment variables named %s_*\n"));
 #line 168 "../file.c"
   puts(_("\t\t\t\t- file must not pre-exist\n"));
@@ -1435,31 +1530,31 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \\\n\
        "a shell script to parse the options for %s:\n\n"));
 #line 161 "../enum.c"
   puts(_("  or an integer mask with any of the lower %d bits set\n"));
-#line 919 "../usage.c"
+#line 932 "../usage.c"
   puts(_("\t\t\t\t- is a set membership option\n"));
-#line 940 "../usage.c"
+#line 953 "../usage.c"
   puts(_("\t\t\t\t- must appear between %d and %d times\n"));
 #line 418 "../usage.c"
   puts(_("Options are specified by single or double hyphens and their name.\n"));
-#line 926 "../usage.c"
+#line 939 "../usage.c"
   puts(_("\t\t\t\t- may appear multiple times\n"));
-#line 913 "../usage.c"
+#line 926 "../usage.c"
   puts(_("\t\t\t\t- may not be preset\n"));
-#line 1323 "../usage.c"
+#line 1336 "../usage.c"
   puts(_("   Arg Option-Name    Description\n"));
-#line 1259 "../usage.c"
+#line 1272 "../usage.c"
   puts(_("  Flg Arg Option-Name    Description\n"));
-#line 1317 "../usage.c"
+#line 1330 "../usage.c"
   puts(_("  Flg Arg Option-Name    Description\n"));
-#line 1318 "../usage.c"
+#line 1331 "../usage.c"
   puts(_(" %3s %s"));
-#line 1324 "../usage.c"
+#line 1337 "../usage.c"
   puts(_(" %3s %s"));
 #line 423 "../usage.c"
   puts(_("The '-#<number>' option may omit the hash char\n"));
 #line 419 "../usage.c"
   puts(_("All arguments are named options.\n"));
-#line 993 "../usage.c"
+#line 1006 "../usage.c"
   puts(_(" - reading file %s"));
 #line 445 "../usage.c"
   puts(_("\n"
@@ -1470,17 +1565,17 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \\\n\
 #line 129 "../version.c"
   puts(_("\n"
        "please send bug reports to:  <%s>\n"));
-#line 925 "../usage.c"
+#line 938 "../usage.c"
   puts(_("\t\t\t\t- may NOT appear - preset only\n"));
-#line 965 "../usage.c"
+#line 978 "../usage.c"
   puts(_("\n"
        "The following option preset mechanisms are supported:\n"));
-#line 1206 "../usage.c"
+#line 1219 "../usage.c"
   puts(_("\n"
        "The following option preset mechanisms are supported:\n"));
-#line 704 "../usage.c"
+#line 717 "../usage.c"
   puts(_("prohibits these options:\n"));
-#line 699 "../usage.c"
+#line 712 "../usage.c"
   puts(_("prohibits the option '%s'\n"));
 #line 81 "../numeric.c"
   puts(_("%s%ld to %ld"));
@@ -1500,26 +1595,26 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \\\n\
   puts(_("%sless than or equal to %ld"));
 #line 426 "../usage.c"
   puts(_("Operands and options may be intermixed.  They will be reordered.\n"));
-#line 674 "../usage.c"
+#line 687 "../usage.c"
   puts(_("requires the option '%s'\n"));
-#line 677 "../usage.c"
+#line 690 "../usage.c"
   puts(_("requires these options:\n"));
-#line 1335 "../usage.c"
+#line 1348 "../usage.c"
   puts(_("   Arg Option-Name   Req?  Description\n"));
-#line 1329 "../usage.c"
+#line 1342 "../usage.c"
   puts(_("  Flg Arg Option-Name   Req?  Description\n"));
 #line 162 "../enum.c"
   puts(_("or you may use a numeric representation.  Preceding these with a '!'\n"
        "will clear the bits, specifying 'none' will clear all bits, and 'all'\n"
        "will set them all.  Multiple entries may be passed as an option\n"
        "argument list.\n"));
-#line 932 "../usage.c"
+#line 945 "../usage.c"
   puts(_("\t\t\t\t- may appear up to %d times\n"));
 #line 72 "../enum.c"
   puts(_("The valid \"%s\" option keywords are:\n"));
-#line 1168 "../usage.c"
+#line 1181 "../usage.c"
   puts(_("The next option supports vendor supported extra options:"));
-#line 795 "../usage.c"
+#line 808 "../usage.c"
   puts(_("These additional options are:"));
   /* END-USAGE-TEXT */
 }
index d50c9df13914e6aba3c57a1dbc7a697dcda88c3d..18c5d6cb7deaf9b1f84d1906691e40f9156b86eb 100644 (file)
@@ -1,7 +1,7 @@
 /*
  *  EDIT THIS FILE WITH CAUTION  (sntp-opts.h)
  *
- *  It has been AutoGen-ed  February 22, 2013 at 03:21:02 AM by AutoGen 5.17.2pre17
+ *  It has been AutoGen-ed  February 27, 2013 at 11:25:02 AM by AutoGen 5.17.3.pre2
  *  From the definitions    sntp-opts.def
  *  and the template file   options
  *
@@ -35,7 +35,7 @@
  *  representations about the suitability this software for any purpose. It
  *  is provided "as is" without express or implied warranty.
  */
-/*
+/**
  *  This file contains the programmatic interface to the Automated
  *  Options generated for the sntp program.
  *  These macros are documented in the AutoGen info file in the
@@ -46,7 +46,7 @@
 #include "config.h"
 #include <autoopts/options.h>
 
-/*
+/**
  *  Ensure that the library used for compiling this generated header is at
  *  least as new as the version current when the header template was released
  *  (not counting patch version increments).  Also ensure that the oldest
@@ -60,8 +60,8 @@
   Choke Me.
 #endif
 
-/*
- *  Enumeration of each option:
+/**
+ *  Enumeration of each option type for sntp
  */
 typedef enum {
     INDEX_OPT_IPV4             =  0,
@@ -88,34 +88,51 @@ typedef enum {
     INDEX_OPT_SAVE_OPTS        = 21,
     INDEX_OPT_LOAD_OPTS        = 22
 } teOptIndex;
-
+/** count of all options for sntp */
 #define OPTION_CT    23
-#define SNTP_VERSION       "4.2.7p357"
-#define SNTP_FULL_VERSION  "sntp 4.2.7p357"
+/** sntp version */
+#define SNTP_VERSION       "4.2.7p358"
+/** Full sntp version text */
+#define SNTP_FULL_VERSION  "sntp 4.2.7p358"
 
-/*
+/**
  *  Interface defines for all options.  Replace "n" with the UPPER_CASED
  *  option name (as in the teOptIndex enumeration above).
  *  e.g. HAVE_OPT(IPV4)
  */
 #define         DESC(n) (sntpOptions.pOptDesc[INDEX_OPT_## n])
+/** 'true' if an option has been specified in any way */
 #define     HAVE_OPT(n) (! UNUSED_OPT(& DESC(n)))
+/** The string argument to an option. The argument type must be "string". */
 #define      OPT_ARG(n) (DESC(n).optArg.argString)
+/** Mask the option state revealing how an option was specified.
+ *  It will be one and only one of \a OPTST_SET, \a OPTST_PRESET,
+ * \a OPTST_DEFINED, \a OPTST_RESET or zero.
+ */
 #define    STATE_OPT(n) (DESC(n).fOptState & OPTST_SET_MASK)
+/** Count of option's occurrances *on the command line*. */
 #define    COUNT_OPT(n) (DESC(n).optOccCt)
+/** mask of \a OPTST_SET and \a OPTST_DEFINED. */
 #define    ISSEL_OPT(n) (SELECTED_OPT(&DESC(n)))
+/** 'true' if \a HAVE_OPT would yield 'false'. */
 #define ISUNUSED_OPT(n) (UNUSED_OPT(& DESC(n)))
+/** 'true' if OPTST_DISABLED bit not set. */
 #define  ENABLED_OPT(n) (! DISABLED_OPT(& DESC(n)))
+/** number of stacked option arguments.
+ *  Valid only for stacked option arguments. */
 #define  STACKCT_OPT(n) (((tArgList*)(DESC(n).optCookie))->useCt)
+/** stacked argument vector.
+ *  Valid only for stacked option arguments. */
 #define STACKLST_OPT(n) (((tArgList*)(DESC(n).optCookie))->apzArgs)
+/** Reset an option. */
 #define    CLEAR_OPT(n) STMTS( \
                 DESC(n).fOptState &= OPTST_PERSISTENT_MASK;   \
                 if ((DESC(n).fOptState & OPTST_INITENABLED) == 0) \
                     DESC(n).fOptState |= OPTST_DISABLED; \
                 DESC(n).optCookie = NULL )
 
-/* * * * * *
- *
+/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
+/**
  *  Enumeration of sntp exit codes
  */
 typedef enum {
@@ -125,7 +142,8 @@ typedef enum {
     SNTP_EXIT_NO_CONFIG_INPUT       = 66,
     SNTP_EXIT_LIBOPTS_FAILURE       = 70
 } sntp_exit_code_t;
-/*
+/** @} */
+/**
  *  Make sure there are no #define name conflicts with the option names
  */
 #ifndef     NO_OPTION_NAME_WARNINGS
@@ -222,9 +240,10 @@ typedef enum {
 # undef WAIT
 #endif  /*  NO_OPTION_NAME_WARNINGS */
 
-/* * * * * *
- *
+/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
+/**
  *  Interface defines for specific options.
+ * @{
  */
 #define VALUE_OPT_IPV4           '4'
 #define VALUE_OPT_IPV6           '6'
@@ -266,10 +285,15 @@ typedef enum {
         DESC(WAIT).fOptState &= OPTST_PERSISTENT_MASK; \
         DESC(WAIT).fOptState |= OPTST_SET | OPTST_DISABLED; \
         DESC(WAIT).optArg.argString = NULL )
+/** option flag (value) for " (get "val-name") " option */
 #define VALUE_OPT_HELP          '?'
+/** option flag (value) for " (get "val-name") " option */
 #define VALUE_OPT_MORE_HELP     '!'
+/** option flag (value) for " (get "val-name") " option */
 #define VALUE_OPT_VERSION       INDEX_OPT_VERSION
+/** option flag (value) for " (get "val-name") " option */
 #define VALUE_OPT_SAVE_OPTS     '>'
+/** option flag (value) for " (get "val-name") " option */
 #define VALUE_OPT_LOAD_OPTS     '<'
 #define SET_OPT_SAVE_OPTS(a)   STMTS( \
         DESC(SAVE_OPTS).fOptState &= OPTST_PERSISTENT_MASK; \
@@ -285,7 +309,7 @@ typedef enum {
                 sntpOptions.pzCurOpt  = NULL)
 #define START_OPT       RESTART_OPT(1)
 #define USAGE(c)        (*sntpOptions.pUsageProc)(&sntpOptions, c)
-/* extracted from opthead.tlib near line 498 */
+/* extracted from opthead.tlib near line 538 */
 
 #ifdef  __cplusplus
 extern "C" {
index fdca25a5e5116da9c6e7de690a951cb620ebbcf5..5dc80cb244916127f51c819ab30796f875b2d13d 100644 (file)
@@ -1,8 +1,8 @@
-.TH sntp 1sntpman "21 Feb 2013" "4.2.7p357" "User Commands"
+.TH sntp 1sntpman "27 Feb 2013" "4.2.7p358" "User Commands"
 .\"
 .\"  EDIT THIS FILE WITH CAUTION  (sntp-opts.man)
 .\"
-.\"  It has been AutoGen-ed  February 21, 2013 at 10:48:36 PM by AutoGen 5.17.2pre17
+.\"  It has been AutoGen-ed  February 27, 2013 at 11:39:28 AM by AutoGen 5.17.3.pre2
 .\"  From the definitions    sntp-opts.def
 .\"  and the template file   agman-cmd.tpl
 .\"
@@ -316,7 +316,7 @@ This program is released under the terms of the NTP license, <http://ntp.org/lic
 .SH "BUGS"
 Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
 .SH NOTES
-This document corresponds to version 4.2.7p357 of
+This document corresponds to version 4.2.7p358 of
 .B  .
 .PP
 This manual page was \fIAutoGen\fP-erated from the \fBsntp\fP
index a9c15b025a4ae444263227fd1d0e2789ac96c598..17f67c3e4d25252cced4f9721c922caa900d1c46 100644 (file)
@@ -1,9 +1,9 @@
-.Dd February 21 2013
+.Dd February 27 2013
 .Dt SNTP 1sntpmdoc User Commands
 .Os SunOS 5.10
 .\"  EDIT THIS FILE WITH CAUTION  (sntp-opts.mdoc)
 .\"
-.\"  It has been AutoGen-ed  February 21, 2013 at 10:48:42 PM by AutoGen 5.17.2pre17
+.\"  It has been AutoGen-ed  February 27, 2013 at 11:39:34 AM by AutoGen 5.17.3.pre2
 .\"  From the definitions    sntp-opts.def
 .\"  and the template file   agmdoc-cmd.tpl
 .Sh NAME
@@ -297,7 +297,7 @@ This program is released under the terms of the NTP license, <http://ntp.org/lic
 .Sh "BUGS"
 Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
 .Sh NOTES
-This document corresponds to version 4.2.7p357 of
+This document corresponds to version 4.2.7p358 of
 .Nm .
 .Pp
 This manual page was \fIAutoGen\fP\-erated from the \fBsntp\fP
index 67c1dd453d9a0e0ec3ce5bfb0b02548edf7e1a06..d44d3a572ea5b5962b93acaf9fe20c20e94073cd 100644 (file)
@@ -36,7 +36,7 @@ display the time offset of the system clock relative to the server
 clock.  Run as root, it can correct the system clock to this offset as
 well.  It can be run as an interactive command or from a cron job.
 
-  <p>This document applies to version 4.2.7p357 of <code>sntp</code>.
+  <p>This document applies to version 4.2.7p358 of <code>sntp</code>.
 
   <p>The program implements the SNTP protocol as defined by RFC 5905, the NTPv4
 IETF specification.
@@ -176,7 +176,7 @@ the usage text by passing it through a pager program.
 used to select the program, defaulting to <span class="file">more</span>.  Both will exit
 with a status code of 0.
 
-<pre class="example">sntp - standard Simple Network Time Protocol client program - Ver. 4.2.7p357
+<pre class="example">sntp - standard Simple Network Time Protocol client program - Ver. 4.2.7p358
 Usage:  sntp [ -&lt;flag&gt; [&lt;val&gt;] | --&lt;name&gt;[{=| }&lt;val&gt;] ]... \
                 [ hostname-or-IP ...]
   Flg Arg Option-Name    Description
@@ -227,7 +227,7 @@ The following option preset mechanisms are supported:
  - reading file ./.ntprc
  - examining environment variables named SNTP_*
 
-please send bug reports to:  &lt;http://bugs.ntp.org, bugs@ntp.org&gt;
+Please send bug reports to:  &lt;http://bugs.ntp.org, bugs@ntp.org&gt;
 </pre>
   <div class="node">
 <p><hr>
index 45259a6514d1fb06e57832d613f8e2db87905c6d..18777e01c07caf7895254c7ca24394bf747dc9bd 100644 (file)
@@ -1,8 +1,8 @@
-.TH sntp @SNTP_MS@ "21 Feb 2013" "4.2.7p357" "User Commands"
+.TH sntp @SNTP_MS@ "27 Feb 2013" "4.2.7p358" "User Commands"
 .\"
 .\"  EDIT THIS FILE WITH CAUTION  (sntp-opts.man)
 .\"
-.\"  It has been AutoGen-ed  February 21, 2013 at 10:48:36 PM by AutoGen 5.17.2pre17
+.\"  It has been AutoGen-ed  February 27, 2013 at 11:39:28 AM by AutoGen 5.17.3.pre2
 .\"  From the definitions    sntp-opts.def
 .\"  and the template file   agman-cmd.tpl
 .\"
@@ -316,7 +316,7 @@ This program is released under the terms of the NTP license, <http://ntp.org/lic
 .SH "BUGS"
 Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
 .SH NOTES
-This document corresponds to version 4.2.7p357 of
+This document corresponds to version 4.2.7p358 of
 .B  .
 .PP
 This manual page was \fIAutoGen\fP-erated from the \fBsntp\fP
index c15d11f46a8f17a9ad137cafa2e10c49d8aa4ba4..0857ab19023d6e0d3b2276db561c649c1471a594 100644 (file)
@@ -1,9 +1,9 @@
-.Dd February 21 2013
+.Dd February 27 2013
 .Dt SNTP @SNTP_MS@ User Commands
 .Os SunOS 5.10
 .\"  EDIT THIS FILE WITH CAUTION  (sntp-opts.mdoc)
 .\"
-.\"  It has been AutoGen-ed  February 21, 2013 at 10:48:42 PM by AutoGen 5.17.2pre17
+.\"  It has been AutoGen-ed  February 27, 2013 at 11:39:34 AM by AutoGen 5.17.3.pre2
 .\"  From the definitions    sntp-opts.def
 .\"  and the template file   agmdoc-cmd.tpl
 .Sh NAME
@@ -297,7 +297,7 @@ This program is released under the terms of the NTP license, <http://ntp.org/lic
 .Sh "BUGS"
 Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
 .Sh NOTES
-This document corresponds to version 4.2.7p357 of
+This document corresponds to version 4.2.7p358 of
 .Nm .
 .Pp
 This manual page was \fIAutoGen\fP\-erated from the \fBsntp\fP
index 8ced077ce067251b9e103a6f91b4903e1e525aba..1bdf4e1bc9e269ef652550d366894535337d8001 100644 (file)
@@ -6,7 +6,7 @@
 #
 # EDIT THIS FILE WITH CAUTION  (invoke-ntp-keygen.texi)
 #
-# It has been AutoGen-ed  February 21, 2013 at 10:48:14 PM by AutoGen 5.17.2pre17
+# It has been AutoGen-ed  February 27, 2013 at 11:38:55 AM by AutoGen 5.17.3.pre2
 # From the definitions    ntp-keygen-opts.def
 # and the template file   agtexi-cmd.tpl
 @end ignore
@@ -908,7 +908,7 @@ with a status code of 0.
 
 @exampleindent 0
 @example
-ntp-keygen (ntp) - Create a NTP host key - Ver. 4.2.7p357
+ntp-keygen (ntp) - Create a NTP host key - Ver. 4.2.7p358
 Usage:  ntp-keygen [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]...
   Flg Arg Option-Name    Description
    -b Num imbits         identity modulus bits
index 0366869e13556335e0069592f4729293cb1084b7..a39cb4f17e03a9174613dce51c158f41dad22684 100644 (file)
@@ -1,7 +1,7 @@
 /*
  *  EDIT THIS FILE WITH CAUTION  (ntp-keygen-opts.c)
  *
- *  It has been AutoGen-ed  February 21, 2013 at 10:47:55 PM by AutoGen 5.17.2pre17
+ *  It has been AutoGen-ed  February 27, 2013 at 11:38:35 AM by AutoGen 5.17.3.pre2
  *  From the definitions    ntp-keygen-opts.def
  *  and the template file   options
  *
@@ -68,11 +68,11 @@ extern FILE * option_usage_fp;
 #  define NULL 0
 #endif
 
-/*
- *  ntp-keygen option static const strings
+/**
+ *  static const strings for ntp-keygen options
  */
 static char const ntp_keygen_opt_strs[2357] =
-/*     0 */ "ntp-keygen (ntp) 4.2.7p357\n"
+/*     0 */ "ntp-keygen (ntp) 4.2.7p358\n"
             "Copyright (C) 1970-2013 The University of Delaware, all rights reserved.\n"
             "This is free software. It is licensed for use, modification and\n"
             "redistribution under the terms of the NTP License, copies of which\n"
@@ -163,22 +163,26 @@ static char const ntp_keygen_opt_strs[2357] =
 /*  2136 */ "no-load-opts\0"
 /*  2149 */ "no\0"
 /*  2152 */ "NTP_KEYGEN\0"
-/*  2163 */ "ntp-keygen (ntp) - Create a NTP host key - Ver. 4.2.7p357\n"
+/*  2163 */ "ntp-keygen (ntp) - Create a NTP host key - Ver. 4.2.7p358\n"
             "Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]...\n\0"
 /*  2279 */ "$HOME\0"
 /*  2285 */ ".\0"
 /*  2287 */ ".ntprc\0"
 /*  2294 */ "http://bugs.ntp.org, bugs@ntp.org\0"
 /*  2328 */ "\n\0"
-/*  2330 */ "ntp-keygen (ntp) 4.2.7p357";
+/*  2330 */ "ntp-keygen (ntp) 4.2.7p358";
 
-/*
+/**
  *  imbits option description:
  */
 #ifdef AUTOKEY
+/** Descriptive text for the imbits option */
 #define IMBITS_DESC      (ntp_keygen_opt_strs+966)
+/** Upper-cased name for the imbits option */
 #define IMBITS_NAME      (ntp_keygen_opt_strs+988)
+/** Name string for the imbits option */
 #define IMBITS_name      (ntp_keygen_opt_strs+995)
+/** Compiled in flag settings for the imbits option */
 #define IMBITS_FLAGS     (OPTST_DISABLED \
         | OPTST_SET_ARGTYPE(OPARG_TYPE_NUMERIC))
 
@@ -189,13 +193,17 @@ static char const ntp_keygen_opt_strs[2357] =
 #define IMBITS_name      NULL
 #endif  /* AUTOKEY */
 
-/*
+/**
  *  certificate option description:
  */
 #ifdef AUTOKEY
+/** Descriptive text for the certificate option */
 #define CERTIFICATE_DESC      (ntp_keygen_opt_strs+1002)
+/** Upper-cased name for the certificate option */
 #define CERTIFICATE_NAME      (ntp_keygen_opt_strs+1021)
+/** Name string for the certificate option */
 #define CERTIFICATE_name      (ntp_keygen_opt_strs+1033)
+/** Compiled in flag settings for the certificate option */
 #define CERTIFICATE_FLAGS     (OPTST_DISABLED \
         | OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
 
@@ -206,13 +214,17 @@ static char const ntp_keygen_opt_strs[2357] =
 #define CERTIFICATE_name      NULL
 #endif  /* AUTOKEY */
 
-/*
+/**
  *  cipher option description:
  */
 #ifdef AUTOKEY
+/** Descriptive text for the cipher option */
 #define CIPHER_DESC      (ntp_keygen_opt_strs+1045)
+/** Upper-cased name for the cipher option */
 #define CIPHER_NAME      (ntp_keygen_opt_strs+1063)
+/** Name string for the cipher option */
 #define CIPHER_name      (ntp_keygen_opt_strs+1070)
+/** Compiled in flag settings for the cipher option */
 #define CIPHER_FLAGS     (OPTST_DISABLED \
         | OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
 
@@ -223,30 +235,42 @@ static char const ntp_keygen_opt_strs[2357] =
 #define CIPHER_name      NULL
 #endif  /* AUTOKEY */
 
-/*
+/**
  *  debug-level option description:
  */
+/** Descriptive text for the debug-level option */
 #define DEBUG_LEVEL_DESC      (ntp_keygen_opt_strs+1077)
+/** Upper-cased name for the debug-level option */
 #define DEBUG_LEVEL_NAME      (ntp_keygen_opt_strs+1108)
+/** Name string for the debug-level option */
 #define DEBUG_LEVEL_name      (ntp_keygen_opt_strs+1120)
+/** Compiled in flag settings for the debug-level option */
 #define DEBUG_LEVEL_FLAGS     (OPTST_DISABLED)
 
-/*
+/**
  *  set-debug-level option description:
  */
+/** Descriptive text for the set-debug-level option */
 #define SET_DEBUG_LEVEL_DESC      (ntp_keygen_opt_strs+1132)
+/** Upper-cased name for the set-debug-level option */
 #define SET_DEBUG_LEVEL_NAME      (ntp_keygen_opt_strs+1162)
+/** Name string for the set-debug-level option */
 #define SET_DEBUG_LEVEL_name      (ntp_keygen_opt_strs+1178)
+/** Compiled in flag settings for the set-debug-level option */
 #define SET_DEBUG_LEVEL_FLAGS     (OPTST_DISABLED \
         | OPTST_SET_ARGTYPE(OPARG_TYPE_NUMERIC))
 
-/*
+/**
  *  id-key option description:
  */
 #ifdef AUTOKEY
+/** Descriptive text for the id-key option */
 #define ID_KEY_DESC      (ntp_keygen_opt_strs+1194)
+/** Upper-cased name for the id-key option */
 #define ID_KEY_NAME      (ntp_keygen_opt_strs+1224)
+/** Name string for the id-key option */
 #define ID_KEY_name      (ntp_keygen_opt_strs+1231)
+/** Compiled in flag settings for the id-key option */
 #define ID_KEY_FLAGS     (OPTST_DISABLED)
 
 #else   /* disable id-key */
@@ -256,13 +280,17 @@ static char const ntp_keygen_opt_strs[2357] =
 #define ID_KEY_name      NULL
 #endif  /* AUTOKEY */
 
-/*
+/**
  *  gq-params option description:
  */
 #ifdef AUTOKEY
+/** Descriptive text for the gq-params option */
 #define GQ_PARAMS_DESC      (ntp_keygen_opt_strs+1238)
+/** Upper-cased name for the gq-params option */
 #define GQ_PARAMS_NAME      (ntp_keygen_opt_strs+1270)
+/** Name string for the gq-params option */
 #define GQ_PARAMS_name      (ntp_keygen_opt_strs+1280)
+/** Compiled in flag settings for the gq-params option */
 #define GQ_PARAMS_FLAGS     (OPTST_DISABLED)
 
 #else   /* disable gq-params */
@@ -272,13 +300,17 @@ static char const ntp_keygen_opt_strs[2357] =
 #define GQ_PARAMS_name      NULL
 #endif  /* AUTOKEY */
 
-/*
+/**
  *  host-key option description:
  */
 #ifdef AUTOKEY
+/** Descriptive text for the host-key option */
 #define HOST_KEY_DESC      (ntp_keygen_opt_strs+1290)
+/** Upper-cased name for the host-key option */
 #define HOST_KEY_NAME      (ntp_keygen_opt_strs+1312)
+/** Name string for the host-key option */
 #define HOST_KEY_name      (ntp_keygen_opt_strs+1321)
+/** Compiled in flag settings for the host-key option */
 #define HOST_KEY_FLAGS     (OPTST_DISABLED)
 
 #else   /* disable host-key */
@@ -288,13 +320,17 @@ static char const ntp_keygen_opt_strs[2357] =
 #define HOST_KEY_name      NULL
 #endif  /* AUTOKEY */
 
-/*
+/**
  *  iffkey option description:
  */
 #ifdef AUTOKEY
+/** Descriptive text for the iffkey option */
 #define IFFKEY_DESC      (ntp_keygen_opt_strs+1330)
+/** Upper-cased name for the iffkey option */
 #define IFFKEY_NAME      (ntp_keygen_opt_strs+1354)
+/** Name string for the iffkey option */
 #define IFFKEY_name      (ntp_keygen_opt_strs+1361)
+/** Compiled in flag settings for the iffkey option */
 #define IFFKEY_FLAGS     (OPTST_DISABLED)
 
 #else   /* disable iffkey */
@@ -304,13 +340,17 @@ static char const ntp_keygen_opt_strs[2357] =
 #define IFFKEY_name      NULL
 #endif  /* AUTOKEY */
 
-/*
+/**
  *  ident option description:
  */
 #ifdef AUTOKEY
+/** Descriptive text for the ident option */
 #define IDENT_DESC      (ntp_keygen_opt_strs+1368)
+/** Upper-cased name for the ident option */
 #define IDENT_NAME      (ntp_keygen_opt_strs+1391)
+/** Name string for the ident option */
 #define IDENT_name      (ntp_keygen_opt_strs+1397)
+/** Compiled in flag settings for the ident option */
 #define IDENT_FLAGS     (OPTST_DISABLED \
         | OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
 
@@ -321,13 +361,17 @@ static char const ntp_keygen_opt_strs[2357] =
 #define IDENT_name      NULL
 #endif  /* AUTOKEY */
 
-/*
+/**
  *  lifetime option description:
  */
 #ifdef AUTOKEY
+/** Descriptive text for the lifetime option */
 #define LIFETIME_DESC      (ntp_keygen_opt_strs+1403)
+/** Upper-cased name for the lifetime option */
 #define LIFETIME_NAME      (ntp_keygen_opt_strs+1428)
+/** Name string for the lifetime option */
 #define LIFETIME_name      (ntp_keygen_opt_strs+1437)
+/** Compiled in flag settings for the lifetime option */
 #define LIFETIME_FLAGS     (OPTST_DISABLED \
         | OPTST_SET_ARGTYPE(OPARG_TYPE_NUMERIC))
 
@@ -338,21 +382,29 @@ static char const ntp_keygen_opt_strs[2357] =
 #define LIFETIME_name      NULL
 #endif  /* AUTOKEY */
 
-/*
+/**
  *  md5key option description:
  */
+/** Descriptive text for the md5key option */
 #define MD5KEY_DESC      (ntp_keygen_opt_strs+1446)
+/** Upper-cased name for the md5key option */
 #define MD5KEY_NAME      (ntp_keygen_opt_strs+1464)
+/** Name string for the md5key option */
 #define MD5KEY_name      (ntp_keygen_opt_strs+1471)
+/** Compiled in flag settings for the md5key option */
 #define MD5KEY_FLAGS     (OPTST_DISABLED)
 
-/*
+/**
  *  modulus option description:
  */
 #ifdef AUTOKEY
+/** Descriptive text for the modulus option */
 #define MODULUS_DESC      (ntp_keygen_opt_strs+1478)
+/** Upper-cased name for the modulus option */
 #define MODULUS_NAME      (ntp_keygen_opt_strs+1486)
+/** Name string for the modulus option */
 #define MODULUS_name      (ntp_keygen_opt_strs+1478)
+/** Compiled in flag settings for the modulus option */
 #define MODULUS_FLAGS     (OPTST_DISABLED \
         | OPTST_SET_ARGTYPE(OPARG_TYPE_NUMERIC))
 
@@ -363,13 +415,17 @@ static char const ntp_keygen_opt_strs[2357] =
 #define MODULUS_name      NULL
 #endif  /* AUTOKEY */
 
-/*
+/**
  *  pvt-cert option description:
  */
 #ifdef AUTOKEY
+/** Descriptive text for the pvt-cert option */
 #define PVT_CERT_DESC      (ntp_keygen_opt_strs+1494)
+/** Upper-cased name for the pvt-cert option */
 #define PVT_CERT_NAME      (ntp_keygen_opt_strs+1526)
+/** Name string for the pvt-cert option */
 #define PVT_CERT_name      (ntp_keygen_opt_strs+1535)
+/** Compiled in flag settings for the pvt-cert option */
 #define PVT_CERT_FLAGS     (OPTST_DISABLED)
 
 #else   /* disable pvt-cert */
@@ -379,13 +435,17 @@ static char const ntp_keygen_opt_strs[2357] =
 #define PVT_CERT_name      NULL
 #endif  /* AUTOKEY */
 
-/*
+/**
  *  pvt-passwd option description:
  */
 #ifdef AUTOKEY
+/** Descriptive text for the pvt-passwd option */
 #define PVT_PASSWD_DESC      (ntp_keygen_opt_strs+1544)
+/** Upper-cased name for the pvt-passwd option */
 #define PVT_PASSWD_NAME      (ntp_keygen_opt_strs+1568)
+/** Name string for the pvt-passwd option */
 #define PVT_PASSWD_name      (ntp_keygen_opt_strs+1579)
+/** Compiled in flag settings for the pvt-passwd option */
 #define PVT_PASSWD_FLAGS     (OPTST_DISABLED \
         | OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
 
@@ -396,13 +456,17 @@ static char const ntp_keygen_opt_strs[2357] =
 #define PVT_PASSWD_name      NULL
 #endif  /* AUTOKEY */
 
-/*
+/**
  *  get-pvt-passwd option description:
  */
 #ifdef AUTOKEY
+/** Descriptive text for the get-pvt-passwd option */
 #define GET_PVT_PASSWD_DESC      (ntp_keygen_opt_strs+1590)
+/** Upper-cased name for the get-pvt-passwd option */
 #define GET_PVT_PASSWD_NAME      (ntp_keygen_opt_strs+1613)
+/** Name string for the get-pvt-passwd option */
 #define GET_PVT_PASSWD_name      (ntp_keygen_opt_strs+1628)
+/** Compiled in flag settings for the get-pvt-passwd option */
 #define GET_PVT_PASSWD_FLAGS     (OPTST_DISABLED \
         | OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
 
@@ -413,13 +477,17 @@ static char const ntp_keygen_opt_strs[2357] =
 #define GET_PVT_PASSWD_name      NULL
 #endif  /* AUTOKEY */
 
-/*
+/**
  *  sign-key option description:
  */
 #ifdef AUTOKEY
+/** Descriptive text for the sign-key option */
 #define SIGN_KEY_DESC      (ntp_keygen_opt_strs+1643)
+/** Upper-cased name for the sign-key option */
 #define SIGN_KEY_NAME      (ntp_keygen_opt_strs+1674)
+/** Name string for the sign-key option */
 #define SIGN_KEY_name      (ntp_keygen_opt_strs+1683)
+/** Compiled in flag settings for the sign-key option */
 #define SIGN_KEY_FLAGS     (OPTST_DISABLED \
         | OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
 
@@ -430,13 +498,17 @@ static char const ntp_keygen_opt_strs[2357] =
 #define SIGN_KEY_name      NULL
 #endif  /* AUTOKEY */
 
-/*
+/**
  *  subject-name option description:
  */
 #ifdef AUTOKEY
+/** Descriptive text for the subject-name option */
 #define SUBJECT_NAME_DESC      (ntp_keygen_opt_strs+1692)
+/** Upper-cased name for the subject-name option */
 #define SUBJECT_NAME_NAME      (ntp_keygen_opt_strs+1727)
+/** Name string for the subject-name option */
 #define SUBJECT_NAME_name      (ntp_keygen_opt_strs+1740)
+/** Compiled in flag settings for the subject-name option */
 #define SUBJECT_NAME_FLAGS     (OPTST_DISABLED \
         | OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
 
@@ -447,13 +519,17 @@ static char const ntp_keygen_opt_strs[2357] =
 #define SUBJECT_NAME_name      NULL
 #endif  /* AUTOKEY */
 
-/*
+/**
  *  trusted-cert option description:
  */
 #ifdef AUTOKEY
+/** Descriptive text for the trusted-cert option */
 #define TRUSTED_CERT_DESC      (ntp_keygen_opt_strs+1753)
+/** Upper-cased name for the trusted-cert option */
 #define TRUSTED_CERT_NAME      (ntp_keygen_opt_strs+1785)
+/** Name string for the trusted-cert option */
 #define TRUSTED_CERT_name      (ntp_keygen_opt_strs+1798)
+/** Compiled in flag settings for the trusted-cert option */
 #define TRUSTED_CERT_FLAGS     (OPTST_DISABLED)
 
 #else   /* disable trusted-cert */
@@ -463,13 +539,17 @@ static char const ntp_keygen_opt_strs[2357] =
 #define TRUSTED_CERT_name      NULL
 #endif  /* AUTOKEY */
 
-/*
+/**
  *  mv-params option description:
  */
 #ifdef AUTOKEY
+/** Descriptive text for the mv-params option */
 #define MV_PARAMS_DESC      (ntp_keygen_opt_strs+1811)
+/** Upper-cased name for the mv-params option */
 #define MV_PARAMS_NAME      (ntp_keygen_opt_strs+1840)
+/** Name string for the mv-params option */
 #define MV_PARAMS_name      (ntp_keygen_opt_strs+1850)
+/** Compiled in flag settings for the mv-params option */
 #define MV_PARAMS_FLAGS     (OPTST_DISABLED \
         | OPTST_SET_ARGTYPE(OPARG_TYPE_NUMERIC))
 
@@ -480,13 +560,17 @@ static char const ntp_keygen_opt_strs[2357] =
 #define MV_PARAMS_name      NULL
 #endif  /* AUTOKEY */
 
-/*
+/**
  *  mv-keys option description:
  */
 #ifdef AUTOKEY
+/** Descriptive text for the mv-keys option */
 #define MV_KEYS_DESC      (ntp_keygen_opt_strs+1860)
+/** Upper-cased name for the mv-keys option */
 #define MV_KEYS_NAME      (ntp_keygen_opt_strs+1881)
+/** Name string for the mv-keys option */
 #define MV_KEYS_name      (ntp_keygen_opt_strs+1889)
+/** Compiled in flag settings for the mv-keys option */
 #define MV_KEYS_FLAGS     (OPTST_DISABLED \
         | OPTST_SET_ARGTYPE(OPARG_TYPE_NUMERIC))
 
@@ -526,7 +610,7 @@ static char const ntp_keygen_opt_strs[2357] =
 #define NO_LOAD_OPTS_name  (ntp_keygen_opt_strs+2136)
 #define LOAD_OPTS_pfx      (ntp_keygen_opt_strs+2149)
 #define LOAD_OPTS_name     (NO_LOAD_OPTS_name + 3)
-/*
+/**
  *  Declare option callback procedures
  */
 #ifdef AUTOKEY
@@ -565,7 +649,7 @@ extern tOptProc
 static tOptProc
     doOptDebug_Level, doUsageOpt;
 
-/*
+/**
  *  #define map the "normal" callout procs
  */
 #define DEBUG_LEVEL_OPT_PROC doOptDebug_Level
@@ -898,22 +982,27 @@ static tOptDesc optDesc[OPTION_CT] = {
 };
 
 
-/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
- *
- *  Define the ntp-keygen Option Environment
- */
+/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
+/** Reference to the upper cased version of ntp-keygen. */
 #define zPROGNAME       (ntp_keygen_opt_strs+2152)
+/** Reference to the title line for ntp-keygen usage. */
 #define zUsageTitle     (ntp_keygen_opt_strs+2163)
+/** ntp-keygen configuration file name. */
 #define zRcName         (ntp_keygen_opt_strs+2287)
+/** Directories to search for ntp-keygen config files. */
 static char const * const apzHomeList[3] = {
     ntp_keygen_opt_strs+2279,
     ntp_keygen_opt_strs+2285,
     NULL };
+/** The ntp-keygen program bug email address. */
 #define zBugsAddr       (ntp_keygen_opt_strs+2294)
+/** Clarification/explanation of what ntp-keygen does. */
 #define zExplain        (ntp_keygen_opt_strs+2328)
+/** Extra detail explaining what ntp-keygen does. */
 #define zDetail         (NULL)
+/** The full version string for ntp-keygen. */
 #define zFullVersion    (ntp_keygen_opt_strs+2330)
-/* extracted from optcode.tlib near line 364 */
+/* extracted from optcode.tlib near line 371 */
 
 #if defined(ENABLE_NLS)
 # define OPTPROC_BASE OPTPROC_TRANSLATE
@@ -934,8 +1023,8 @@ static char const * const apzHomeList[3] = {
 /**
  * The callout function that invokes the optionUsage function.
  *
- * @param pOptions the AutoOpts option description structure
- * @param pOptDesc the descriptor for the "help" (usage) option.
+ * @param[in] pOptions the AutoOpts option description structure
+ * @param[in] pOptDesc the descriptor for the "help" (usage) option.
  * @noreturn
  */
 static void
@@ -950,9 +1039,9 @@ doUsageOpt(tOptions * pOptions, tOptDesc * pOptDesc)
 /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
 /**
  * Code to handle the imbits option, when AUTOKEY is #define-d.
- *
- * @param pOptions the ntp-keygen options data structure
- * @param pOptDesc the option descriptor for this option.
+ * The number of bits in the identity modulus.  The default is 256.
+ * @param[in] pOptions the ntp-keygen options data structure
+ * @param[in,out] pOptDesc the option descriptor for this option.
  */
 #ifdef AUTOKEY
 static void
@@ -990,8 +1079,8 @@ doOptImbits(tOptions* pOptions, tOptDesc* pOptDesc)
 /**
  * Code to handle the debug-level option.
  *
- * @param pOptions the ntp-keygen options data structure
- * @param pOptDesc the option descriptor for this option.
+ * @param[in] pOptions the ntp-keygen options data structure
+ * @param[in,out] pOptDesc the option descriptor for this option.
  */
 static void
 doOptDebug_Level(tOptions* pOptions, tOptDesc* pOptDesc)
@@ -1012,9 +1101,9 @@ OPT_VALUE_SET_DEBUG_LEVEL++;
 /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
 /**
  * Code to handle the modulus option, when AUTOKEY is #define-d.
- *
- * @param pOptions the ntp-keygen options data structure
- * @param pOptDesc the option descriptor for this option.
+ * The number of bits in the prime modulus.  The default is 512.
+ * @param[in] pOptions the ntp-keygen options data structure
+ * @param[in,out] pOptDesc the option descriptor for this option.
  */
 #ifdef AUTOKEY
 static void
@@ -1055,8 +1144,8 @@ extern void optionPutShell(tOptions*);
  * Generated main procedure.  This will emit text that a Bourne shell can
  * process to handle its command line arguments.
  *
- * @param argc argument count
- * @param argv argument vector
+ * @param[in] argc argument count
+ * @param[in] argv argument vector
  * @returns program exit code
  */
 int
@@ -1087,6 +1176,7 @@ main(int argc, char ** argv)
 #ifndef  WITH_PACKAGER
 # define ntp_keygen_packager_info NULL
 #else
+/** Packager information for ntp-keygen. */
 static char const ntp_keygen_packager_info[] =
     "Packaged by " WITH_PACKAGER
 
@@ -1141,7 +1231,7 @@ tOptions ntp_keygenOptions = {
 };
 
 #if ENABLE_NLS
-/*
+/**
  * This code is designed to translate translatable option text for the
  * ntp-keygen program.  These translations happen upon entry
  * to optionProcess().
@@ -1250,6 +1340,7 @@ translate_option_strings(void)
 #endif /* ENABLE_NLS */
 
 #ifdef DO_NOT_COMPILE_THIS_CODE_IT_IS_FOR_GETTEXT
+/** I18N function strictly for xgettext.  Do not compile. */
 static void bogus_function(void) {
   /* TRANSLATORS:
 
@@ -1268,7 +1359,7 @@ static void bogus_function(void) {
      translate option names.
    */
   /* referenced via ntp_keygenOptions.pzCopyright */
-  puts(_("ntp-keygen (ntp) 4.2.7p357\n\
+  puts(_("ntp-keygen (ntp) 4.2.7p358\n\
 Copyright (C) 1970-2013 The University of Delaware, all rights reserved.\n\
 This is free software. It is licensed for use, modification and\n\
 redistribution under the terms of the NTP License, copies of which\n\
@@ -1366,14 +1457,14 @@ provided \"as is\" without express or implied warranty.\n"));
   puts(_("load options from a config file"));
 
   /* referenced via ntp_keygenOptions.pzUsageTitle */
-  puts(_("ntp-keygen (ntp) - Create a NTP host key - Ver. 4.2.7p357\n\
+  puts(_("ntp-keygen (ntp) - Create a NTP host key - Ver. 4.2.7p358\n\
 Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]...\n"));
 
   /* referenced via ntp_keygenOptions.pzExplain */
   puts(_("\n"));
 
   /* referenced via ntp_keygenOptions.pzFullVersion */
-  puts(_("ntp-keygen (ntp) 4.2.7p357"));
+  puts(_("ntp-keygen (ntp) 4.2.7p358"));
 
   /* referenced via ntp_keygenOptions.pzFullUsage */
   puts(_("<<<NOT-FOUND>>>"));
@@ -1408,7 +1499,7 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]...\n"));
   puts(_("could not locate the 'help' option"));
 #line 351 "../autoopts.c"
   puts(_("optionProcess() was called with invalid data"));
-#line 770 "../usage.c"
+#line 783 "../usage.c"
   puts(_("invalid argument type specified"));
 #line 589 "../find.c"
   puts(_("defaulted to option with optional arg"));
@@ -1457,9 +1548,9 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]...\n"));
   puts(_("  or an integer from %d through %d\n"));
 #line 164 "../enum.c"
   puts(_("  or an integer from %d through %d\n"));
-#line 769 "../usage.c"
+#line 782 "../usage.c"
   puts(_("%s error:  invalid option descriptor for %s\n"));
-#line 1097 "../usage.c"
+#line 1110 "../usage.c"
   puts(_("%s error:  invalid option descriptor for %s\n"));
 #line 379 "../find.c"
   puts(_("%s: invalid option name: %s\n"));
@@ -1467,7 +1558,7 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]...\n"));
   puts(_("%s: The '%s' option requires an argument.\n"));
 #line 171 "../autoopts.c"
   puts(_("(AutoOpts bug):  Equivalenced option '%s' was equivalenced to both\n"
-       "\t'%s' and '%s'"));
+       "\t'%s' and '%s'."));
 #line 94 "../check.c"
   puts(_("%s error:  The %s option is required\n"));
 #line 623 "../find.c"
@@ -1495,7 +1586,7 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]...\n"));
 #line 53 "../time.c"
   puts(_("%s error:  '%s' is not a recognizable time duration.\n"));
 #line 92 "../check.c"
-  puts(_("%s error:  The %s option must appear %d times\n"));
+  puts(_("%s error:  The %s option must appear %d times.\n"));
 #line 157 "../numeric.c"
   puts(_("%s error:  '%s' is not a recognizable number.\n"));
 #line 195 "../enum.c"
@@ -1512,7 +1603,7 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]...\n"));
   puts(_("standard output"));
 #line 451 "../usage.c"
   puts(_("standard output"));
-#line 647 "../usage.c"
+#line 660 "../usage.c"
   puts(_("standard output"));
 #line 175 "../version.c"
   puts(_("standard output"));
@@ -1520,7 +1611,7 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]...\n"));
   puts(_("standard error"));
 #line 451 "../usage.c"
   puts(_("standard error"));
-#line 647 "../usage.c"
+#line 660 "../usage.c"
   puts(_("standard error"));
 #line 175 "../version.c"
   puts(_("standard error"));
@@ -1532,7 +1623,7 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]...\n"));
   puts(_("write"));
 #line 450 "../usage.c"
   puts(_("write"));
-#line 646 "../usage.c"
+#line 659 "../usage.c"
   puts(_("write"));
 #line 174 "../version.c"
   puts(_("write"));
@@ -1553,23 +1644,23 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]...\n"));
   /* END-LIBOPTS-MESSAGES */
 
   /* USAGE-TEXT: */
-#line 895 "../usage.c"
+#line 908 "../usage.c"
   puts(_("\t\t\t\t- an alternate for '%s'\n"));
-#line 1164 "../usage.c"
+#line 1177 "../usage.c"
   puts(_("Version, usage and configuration options:"));
-#line 946 "../usage.c"
+#line 959 "../usage.c"
   puts(_("\t\t\t\t- default option for unnamed options\n"));
-#line 859 "../usage.c"
+#line 872 "../usage.c"
   puts(_("\t\t\t\t- disabled as '--%s'\n"));
-#line 1133 "../usage.c"
+#line 1146 "../usage.c"
   puts(_(" --- %-14s %s\n"));
-#line 1131 "../usage.c"
+#line 1144 "../usage.c"
   puts(_("This option has been disabled"));
-#line 886 "../usage.c"
+#line 899 "../usage.c"
   puts(_("\t\t\t\t- enabled by default\n"));
 #line 40 "../alias.c"
   puts(_("%s error:  only "));
-#line 1208 "../usage.c"
+#line 1221 "../usage.c"
   puts(_(" - examining environment variables named %s_*\n"));
 #line 168 "../file.c"
   puts(_("\t\t\t\t- file must not pre-exist\n"));
@@ -1585,31 +1676,31 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]...\n"));
        "a shell script to parse the options for %s:\n\n"));
 #line 161 "../enum.c"
   puts(_("  or an integer mask with any of the lower %d bits set\n"));
-#line 919 "../usage.c"
+#line 932 "../usage.c"
   puts(_("\t\t\t\t- is a set membership option\n"));
-#line 940 "../usage.c"
+#line 953 "../usage.c"
   puts(_("\t\t\t\t- must appear between %d and %d times\n"));
 #line 418 "../usage.c"
   puts(_("Options are specified by single or double hyphens and their name.\n"));
-#line 926 "../usage.c"
+#line 939 "../usage.c"
   puts(_("\t\t\t\t- may appear multiple times\n"));
-#line 913 "../usage.c"
+#line 926 "../usage.c"
   puts(_("\t\t\t\t- may not be preset\n"));
-#line 1323 "../usage.c"
+#line 1336 "../usage.c"
   puts(_("   Arg Option-Name    Description\n"));
-#line 1259 "../usage.c"
+#line 1272 "../usage.c"
   puts(_("  Flg Arg Option-Name    Description\n"));
-#line 1317 "../usage.c"
+#line 1330 "../usage.c"
   puts(_("  Flg Arg Option-Name    Description\n"));
-#line 1318 "../usage.c"
+#line 1331 "../usage.c"
   puts(_(" %3s %s"));
-#line 1324 "../usage.c"
+#line 1337 "../usage.c"
   puts(_(" %3s %s"));
 #line 423 "../usage.c"
   puts(_("The '-#<number>' option may omit the hash char\n"));
 #line 419 "../usage.c"
   puts(_("All arguments are named options.\n"));
-#line 993 "../usage.c"
+#line 1006 "../usage.c"
   puts(_(" - reading file %s"));
 #line 445 "../usage.c"
   puts(_("\n"
@@ -1620,17 +1711,17 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]...\n"));
 #line 129 "../version.c"
   puts(_("\n"
        "please send bug reports to:  <%s>\n"));
-#line 925 "../usage.c"
+#line 938 "../usage.c"
   puts(_("\t\t\t\t- may NOT appear - preset only\n"));
-#line 965 "../usage.c"
+#line 978 "../usage.c"
   puts(_("\n"
        "The following option preset mechanisms are supported:\n"));
-#line 1206 "../usage.c"
+#line 1219 "../usage.c"
   puts(_("\n"
        "The following option preset mechanisms are supported:\n"));
-#line 704 "../usage.c"
+#line 717 "../usage.c"
   puts(_("prohibits these options:\n"));
-#line 699 "../usage.c"
+#line 712 "../usage.c"
   puts(_("prohibits the option '%s'\n"));
 #line 81 "../numeric.c"
   puts(_("%s%ld to %ld"));
@@ -1650,26 +1741,26 @@ Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]...\n"));
   puts(_("%sless than or equal to %ld"));
 #line 426 "../usage.c"
   puts(_("Operands and options may be intermixed.  They will be reordered.\n"));
-#line 674 "../usage.c"
+#line 687 "../usage.c"
   puts(_("requires the option '%s'\n"));
-#line 677 "../usage.c"
+#line 690 "../usage.c"
   puts(_("requires these options:\n"));
-#line 1335 "../usage.c"
+#line 1348 "../usage.c"
   puts(_("   Arg Option-Name   Req?  Description\n"));
-#line 1329 "../usage.c"
+#line 1342 "../usage.c"
   puts(_("  Flg Arg Option-Name   Req?  Description\n"));
 #line 162 "../enum.c"
   puts(_("or you may use a numeric representation.  Preceding these with a '!'\n"
        "will clear the bits, specifying 'none' will clear all bits, and 'all'\n"
        "will set them all.  Multiple entries may be passed as an option\n"
        "argument list.\n"));
-#line 932 "../usage.c"
+#line 945 "../usage.c"
   puts(_("\t\t\t\t- may appear up to %d times\n"));
 #line 72 "../enum.c"
   puts(_("The valid \"%s\" option keywords are:\n"));
-#line 1168 "../usage.c"
+#line 1181 "../usage.c"
   puts(_("The next option supports vendor supported extra options:"));
-#line 795 "../usage.c"
+#line 808 "../usage.c"
   puts(_("These additional options are:"));
   /* END-USAGE-TEXT */
 }
index a810c72b8df47808b99d18bf5d8e7b480c673676..53b1d0954f108f1b07eb706836534a1954c22fe0 100644 (file)
@@ -1,7 +1,7 @@
 /*
  *  EDIT THIS FILE WITH CAUTION  (ntp-keygen-opts.h)
  *
- *  It has been AutoGen-ed  February 21, 2013 at 10:47:54 PM by AutoGen 5.17.2pre17
+ *  It has been AutoGen-ed  February 27, 2013 at 11:38:35 AM by AutoGen 5.17.3.pre2
  *  From the definitions    ntp-keygen-opts.def
  *  and the template file   options
  *
@@ -35,7 +35,7 @@
  *  representations about the suitability this software for any purpose. It
  *  is provided "as is" without express or implied warranty.
  */
-/*
+/**
  *  This file contains the programmatic interface to the Automated
  *  Options generated for the ntp-keygen program.
  *  These macros are documented in the AutoGen info file in the
@@ -46,7 +46,7 @@
 #include "config.h"
 #include <autoopts/options.h>
 
-/*
+/**
  *  Ensure that the library used for compiling this generated header is at
  *  least as new as the version current when the header template was released
  *  (not counting patch version increments).  Also ensure that the oldest
@@ -60,8 +60,8 @@
   Choke Me.
 #endif
 
-/*
- *  Enumeration of each option:
+/**
+ *  Enumeration of each option type for ntp-keygen
  */
 typedef enum {
     INDEX_OPT_IMBITS           =  0,
@@ -91,34 +91,51 @@ typedef enum {
     INDEX_OPT_SAVE_OPTS        = 24,
     INDEX_OPT_LOAD_OPTS        = 25
 } teOptIndex;
-
+/** count of all options for ntp-keygen */
 #define OPTION_CT    26
-#define NTP_KEYGEN_VERSION       "4.2.7p357"
-#define NTP_KEYGEN_FULL_VERSION  "ntp-keygen (ntp) 4.2.7p357"
+/** ntp-keygen version */
+#define NTP_KEYGEN_VERSION       "4.2.7p358"
+/** Full ntp-keygen version text */
+#define NTP_KEYGEN_FULL_VERSION  "ntp-keygen (ntp) 4.2.7p358"
 
-/*
+/**
  *  Interface defines for all options.  Replace "n" with the UPPER_CASED
  *  option name (as in the teOptIndex enumeration above).
  *  e.g. HAVE_OPT(IMBITS)
  */
 #define         DESC(n) (ntp_keygenOptions.pOptDesc[INDEX_OPT_## n])
+/** 'true' if an option has been specified in any way */
 #define     HAVE_OPT(n) (! UNUSED_OPT(& DESC(n)))
+/** The string argument to an option. The argument type must be "string". */
 #define      OPT_ARG(n) (DESC(n).optArg.argString)
+/** Mask the option state revealing how an option was specified.
+ *  It will be one and only one of \a OPTST_SET, \a OPTST_PRESET,
+ * \a OPTST_DEFINED, \a OPTST_RESET or zero.
+ */
 #define    STATE_OPT(n) (DESC(n).fOptState & OPTST_SET_MASK)
+/** Count of option's occurrances *on the command line*. */
 #define    COUNT_OPT(n) (DESC(n).optOccCt)
+/** mask of \a OPTST_SET and \a OPTST_DEFINED. */
 #define    ISSEL_OPT(n) (SELECTED_OPT(&DESC(n)))
+/** 'true' if \a HAVE_OPT would yield 'false'. */
 #define ISUNUSED_OPT(n) (UNUSED_OPT(& DESC(n)))
+/** 'true' if OPTST_DISABLED bit not set. */
 #define  ENABLED_OPT(n) (! DISABLED_OPT(& DESC(n)))
+/** number of stacked option arguments.
+ *  Valid only for stacked option arguments. */
 #define  STACKCT_OPT(n) (((tArgList*)(DESC(n).optCookie))->useCt)
+/** stacked argument vector.
+ *  Valid only for stacked option arguments. */
 #define STACKLST_OPT(n) (((tArgList*)(DESC(n).optCookie))->apzArgs)
+/** Reset an option. */
 #define    CLEAR_OPT(n) STMTS( \
                 DESC(n).fOptState &= OPTST_PERSISTENT_MASK;   \
                 if ((DESC(n).fOptState & OPTST_INITENABLED) == 0) \
                     DESC(n).fOptState |= OPTST_DISABLED; \
                 DESC(n).optCookie = NULL )
 
-/* * * * * *
- *
+/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
+/**
  *  Enumeration of ntp-keygen exit codes
  */
 typedef enum {
@@ -128,7 +145,8 @@ typedef enum {
     NTP_KEYGEN_EXIT_NO_CONFIG_INPUT = 66,
     NTP_KEYGEN_EXIT_LIBOPTS_FAILURE = 70
 } ntp_keygen_exit_code_t;
-/*
+/** @} */
+/**
  *  Make sure there are no #define name conflicts with the option names
  */
 #ifndef     NO_OPTION_NAME_WARNINGS
@@ -240,9 +258,10 @@ typedef enum {
 # undef MV_KEYS
 #endif  /*  NO_OPTION_NAME_WARNINGS */
 
-/* * * * * *
- *
+/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
+/**
  *  Interface defines for specific options.
+ * @{
  */
 #define VALUE_OPT_IMBITS         'b'
 #ifdef AUTOKEY
@@ -282,10 +301,15 @@ typedef enum {
 #ifdef AUTOKEY
 #define OPT_VALUE_MV_KEYS        (DESC(MV_KEYS).optArg.argInt)
 #endif /* AUTOKEY */
+/** option flag (value) for " (get "val-name") " option */
 #define VALUE_OPT_HELP          '?'
+/** option flag (value) for " (get "val-name") " option */
 #define VALUE_OPT_MORE_HELP     '!'
+/** option flag (value) for " (get "val-name") " option */
 #define VALUE_OPT_VERSION       INDEX_OPT_VERSION
+/** option flag (value) for " (get "val-name") " option */
 #define VALUE_OPT_SAVE_OPTS     '>'
+/** option flag (value) for " (get "val-name") " option */
 #define VALUE_OPT_LOAD_OPTS     '<'
 #define SET_OPT_SAVE_OPTS(a)   STMTS( \
         DESC(SAVE_OPTS).fOptState &= OPTST_PERSISTENT_MASK; \
@@ -301,7 +325,7 @@ typedef enum {
                 ntp_keygenOptions.pzCurOpt  = NULL)
 #define START_OPT       RESTART_OPT(1)
 #define USAGE(c)        (*ntp_keygenOptions.pUsageProc)(&ntp_keygenOptions, c)
-/* extracted from opthead.tlib near line 498 */
+/* extracted from opthead.tlib near line 538 */
 
 #ifdef  __cplusplus
 extern "C" {
index c6d6aaca8471f020611c99b6ae669f184f2e5a5e..64812856bf6cbc8f145582a8d943054b98b7074c 100644 (file)
@@ -1,8 +1,8 @@
-.TH ntp-keygen 1ntp-keygenman "21 Feb 2013" "ntp (4.2.7p357)" "User Commands"
+.TH ntp-keygen 1ntp-keygenman "27 Feb 2013" "ntp (4.2.7p358)" "User Commands"
 .\"
 .\"  EDIT THIS FILE WITH CAUTION  (ntp-keygen-opts.man)
 .\"
-.\"  It has been AutoGen-ed  February 21, 2013 at 10:48:09 PM by AutoGen 5.17.2pre17
+.\"  It has been AutoGen-ed  February 27, 2013 at 11:38:50 AM by AutoGen 5.17.3.pre2
 .\"  From the definitions    ntp-keygen-opts.def
 .\"  and the template file   agman-cmd.tpl
 .\"
@@ -1109,7 +1109,7 @@ Please report bugs to http://bugs.ntp.org .
 .PP
 Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
 .SH NOTES
-This document corresponds to version 4.2.7p357 of NTP.
+This document corresponds to version 4.2.7p358 of NTP.
 Portions of this document came from FreeBSD.
 .PP
 This manual page was \fIAutoGen\fP-erated from the \fBntp-keygen\fP
index 9e1ae9eca89bc9ba719e2b9e835219202c41519e..3865cbea7ac507271f6b7feaea68841e4a2837a4 100644 (file)
@@ -1,9 +1,9 @@
-.Dd February 21 2013
+.Dd February 27 2013
 .Dt NTP_KEYGEN 1ntp-keygenmdoc User Commands
 .Os SunOS 5.10
 .\"  EDIT THIS FILE WITH CAUTION  (ntp-keygen-opts.mdoc)
 .\"
-.\"  It has been AutoGen-ed  February 21, 2013 at 10:48:16 PM by AutoGen 5.17.2pre17
+.\"  It has been AutoGen-ed  February 27, 2013 at 11:38:57 AM by AutoGen 5.17.3.pre2
 .\"  From the definitions    ntp-keygen-opts.def
 .\"  and the template file   agmdoc-cmd.tpl
 .Sh NAME
@@ -1072,7 +1072,7 @@ Please report bugs to http://bugs.ntp.org .
 .Pp
 Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
 .Sh NOTES
-This document corresponds to version 4.2.7p357 of NTP.
+This document corresponds to version 4.2.7p358 of NTP.
 Portions of this document came from FreeBSD.
 .Pp
 This manual page was \fIAutoGen\fP\-erated from the \fBntp\-keygen\fP
index f9a6c1fc284adab0e9afd804fb7a7a54f0867bbf..cdf2e2bcbda5a5f430dd7681d6207df7dadc59b6 100644 (file)
@@ -70,7 +70,7 @@ All other files are in PEM-encoded
 printable ASCII format so they can be embedded as MIME attachments in
 mail to other sites.
 
-  <p>This document applies to version 4.2.7p357 of <code>ntp-keygen</code>.
+  <p>This document applies to version 4.2.7p358 of <code>ntp-keygen</code>.
 
 <div class="node">
 <p><hr>
@@ -1120,7 +1120,7 @@ the usage text by passing it through a pager program.
 used to select the program, defaulting to <span class="file">more</span>.  Both will exit
 with a status code of 0.
 
-<pre class="example">ntp-keygen (ntp) - Create a NTP host key - Ver. 4.2.7p356
+<pre class="example">ntp-keygen (ntp) - Create a NTP host key - Ver. 4.2.7p357
 Usage:  ntp-keygen [ -&lt;flag&gt; [&lt;val&gt;] | --&lt;name&gt;[{=| }&lt;val&gt;] ]...
   Flg Arg Option-Name    Description
    -b Num imbits         identity modulus bits
index 1b3596ee7c68ef45de5c4cedbd00c79dfac47a64..15bd57d0bfa616b1cebb87cda86d083b7dd06b89 100644 (file)
@@ -1,8 +1,8 @@
-.TH ntp-keygen @NTP_KEYGEN_MS@ "21 Feb 2013" "ntp (4.2.7p357)" "User Commands"
+.TH ntp-keygen @NTP_KEYGEN_MS@ "27 Feb 2013" "ntp (4.2.7p358)" "User Commands"
 .\"
 .\"  EDIT THIS FILE WITH CAUTION  (ntp-keygen-opts.man)
 .\"
-.\"  It has been AutoGen-ed  February 21, 2013 at 10:48:09 PM by AutoGen 5.17.2pre17
+.\"  It has been AutoGen-ed  February 27, 2013 at 11:38:50 AM by AutoGen 5.17.3.pre2
 .\"  From the definitions    ntp-keygen-opts.def
 .\"  and the template file   agman-cmd.tpl
 .\"
@@ -1109,7 +1109,7 @@ Please report bugs to http://bugs.ntp.org .
 .PP
 Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
 .SH NOTES
-This document corresponds to version 4.2.7p357 of NTP.
+This document corresponds to version 4.2.7p358 of NTP.
 Portions of this document came from FreeBSD.
 .PP
 This manual page was \fIAutoGen\fP-erated from the \fBntp-keygen\fP
index 4a9f1873adaeda7dfea2b8a0c3bc352cdcafb7e0..9eb1057f02b0b4f7e6d63af7f65090332e0702ae 100644 (file)
@@ -1,9 +1,9 @@
-.Dd February 21 2013
+.Dd February 27 2013
 .Dt NTP_KEYGEN @NTP_KEYGEN_MS@ User Commands
 .Os SunOS 5.10
 .\"  EDIT THIS FILE WITH CAUTION  (ntp-keygen-opts.mdoc)
 .\"
-.\"  It has been AutoGen-ed  February 21, 2013 at 10:48:16 PM by AutoGen 5.17.2pre17
+.\"  It has been AutoGen-ed  February 27, 2013 at 11:38:57 AM by AutoGen 5.17.3.pre2
 .\"  From the definitions    ntp-keygen-opts.def
 .\"  and the template file   agmdoc-cmd.tpl
 .Sh NAME
@@ -1072,7 +1072,7 @@ Please report bugs to http://bugs.ntp.org .
 .Pp
 Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
 .Sh NOTES
-This document corresponds to version 4.2.7p357 of NTP.
+This document corresponds to version 4.2.7p358 of NTP.
 Portions of this document came from FreeBSD.
 .Pp
 This manual page was \fIAutoGen\fP\-erated from the \fBntp\-keygen\fP