home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 October / usenetsourcesnewsgroupsinfomagicoctober1994disk2.iso / unix / volume16 / psterm / part01 next >
Text File  |  1988-11-01  |  58KB  |  1,705 lines
  1. Subject:  v16i048:  Terminal emulator for NeWS window system, Part01/04
  2. Newsgroups: comp.sources.unix
  3. Sender: sources
  4. Approved: rsalz@uunet.UU.NET
  5.  
  6. Submitted-by: hoptoad!gnu@uunet.uu.net
  7. Posting-number: Volume 16, Issue 48
  8. Archive-name: psterm/part01
  9.  
  10. The Grasshopper Group took Sun's psterm and worked it over to make a
  11. much better terminal emulator for NeWS.  We also worked with Sun to
  12. clarify the copyright to make it clear that it can be redistributed by
  13. anyone on any machine.
  14.  
  15. This psterm has:
  16.  
  17.     scroll bars
  18.     whole screen font changes and variable width fonts
  19.     whole screen point size changes
  20.     resizing can change rows/cols *or* point size
  21.     rectangular and "hot" selections
  22.     numerous bug fixes (more will be needed)
  23.  
  24. We encourage you to use and improve it; send us back the changes.  Send
  25. flowers, brickbats, picture postcards and diff files to: tech@toad.com
  26. or to Grasshopper Group, 212 Clayton St., San Francisco, CA  94117.
  27.  
  28. : psterm part 1 of 4
  29. : To unbundle, sh this file
  30. echo README
  31. cat >README <<'@@@ Fin de README'
  32. Psterm is a terminal emulator that runs under the NeWS window system.
  33. Terminal-oriented applications (like the Unix shell) run inside it.
  34. It displays their output, manages their input, and handles their
  35. interaction with other programs that share the user's screen.
  36. It will try to emulate any terminal described by "termcap", though due
  37. to limitations in the termcap model it often fails at this;
  38. it's best to use the "psterm" termcap entry unless you have special
  39. requirements.
  40.  
  41. This is release Grass-1 of psterm from the Grasshopper Group.  The
  42. original source from Sun Microsystems' NeWS 1.1 release is freely
  43. distributable under Sun's copyright, reproduced below.  (Sun modified
  44. the copyright after the release, and supplied us the revised wording
  45. that is used here.)  The modifications to that source which were made at
  46. the Grasshopper Group are in the public domain.
  47.  
  48. The Grasshopper Group sells and supports NeWS-related products.  Our
  49. first product is MacNews, a port of NeWS for A/UX on the Macintosh-II.
  50. Psterm is our second "product", though it is offered freely to the public
  51. to make NeWS more usable on all systems, and to advertise our company.
  52. You can reach us at:
  53.  
  54.     Grasshopper Group
  55.     212 Clayton St.
  56.     San Francisco, CA  94117
  57.  
  58. +1 408 978 7616      orders, business questions, 830-5 Pacific     orders@toad.com
  59. +1 415 668 5998      technical questions,          afternoons Pacific   tech@toad.com
  60.  
  61. The Grasshopper Group modifications to psterm are by Eric Messick, from
  62. designs by ||ugh Daniel & Eric Messick.  Please send questions,
  63. comments, bugs, fixes, etc... to tech@toad.com.
  64.  
  65.  
  66.             Installation
  67.  
  68. Unpack the four shar files in an empty directory.
  69.  
  70. The installation has been tested on SunOS 4.0 on Sparc and 68020, and
  71. on A/UX on the Macintosh-II.  It should be fairly easy to port it
  72. to other Unix systems.  If you do such a port, please send back the
  73. changes required, as complete source files or "context diffs", to
  74. the Grasshopper Group at tech@toad.com.  We will integrate your fixes and
  75. post patches as required.
  76.  
  77. Some of the source files include <ref/config.h>.  The directory "ref"
  78. is included, with sample config.h files.  Most of the effort of porting
  79. psterm to another system, is in modifying one of these config files to
  80. match the local programming environment.  Create a symlink to the
  81. appropriate one as follows, replacing XXX with "sunos" or "aux".  If
  82. your system doesn't have symbolic links, just link it or copy it
  83. instead.
  84.  
  85.     cd ref
  86.     ln -s config_XXX config.h
  87.     cd ..
  88.  
  89. Now you should be ready to:
  90.  
  91.     make
  92.  
  93. to create the binary program "psterm".  Then:
  94.  
  95.     make install
  96.  
  97. to install the psterm binary in /usr/NeWS/bin/psterm, the PostScript
  98. code in /usr/NeWS/lib/psterm.ps, and the man page in /usr/man/manl/psterm.l.
  99. Edit the Makefile if this is inappropriate on your system.
  100.  
  101. A tutorial called UsingPSTerm is also included.
  102.  
  103. You should also install a new terminal type in /etc/termcap which
  104. was designed specifically for psterm.  You will have to do this step,
  105. and the next (terminfo) step if required, as root:
  106.  
  107.     mv /etc/termcap /etc/termcap.orig
  108.     cat psterm.tcap /etc/termcap.orig > /etc/termcap
  109.  
  110. If your system uses terminfo, you'll have to update your terminfo database as
  111. well...  so, as root:
  112.  
  113.     tic psterm.tinfo
  114.  
  115. Tic is in /usr/5bin if you have installed "System V Compatability"
  116. under SunOS.  Remember to update the terminal descriptions on all of
  117. the systems in your network, and to compile the psterm binary for all
  118. machines, even if there is no news_server (or screen!) on machines like
  119. Vaxen or Amdahls.
  120.  
  121. Note: the termcap and terminfo updates also include nterm descriptions.
  122.  
  123. That should be it... have fun.
  124.  
  125. If you find bugs, first read the BUGS file in this release.  Then, if
  126. your bug is news to us (or if you have a fix for it), send email to
  127. "tech@toad.com" describing which psterm you have (including the patch
  128. level from patchlevel.h), how to reproduce the bug, what happens when
  129. you reproduce it, and how to fix it if you know.
  130.  
  131.  
  132.             Table Of Contents
  133.  
  134.   This set of shar files contains the following files:
  135.  
  136. BUGS        Text file containing known bug descriptions
  137. Makefile    Makefile
  138. README        This file
  139. UsingPSTerm    Ascii text tutorial
  140. bsd.c        bsd operating system interface
  141. display.c    screen maintainence
  142. io.c        low level input/output
  143. main.c        argument processing, main()
  144. patchlevel.h    revision level
  145. psterm.1    man page
  146. psterm.ps    PostScript code
  147. psterm.tcap    termcap entries
  148. psterm.tinfo    terminfo entries
  149. ref/config_aux    A/UX specific configuration information
  150. ref/config_sunos    SunOS configuration information
  151. sampl.pstermrc    example .pstermrc file
  152. sampl.user.ps    example user.ps file
  153. screen.h    description of screen data structures
  154. selection.c    text selection handling routines
  155. slave.c        process forking routines
  156. sys5.c        System V operating system interface
  157. tcap.cps    C to PostScript interface routines
  158. tcap_ops.c    termcap screen manipulation functions
  159. tcap_parse.c    termcap escape sequence parsing code
  160. termcap.h    description of termcap data structures
  161.  
  162.  
  163.  
  164.             Notes
  165.  
  166. NeWS has urgently needed a good terminal emulator for some time.  We at
  167. the Grasshopper Group hope that this version of psterm can fill that
  168. gap for a while.  There are, however, several fundamental problems with
  169. psterm which limit its potential usefulness.  Many of the problems with
  170. the original version of psterm have been dealt with, but the program
  171. has been stretched far beyond the original concept, and is approching
  172. the limits of its design.
  173.  
  174. There is a fundamental conceptual problem with the idea of emulating a
  175. terminal by reading its termcap entry.  The termcap entry describes how
  176. to get a terminal to perform a certain set of tasks.  It does NOT
  177. describe how the given terminal will respond to a sequence of
  178. characters.  This is the information needed by a terminal emulator.  As
  179. an example, consider the vt100 termcap entry.  Clearing the screen on a
  180. vt100 does not home the cursor.  Unfortunately, the termcap string for
  181. screen clearing (cs) is defined to both clear the screen and home the
  182. cursor.  To cope with this, the termcap entry for clearing the screen
  183. on a vt100 emits two escape sequences:  one for homing the cursor, and
  184. one for clearing the screen.  BUT THERE IS NO WAY FOR PSTERM TO KNOW
  185. THIS!  Psterm thinks that in order to clear the screen, this double
  186. sequence must be recieved, and WILL NOT RECOGNIZE JUST THE CLEAR SCREEN
  187. SEQUENCE.  There is a similar problem with the h19 entry.  Codes which
  188. are transmitted by the ``enter screen mode'' string are not defined
  189. elsewhere in the termcap entry, so there is NO WAY for psterm to know
  190. what to do with these.
  191.  
  192. A more serious (though much more subtle) problem concerns the design of
  193. the program itself.  It is not a good example of how to divide the
  194. labor between the client side and the server side.  This is important
  195. because we desperately need good examples of this poorly understood
  196. aspect of NeWS programming.  The power and flexibility of a fully
  197. programmable graphics server depend on programmers correctly dividing
  198. tasks between client and server.  Psterm relies too heavily on the
  199. client program for repainting the screen and repairing damage.  On the
  200. other hand, the other common NeWS terminal emulator, Nterm, does too
  201. much of its terminal emulation in PostScript, and its performance
  202. suffers as a result.  The correct division point lies somewhere between
  203. these two attempts.  As a result of the incorrect division of labor of
  204. psterm, the addition of scrollbars was a difficult and painful task.
  205. If the division had been made at the proper point, I am confident that
  206. implementing scrollbars would have been painless and quick.
  207.  
  208.  
  209.             Sun's copyright notice
  210.  
  211. The original copyright notice on Sun's NeWS 1.1 client program sources
  212. required that it be distributed "as part of a product or program
  213. developed by the user."  This prohibited a variety of noncommercial
  214. distributions, like Usenet postings, source archives like uunet's, or
  215. tape collections like Usenix's or Sun User Group's.  Sun graciously
  216. modified their copyright and authorized us to replace the previous
  217. notice with their new notice, which will be in their next NeWS release.
  218. The whole thing is below (the relevant line is the fourth):
  219.  
  220. /*
  221.  * This file is a product of Sun Microsystems, Inc. and is provided for
  222.  * unrestricted use provided that this legend is included on all tape
  223.  * media and as a part of the software program in whole or part.
  224.  * Users may copy, modify or distribute this file at will.
  225.  * 
  226.  * THIS FILE IS PROVIDED AS IS WITH NO WARRANTIES OF ANY KIND INCLUDING THE
  227.  * WARRANTIES OF DESIGN, MERCHANTIBILITY AND FITNESS FOR A PARTICULAR
  228.  * PURPOSE, OR ARISING FROM A COURSE OF DEALING, USAGE OR TRADE PRACTICE.
  229.  * 
  230.  * This file is provided with no support and without any obligation on the
  231.  * part of Sun Microsystems, Inc. to assist in its use, correction,
  232.  * modification or enhancement.
  233.  * 
  234.  * SUN MICROSYSTEMS, INC. SHALL HAVE NO LIABILITY WITH RESPECT TO THE
  235.  * INFRINGEMENT OF COPYRIGHTS, TRADE SECRETS OR ANY PATENTS BY THIS FILE
  236.  * OR ANY PART THEREOF.
  237.  * 
  238.  * In no event will Sun Microsystems, Inc. be liable for any lost revenue
  239.  * or profits or other special, indirect and consequential damages, even
  240.  * if Sun has been advised of the possibility of such damages.
  241.  * 
  242.  * Sun Microsystems, Inc.
  243.  * 2550 Garcia Avenue
  244.  * Mountain View, California  94043
  245.  */
  246.  
  247. @(#)$Header: README,v 2.4 88/10/04 19:17:18 eric Release $
  248. @@@ Fin de README
  249. echo BUGS
  250. cat >BUGS <<'@@@ Fin de BUGS'
  251. #        Psterm Bug List
  252. # @(#)$Header: BUGS,v 1.3 88/10/03 18:57:58 gnu Release $
  253.  
  254. PSTerm was an experiment in general purpose terminal emulators.  It
  255. was a very interesting experiment, and taught us how to do a few
  256. things.  I feel that it has taught us how NOT to do many more things
  257. in the NeWS environment, and that is has served as a good lesson.
  258.  
  259. We have made PSTerm useful; it serves as a working
  260. "emulator" of the psterm termcap.  Further work on psterm seems
  261. pointless, as more would be gained from a completely new terminal
  262. program.
  263.  
  264. If you wish to hack on it, be warned that we have pushed it
  265. beyond its design already, and that it may be hard going.  We
  266. will not be putting more effort into it except to fold in bug fixes
  267. that are sent in to us (to "tech@toad.com").
  268.  
  269. Thanks to David Rosenthal for creating the original psterm;
  270. it was a wondrous idea.
  271.  
  272.    ---
  273.  
  274. Window placement is in pixel units.  This would perhaps best be fixed by a
  275. parser for units on the command line, though currently NeWS does not
  276. know the dimensions of its screen in inches or dots per inch.  A
  277. related problem is that although units are specified in points, the
  278. resulting measurements are actually pixels.
  279.  
  280. Termcaps cannot describe how to emulate a terminal adequately.  The
  281. information in the termcap or terminfo files is not explicit enough to
  282. let psterm emulate most terminals.  Many termcap entries are written in
  283. ways that depend on the inner workings of a terminal in such a way that
  284. just looking at the termcap will not allow psterm to deal with a
  285. program that knows more or different things about the emulated
  286. terminal.  An example is given in the README file.  Terminfo is
  287. somewhat better, but psterm does not use it.  A proper job would
  288. require more information than provided by both termcap and terminfo.
  289.  
  290. Display slowness.  Sometimes when displaying a full screen of text,
  291. psterm will display it in several chunks, with visible pauses between.
  292. This may have to do with the default psio buffer size of 1K.
  293.  
  294. Some problems are in the fact that NeWS is young:  on some servers, the
  295. icon text gets cleared as soon as it is drawn because of a math 'off by
  296. one' bug (edge condition) that is different for each machine.  See
  297. psterm.ps for new twiddle values to take care of this.
  298.  
  299. Sound (Control G, Beep) is not supported.
  300.  
  301. Sometimes the input focus hilight is on but typing is ignored;
  302. this is a LiteWindows (LiteUI) bug.
  303.  
  304. Fixed width fonts don't scale much of the time because there is
  305. no font matrix information (fontname.fm files) for them.
  306.  
  307. There is a 64k limit to strings in NeWS 1.1, but due to typecheck bugs,
  308. psterm.ps limits selections to 32k.
  309.  
  310. Some problems are just hard work, but it is not clear that psterm is
  311. worth the extra effort to fix.
  312.  
  313. See the README file for more discussion of problems with the psterm concept.
  314. @@@ Fin de BUGS
  315. echo patchlevel.h
  316. cat >patchlevel.h <<'@@@ Fin de patchlevel.h'
  317. #define PATCHLEVEL 0
  318. @@@ Fin de patchlevel.h
  319. echo Makefile
  320. cat >Makefile <<'@@@ Fin de Makefile'
  321. #
  322. # This file is a product of Sun Microsystems, Inc. and is provided for
  323. # unrestricted use provided that this legend is included on all tape
  324. # media and as a part of the software program in whole or part.
  325. # Users may copy, modify or distribute this file at will.
  326. # 
  327. # THIS FILE IS PROVIDED AS IS WITH NO WARRANTIES OF ANY KIND INCLUDING THE
  328. # WARRANTIES OF DESIGN, MERCHANTIBILITY AND FITNESS FOR A PARTICULAR
  329. # PURPOSE, OR ARISING FROM A COURSE OF DEALING, USAGE OR TRADE PRACTICE.
  330. # 
  331. # This file is provided with no support and without any obligation on the
  332. # part of Sun Microsystems, Inc. to assist in its use, correction,
  333. # modification or enhancement.
  334. # 
  335. # SUN MICROSYSTEMS, INC. SHALL HAVE NO LIABILITY WITH RESPECT TO THE
  336. # INFRINGEMENT OF COPYRIGHTS, TRADE SECRETS OR ANY PATENTS BY THIS FILE
  337. # OR ANY PART THEREOF.
  338. # 
  339. # In no event will Sun Microsystems, Inc. be liable for any lost revenue
  340. # or profits or other special, indirect and consequential damages, even
  341. # if Sun has been advised of the possibility of such damages.
  342. # 
  343. # Sun Microsystems, Inc.
  344. # 2550 Garcia Avenue
  345. # Mountain View, California  94043
  346. #
  347. #
  348. # @(#)Makefile.psterm 9.9 88/01/19
  349. # @(#)$Header: Makefile,v 2.4 88/10/04 19:17:36 eric Release $
  350. #
  351. # Copyright (c) 1987 by Sun Microsystems, Inc.
  352. #
  353. # Modifications to the original Sun Microsystems, Inc. source code
  354. # made by the Grasshopper Group are in the Public Domain.
  355. #
  356. # Extensions to this file by Eric Messick of the Grasshopper Group.
  357. #
  358. # Grasshopper Group
  359. # 212 Clayton St
  360. # San Francisco, CA 94117
  361. #
  362.  
  363. SHELL=/bin/sh
  364.  
  365. # Global macro definitions
  366. NEWSHOME=/usr/NeWS
  367. INSDIR=${NEWSHOME}
  368. BINDIR=${INSDIR}/bin
  369. INCLUDE=${INSDIR}/include
  370. LIBDIR=${INSDIR}/lib
  371. MANDIR=/usr/man/manl
  372. MANEXT=l
  373.  
  374. # --- Global macro definitions ---
  375. OPT=-O
  376. TARGET_ARCH=
  377. OSI=REF
  378. SYSV_NETWORK=
  379. BYTES=
  380. TERMFLAG=
  381. SYSV_NETLIB=
  382. TERMLIB=-ltermcap
  383. PREPROC=-I. -I${INCLUDE} -D${OSI} -DUTMP ${TERMFLAG} ${SYSV_NETWORK}
  384.  
  385. COPTS= ${BYTES}
  386. CPS= ${BINDIR}/cps
  387. LIBCPS= ${LIBDIR}/libcps.a
  388.  
  389. CFLAGS=${OPT} ${COPTS} ${PREPROC}
  390.  
  391. # Too many lints -- pick your own lint flags.
  392. #LINT=/usr/5bin/lint
  393. LOPTS=-abch
  394. #LOPTS=
  395. LINTOPTS=${LOPTS} ${PREPROC}
  396.  
  397. LIBS=${TERMLIB} ${LIBCPS} ${SYSV_NETLIB}
  398.  
  399. # When adding files, also modify 'make shar' below.
  400. SRCS =     display.c \
  401.     selection.c \
  402.     io.c \
  403.     main.c \
  404.     slave.c \
  405.     tcap_ops.c \
  406.     tcap_parse.c \
  407.     bsd.c \
  408.     sys5.c
  409.  
  410. OBJS =     display.o \
  411.     selection.o \
  412.     io.o \
  413.     main.o \
  414.     slave.o \
  415.     tcap_ops.o \
  416.     tcap_parse.o \
  417.     bsd.o \
  418.     sys5.o
  419.  
  420. HDRS =     screen.h \
  421.     tcap.h \
  422.     termcap.h
  423.  
  424. SHAR1 =    README \
  425.     BUGS \
  426.     patchlevel.h \
  427.     Makefile \
  428.     psterm.1 \
  429.     UsingPSTerm \
  430.     bsd.c \
  431.     screen.h
  432. SHAR2 =    sampl.pstermrc \
  433.     sampl.user.ps \
  434.     psterm.tcap \
  435.     psterm.tinfo \
  436.     slave.c \
  437.     io.c \
  438.     main.c \
  439.     display.c
  440. SHAR3 =    ref/config_aux \
  441.     ref/config_sunos \
  442.     psterm.ps \
  443.     selection.c \
  444.     sys5.c
  445. SHAR4 = tcap.cps \
  446.     tcap_ops.c \
  447.     tcap_parse.c \
  448.     termcap.h
  449.  
  450. all:    psterm
  451.  
  452. lint:    tcap.h
  453.     ${LINT} ${LINTOPTS} ${SRCS} | grep -v _CPS
  454.  
  455. psterm:    ${OBJS}
  456.     ${CC} ${CFLAGS} -o psterm ${OBJS} ${LIBS}
  457.  
  458. tcap.h: tcap.cps
  459.  
  460. install: psterm psterm.ps
  461.     rm -f ${BINDIR}/psterm ${LIBDIR}/psterm.ps
  462.     cp psterm ${BINDIR}
  463.     cp psterm.ps ${LIBDIR}/psterm.ps
  464.     cp psterm.1 ${MANDIR}/psterm.${MANEXT}
  465.  
  466. clean:
  467.     rm -f *.o psterm tcap tcap.h *.BAK *~
  468.  
  469. shar:
  470.     echo ": psterm part 1 of 4" > psterm.shar.1
  471.     shar ${SHAR1}    >> psterm.shar.1
  472.     echo ": psterm part 2 of 4" > psterm.shar.2
  473.     shar ${SHAR2}    >> psterm.shar.2
  474.     echo ": psterm part 3 of 4" > psterm.shar.3
  475.     echo "echo ref"  >> psterm.shar.3
  476.     echo "mkdir ref" >> psterm.shar.3
  477.     shar ${SHAR3}    >> psterm.shar.3
  478.     echo ": psterm part 4 of 4" > psterm.shar.4
  479.     shar ${SHAR4}    >> psterm.shar.4
  480.  
  481. depend: ${HDRS} ${SRCS}
  482.     ${INSDIR}/clientsrc/makedepend ". -I${INCLUDE}"
  483.  
  484. .SUFFIXES: .h .cps
  485. .cps.h:
  486.     ${CPS} $*.cps
  487.  
  488. # START OF AUTOMATICALLY GENERATED DEPENDENCIES 
  489. bsd.o: bsd.c
  490. display.o: display.c screen.h tcap.h
  491. io.o: io.c
  492. main.o: main.c
  493. selection.o: screen.h selection.c tcap.h
  494. slave.o: slave.c
  495. sys5.o: sys5.c
  496. tcap_ops.o: screen.h tcap.h tcap_ops.c termcap.h
  497. tcap_parse.o: tcap_parse.c termcap.h
  498. @@@ Fin de Makefile
  499. echo psterm.1
  500. cat >psterm.1 <<'@@@ Fin de psterm.1'
  501. .\" @(#)psterm.1 9.2 88/01/19 Copyright 1987 Sun Micro
  502. .\" @(#)$Header: psterm.1,v 2.3 88/10/04 05:59:48 gnu Release $
  503. .TH PSTERM 1  "28 July 1988"
  504. .SH NAME
  505. psterm \(em NeWS terminal emulator
  506. .SH SYNOPSIS
  507. .B psterm
  508. [
  509. options
  510. ]
  511. [
  512. command
  513. ]
  514. .IX psterm#(1) "" "\fLpsterm\fP(1) \(em NeWS terminal emulator"
  515. .SH DESCRIPTION
  516. .I psterm
  517. is a
  518. .IR termcap -based
  519. terminal emulator program for NeWS.  When invoked,  it reads the
  520. .I /etc/termcap
  521. entry for the terminal named
  522. .I psterm
  523. or the termcap named by the
  524. .B -t
  525. option, and arranges to emulate the behavior of that
  526. terminal.  It forks an instance of
  527. .I command
  528. (or, by default,  the program specified by the
  529. .B SHELL
  530. environment variable, or
  531. .I csh 
  532. if this is undefined),
  533. routing keyboard input to the program and displaying its output.
  534. .LP
  535. It responds to (most of) the particular escape sequences that
  536. .I termcap
  537. defines for that terminal.
  538. .SH OPTIONS
  539. .TP
  540. .B \-bg
  541. causes
  542. .I psterm
  543. to place itself in the background by
  544. disassociating itself from the parent process and the controlling terminal.
  545. If
  546. .I psterm
  547. is invoked with
  548. .IR rsh (1),
  549. this option will cause the
  550. rsh command to complete immediately, rather than hang around until
  551. .I psterm
  552. exits.
  553. This is the default if
  554. .I psterm
  555. is invoked with
  556. .I stdin
  557. not connected to a
  558. .I tty.
  559. .TP
  560. .B \-C
  561. route
  562. .I /dev/console
  563. messages to this window, if supported by the operating system.
  564. .TP
  565. .B \-co "\fIcolumns\fP
  566. specifies the width of the window in characters.
  567. .TP
  568. .B \-F font
  569. overrides the default terminal font.
  570. .TP
  571. .B \-f
  572. Ignored.  For compatibility with older versions.
  573. .TP
  574. .B \-fg
  575. forces 
  576. .I psterm
  577. not to fork, thus leaving you in the forground.
  578. .TP
  579. .B \-fl "\fIframe label\fP"
  580. Use the specified string for the frame label.
  581. .TP
  582. .B \-fs fontsize
  583. overrides the default terminal font point size.
  584. .TP
  585. .B \-ic
  586. forces 
  587. .I psterm
  588. to come up iconic instead of as an open window.
  589. .TP
  590. .B \-il "\fIicon label\fP"
  591. Use the specified string for the icon label.  The icon label normally defaults
  592. to the name of the host on which
  593. .I psterm
  594. is running.
  595. .TP
  596. .B \-ixy x y
  597. sets the initial icon location.
  598. Similar to 
  599. .B \-xy x y.
  600. .TP
  601. .B \-li "\fIlines\fP"
  602. specifies the height of the window in characters.
  603. .TP
  604. .B \-ls
  605. causes
  606. .I psterm
  607. to invoke the shell as a login shell.  In addition, any
  608. specified
  609. .I command
  610. will be passed to the shell with a
  611. .B \-c
  612. option,
  613. rather than being invoked directly, so that the shell can establish any
  614. environment variables that may be needed by the command.  Further, if
  615. .I psterm
  616. is invoked via
  617. .IR rsh (1),
  618. the host at the other end of the
  619. .I rsh
  620. socket will be used as the server, unless a NEWSSERVER
  621. environment variable is present.
  622. .TP
  623. .B \-pm
  624. specifies that a 
  625. .I psterm
  626. should enable 
  627. .IR "page mode" .
  628. When page mode is enabled and a command produces
  629. more lines of output that can fit on the screen at once,
  630. .I psterm
  631. will stop scrolling, hide the cursor, and wait until the
  632. user types a character before resuming output.  
  633. When 
  634. .I psterm
  635. is blocked with a screenfull of data,
  636. typing a carriage return or space will cause
  637. scrolling to proceed by one line or one screenful, respectively; any other
  638. character will cause the next screenfull
  639. to appear and be passed through as normal
  640. input.  
  641. This mode can also be enabled or disabled interactively, using the
  642. .I "Page Mode"
  643. menu item.
  644. .TP
  645. .B \-r
  646. forces 
  647. .I psterm
  648. to reload the 
  649. .I psterm.rc
  650. file and the
  651. .I .pstermrc
  652. file.
  653. Normally, 
  654. .I psterm
  655. checks and if the dictionary
  656. .B PSTermDict
  657. exists in 
  658. .B systemdict,
  659. it does not bother reloading the
  660. .I PostScript
  661. files.
  662. .TP
  663. .B \-sl savelines
  664. specify the length of the scroll region.
  665. Defaults to 0, which turns scrollbars off.
  666. .TP
  667. .B \-t term
  668. specify a particular terminal type to override the
  669. .B TERM
  670. environment variable.
  671. Some types work well, others do not.
  672. The terminal type ``psterm'' was designed specifically for use with
  673. .I psterm,
  674. and works quite well.
  675. .TP
  676. .B \-ui userinit
  677. .I psterm
  678. will execute 
  679. .I userinit
  680. as a
  681. .I PostScript
  682. function before creating the terminal window.
  683. This allows the overriding of terminal characteristics on an
  684. individual window basis.
  685. The only function currently defined for this purpose is
  686. .I \-ui StretchOpen
  687. which requests a sizing box on window creation instead of a fixed size window.
  688. See the example
  689. .I \.pstermrc
  690. file for more code that can be called from here.
  691. .TP
  692. .B \-w
  693. wait around after the
  694. .I command
  695. terminates.
  696. .TP
  697. .B \-xy "\fIx y\fP"
  698. specifies the location of the lower left hand corner of the
  699. window (in screen pixel coordinates).
  700.  
  701. .SH "SELECTION"
  702. .LP
  703. Clicking the left mouse button over a character selects that character.
  704. Dragging the mouse extends the selection.
  705. Clicking or dragging beyond the end of the line
  706. selects the newline at the end of that line.
  707. Clicking the middle mouse button over a character
  708. when a selection does not exist in that window
  709. selects that character.
  710. Clicking the middle mouse button over a character
  711. when a selection does exist in that window
  712. extends or shrinks the selection to that character.
  713. Dragging the mouse still extends the selection.
  714. .LP
  715. Clicking and dragging with a shift key down selects a
  716. .I rectangle
  717. of text, padded with spaces if necessary.
  718. .LP
  719. The Copy key (L6) copies the 
  720. selection to the
  721. .IR shelf .
  722. The Paste key (L8) copies the contents of the
  723. .I shelf
  724. to the
  725. .I "insertion point".
  726. .LP
  727. Copy and Paste of selections
  728. works across separate invocations of
  729. .I psterm.
  730. They do not work between
  731. .I psterm
  732. and SunView.
  733. However, a mechanism does exist for transferring a SunView
  734. selection to the \*(Sd shelf, and vice versa. See the description
  735. of 
  736. .I Selection Transfer
  737. in 
  738. .IR news_server (1).
  739. .SH "MENU ITEMS"
  740. .I psterm
  741. creates a client menu with entries to
  742. .I stuff
  743. the current selection to the insertion point,
  744. get at the normal
  745. .I frame
  746. menu, and get at a
  747. .I config
  748. menu for changing some parameters of a running 
  749. .I psterm.
  750. Under the
  751. .I config
  752. menu, are other sub-menus changing various parameters.
  753. .LP
  754. Config... Lines x Cols...  This menu sets the terminal size to the
  755. indicated number of lines and columns.  By default, this will change
  756. the window size to fit.
  757. .LP
  758. Config... Points...  This menu sets the font point size.  By default,
  759. this will change the window size to fit.
  760. .LP
  761. Config... Fonts...  This menu sets the terminal font to one of the
  762. standard fixed width fonts.  This is likely to change the size of the
  763. characters, and behaves as thought the font size had been changed.
  764. Note that /Screen font (the default) only scales to a few
  765. predetermined sizes.  Selecting a new point size is likely to have no
  766. effect until a fully scalable font is selected.  Several other fonts
  767. exibit this behavior.  See More Fonts!... below.
  768. .LP
  769. Config... More Fonts!...  This menu lists all fonts known to the
  770. system at the time the psterm was started.  Note that some of these
  771. are likely to be silly.  The width of the letter ``m'' in the font is
  772. used to determine the spacing between characters.  Some fonts have no
  773. ``m'' character.  See Config... Toggles... Var Width Fonts below.
  774. .LP
  775. Config... Resizing stuff...  This menu is strange.  Under it are three
  776. pairs of toggles.  These toggles control the behavior of psterm when
  777. one of three parameters is changed.  Basically, there are three
  778. parameters used to determine the way the terminal is displayed, and
  779. they are all interdependant.  The three parameters are Font Size,
  780. Lines/Cols, and Window Size.  Fixing values for any two of these
  781. determines the third value.  When you change one of these parameters,
  782. psterm consults this menu to determine which of the other two
  783. parameters should stay the same, and which should change.  The
  784. parameter with the ``*'' next to it will be the one which changes.
  785. Select the menu entry for the unstarred parameter to cause it to
  786. become the new starred parameter.  Remember that you choose among
  787. three independant pairs of values.  Now, go play.
  788. .LP
  789. Config... Save Lines...  This menu selects the number of lines saved.
  790. If you select a value other than zero, a scrollbar will appear
  791. allowing you to scroll through the saved region.  Selecting zero will
  792. remove the scrollbar.  Saving a large number of lines takes a lot of
  793. memory, and possibly several seconds to set up.
  794. .LP
  795. Config... Toggles...  This menu controls the on/off state of several
  796. items.  Select the item to toggle it.  If there is an ``*'' next to an
  797. item, it is on now, and selecting it will turn it off.  The first item
  798. is Page Mode.  See the -pm option above.  The second item is Auto
  799. Margins.  The initial state of this item is determined from the
  800. termcap entry for the terminal being emulated.  If Auto Margins is on,
  801. when the terminal's cursor is in the rightmost column and another
  802. character needs to be displayed, a newline will automatically be
  803. inserted.  If Auto Margins is off, the cursor will ``stick'' to the
  804. right of the window.  The third item is Var Width Fonts, and defaults
  805. to on.  This item is only of importance if the current font is not a
  806. fixed width font.  Basically, if it is off, all fonts are forced to be
  807. fixed width.  With Var Width Fonts on, normal output will be more
  808. readable under a variable width font, like /Times-Roman, but columns
  809. of text will not line up properly, and cursor motion and selection of
  810. text can produce wierd effects.  This should be fun to play with.
  811. The fourth item is Fast Repaint, defaulting to on.  If you turn it off,
  812. then every repaint will be seen, even if another is already in progress.
  813. The fifth item is Scrolling Allowed, defaulting to on.  This is here
  814. in case your server can repaint faster than it can do a copyarea.
  815. On a Silicon Graphics, you might want to turn this off by default.
  816. Just set DefaultUseCopyArea to false in your .pstermrc file.
  817. .LP
  818. Config... Set Labels...  This menu allows you to set the value of the
  819. frame label, the icon label, or both.  Label values are set to the contents
  820. of the current selection.  You can also set the frame label to a string
  821. indicating what version of psterm you are running.
  822. .SH FILES
  823. .PD 0
  824. .TP 1.5i
  825. .I /etc/termcap
  826. to find the terminal description.
  827. .TP
  828. .IB /usr/NeWS/lib/psterm.ps
  829. containing most of the PostScript code.
  830. .TP
  831. .IB ~/.pstermrc
  832. to customize the terminal on startup.
  833. .PD
  834. .SH "SEE ALSO"
  835. .IR news_server (1)
  836. .LP
  837. .I "NeWS Manual"
  838. .SH BUGS
  839. .LP
  840. A bug in liteUI causes keyboard events to be distributed to the wrong
  841. place.
  842. This may cause characters that you type to not go to the terminal that
  843. your mouse pointer is inside of.  To redirect the keyboard properly,
  844. move the mouse out of the window, and back in.
  845. This is often necessary when initially starting
  846. .I psterm.
  847. .LP
  848. Another obscure bug in liteUI can cause NeWS to think that your shift
  849. key is permanently stuck down.  It is triggered by holding the shift
  850. key down, and clicking on the mouse while dragging it across canvas
  851. boundries as you might while making rectangular selections.
  852. If this happens, you will have to exit NeWS to reset it.
  853. As an emergency measure, it is suggested that you have an alias
  854. in your .cshrc file to set the
  855. .I lcase
  856. tty parameter.
  857. .LP
  858. alias STTY stty lcase
  859. .LP
  860. will work for this.
  861. .LP
  862. Emulating some terminal types works better than others, largely because
  863. there are incomplete
  864. .I /etc/termcap
  865. entries for them.
  866. .LP
  867. A large number of
  868. .I termcap
  869. fields have yet to be implemented.
  870. .LP
  871. .I "Page Mode"
  872. gets easily confused.
  873. .LP
  874. See the BUGS and README files distributed with the source.
  875.  
  876. @@@ Fin de psterm.1
  877. echo UsingPSTerm
  878. cat >UsingPSTerm <<'@@@ Fin de UsingPSTerm'
  879.  
  880.  
  881.                 UsingPSTerm
  882.  
  883.         A user guide for the new psterm program
  884.  
  885.                 by Eric Messick
  886.  
  887.  @(#)$Header: UsingPSTerm,v 2.1 88/10/03 18:17:14 eric Release $
  888.  
  889.     Starting psterm.
  890.  
  891. If you're using psterm, chances are quite good that you are in NeWS.
  892. This probably means that the directory /usr/NeWS/bin has found its way
  893. into your $PATH.  If not, it's time it migrated in there, because
  894. that's the directory where you'll find the psterm binary.  Just
  895. starting psterm from the shell (your command interpreter) will get you
  896. a reasonable set of default starting conditions.  With no command line
  897. options, the following things will happen:
  898.  
  899.     psterm will look at various portions of your environment and
  900. will question your tty driver and build up a picture of what your
  901. current terminal type is and how big it is.
  902.  
  903.     psterm will then try to talk to your news_server.  Hopefully,
  904. it will succeed.
  905.  
  906.     psterm next opens a window on your screen.  This window will
  907. have its lower left corner in the lower left corner of your screen.
  908. Text in the window will be presented in 12 point /Screen font by
  909. default.  The window will be sized so that precisely the proper number
  910. of rows and columns of text appear inside the window borders.
  911.  
  912.     A shell is then started, and the shell's prompt should appear
  913. in the terminal window.
  914.  
  915.     Moving the NeWS cursor into the terminal window will allow you
  916. to type to the shell.
  917.  
  918.     Typing the ``exit'' command into the window's shell will cause
  919. the window to go away.
  920.  
  921.  
  922. Now, let's take a look at the command line options that are available
  923. to change the behavior of psterm.  If you enter an illegal option on
  924. the command line, psterm will print a usage line that looks something
  925. like this:
  926.  
  927. Usage: psterm [-bg] [-C] [-co columns] [-F font] [-f] [-fg] [-fl framelabel] \
  928.         [-fs fontsize] [-ic] [-il iconlabel] [-ixy x y] [-li lines] \
  929.         [-ls] [-pm] [-r] [-sl savelines] [-t termtype] [-ui userinit] [-w] \
  930.         [-xy x y] [command]
  931.  
  932. As you can see, psterm has quite a few options.  Let's take a closer
  933. look at them.
  934.  
  935. -bg    Forces psterm to fork, even when not connected to a tty.
  936.         Normally, psterm will not bother to fork unless
  937.         connected to a tty.
  938.  
  939. -C    Redirects the console output to the psterm window.  Note:
  940.         this does not work under A/UX.
  941.  
  942. -co columns
  943.     Overrides the termcap entry and tty driver for deciding how
  944.         many columns the emulated terminal has.
  945.  
  946. -F font    Overrides the default terminal font.
  947.  
  948. -f    Ignored.  For compatability with older versions.
  949.  
  950. -fg    Forces psterm not to fork, thus leaving you in the forground.
  951.         Normally, psterm will fork if its stdin is connected
  952.         to a tty, and not bother otherwise.
  953.  
  954. -fl framelabel
  955.     Sets the frame label.  Default is either the host name if -ls
  956.         is specified, or a string indicating the terminal
  957.         type.
  958.  
  959. -fs fontsize
  960.     Overrides the default terminal font point size.
  961.  
  962. -ic    Forces psterm to come up iconic instead of as an open window.
  963.  
  964. -il iconlabel
  965.     Sets the icon label.  Default is the host name.
  966.  
  967. -ixy x y
  968.     Sets the position of the icon.  Similar to -xy x y.
  969.  
  970. -li lines
  971.     Similar to -co.
  972.  
  973. -ls    Creates a login shell instead of a normal shell.  Sets a few
  974.         environment variables and executes your .login file.
  975.  
  976. -pm    Turns on page mode.  Causes psterm to stop output when a full
  977.         page has been displayed since the last input.  Space
  978.         and return are munched when output is stopped and any
  979.         character continues output.
  980.  
  981. -r    Forces psterm to reload the psterm.ps file and the .pstermrc
  982.         file.  Normally, psterm checks and if the dictionary
  983.         PSTermDict exists in systemdict, it does not bother
  984.         reloading the PostScript files.  If you make a change
  985.         in psterm.ps or your .pstermrc, you will probably have
  986.         to use this option to get your changes to be loaded.
  987.  
  988. -sl savelines
  989.     Specifies the number of lines to save in memory.  If this is
  990.         non-zero, a scrollbar will appear, allowing you to
  991.         scroll through the saved lines.
  992.  
  993. -t termtype
  994.     Overrides the environment variable $TERM in specifying what
  995.         kind of terminal psterm will emulate.  psterm looks in
  996.         the file /etc/termcap to find a description of the
  997.         terminal that it is trying to emulate, and does that
  998.         the best that it can.  Some types work well, others do
  999.         not.  The terminal type ``psterm'' was designed
  1000.         specifically for use with psterm, and works perfectly.
  1001.  
  1002. -ui userinit
  1003.     psterm will execute userinit as a PostScript function before
  1004.         creating the terminal window.  This allows the
  1005.         overriding of terminal characteristics on an
  1006.         individual window basis.  The only function currently
  1007.         defined for this purpose is -ui StretchOpen which
  1008.         requests a sizing box on window creation instead of a
  1009.         fixed size window.  See the example .pstermrc file for
  1010.         more code that can be called from here.
  1011.  
  1012. -w    wait around after the shell exits before deleting the window.
  1013.  
  1014. -xy x y    Sets the lower left corner of the window position.
  1015.  
  1016.  
  1017. Following the other command line options, you can specify a command
  1018. and arguments to be executed in lieu of your shell.
  1019.  
  1020.  
  1021.  
  1022.  
  1023.     Starting psterm from a Menu
  1024.  
  1025. The default root menu has entries for starting a psterm.  These just
  1026. consist of a string of options on a command line that is sent to the
  1027. forkunix NeWS function.  NeWS forks a process to execute the psterm,
  1028. and redirects its stdin stdout and stderr, generally to /dev/null.
  1029. When psterm sees that it has been started this way, it doesn't bother
  1030. to fork itself (see -fg and -bg, above).  You can create your own menu
  1031. entries to do this in your .litewin.rc file.  See the example files.
  1032.  
  1033.  
  1034.  
  1035.     Starting a psterm on a Remote Machine
  1036.  
  1037. Ok, let's get some terms streight.  You're sitting in front of a
  1038. screen connected to a computer.  That computer is your local system.
  1039. Programs run there are run locally.  Your computer is connected to a
  1040. network that has other machines hooked up to it.  You want to run a
  1041. psterm on one of those machines.  The other machine is the remote
  1042. machine, and the psterm running on the remote machine is the remote
  1043. psterm.  Your news_server is running on your local machine.  Ok?
  1044.  
  1045. If psterm is started on a remote system, it will do it's best to find
  1046. the news_server that it was started from and connect to it.  This
  1047. gives you a transparent way to access other machines.  There are a few
  1048. things that may confuse or thwart it in its efforts for you.  You
  1049. should be aware of these if you have a computer network.  First, you
  1050. need to know that under SysV the remote execution command is called
  1051. remsh, while under other systems it is called rsh.  Next, you should
  1052. be sure that you have your .rhosts file set up correctly so that you
  1053. can start remote programs on the remote machine in the first place.
  1054. Once your local system has connected to the remote system, it needs to
  1055. be able to get to the psterm program.  Does it exist on the remote
  1056. system?  Will the path set in your .cshrc file find the right binary?
  1057. Does the remote system use a different binary format than your local
  1058. one?  If so, you may need a way to change your $PATH in a way that
  1059. depends on which remote system you are starting the psterm on.  You
  1060. also need to make certain that the terminal type that you've asked for
  1061. exists in the remote machine's /etc/termcap file (setting your
  1062. $TERMCAP variable in your .cshrc file could take care of this also).
  1063. If your local machine is running multiple news_servers, a remote
  1064. psterm may have trouble determining which one you are on.  Currently,
  1065. it picks the first one.  Once it figures out which news_server it
  1066. wants to talk to, you need to make sure that the news_server is
  1067. willing to talk back.  You have to either get the remote host into the
  1068. list of hosts that your local server will talk to, or set
  1069. /NetSecurityWanted to false in you .litewin.rc.  See the example
  1070. files.
  1071.  
  1072.  
  1073.  
  1074.     Getting Around in psterm
  1075.  
  1076. Ok, you've started your psterm.  Now what?  Well, you can type into
  1077. your shell, and get responses back out, but you knew that already.
  1078. Remember that the cursor has to be in the window that you are typing
  1079. into (unless you have set click to type).  But let's find out what
  1080. other nifty things you can do.
  1081.  
  1082. When using the mouse, what matters is where you click it.  Let's talk
  1083. about the different places that you can click on.
  1084.  
  1085. First, there's the ``frame''.  It's the border just outside of where
  1086. the window text actually goes.  It looks like the frame around a
  1087. picture.  The frame holds three things.  Most importantly, it holds
  1088. the terminal canvas, which is where the window text goes.  This area
  1089. is big and obvious -- right in the center, with a border line going
  1090. all the way around it.  Next, there's the close gadget.  It's in the
  1091. upper left hand corner of the frame, and it looks like two arrows
  1092. pointing at each other.  Finally, there's the stretch gadget.  It's in
  1093. the lower right hand corner of the frame.  If your frame borders are
  1094. very narrow, you may not be able to see the stretch gadget (it looks
  1095. like part of an arrow facing down and to the right), but it is still
  1096. there and you can still hit it with the mouse, although you will have
  1097. to be very accurate with your mouse placement.
  1098.  
  1099. Ok, so what happens when we click on these things?  Well, that depends
  1100. on what mouse button you use.  Unless you've changed them, the three
  1101. mouse buttons, called the PointButton, AdjustButton, and MenuButton,
  1102. will be set to the LeftMouseButton, MiddleMouseButton, and
  1103. RightMouseButton, respectively.  On the Mac, the LeftMouseButon means
  1104. that you have to hold down the ``option'' key when you press the mouse
  1105. button.  Likewise, the MiddleMouseButton on the Mac is generated by
  1106. holding down the ``point of interest'' key (it looks like a clover,
  1107. and is just to the right of the option key) when clicking on the
  1108. mouse.  So, on the Mac, PointButton means option, AdjustButton means
  1109. point of interest, and MenuButton means normal.  Got that?
  1110.  
  1111. The close gadget and stretch gadget have special behavior on the Mac.
  1112. You can use any of the mouse buttons on them to activate them.  On the
  1113. Sun, use the PointButton.  Clicking on the close gadget turns the
  1114. window into an icon.  The icon will be a tiny copy of the screen that
  1115. you're displaying on the full size window.  Each character in the icon
  1116. will be represented by a single pixel (actually, a 1pt by 1pt square).
  1117. You can still type into the window (if the cursor is inside the icon),
  1118. and you will be able to see the response (although reading it is
  1119. likely to be difficult).  The MenuButton will bring up the icon's
  1120. menu, which is standard.  The AdjustButton will drag the icon around
  1121. the screen, also standard. Finally, the PointButton turns the icon
  1122. back into a window, also standard.
  1123.  
  1124. Now that you're back with a window again, what does the stretch gadget
  1125. do?  Clicking down on the stretch gadget allows you to ``pick up'' the
  1126. lower right hand corner of the window and stretch it around.  When
  1127. you're done playing, and release the mouse button, the window will
  1128. resize itself to fit inside of the rectangle you specified.
  1129. Generally, this will mean changing the number of rows and columns in
  1130. the window.  Whenever this happens, psterm makes sure that your tty
  1131. driver finds out about this, so that smart programs can repaint
  1132. themselves to the new size.  Note that many programs won't be able to
  1133. deal with this very well.  That's about it for the gadgets.
  1134.  
  1135. Let's turn to the frame itself next.  The PointButton clicked in the
  1136. frame will bring the window to the front of the screen.  Handy.  The
  1137. AdjustButton lets you drag the window around.  The MenuButton brings
  1138. up the standard frame menu.  There.  That wasn't so hard.
  1139.  
  1140. Now for the terminal canvas itself.  The PointButton and the
  1141. AdjustButton work together here to allow you to select pieces of text
  1142. that appear on the window.  The PointButton always starts a new
  1143. selection, while the AdjustButton extends the current selection, or
  1144. starts a new one if there isn't a selection going on right now.
  1145. That's the only difference between them.  Now, how do they work?  More
  1146. clicking and dragging here, folks.  Push and hold the PointButton and
  1147. a new selection is started.  What you have selected so far will have a
  1148. line drawn around it.  Dragging the mouse around changes the size of
  1149. the text selected.  When you release the mouse, the selection area
  1150. stops changing in response to your mouse movements.  After the
  1151. selection has been reported to the server, its hilighting is changed
  1152. to reverse video.  If one of the ends of your selection is not quite
  1153. what you want, use the AdjustButton to adjust it.  Just click down and
  1154. drag the mouse to the spot you want.  It's quite easy when you get
  1155. used to it.
  1156.  
  1157. So, what do you use the selected text for?  Here we come to using the
  1158. MenuButton in the terminal canvas.  It brings up the terminal menu.
  1159. There are three entries in the terminal menu.  The first is ``Stuff''.
  1160. Stuff takes whatever text is selected and stuffs it into your
  1161. terminal.  Basically, it pretends to type it for you.  It doesn't
  1162. matter which window you've selected text in, stuff can find it.  It's
  1163. real easy to grab some text in one window and move it to another with
  1164. stuff.  Once you've made a selection, it remains the current selection
  1165. even if it's not on the screen anymore.  Neat stuff.
  1166.  
  1167. The second entry in the terminal menu is ``Frame...''  Under here is a
  1168. copy of the standard frame menu.
  1169.  
  1170. The third entry in the terminal menu is ``Config...''  Here things get
  1171. fun.  Each of the submenus under Config... also has a submenu.  We
  1172. will deal with them individually.
  1173.  
  1174. Config... Lines x Cols...  This menu sets the terminal size to the
  1175. indicated number of lines and columns.  By default, this will change
  1176. the window size to fit.
  1177.  
  1178. Config... Points...  This menu sets the font point size.  By default,
  1179. this will change the window size to fit.
  1180.  
  1181. Config... Fonts...  This menu sets the terminal font to one of the
  1182. standard fixed width fonts.  This is likely to change the size of the
  1183. characters, and behaves as thought the font size had been changed.
  1184. Note that /Screen font (the default) only scales to a few
  1185. predetermined sizes.  Selecting a new point size is likely to have no
  1186. effect until a fully scalable font is selected.  Several other fonts
  1187. exibit this behavior.  See More Fonts!... below.
  1188.  
  1189. Config... More Fonts!...  This menu lists all fonts known to the
  1190. system at the time the psterm was started.  Note that some of these
  1191. are likely to be silly.  The width of the letter ``m'' in the font is
  1192. used to determine the spacing between characters.  Some fonts have no
  1193. ``m'' character.  See Config... Toggles... Var Width Fonts below.
  1194.  
  1195. Config... Resizing stuff...  This menu is strange.  Under it are three
  1196. pairs of toggles.  These toggles control the behavior of psterm when
  1197. one of three parameters is changed.  Basically, there are three
  1198. parameters used to determine the way the terminal is displayed, and
  1199. they are all interdependant.  The three parameters are Font Size,
  1200. Lines/Cols, and Window Size.  Fixing values for any two of these
  1201. determines the third value.  When you change one of these parameters,
  1202. psterm consults this menu to determine which of the other two
  1203. parameters should stay the same, and which should change.  The
  1204. parameter with the ``*'' next to it will be the one which changes.
  1205. Select the menu entry for the unstarred parameter to cause it to
  1206. become the new starred parameter.  Remember that you choose among
  1207. three independant pairs of values.  Now, go play.
  1208.  
  1209. Config... Save Lines...  This menu selects the number of lines saved.
  1210. If you select a value other than zero, a scrollbar will appear
  1211. allowing you to scroll through the saved region.  Selecting zero will
  1212. remove the scrollbar.  Saving a large number of lines takes a lot of
  1213. memory, and possibly several seconds to set up.
  1214.  
  1215. Config... Toggles...  This menu controls the on/off state of several
  1216. items.  Select the item to toggle it.  If there is an ``*'' next to an
  1217. item, it is on now, and selecting it will turn it off.  The first item
  1218. is Page Mode.  See the -pm option above.  The second item is Auto
  1219. Margins.  The initial state of this item is determined from the
  1220. termcap entry for the terminal being emulated.  If Auto Margins is on,
  1221. when the terminal's cursor is in the rightmost column and another
  1222. character needs to be displayed, a newline will automatically be
  1223. inserted.  If Auto Margins is off, the cursor will ``stick'' to the
  1224. right of the window.  The third item is Var Width Fonts, and defaults
  1225. to on.  This item is only of importance if the current font is not a
  1226. fixed width font.  Basically, if it is off, all fonts are forced to be
  1227. fixed width.  With Var Width Fonts on, normal output will be more
  1228. readable under a variable width font, like /Times-Roman, but columns
  1229. of text will not line up properly, and cursor motion and selection of
  1230. text can produce wierd effects.  This should be fun to play with.
  1231. The fourth item is Fast Repaint, defaulting to on.  If you turn it off,
  1232. then every repaint will be seen, even if another is already in progress.
  1233. The fifth item is Scrolling Allowed, defaulting to on.  This is here
  1234. in case your server can repaint faster than it can do a copyarea.
  1235. On a Silicon Graphics, you might want to turn this off by default.
  1236. Just set DefaultUseCopyArea to false in your .pstermrc file.
  1237.  
  1238. Config... Set Labels...  This menu allows you to set the value of the
  1239. frame label, the icon label, or both.  Label values are set to the contents
  1240. of the current selection.  You can also set the frame label to a string
  1241. indicating what version of psterm you are running.
  1242.  
  1243.  
  1244. Well, we've wound our way all the way through the menu tree, and that
  1245. completes what you can do with the mouse in psterm.  Getting around in
  1246. psterm can be quite amusing... have fun.
  1247.  
  1248.  
  1249.  
  1250.     Customizing psterm
  1251.  
  1252. It's easy to feed new PostScript code to psterm.  Just put the code
  1253. inside a file in your home directory called ``.pstermrc''.  psterm
  1254. will automatically load the contents of this file whenever it starts
  1255. up freshly (or you specify -r).  You can use this to override defaults
  1256. for all of your terminal sessions, or to set up custom code to be run
  1257. only for certain sessions (via the -ui userinit option).  See the
  1258. example .pstermrc files and the top of psterm.ps for more information.
  1259. @@@ Fin de UsingPSTerm
  1260. echo bsd.c
  1261. cat >bsd.c <<'@@@ Fin de bsd.c'
  1262. /*
  1263.  * This file is a product of Sun Microsystems, Inc. and is provided for
  1264.  * unrestricted use provided that this legend is included on all tape
  1265.  * media and as a part of the software program in whole or part.
  1266.  * Users may copy, modify or distribute this file at will.
  1267.  * 
  1268.  * THIS FILE IS PROVIDED AS IS WITH NO WARRANTIES OF ANY KIND INCLUDING THE
  1269.  * WARRANTIES OF DESIGN, MERCHANTIBILITY AND FITNESS FOR A PARTICULAR
  1270.  * PURPOSE, OR ARISING FROM A COURSE OF DEALING, USAGE OR TRADE PRACTICE.
  1271.  * 
  1272.  * This file is provided with no support and without any obligation on the
  1273.  * part of Sun Microsystems, Inc. to assist in its use, correction,
  1274.  * modification or enhancement.
  1275.  * 
  1276.  * SUN MICROSYSTEMS, INC. SHALL HAVE NO LIABILITY WITH RESPECT TO THE
  1277.  * INFRINGEMENT OF COPYRIGHTS, TRADE SECRETS OR ANY PATENTS BY THIS FILE
  1278.  * OR ANY PART THEREOF.
  1279.  * 
  1280.  * In no event will Sun Microsystems, Inc. be liable for any lost revenue
  1281.  * or profits or other special, indirect and consequential damages, even
  1282.  * if Sun has been advised of the possibility of such damages.
  1283.  * 
  1284.  * Sun Microsystems, Inc.
  1285.  * 2550 Garcia Avenue
  1286.  * Mountain View, California  94043
  1287.  *
  1288.  * Modifications to the original Sun Microsystems, Inc. source code
  1289.  * made by the Grasshopper Group are in the Public Domain.
  1290.  *
  1291.  * Extensions to this file by Eric Messick of the Grasshopper Group.
  1292.  *
  1293.  * Grasshopper Group
  1294.  * 212 Clayton St
  1295.  * San Francisco, CA 94117
  1296.  *
  1297.  */
  1298.  
  1299. #ifdef REF
  1300. #include <ref/config.h>
  1301. #endif
  1302.  
  1303. #ifndef lint
  1304. static  char sccsid[] = "@(#)bsd.c 9.5 88/01/19 SMI";
  1305. static    char RCSid[] = "@(#)$Header: bsd.c,v 2.2 88/10/04 05:11:14 eric Release $";
  1306. #endif
  1307.  
  1308. /*
  1309.  * Copyright (c) 1987 by Sun Microsystems, Inc.
  1310.  */
  1311.  
  1312. #ifdef HAVE_BSD_TTYS
  1313. /*
  1314.  * BSD Support Routines.
  1315.  */
  1316. #include <sys/types.h>
  1317. #include <sgtty.h>
  1318. #include <sys/file.h>
  1319. #include <signal.h>
  1320. #include <stdio.h>
  1321.  
  1322. extern void perror();
  1323. #ifndef bzero
  1324. extern void bzero();
  1325. #endif
  1326. extern char *strncpy();
  1327. extern long time();
  1328. extern long lseek();
  1329.  
  1330. /* Tty mode statics */
  1331. static    struct tchars tc;
  1332. static    struct ltchars ltc;
  1333. static    struct sgttyb sg;
  1334. static    int lm;            /* localmodes */
  1335. static    int ld;            /* ldisc */
  1336.  
  1337. /* Default settings for tty mode stuff */
  1338. static    struct tchars tc_df =
  1339.     { CINTR, CQUIT, CSTART, CSTOP, CEOF, CBRK };
  1340. static    struct ltchars ltc_df =
  1341.     { CSUSP, CDSUSP, CRPRNT, CFLUSH, CWERASE, CLNEXT };
  1342. static    struct sgttyb sg_df =
  1343.     { B9600, B9600, CERASE, CKILL, ANYP|ECHO|CRMOD };
  1344. static    int lm_df = LCRTBS|LCRTERA|LCRTKIL|LCTLECH;
  1345. static    int ld_df = NTTYDISC;
  1346.  
  1347. extern    int console;
  1348. extern    int CharsPerLine;
  1349. extern    int LinesPerScreen;
  1350.  
  1351. static void get_tty_util();
  1352.  
  1353. GetTTYDefaults()
  1354. {
  1355.     int fd;
  1356.  
  1357.     /* Get settings of controlling terminal */
  1358.     fd = open("/dev/tty", O_RDWR);
  1359.     get_tty_util(fd);
  1360.     if (fd > 0)
  1361.     close(fd);
  1362. #ifdef sun
  1363.     /*
  1364.      * Modify setting with data passed thru the environment.
  1365.      * Read environment variable WINDOW_TTYPARMS
  1366.      */
  1367.     if(we_getptyparms(&ld, &lm, &sg, &tc, <c) == -1) {
  1368.     /*
  1369.      * Try to get the tty parameters from stderr (2).
  1370.      * Using stdin (0) fails when being started in the background
  1371.      *   because csh redirects stdin from the tty to /dev/null.
  1372.      */
  1373.     fd = 2;
  1374.     if (!isatty(fd)) {
  1375.         fd = open("/dev/console", 2);
  1376.     }
  1377.     get_tty_util(fd);
  1378.     if (fd != 2)
  1379.         (void) close(fd);
  1380.    }
  1381. #endif
  1382. }
  1383.  
  1384. static void
  1385. get_tty_util(fd)
  1386.     int fd;
  1387. {
  1388.     if (fd > 0) {
  1389.     if(ioctl(fd, TIOCGETP, &sg) == 0 || (sg.sg_flags&ECHO) == 0)
  1390.         sg = sg_df;
  1391.     (void) ioctl(fd, TIOCGETC, &tc);
  1392.     if (tc.t_quitc == 0)
  1393.         tc = tc_df;
  1394.     (void) ioctl(fd, TIOCGETD, &ld);
  1395.     if (ld == 0)
  1396.         ld = ld_df;
  1397.     (void) ioctl(fd, TIOCLGET, &lm);
  1398.     if (lm == 0)
  1399.         lm = lm_df;
  1400.     (void) ioctl(fd, TIOCGLTC, <c);
  1401.     if (ltc.t_suspc == 0)
  1402.         ltc = ltc_df;
  1403.     (void) ioctl(fd, TIOCNOTTY, 0);
  1404.     } else {
  1405.     /* Last resort...use some default values */
  1406.     tc = tc_df;
  1407.     ld = ld_df;
  1408.     lm = lm_df;
  1409.     ltc = ltc_df;
  1410.     sg = sg_df;
  1411.     }
  1412. }
  1413.  
  1414. SetTTYState(fd)
  1415.     int fd;
  1416. {
  1417.     (void) ioctl(fd, TIOCHPCL, 0);
  1418.     (void) ioctl(fd, TIOCSETD, &ld);
  1419.     if ((sg.sg_flags & ECHO) == 0)
  1420.     sg = sg_df;
  1421.     (void) ioctl(fd, TIOCSETP, &sg);
  1422.     (void) ioctl(fd, TIOCSETC, &tc);
  1423.     (void) ioctl(fd, TIOCSLTC, <c);
  1424.     (void) ioctl(fd, TIOCLSET, &lm);
  1425. #ifdef TIOCSWINSZ
  1426.     { struct winsize ws;
  1427.       ws.ws_row = LinesPerScreen; ws.ws_col = CharsPerLine;
  1428.       (void) ioctl(fd, TIOCSWINSZ, &ws);
  1429.     }
  1430. #endif
  1431. #ifdef TIOCSSIZE
  1432.     { struct ttysize ts;
  1433.       ts.ts_lines = LinesPerScreen; ts.ts_cols = CharsPerLine;
  1434.       (void) ioctl(fd, TIOCSSIZE, &ts);
  1435.     }
  1436. #endif
  1437.     if (console) {
  1438. #ifdef TIOCCONS
  1439.     if (ioctl(fd, TIOCCONS, 0) < 0)
  1440.         perror("tcap(TIOCCONS)");
  1441. #endif
  1442.     }
  1443. }
  1444.  
  1445. DisAssociateTTY()
  1446. {
  1447.     int fd;
  1448.  
  1449.     if (( fd = open("/dev/tty", O_RDWR)) >= 0) {
  1450.     ioctl(fd, TIOCNOTTY, 0);
  1451.     close(fd);
  1452.     }
  1453. }
  1454.  
  1455. AssociateTTY()
  1456. {
  1457.  
  1458. }
  1459.  
  1460. /*ARGSUSED*/
  1461. SetupControllingTTY(line)
  1462.    char line[];
  1463. {
  1464.     int fd, pid;
  1465.  
  1466.     if ((fd = open("/dev/tty", O_RDWR)) < 0) {
  1467.     (void) setpgrp(0, 0);
  1468.     (void) close(open(line, O_RDWR));
  1469.     } else {
  1470.     close(fd);
  1471.     }
  1472.     (void) setpgrp(0, pid = getpid());
  1473.     (void) ioctl(0, TIOCSPGRP, &pid);
  1474. }
  1475.  
  1476. #include <utmp.h>
  1477. #include <pwd.h>
  1478.  
  1479. #define SCPYN(a, b)    strncpy(a, b, sizeof(a))
  1480. #define SCMPN(a, b)    strncmp(a, b, sizeof(a))
  1481.  
  1482. static    char utmpf[] = "/etc/utmp";
  1483. static    char wtmpf[] = "/usr/adm/wtmp";
  1484. static    int tslot = -1;
  1485. static    struct utmp utmp;
  1486.  
  1487. addut(uid, line)
  1488.     int uid;
  1489.     char line[];
  1490. {
  1491. #ifdef UTMP
  1492.     struct passwd *pw;
  1493.     int i;
  1494.  
  1495.     /*
  1496.      * Record entry in /etc/utmp if possible.
  1497.      */
  1498.     tslot = ttyslot();
  1499.     pw = getpwuid(uid);
  1500.     if (tslot > 0 && pw && (i = open(utmpf, O_RDWR)) >= 0) {
  1501.     char *cp, *p, *getenv(), *index();
  1502.  
  1503.     bzero((char *)&utmp, sizeof (utmp));
  1504.     SCPYN(utmp.ut_line, &line[5]);
  1505.     SCPYN(utmp.ut_name, pw->pw_name);
  1506.     if ((cp = getenv("NEWSSERVER")) == NULL)
  1507.         cp = "";
  1508.     if ((p = index(cp, ';')) && p[1] != '\0')
  1509.         cp = p+1;
  1510.     SCPYN(utmp.ut_host, cp);
  1511.     (void) time(&utmp.ut_time);
  1512.     (void) lseek(i, (long)(tslot * sizeof (utmp)), L_SET);
  1513.     (void) write(i, (char *)&utmp, sizeof (utmp));
  1514.     (void) close(i);
  1515.     if ((i = open(wtmpf, O_WRONLY|O_APPEND)) >= 0) {
  1516.         write(i, (char *)&utmp, sizeof(utmp));
  1517.         close(i);
  1518.     }
  1519.     }
  1520. #endif
  1521. }
  1522.  
  1523. rmut()
  1524. {
  1525. #ifdef UTMP
  1526.     int fd;
  1527.     struct utmp wtmp;
  1528.  
  1529.     if (tslot >= 0 && (fd = open(utmpf, O_WRONLY)) >= 0) {
  1530.     wtmp = utmp;
  1531.     bzero((char *)&utmp, sizeof (utmp));
  1532.     (void) lseek(fd, (long)(tslot * sizeof (utmp)), L_SET);
  1533.     (void) write(fd, (char *)&utmp, sizeof (utmp));
  1534.     (void) close(fd);
  1535.     fd = open(wtmpf, O_WRONLY|O_APPEND);
  1536.     if (fd >= 0) {
  1537.         SCPYN(wtmp.ut_name, "");
  1538.         SCPYN(wtmp.ut_host, "");
  1539.         time(&wtmp.ut_time);
  1540.         write(fd, (char *)&wtmp, sizeof(wtmp));
  1541.         close(fd);
  1542.     }
  1543.     }
  1544. #endif
  1545. }
  1546. #endif /* !HAVE_BSD_TTYS */
  1547.  
  1548. #ifdef sun
  1549. #define    WE_TTYPARMS    "WINDOW_TTYPARMS"
  1550.  
  1551. /*
  1552.  * Get tty settings from environment.
  1553.  */
  1554. int
  1555. we_getptyparms(ldisc, localmodes, mode, tchars, ltchars)
  1556.     int *ldisc, *localmodes;
  1557.     struct sgttyb *mode;
  1558.     struct tchars *tchars;
  1559.     struct ltchars *ltchars;
  1560. {
  1561.     char *str, *getenv();
  1562.     short temps[16];    /* Needed for sscanf as there is no %hhd */
  1563.  
  1564.     if((str = getenv(WE_TTYPARMS)) == NULL) {
  1565.         return (-1);
  1566.     } else {
  1567.         if (sscanf(str,
  1568.   "%ld,%ld,%hd,%hd,%hd,%hd,%hd,%hd,%hd,%hd,%hd,%hd,%hd,%hd,%hd,%hd,%hd,%hd,%hd",
  1569.             ldisc, localmodes, &temps[0], &temps[1], &temps[2],
  1570.             &temps[3], &mode->sg_flags, &temps[4], &temps[5], &temps[6],
  1571.             &temps[7], &temps[8], &temps[9], &temps[10], &temps[11],
  1572.             &temps[12], &temps[13], &temps[14], &temps[15])
  1573.              != 19)
  1574.             return (-1);
  1575.             mode->sg_ispeed = temps[0];
  1576.             mode->sg_ospeed = temps[1];
  1577.             mode->sg_erase = temps[2];
  1578.             mode->sg_kill = temps[3];
  1579.             tchars->t_intrc = temps[4];
  1580.             tchars->t_quitc = temps[5];
  1581.             tchars->t_startc = temps[6];
  1582.             tchars->t_stopc = temps[7];
  1583.             tchars->t_eofc = temps[8];
  1584.             tchars->t_brkc = temps[9];
  1585.             ltchars->t_suspc = temps[10];
  1586.             ltchars->t_dsuspc = temps[11];
  1587.             ltchars->t_rprntc = temps[12];
  1588.             ltchars->t_flushc = temps[13];
  1589.             ltchars->t_werasc = temps[14];
  1590.             ltchars->t_lnextc = temps[15];
  1591.         /*
  1592.          * Always clear
  1593.          */
  1594.         (void)unsetenv(WE_TTYPARMS);
  1595.         return (0);
  1596.     }
  1597. }
  1598. #endif    /* of !HAVE_BST_TTYS */
  1599.  
  1600. @@@ Fin de bsd.c
  1601. echo screen.h
  1602. cat >screen.h <<'@@@ Fin de screen.h'
  1603. /*
  1604.  * This file is a product of Sun Microsystems, Inc. and is provided for
  1605.  * unrestricted use provided that this legend is included on all tape
  1606.  * media and as a part of the software program in whole or part.
  1607.  * Users may copy, modify or distribute this file at will.
  1608.  * 
  1609.  * THIS FILE IS PROVIDED AS IS WITH NO WARRANTIES OF ANY KIND INCLUDING THE
  1610.  * WARRANTIES OF DESIGN, MERCHANTIBILITY AND FITNESS FOR A PARTICULAR
  1611.  * PURPOSE, OR ARISING FROM A COURSE OF DEALING, USAGE OR TRADE PRACTICE.
  1612.  * 
  1613.  * This file is provided with no support and without any obligation on the
  1614.  * part of Sun Microsystems, Inc. to assist in its use, correction,
  1615.  * modification or enhancement.
  1616.  * 
  1617.  * SUN MICROSYSTEMS, INC. SHALL HAVE NO LIABILITY WITH RESPECT TO THE
  1618.  * INFRINGEMENT OF COPYRIGHTS, TRADE SECRETS OR ANY PATENTS BY THIS FILE
  1619.  * OR ANY PART THEREOF.
  1620.  * 
  1621.  * In no event will Sun Microsystems, Inc. be liable for any lost revenue
  1622.  * or profits or other special, indirect and consequential damages, even
  1623.  * if Sun has been advised of the possibility of such damages.
  1624.  * 
  1625.  * Sun Microsystems, Inc.
  1626.  * 2550 Garcia Avenue
  1627.  * Mountain View, California  94043
  1628.  *
  1629.  * Modifications to the original Sun Microsystems, Inc. source code
  1630.  * made by the Grasshopper Group are in the Public Domain.
  1631.  *
  1632.  * Extensions to this file by Eric Messick of the Grasshopper Group.
  1633.  *
  1634.  * Grasshopper Group
  1635.  * 212 Clayton St
  1636.  * San Francisco, CA 94117
  1637.  *
  1638.  */
  1639.  
  1640. /*
  1641.  * "@(#)screen.h 9.4 88/01/19
  1642.  * "@(#)$Header: screen.h,v 2.1 88/10/04 05:59:52 gnu Release $
  1643.  *
  1644.  * Copyright (c) 1985 by Sun Microsystems, Inc.
  1645.  */
  1646.  
  1647.  
  1648.  
  1649. struct line {
  1650.     u_short    length;        /* chars zero through length are meaningful */
  1651.     u_short    buffer_length;    /* body has this many chars allocated */
  1652.     u_short    changeposition;    /* we've scribbled on stuff right of this pos */
  1653.     u_short    end_of_changes;    /* we haven't scribbled past this point */
  1654.     int        usedtobe;    /* this line was scrolled from line usedtobe */
  1655.     int        flags;        /* attributes of this line */
  1656.     char *    body;        /* chars to display */
  1657.     u_char *    prop;        /* how to display them (attributes) */
  1658. };
  1659.  
  1660. /* values for flags */
  1661. #define LINE_WRAPPED    1    /* newline at end of line caused by autowrap */
  1662.  
  1663. struct line **screen, **lines;
  1664.  
  1665. struct pair {
  1666.     short    x, y;
  1667. };
  1668.  
  1669. struct range {
  1670.     struct pair    first, last_plus_one;
  1671. };
  1672.  
  1673. /*
  1674.  * Values for struct line -> prop
  1675.  */
  1676. #define    InsertMode    0x0100
  1677. #define AutoMarginMode    0x0200
  1678. #define IgnoreNewlineAfterWrapMode 0x0400
  1679. #define WrapJustHappenedMode    0x0800
  1680. #define    ReverseVideoMode    0x0001
  1681. #define    UnderlineMode    0x0002
  1682. #define    BoldMode    0x0004
  1683. #define    BlinkMode    0x0008
  1684. #define StandOutMode    ReverseVideoMode
  1685. #define    Attributes    (ReverseVideoMode|UnderlineMode|BoldMode|BlinkMode)
  1686.  
  1687. #define PrimSelMode    0x0010
  1688. #define SecnSelMode    0x0020
  1689. #define ReverseVideoLook    (ReverseVideoMode|PrimSelMode)
  1690. #define UnderlineLook        (UnderlineMode|SecnSelMode)
  1691. #define MaxCharsPerLine    2048
  1692. #define MaxLinesPerScreen 2048
  1693.  
  1694. #define bugprintf(fmt, a1, a2, a3) \
  1695.     { \
  1696.         char errors[1024]; \
  1697.         \
  1698.         sprintf(errors, fmt, a1, a2, a3); \
  1699.         PopMsg(errors); \
  1700.         FlushPostScript(); \
  1701.     }
  1702. @@@ Fin de screen.h
  1703. exit 0
  1704.  
  1705.