[PATCH] copyedit body of man page text
Paul Theodoropoulos
paul at anastrophe.com
Fri Jun 22 20:40:52 UTC 2018
---
docs/includes/ntpviz-body.txt | 39 +++++++++++++++++++--------------------
1 file changed, 19 insertions(+), 20 deletions(-)
diff --git a/docs/includes/ntpviz-body.txt b/docs/includes/ntpviz-body.txt
index 3c2eeb4d6..1329ba4f4 100644
--- a/docs/includes/ntpviz-body.txt
+++ b/docs/includes/ntpviz-body.txt
@@ -67,7 +67,7 @@ subset of comparative plots for multiple directories.
timestamps (yyyy-mmm-ddThh:mm:ss). +
The default end time is the last logfile entry timestamp. +
The default start time is computed as the end time minus DAYS. +
- Alternatively you can specify either -s or -e (but not both) and use
+ Alternatively you may specify either -s or -e (but not both) and use
-p to set the plot period in days.
-s TIME or --starttime TIME::
@@ -126,9 +126,9 @@ The following plots are available:
Clock time-jitter plot from the loop statistics (field 5).
--local-gps::
- Plot GPS Time Dilution of Precision (TDOP) and Number of Sats Used
- (nSats). This plot is only generated if there is a log file named
- gpsd in the log file directory.
+ Plot GPS Time Dilution of Precision (TDOP) and number of satellites
+ used (nSats). This plot is only generated if there is a log file
+ named gpsd in the log file directory.
--local-offset::
Clock time and clock frequency offsets from the loop statistics
@@ -162,34 +162,33 @@ The following plots are available:
If no individual plot is specified, all plots and an index HTML page
are generated into the output directory.
-When an index is generated, ntpviz will look for two files in the
-output directory. Neither of these files need be present, and the
-'header' and 'footer' files may contain arbitrary HTML.
+When an index is generated, ntpviz will look for a 'header' and
+'footer' file in the output directory. Neither of these files are
+required. The files may contain arbitrary HTML.
-The first file is named 'header'. The contents of that file will be
-added almost at the top of the body on the generated index page.
+The 'header' file will be added almost at the top of the body of the
+generated index page, and the 'footer' file will be added almost at
+the bottom of the body of the generated index page.
-This is the place to put links to other web pages, or headline notes.
+The contents are at the discretion of the operator. One might put
+links to other related webpages, or notes on the server OS, software
+versions, hardware configuration, etc. into either of these files,
+as desired.
-The second file is named 'footer'. The contents of that file will be
-added almost at the bottom of the body on the generated index.
-
-It is suggested that notes on the server be included in the footer
-file: OS, versions, CPU speed, etc. You may also put links there.
-
-The code includes various sanity checks and will bail out with a message to
-standard error on, for example, missing logfile data required for a plot.
+The code includes various sanity checks and will bail out with a message
+to standard error on, for example, missing logfile data required for a
+plot.
=== Argument File ===
-Any command line options can also be placed into a command file. The
+Any command line options may also be placed into a command file. The
command file name (OPTIONFILE) is prefixed on the command line with an
atsign (@).
Each line in the command file should contain just one option. Multiple
options per line are allowed, but discouraged. Blank lines are allowed.
-Comments can be added, and start with an octothorpe (#). Comments may
+Comments may be added, prepended with an octothorpe (#). Comments may
appear on a new line, or trailing, after the # .
When an option takes a parameter, the option and parameter must be
--
2.11.0
More information about the devel
mailing list