bin/45008: document all rcmd(1) options

[neitzel%marshlabs.gaertner.de@localhost]

>Number:         45008
>Category:       bin
>Synopsis:       document all rcmd(1) options
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    bin-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Tue May 31 06:30:00 +0000 2011
>Originator:     Martin Neitzel
>Release:        NetBSD 5.1_STABLE (2011-05-30)
>Organization:
        Gaertner Datensysteme, Marshlabs
>Environment:
System: NetBSD nguyen.marshlabs.gaertner.de 5.1_STABLE NetBSD 5.1_STABLE 
(NGUYEN) #0: Tue May 24 22:39:32 CEST 2011 
neitzel%nguyen.marshlabs.gaertner.de@localhost:/u1/scratch/obj/sys/arch/i386/compile/NGUYEN
 i386
Architecture: any
Machine: any
>Description:
        Among other options,
        rcmd(1) has the -4/-6 options correctly working but not documented.

        rsh(1) has the -4/-6 options correctly documented but not working.

        Using rcmd -4/-6 instead is in fact a simple work-around until a fix
        for rsh(1) such as the one provided with PR lib/45007 is adopted;
        that fix depends on the yet undocumented rcmd(1) options.

        Both commands share the source and almost all options,
        set off by a mere -DIN_RCMD compile flag.

>How-To-Repeat:
        man 1 rcmd

>Fix:
        This patch documents the -4, -6 and -p port options, just as
        in rsh(1), mentions the possible "user@host" syntax, and elevates 
        the flags -d and -n into the SYNOSIS, too.

        There are no functional changes with the rcmd(1) program per se,
        so I didn't update the .Dd date.

        The diff is against netbsd-5 or -current (identical) as
        of today (2011-05-31).

Index: bin/rcmd/rcmd.1
===================================================================
RCS file: /cvsroot/src/bin/rcmd/rcmd.1,v
retrieving revision 1.19
diff -u -r1.19 rcmd.1
--- bin/rcmd/rcmd.1     30 May 2008 02:29:37 -0000      1.19
+++ bin/rcmd/rcmd.1     31 May 2011 06:05:16 -0000
@@ -63,6 +63,8 @@
 .Xr rcmd 3
 .Sh SYNOPSIS
 .Nm
+.Op Fl 46dn
+.Op Fl p Ar port
 .Op Fl l Ar username
 .Op Fl u Ar localusername
 .Ar host
@@ -84,6 +86,10 @@
 normally terminates when the remote command does.
 The options are as follows:
 .Bl -tag -width flag
+.It Fl 4
+Use IPv4 addresses only.
+.It Fl 6
+Use IPv6 addresses only.
 .It Fl d
 The
 .Fl d
@@ -97,6 +103,9 @@
 The
 .Fl l
 option allows the remote name to be specified.
+Another possible way to specify the remote username
+is the notation
+.Ar user@host .
 .It Fl u
 The
 .Fl u
@@ -110,6 +119,12 @@
 (see the
 .Sx BUGS
 section of this manual page).
+.It Fl p Ar port
+Uses the given
+.Pa port
+instead of the one assigned to the service
+.Dq shell .
+May be given either as symbolic name or as number.
 .El
 .Pp
 Shell metacharacters which are not quoted are interpreted on local machine,