From:	CRDGW2::CRDGW2::MRGATE::"SMTP::CRDGW1::MCNC!RELAY-INFO-VAX%CRVAX.SRI.COM%GIZMO.SRI.COM" 15-APR-1989 05:18
To:	MRGATE::"ARISIA::EVERHART"
Subj:	Installing Tony's Curses

Received: by ge-rtp (5.57/ge-rtp.GE.COM/1.18)
	id AA20795; Sat, 15 Apr 89 05:09:57 EDT
Received: from GIZMO.SRI.COM by mcnc.mcnc.org (5.59/MCNC/5-16-88)
	id AA19233; Sat, 15 Apr 89 04:26:57 EDT
Received: From KL.SRI.COM by CRVAX.SRI.COM with TCP; Fri, 14 APR 89 19:05:55 PDT
Received: from ucbvax.Berkeley.EDU by KL.SRI.COM with TCP; Fri, 14 Apr 89 19:02:56 PDT
Received: by ucbvax.Berkeley.EDU (5.61/1.36)
	id AA17178; Fri, 14 Apr 89 18:42:40 -0700
Received: from USENET by ucbvax.Berkeley.EDU with netnews
	for info-vax@kl.sri.com (info-vax@kl.sri.com)
	(contact usenet@ucbvax.Berkeley.EDU if you have questions)
Date: 14 Apr 89 23:19:43 GMT
From: mcnc!g.ms.uky.edu!uflorida!haven!vrdxhq!bdmrrr!shprentz@crdgw1  (Joel Shprentz)
Organization: BDM Corp., McLean, Virginia
Subject: Installing Tony's Curses
Message-Id: <1079@bdmrrr.bdm.com>
Sender: info-vax-request@kl.sri.com
To: info-vax@kl.sri.com

When Tony Ivanov's VMS Curses package arrived today, I tried to install
it.  There were a few difficulties, but Tony worked with me to overcome
them.  These notes may help others who receive Tony's Curses package.

1. The program MOD_ENTRY_NAME.FOR uses the includes the file
GLIBSRC:$OBJDEF.FTN in two places.  The compiler complains because
GLIBSRC in not defined.  Change the include statements to reference the
file $OBJDEF.FTN -- it is in the current directory.

2. Tony recommends copying three include files (termio.h, vmstermio.h,
and vmscurses.h) to sys$library.  If you can't do that, copy them to
some convenient directory and use the symbol VAXC$INCLUDE to specify a
list of paths to search for system include files.  My definition is:

	$ VAXC$INCLUDE :== sys$disk:[shprentz.library],sys$library

3. The trmdef.h file is missing.  You can create it from information in
the system library.  First, extract some assembler equates:

	$ lib/extract=$trmdef/output=trmdef.h sys$library:starlet.mlb

Then edit trmdef.h, converting assembler equates into C defines.
Discard the assembler directives at the beginning and end of the file.
Put the file where the C compiler can find it as described in step 2
above.

4. Vax C 2.4 warns about parameter type mismatches in a few functions
while compiling GVG$VAXCIO.C.  Tony reports that C 2.2 does not
complain.  The warnings do not seem to hurt performance of the
package.

5. Tony recommends copying the VMS$CURSES and revised VAXCRTL object
libraries to sys$library.  If you can't do that, copy them to some
convenient directory.  Be sure to link your version of these libraries
into your programs.

6. Unlike the Curses package supplied with VMS, Tony's packages uses a
termcap file.  Tony recommends copying a termcap file from a Unix
system to sys$library.  If you can't do that, copy it to some
convenient directory and tell Tony's Curses where to find it.  This is
a little tricky because Curses assumes that it is working with Unix
pathnames, not VMS file specifications.  This worked for me:

	$ assign "/sys$disk/shprentz/library/termcap." termcap

The path must begin with a '/' character or Curses will not recognize
it as a path.  Also notice that the termcap filename ends with a dot.

7. Curses will try to find your terminal type in the termcap file.  If
you do not assign a terminal type, VMS will supply one for you.  On my
system, SHOW TERM reports a terminal type of VT100.  When asked by
Curses for the value of the TERM environment variable, VMS responds
"vt100-80" -- note lowercase "vt" and screen width, 80.  Be sure your
termcap file has an entry for your terminal type.  You can also assign
your own terminal type:

	$ assign "vt100" term

Special thanks go to Tony Ivanov who helped me get Curses up and
running.  You can reach Tony by electronic mail at
tony@gvgpvd.GVG.TEK.COM.
-- 
Joel Shprentz                   Phone:  (703) 848-7305
BDM Corporation                 Uucp:  {rutgers,vrdxhq,rlgvax}!bdmrrr!shprentz
7915 Jones Branch Drive         Internet:  shprentz@bdmrrr.bdm.com
McLean, Virginia  22102