From owner-freebsd-bugs  Wed Nov  5 19:00:06 1997
Return-Path: <owner-freebsd-bugs>
Received: (from root@localhost)
          by hub.freebsd.org (8.8.7/8.8.7) id TAA03640
          for bugs-outgoing; Wed, 5 Nov 1997 19:00:06 -0800 (PST)
          (envelope-from owner-freebsd-bugs)
Received: (from gnats@localhost)
          by hub.freebsd.org (8.8.7/8.8.7) id TAA03617;
          Wed, 5 Nov 1997 19:00:02 -0800 (PST)
          (envelope-from gnats)
Date: Wed, 5 Nov 1997 19:00:02 -0800 (PST)
Message-Id: <199711060300.TAA03617@hub.freebsd.org>
To: freebsd-bugs
Cc: 
From: Garrett Wollman <wollman@khavrinen.lcs.mit.edu>
Subject: bin/4954: src/usr.bin/rdist/rdist.1
Reply-To: Garrett Wollman <wollman@khavrinen.lcs.mit.edu>
Sender: owner-freebsd-bugs@FreeBSD.ORG
X-Loop: FreeBSD.org
Precedence: bulk

The following reply was made to PR bin/4954; it has been noted by GNATS.

From: Garrett Wollman <wollman@khavrinen.lcs.mit.edu>
To: jhs@FreeBSD.ORG
Cc: FreeBSD-gnats-submit@FreeBSD.ORG
Subject: bin/4954: src/usr.bin/rdist/rdist.1
Date: Wed, 5 Nov 1997 21:50:14 -0500 (EST)

 <<On Tue, 4 Nov 1997 21:57:33 +0100 (MET), jhs@FreeBSD.ORG said:
 
 > + .Nm Rdist
 > + relies on
 > + .Nm rsh(1)
 
 BZZT!
 .Xr rsh 1
 (or, more accurately,
 .Xr rcmd 3 )
 
 > + type remote services executing succesfully & in silence.
 
 Spelling: it's ``successfully'' and ``and''.
 
 > + If you try something like
 > + .Bd -literal -offset indent
 > + rsh freefall.freebsd.org hostname  
 > + .Ed
 > + .sp
 
 Never, ever, ever bare troff requsts like `.sp' in man pages.
 
 > + & get extra output before the program (
 > + .Nm hostname(1)
 > + ) output, such as
 
 .Pq Xr hostname 1
 (if anything)
 
 > + .Bd -literal -offset indent
 > + Text_perhaps_initiated_from_~/.cshrc_or_similar
 > + freefall.freebsd.org  
 > + .Ed
 
 A display is probably not the right structure, semantically, for this
 purpose.  Instead, it should simply be noted that a common error is
 for non-interactive initialization scripts, like
 .Pa .cshrc ,
 to generate output (or to run other programs which generate output
 when not attached to a terminal---the most frequent offender is
 .Xr stty 1 .
 
 > + .Bd -literal -offset indent
 > + rdist: connection failed: version numbers don't match
 > + .Ed
 > + .sp
 
 Should use a one-line display.
 
 >   .Sh BUGS
 >   Source files must reside on the local host where
 >   .Nm rdist
 > ! is executed
 > ! (Note, a ~/public_html that is a symbolic link via NFS to another local host is not
 > ! considered local by rdist, so rdist will not copy it to the remote rdist destination).
 
 This example is too specific and inappropriate for a manual page.
 
 -GAWollman
 
 --
 Garrett A. Wollman   | O Siem / We are all family / O Siem / We're all the same
 wollman@lcs.mit.edu  | O Siem / The fires of freedom 
 Opinions not those of| Dance in the burning flame
 MIT, LCS, CRS, or NSA|                     - Susan Aglukark and Chad Irschick