SCP from STDIN: "-t" option undocumented?

[Joshua Judson Rosen]

Jerry Feldman <gaf at blu.org> writes:
>
> On 12/22/2011 05:38 PM, Flaherty, Patrick wrote:
> > > Having just now quickly RTFSC and done a few superficial experiments I
> > > conclude that the -t option (mnemonic for "to"; there's also a secret "from"
> > > flag -f) is not suitable for use by humans.  It tells scp that it's in "server"
> > > mode and should expect to communicate with its counterpart using some
> > > undocumented protocol that appears to mix commands and data in-band via
> > > stdin.  That's not the droid you're looking for...
> >
> > Use it anyways, no one has ever accused you of being a human -=]
>
> http://linux.die.net/man/1/rcp

"In particular, -f does not mean that the user's Kerberos ticket should
 be forwarded!"

It can be a good idea to document `interfaces for internal use only',
just to explicitly state what they *are not*--to counteract the
eliza effect when some hapless user happens upon them by accident,
lest the outcome be less than happy.

Maybe a patch to the scp manpage would be accepted, with that rationale?

-- 
"Don't be afraid to ask (λf.((λx.xx) (λr.f(rr))))."