Skip site navigation (1)Skip section navigation (2)
Date:      Sat, 20 Sep 2003 00:51:49 +0200 (CEST)
From:      Christian Weisgerber <naddy@FreeBSD.org>
To:        FreeBSD-gnats-submit@FreeBSD.org
Subject:   docs/57027: timed.8 nits
Message-ID:  <200309192251.h8JMpnjr044895@kemoauc.mips.inka.de>
Resent-Message-ID: <200309192350.h8JNoARx092066@freefall.freebsd.org>

next in thread | raw e-mail | index | archive | help

>Number:         57027
>Category:       docs
>Synopsis:       timed.8 nits
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Sep 19 16:50:10 PDT 2003
>Closed-Date:
>Last-Modified:
>Originator:     Christian Weisgerber
>Release:        FreeBSD 5.1-CURRENT alpha
>Organization:
>Environment:
System: FreeBSD kemoauc.mips.inka.de 5.1-CURRENT FreeBSD 5.1-CURRENT #0: Tue Sep 9 21:32:51 CEST 2003 naddy@kemoauc.mips.inka.de:/usr/obj/usr/src/sys/KEMOAUC alpha
	
>Description:

The patch below marks the -i and -n options as mutually exclusive
in the synopsis line and fixes various mdoc formatting nits.

>From OpenBSD.

>How-To-Repeat:

>Fix:

Index: timed.8
===================================================================
RCS file: /home/ncvs/src/usr.sbin/timed/timed/timed.8,v
retrieving revision 1.13
diff -u -r1.13 timed.8
--- timed.8	14 Jul 2002 14:46:33 -0000	1.13
+++ timed.8	19 Sep 2003 22:36:08 -0000
@@ -41,8 +41,10 @@
 .Sh SYNOPSIS
 .Nm
 .Op Fl dtM
-.Op Fl i Ar network
-.Op Fl n Ar network
+.Xo
+.Oo Fl i Ar network No \&|
+.Fl n Ar network Oc
+.Xc
 .Op Fl F Ar host ...
 .Sh DESCRIPTION
 The
@@ -208,15 +210,17 @@
 interrupts disabled.
 This means that the clock stops while they are printing.
 A machine with many disk or network hardware problems and consequent
-messages cannot keep good time by itself.  Each message typically causes
-the clock to lose a dozen milliseconds.  A time daemon can
-correct the result.
+messages cannot keep good time by itself.
+Each message typically causes
+the clock to lose a dozen milliseconds.
+A time daemon can correct the result.
 .Pp
 Messages in the system log about machines that failed to respond
 usually indicate machines that crashed or were turned off.
 Complaints about machines that failed to respond to initial time
-settings are often associated with "multi-homed" machines
-that looked for time masters on more than one network and eventually
+settings are often associated with
+.Dq multi-homed
+machines that looked for time masters on more than one network and eventually
 chose to become a slave on the other network.
 .Sh WARNINGS
 Temporal chaos will result if two or more time daemons attempt
@@ -232,21 +236,24 @@
 .Pp
 The protocol is based on
 .Tn UDP/IP
-broadcasts.  All machines within
-the range of a broadcast that are using the
+broadcasts.
+All machines within the range of a broadcast that are using the
 .Tn TSP
 protocol must cooperate.
 There cannot be more than a single administrative domain using the
 .Fl F
 flag among all machines reached by a broadcast packet.
 Failure to follow this rule is usually indicated by complaints concerning
-"untrusted" machines in the system log.
+.Dq untrusted
+machines in the system log.
 .Sh FILES
 .Bl -tag -width /var/log/timed.masterlog -compact
 .It Pa /var/log/timed.log
-tracing file for timed
+tracing file for
+.Nm
 .It Pa /var/log/timed.masterlog
-log file for master timed
+log file for master
+.Nm
 .El
 .Sh SEE ALSO
 .Xr date 1 ,
>Release-Note:
>Audit-Trail:
>Unformatted:



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200309192251.h8JMpnjr044895>