'\"macro stdmacro
.if n .pH g1.psh @(#)psh	40.2 of 12/29/89
.ig
Revised: D. Bodnar 9/7/89
format -dqm4 -man6 -rs1 psh.1
..
.\" @(#)string.defs 9.7 89/06/20 SMI;
.\" string definitions for X11/NeWS.
.\" NOTE: the master copy of this file is in src-mc68020/usr.bin/xnews/xnews/man
.ds Ps P\s-2OST\s+2S\s-2CRIPT\s+2
.ds Px \%FIX_P\s-2OST\s+2S\s-2CRIPT\s+2_REFERENCE
.ds Cs CS\s-2CRIPT\s+2
.\".ds Sd S\s-2UN\s+2D\s-2EW\s+2
.\".ds Sd \s-2N\s+2e\s-2WS\s+2
.\".ds Sd \s-2Ne\h'-0.3n'WS\s+2
.\" less kerning so italic doesn't overstrike the eW pair
.ds Sd \s-2Ne\h'-0.2n'WS\s+2
.ds Xn \s-2X11/N\s+2e\h'-0.2n'\s-2WS\s+2
.\" .ds Xn X11/Ne\h'-0.2n'WS
.ds Xe \s-2X11\s+2
.ds Cp \s-2CPS\s+2
.ds Ni \*(Sd Installation Guide
.ds Nm \*(Sd Programmer's Guide
.\" should be NeWS Tutorial and Cookbook
.ds Nt \*(Sd Application Scenario
.\" !! \*(No will eventually become a Technical Report.
.ds No \*(Sd Technical Overview
.ds Pm PostScript Language Reference Manual
.ds Pt PostScript Language Tutorial and Cookbook
.ds Sv \%SunView\ 2
.ds Sp SunView\ 1 Programmer's Guide
.ds Sg SunView\ 1 System Programmer's Guide
.\" @(#)psh.1 9.7 89/01/13 SMI; 
.nr X
.if \nX=0 .ds x} PSH 1 "2 December 1987" "\&"
.if \nX=1 .ds x} PSH 1 "2 December 1987"
.if \nX=2 .ds x} PSH 1 "" "\&"
.if \nX=3 .ds x} PSH "" "" "\&"
.TH \*(x}
.ds Sd \s-2Ne\h'-0.2n'WS\s+2
.ds Xn \s-2X11/N\s+2e\h'-0.2n'\s-2WS\s+2
.ds Ps P\s-2OST\s+2S\s-2CRIPT\s+2
.IX psh#(1) "" "\fLpsh\fP(1)"
.IX "cps facility" "psh#" "\*(Cp facility" "\fLpsh(1)\fP"
.SH NAME
psh \- \*(Sd \*(Ps shell
.SH SYNOPSIS
.B psh
[
.I files
]
.IX psh#(1) ""  "\fLpsh\fP(1) \(em \*(Sd \*(Ps shell"
.SH DESCRIPTION
.LP
If a \fIfiles\fP argument is specified, \fBpsh\fP opens a connection to the server
and transmits the specified files to the server.  If no \fIfiles\fP argument is specified, or
if `-' is specified, \fBpsh\fP opens a connection to the server and transmits stdin
to the server.
Any output from \*(Sd
is copied to stdout.  The files should be \*(Ps programs for the \*(Sd
server to execute.
.LP
A common use for
.B psh
is in creating applications written entirely in the \*(Ps language.
First, type
your \*(Ps program into a file.  Then, add this as its first line:
.sp 1
	\fB#! /usr/\s-1N\s+1e\s-1WS\s+1/bin/psh\fP
.sp 1
If you now make the file executable (with \fBchmod\fP),
you can invoke it by name from the shell, and 
.SM UNIX 
will use
.B /usr/\s-1N\s+1e\s-1WS\s+1/bin/psh 
to execute it.
.B psh
will in turn send your program to the \*(Xn server.
.SH "SEE ALSO"
\fBsh\fP(1)
.P
.I "\*(Nm"
.SH TRADEMARK
\*(Ps is a registered trademark of Adobe Systems Inc.
.SH BUGS
If \fB#! /usr/\s-1N\s+1e\s-1WS\s+1/bin/psh\fP is the first line,
the script or file
is implementation or installation dependent.
.\" Also, the \*(Sd run primitive does not like it.
.\" what does "not like it" mean?
