]> git.ipfire.org Git - thirdparty/ntp.git/commitdiff
Prepare for the generation of sntp.html
authorHarlan Stenn <stenn@ntp.org>
Thu, 26 Nov 2009 06:33:57 +0000 (01:33 -0500)
committerHarlan Stenn <stenn@ntp.org>
Thu, 26 Nov 2009 06:33:57 +0000 (01:33 -0500)
bk: 4b0e2155gnECR1nsQcaOSZRXGPzWkQ

ChangeLog
include/version.texi [new file with mode: 0644]
sntp/Makefile.am
sntp/depsver.mf [new file with mode: 0644]
sntp/sntp.html [new file with mode: 0644]
sntp/version.texi [new file with mode: 0644]

index 23a279be538398e3d89e21e4dc29f44715fd5e78..48f72d3242311716ef910dd78dc8fbb03ecb4467 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,4 @@
+* Prepare for the generation of sntp.html.
 (4.2.5p247-RC) 2009/11/20 Released by Harlan Stenn <stenn@ntp.org>
 * [Bug 1142] nodebug builds shed no light on -d, -D option failure.
 * [Bug 1179] point out the problem with -i/--jaildir and -u/--user when
diff --git a/include/version.texi b/include/version.texi
new file mode 100644 (file)
index 0000000..18a3f3b
--- /dev/null
@@ -0,0 +1,3 @@
+@set UPDATED 23 November 2009
+@set EDITION 4.2.5p247-RC
+@set VERSION 4.2.5p247-RC
index dd551be0bb178bb25abf9e2088b850adaafaac35..d7a64463bf76bd844b3a0f6f512fd6206e189b61 100644 (file)
@@ -76,7 +76,6 @@ man_MANS=     sntp.1
 
 FRC:
 check-autogen-version.def: FRC
-foo1:
        @cd $(srcdir)                                                   \
        && test -r ../include/autogen-version.def                       \
        && ( if cmp -s ../include/autogen-version.def autogen-version.def; \
@@ -86,7 +85,6 @@ foo1:
           fi )
 
 check-version.def: FRC
-foo2:
        @cd $(srcdir)                                   \
        && test -r ../include/version.def               \
        && ( if cmp -s ../include/version.def version.def;      \
@@ -96,7 +94,6 @@ foo2:
           fi )
 
 check-version.m4: FRC
-foo3:
        @cd $(srcdir)                                   \
        && test -r ../version.m4                        \
        && ( if cmp -s ../version.m4 version.m4;        \
@@ -106,7 +103,6 @@ foo3:
           fi )
 
 check-version.texi: FRC
