From jhs@FreeBSD.ORG  Wed Nov  5 14:20:49 1997
Received: from wall.jhs.no_domain (vector.muc.ditec.de [194.120.126.35])
          by hub.freebsd.org (8.8.7/8.8.7) with ESMTP id OAA13781
          for <FreeBSD-gnats-submit@freebsd.org>; Wed, 5 Nov 1997 14:20:45 -0800 (PST)
          (envelope-from jhs@freebsd.org)
Received: (from jhs@localhost) by wall.jhs.no_domain (8.8.5/8.6.9) id VAA01401; Tue, 4 Nov 1997 21:57:33 +0100 (MET)
Message-Id: <199711042057.VAA01401@wall.jhs.no_domain>
Date: Tue, 4 Nov 1997 21:57:33 +0100 (MET)
From: jhs@FreeBSD.ORG
Reply-To: jhs@FreeBSD.ORG
To: FreeBSD-gnats-submit@freebsd.org
Cc: "John Brown" <jbrown@vafibre.com>
Subject: src/usr.bin/rdist/rdist.1
X-Send-Pr-Version: 3.2

>Number:         4954
>Category:       bin
>Synopsis:       Extension of manual
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    steve
>State:          closed
>Quarter:
>Keywords:
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Wed Nov  5 14:30:00 PST 1997
>Closed-Date:    Sun Nov 16 05:28:58 PST 1997
>Last-Modified:  Sun Nov 16 05:29:36 PST 1997
>Originator:     Julian Stacey jhs@freebsd.org
>Release:        FreeBSD 2.2.2-RELEASE i386
>Organization:
>Environment:
>Description:
	Extension of manual.
	I was reminded of writing this by a post to current from
	"John Brown" <jbrown@vafibre.com>
>How-To-Repeat:
	-
>Fix:
	Ive had the following patch in
	http://www.freebsd.org/~jhs/src/bsd/fixes/FreeBSD/\
		src/gen/usr.bin/rdist/rdist.1.diff
	since at least March 97 but not sent it in via send-pr till now, Sorry.
============
Extension of manual

*** old/src/usr.bin/rdist/rdist.1.~1~	Tue Jan 21 19:07:53 1997
--- old/src/usr.bin/rdist/rdist.1	Mon Mar 31 14:07:57 1997
***************
*** 400,409 ****
  .Sh DIAGNOSTICS
  A complaint about mismatch of rdist version numbers may really stem
  from some problem with starting your shell, e.g., you are in too many groups.
  .Sh BUGS
  Source files must reside on the local host where
  .Nm rdist
! is executed.
  .Pp
  There is no easy way to have a special command executed after all files
  in a directory have been updated.
--- 400,436 ----
  .Sh DIAGNOSTICS
  A complaint about mismatch of rdist version numbers may really stem
  from some problem with starting your shell, e.g., you are in too many groups.
+ .Pp
+ .Nm Rdist
+ relies on
+ .Nm rsh(1)
+ type remote services executing succesfully & in silence.
+ If you try something like
+ .Bd -literal -offset indent
+ rsh freefall.freebsd.org hostname  
+ .Ed
+ .sp
+ & get extra output before the program (
+ .Nm hostname(1)
+ ) output, such as
+ .Bd -literal -offset indent
+ Text_perhaps_initiated_from_~/.cshrc_or_similar
+ freefall.freebsd.org  
+ .Ed
+ .sp
+ then the unexpected extra text will cause
+ .Nm rdist
+ to fail with the error message:
+ .Bd -literal -offset indent
+ rdist: connection failed: version numbers don't match
+ .Ed
+ .sp
  .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).
  .Pp
  There is no easy way to have a special command executed after all files
  in a directory have been updated.

============

Julian
--
Julian H. Stacey
Home <jhs@freebsd.org>     http://www.freebsd.org/~jhs/     Tel. +49 89 268616	
>Release-Note:
>Audit-Trail:

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

From: "Jordan K. Hubbard" <jkh@time.cdrom.com>
To: jhs@FreeBSD.ORG
Cc: FreeBSD-gnats-submit@FreeBSD.ORG, "John Brown" <jbrown@vafibre.com>
Subject: Re: bin/4954: src/usr.bin/rdist/rdist.1 
Date: Wed, 05 Nov 1997 19:40:49 -0800

 > >Number:         4954
 
 Ah, OK, there's the PR (sorry, I read your first message before getting
 to this one).  If whomever commits it can also change the awkward & to "and",
 we'll be fine with this one.  Thanks
State-Changed-From-To: open->closed 
State-Changed-By: steve 
State-Changed-When: Sun Nov 16 05:28:58 PST 1997 
State-Changed-Why:  
Slightly modified patch applied to -current.  Thanks! 
>Unformatted:
