Date: Wed, 5 Nov 1997 19:00:02 -0800 (PST) From: Garrett Wollman <wollman@khavrinen.lcs.mit.edu> To: freebsd-bugs Subject: bin/4954: src/usr.bin/rdist/rdist.1 Message-ID: <199711060300.TAA03617@hub.freebsd.org>
next in thread | raw e-mail | index | archive | help
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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?199711060300.TAA03617>