-foo4:
        @cd $(srcdir)                                   \
        && test -r ../include/version.texi                      \
        && ( if cmp -s ../include/version.texi version.texi;    \
@@ -131,7 +127,7 @@ $(srcdir)/sntp.1: $(srcdir)/sntp-opts.def $(srcdir)/../include/version.def
 $(srcdir)/sntp-opts.texi $(srcdir)/sntp-opts.menu: $(srcdir)/sntp-opts.def $(srcdir)/../include/version.def
        $(run_ag) -Taginfo.tpl -DLEVEL=section sntp-opts.def
 
-$(srcdir)/sntp.html: $(srcdir)/sntp-opts.menu $(srcdir)/sntp-opts.texi $(srcdir)/sntp.texi
+$(srcdir)/sntp.html: $(srcdir)/sntp-opts.menu $(srcdir)/sntp-opts.texi $(srcdir)/sntp.texi $(srcdir)/version.texi
        cd $(srcdir) && makeinfo --force --html --no-split -o sntp.html sntp.texi
 
 ../libntp/libntp.a:
diff --git a/sntp/depsver.mf b/sntp/depsver.mf
new file mode 100644 (file)
index 0000000..3e4a618
--- /dev/null
@@ -0,0 +1,67 @@
+$(DEPDIR)/deps-ver: $(top_srcdir)/deps-ver
+       @[ -f $@ ] ||                                                   \
+               cp $(top_srcdir)/deps-ver $@
+       @[ -w $@ ] ||                                                   \
+               chmod ug+w $@
+       @cmp $(top_srcdir)/deps-ver $@ > /dev/null || (                 \
+               $(MAKE) clean &&                                        \
+               echo -n "Prior $(subdir)/$(DEPDIR) version " &&         \
+               cat $@ &&                                               \
+               rm -rf $(DEPDIR) &&                                     \
+               mkdir $(DEPDIR) &&                                      \
+               case "$(top_builddir)" in                               \
+                .)                                                     \
+                   ./config.status Makefile depfiles                   \
+                   ;;                                                  \
+                ..)                                                    \
+                       cd .. &&                                        \
+                       ./config.status $(subdir)/Makefile depfiles &&  \
+                       cd $(subdir)                                    \
+                   ;;                                                  \
+                *)                                                     \
+                   echo 'Fatal: depsver.mf Automake fragment limited'  \
+                        'to immediate subdirectories.' &&              \
+                   echo "top_builddir: $(top_builddir)" &&             \
+                   echo "subdir:       $(subdir)" &&                   \
+                   exit 1                                              \
+                   ;;                                                  \
+               esac &&                                                 \
+               echo -n "Cleaned $(subdir)/$(DEPDIR) version " &&       \
+               cat $(top_srcdir)/deps-ver                              \
+       )
+       cp $(top_srcdir)/deps-ver $@
+
+.deps-ver: $(top_srcdir)/deps-ver
+       @[ ! -d $(DEPDIR) ] || $(MAKE) $(DEPDIR)/deps-ver
+       @touch $@
+
+BUILT_SOURCES += .deps-ver
+CLEANFILES += .deps-ver
+
+#
+# depsver.mf   included in Makefile.am for directories with .deps
+#
+# When building in the same directory with sources that change over
+# time, such as when tracking using bk, the .deps files can become
+# stale with respect to moved, deleted, or superceded headers.  Most
+# commonly, this would exhibit as make reporting a failure to make a
+# header file which is no longer in the location given.  To address
+# this issue, we use a deps-ver file which is updated with each change
+# that breaks old .deps files.  A copy of deps-ver is made into
+# $(DEPDIR) if not already present.  If $(DEPDIR)/deps-ver is present
+# with different contents than deps-ver, we make clean to ensure all
+# .o files built before the incompatible change are rebuilt along with
+# their updated .deps files, then remove $(DEPDIR) and recreate it as
+# empty stubs.
+#
+# It is normal when configured with --disable-dependency-tracking for
+# the DEPDIR to not have been created.  For this reason, we use the
+# intermediate target .deps-ver, which invokes make recursively if
+# DEPDIR exists.
+#
+# If you modify depsver.mf, please make the changes to the master
+# copy, the one in sntp is copied by the bootstrap script from it.
+#
+# This comment block follows rather than leads the related code so that
+# it stays with it in the generated Makefile.in and Makefile.
+#
diff --git a/sntp/sntp.html b/sntp/sntp.html
new file mode 100644 (file)
index 0000000..dcc7e9d
--- /dev/null
@@ -0,0 +1,105 @@
+<html lang="en">
+<head>
+<title>Sntp User's Manual</title>
+<meta http-equiv="Content-Type" content="text/html">
+<meta name="description" content="Sntp User's Manual">
+<meta name="generator" content="makeinfo 4.11">
+<link title="Top" rel="top" href="#Top">
+<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
+<meta http-equiv="Content-Style-Type" content="text/css">
+<style type="text/css"><!--
+  pre.display { font-family:inherit }
+  pre.format  { font-family:inherit }
+  pre.smalldisplay { font-family:inherit; font-size:smaller }
+  pre.smallformat  { font-family:inherit; font-size:smaller }
+  pre.smallexample { font-size:smaller }
+  pre.smalllisp    { font-size:smaller }
+  span.sc    { font-variant:small-caps }
+  span.roman { font-family:serif; font-weight:normal; } 
+  span.sansserif { font-family:sans-serif; font-weight:normal; } 
+--></style>
+</head>
+<body>
+<h1 class="settitle">Sntp User's Manual</h1>
+<div class="node">
+<p><hr>
+<a name="Top"></a>
+Next:&nbsp;<a rel="next" accesskey="n" href="#sntp-Description">sntp Description</a>,
+Previous:&nbsp;<a rel="previous" accesskey="p" href="#dir">(dir)</a>,
+Up:&nbsp;<a rel="up" accesskey="u" href="#dir">(dir)</a>
+
+</div>
+
+<h2 class="unnumbered">Simple Network Time Protocol User Manual</h2>
+
+<p>This document describes the use of the NTP Project's sntp, a program
+that can be used to query a Network Time Protocol (NTP) server and
+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.5p247-RC of sntp.
+
+  <p>The program implements the SNTP protocol as defined by the draft NTPv4
+IETF specification.
+
+  <div class="shortcontents">
+<h2>Short Contents</h2>
+<ul>
+<a href="#Top">Simple Network Time Protocol User Manual</a>
+</ul>
+</div>
+
+<ul class="menu">
+<li><a accesskey="1" href="#sntp-Description">sntp Description</a>:             Description
+* sntp Invocation::                Invoking sntp
+<li><a accesskey="2" href="#Usage">Usage</a>:                        Usage
+</ul>
+
+<div class="node">
+<p><hr>
+<a name="sntp-Description"></a>
+Next:&nbsp;<a rel="next" accesskey="n" href="#Usage">Usage</a>,
+Previous:&nbsp;<a rel="previous" accesskey="p" href="#Top">Top</a>,
+Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
+
+</div>
+
+<!-- node-name,  next,  previous,  up -->
+<h3 class="section">Description</h3>
+
+<p>By default, sntp writes the local data and time (i.e., not UTC) to the
+standard output in the format:
+
+<pre class="example">     1996 Oct 15 20:17:25.123 + 4.567 +/- 0.089 secs
+</pre>
+  <p>where the + 4.567 +/- 0.089 secs indicates the time offset and
+error bound of the system clock relative to the server clock.
+
+<!-- @include sntp-opts.texi -->
+<div class="node">
+<p><hr>
+<a name="Usage"></a>
+Previous:&nbsp;<a rel="previous" accesskey="p" href="#sntp-Description">sntp Description</a>,
+Up:&nbsp;<a rel="up" accesskey="u" href="#Top">Top</a>
+
+</div>
+
+<!-- node-name,  next,  previous,  up -->
+<h3 class="section">Usage</h3>
+
+<p>The simplest use of this program is as an unprivileged command to
+check the current time, offset, and error in the local clock. 
+For example:
+
+<pre class="example">     sntp ntpserver.somewhere
+</pre>
+  <p>With suitable privilege, it can be run as a command or in a
+<code>crom</code> job to reset the local clock from a reliable server, like
+the <code>ntpdate</code> and <code>rdate</code> commands. 
+For example:
+
+<pre class="example">     sntp -a ntpserver.somewhere
+</pre>
+  </body></html>
+
diff --git a/sntp/version.texi b/sntp/version.texi
new file mode 100644 (file)
index 0000000..18a3f3b
--- /dev/null
@@ -0,0 +1,3 @@
+@set UPDATED 23 November 2009
+@set EDITION 4.2.5p247-RC
+@set VERSION 4.2.5p247-RC