Summary: | Extension of manual | ||
---|---|---|---|
Product: | Base System | Reporter: | jhs <jhs> |
Component: | bin | Assignee: | Steve Price <steve> |
Status: | Closed FIXED | ||
Severity: | Affects Only Me | CC: | jbrown |
Priority: | Normal | ||
Version: | 2.2.2-RELEASE | ||
Hardware: | Any | ||
OS: | Any |
Description
jhs
![]() ![]() <<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 > >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 Slightly modified patch applied to -current. Thanks! |