README file for the terminfo directory of ICOBOL             01/05/06


In this directory are example source files for several terminals
that have been tested to work with ICOBOL when ICTERM is set to
terminfo and TERM points to one of these entries in the terminfo
database.

In many cases you will notice that the terminal names have an
appended 'i'.  This was done to indicate ICOBOL and to also
keep this entry from conflicting with an entry that may already
be in the terminfo database.  If you wish the 'i' can be removed.

To add one of these entries to your particular terminfo database
as superuser run the tic command giving the source-file as its
argument.  Tic will compile the entry and place it in the
terminfo database, any errors will be displayed.

You can change any of these entries by editing the source file
with the appropriate changes and re-compiling with tic.

When ICTERM is set to terminfo, i.e., 'ICTERM=terminfo', ICOBOL
uses the curses library to interact with the screen.  In
particular, ICOBOL uses the following terminfo entries:

    For output:

    bel       sound bell
    clear     clear screen
    cub1      cursor left
    cud1      cursor down
    cuf1      cursor right
    cuu1      cursor up
    cup       cursor address
    dch1      delete character
    do        cursor down
    ed        clear to end of display
    el        clear to end of line
    home      cursor home
    ind       scroll forward
    mc4       Turn printer off
    mc5       turn printer on
    sgr       set attributes (ICOBOL uses underline(p2), reverse(p3),
                                          blink(p4), and bold(p6))

                  standout(p1), dim(p5), invisible(p7),  protect(p8),
                  and alternate character set(p9) are not used.

              For color terminals the above attributes can be mapped
              to particular color combinations especially underline
              and bold which normally are not supported on color
              terminals.

    up        cursor up


    For input:

        As noted under ICTERM=terminfo in the
        the ICOBOL Configuration Manual


The termi program in the examples directory can be used to test
a particular terminfo for both output attributes and input keys.

The standard UNIX program, infocmp, can be used to view the compiled
terminfo database for a particular entry.  It should be used to insure
that what you thought you entered is really in the database.

End readme


