WL(1)

NAME
WL - Winterp-Lisp client for communicating with WINTERP UN*X Domain Eval-Server.

SYNOPSIS
wl [-f <socket-filepath>] [<s-expr>]

DESCRIPTION
--->> FOR DETAILS ON WINTERP SEE /usr/local/winterp/doc/winterp.doc <<---

The WINTERP client program wl (stands for Winterp-Lisp) sends the XLISP expression given on its command line to the WINTERP server. wl hangs until WINTERP has evaluated the s-expression given on wl's command-line. After the s-expression is successfully evaluated by WINTERP, wl prints to stdout the results of the evaluation, and sets exit status 0. If an evaluation error occurs, an error messsage is output to stderr, and exit status gets set to 127.

By default, WINTERP compiles with the Unix-Domain eval server enabled. If for some reason your machine or OS does not support Unix Domain Sockets, you may turn off compilation of these features. Do this by (1) removing "-DWINTERP_WANT_UNIX_SERVER" in the associated <winterp-top-dir>/src-server/Makefile.* makefile; or (2) make equivalent change to the Imakefile or its generated Makefile in that directory; or (3) edit <winterp-top-dir>/src-server/config.h...

The Unix Domain Socket can also be enabled/disabled via X resource <<Winterp.enableUnixServer:>>, or via command-line arguments <<-no_unix_server>> or <<-enable_unix_server>>.

wl will "hang" waiting for WINTERP to finish the evaluation. When the evaluation completes, wl prints the results of the evaluation to stdout, and returns exit status 0. If an error occurs in evaluation, an exit status of 128 is returned and the following is printed to stderr: "wl: an evaluation error occured in WINTERP server." Finally, if some other error occurs, e.g. network error, unable to bind socket, etc, then exit status of 1 is returned and an eror message will appear on stderr.

If evaluation via wl causes an error and *BREAKENABLE* is set (including by selecting "Error Break-Loop" or "Error Trace-Back" in the "WINTERP Control Panel), then wl will hang until the break-loop exits, typically because the user has invoked functions Control-D into WINTERP's controlling terminal.

Example: invoking the following in a UN*X command shell:

        wl '(load "rc-shell")'

while there is a WINTERP running with a unix domain socket enable, will cause WINTERP to load the file "rc-shell" and pop up the widgetry associated with loading that file.

OPTIONS
[-f<socket-filepath>] The optional <socket-filepath> argument sets the pathname for the Unix Domain Socket eval-server. By default, <socket-filepath> is "/tmp/.winterp_serv", you may want to specify a different <socket-filepath> if multiple winterp
 applications are running. Alternately, you may want to hide the Unix Domain Socket from other users if you are on a multi-user machine. Note that you may specify <socket-filepath> via environment variable WINTERP_UNIX_SOCKET_FILEPATH. The environment variable sets <socket-filepath> for both wl and winterp [<s-expr>] The <s-expr> argument is a single Lisp s-expression to be sent to WINTERP's Lisp listener. If no <s-expr> argument is given, wl sends an EOF (==Control-D) to XLISP, which causes WINTERP to terminate. Note that the <s-expr> must be quoted with ['] so that the shell does not attempt to interpret the parentheses as shell commands.

AVAILABILITY:
You may obtain the latest released version of the WINTERP source, documentation, and examples via anonymous ftp from internet host ftp.x.org in directory /contrib/devel_tools, file winterp-2.xx.tar.gz, where 'xx' represents the revision number. Directory /contrib/devel_tools/winterp contains slides, papers, further documentation, contributed code, etc.

An automated reply indicating the locations and status of the latest WINTERP source may be obtained by sending an e-mail message to winterp-source@netcom.com.

CONTACTING OTHER USERS
winterp@netcom.com is the mailing list for WINTERP-related announcements and discussions. To get added/removed from the list, send mail to winterp-request@netcom.com. Please do not send junk mail or subscribe/unsubscribe messages to the mailing list winterp@netcom.com.

For discussions about XLISP, see the USENET newsgroup comp.lang.lisp.x.

SEE ALSO
winterp(1), wl-tcpip(1).

FILES
/tmp/.winterp_serv $WINTERP_UNIX_SOCKET_FILEPATH

AUTHOR
Niels Mayer (mayer@netcom.com)