-- $Id: README,v 1.24 2005/10/01 22:01:07 tom Exp $

-------------------------------------------------------------------------------

The programs in this directory are designed to test your newest toy :-)

Check the sources for any further details.

blue - Blue Moon, a nifty solitaire (uses color)

bs.c - the game of Battleships (uses color)

firework.c - multi-colored fireworks (uses color)

gdc.c - Great Digital Clock (uses color)

hanoi.c - the game of hanoi (uses color essentially)

knight.c - the game of Knight's Tour (uses color)

lrtest.c - test of access to the lower-right corner

ncurses.c - multi-test program (uses color)

newdemo.c - another test from PDCurses (uses color)

rain.c - rain drops keep falling on my head...

tclock.c - analog/digital clock

testcurs.c - a test from the PDCurses people (uses color)

worm.c - worms run all over your screen (uses color)

xmas.c - Xmas greeting card

The bs and knight games demonstrate processing of mouse events under xterm.

This directory also contains:

tracemunch - Perl script to crunch trace scripts to make them easier to read

-------------------------------------------------------------------------------

-------------------------------------------------------------------------------

These programs provide examples of use, but do not comprise a complete set of

tests. Here is a list of library externals, noting those that are used:

libform:

-------

TYPE_ALNUM test: demo_forms

TYPE_ALPHA test: demo_forms ncurses

TYPE_ENUM test: demo_forms

TYPE_INTEGER test: demo_forms

TYPE_IPV4 test: demo_forms

TYPE_NUMERIC test: demo_forms

TYPE_REGEXP test: demo_forms

current_field test: demo_forms edit_field ncurses

data_ahead test: demo_forms

data_behind test: demo_forms

dup_field -

dynamic_field_info test: demo_forms

field_arg -

field_back -

field_buffer test: cardfile demo_forms edit_field ncurses

field_count -

field_fore -

field_index test: demo_forms

field_info test: ncurses

field_init -

field_just -

field_opts test: demo_forms ncurses

field_opts_off test: cardfile demo_forms

field_opts_on test: demo_forms

field_pad -

field_status test: demo_forms

field_term -

field_type test: demo_forms

field_userptr test: ncurses

form_driver test: cardfile demo_forms edit_field ncurses

form_fields test: cardfile demo_forms

form_init -

form_opts -

form_opts_off -

form_opts_on -

form_page -

form_request_by_name -

form_request_name test: edit_field

form_sub test: cardfile demo_forms ncurses

form_term -

form_userptr -

form_win test: cardfile demo_forms edit_field ncurses

free_field test: cardfile demo_forms ncurses

free_fieldtype test: ncurses

free_form test: cardfile demo_forms ncurses

link_field -

link_fieldtype -

move_field -

new_field test: cardfile demo_forms ncurses

new_fieldtype test: ncurses

new_form test: cardfile demo_forms ncurses

new_page -

pos_form_cursor -

post_form test: cardfile demo_forms ncurses

scale_form test: demo_forms ncurses

set_current_field test: demo_forms

set_field_back test: cardfile demo_forms edit_field ncurses

set_field_buffer test: cardfile demo_forms edit_field ncurses

set_field_fore test: demo_forms

set_field_init -

set_field_just test: cardfile demo_forms

set_field_opts test: demo_forms ncurses

set_field_pad -

set_field_status test: demo_forms

set_field_term -

set_field_type test: demo_forms ncurses

set_field_userptr test: demo_forms ncurses

set_fieldtype_arg -

set_fieldtype_choice -

set_form_fields -

set_form_init -

set_form_opts -

set_form_page -

set_form_sub test: cardfile demo_forms ncurses

set_form_term -

set_form_userptr -

set_form_win test: cardfile demo_forms ncurses

set_max_field test: demo_forms

set_new_page test: demo_forms

unpost_form test: cardfile demo_forms ncurses

libmenu:

-------

current_item test: demo_menus ncurses

free_item test: ncurses

free_menu test: demo_menus ncurses

item_count test: demo_menus

item_description -

item_index test: demo_menus ncurses

item_init -

item_name test: ncurses

item_opts -

item_opts_off -

item_opts_on -

item_term -

item_userptr -

item_value test: demo_menus ncurses

item_visible -

menu_back -

menu_driver test: demo_menus ncurses

menu_fore -

menu_format -

menu_grey -

menu_init -

menu_items test: demo_menus ncurses

menu_mark -

menu_opts -

menu_opts_off test: demo_menus ncurses

menu_opts_on test: demo_menus

menu_pad -

menu_pattern -

menu_request_by_name -

menu_request_name -

menu_spacing test: demo_menus

menu_sub -

menu_term -

menu_userptr -

menu_win test: demo_menus ncurses

new_item test: demo_menus ncurses

new_menu test: demo_menus ncurses

pos_menu_cursor lib: menu

post_menu test: demo_menus ncurses

scale_menu test: demo_menus ncurses

set_current_item -

set_item_init -

set_item_opts -

set_item_term -

set_item_userptr -

set_item_value test: demo_menus ncurses

set_menu_back test: demo_menus

set_menu_fore test: demo_menus

set_menu_format test: demo_menus ncurses

set_menu_grey -

set_menu_init -

set_menu_items -

set_menu_mark test: demo_menus

set_menu_opts -

set_menu_pad -

set_menu_pattern -

set_menu_spacing -

set_menu_sub test: demo_menus ncurses

set_menu_term -

set_menu_userptr -

set_menu_win test: demo_menus ncurses

set_top_row -

top_row -

unpost_menu test: ncurses

libncurses:

----------

BC -

COLORS test: ncurses xmas

COLOR_PAIR test: background blue bs cardfile demo_forms demo_menus filter firework gdc hanoi ins_wide inserts knight ncurses newdemo rain tclock testaddch testcurs view worm xmas

COLOR_PAIRS test: ncurses newdemo

COLS test: cardfile demo_defkey demo_forms demo_keyok demo_menus edit_field firework hashtest ins_wide inserts lrtest ncurses newdemo rain tclock testcurs view worm

ESCDELAY lib: ncurses

LINES test: cardfile demo_defkey demo_keyok demo_menus edit_field firework hanoi hashtest ins_wide inserts lrtest ncurses newdemo rain tclock testcurs view worm xmas

PAIR_NUMBER test: ncurses

PC lib: ncurses

SP lib: ncurses

TABSIZE lib: menu

UP -

acs_map test: gdc ins_wide inserts knight ncurses newdemo testcurs

add_wch test: ncurses

add_wchnstr test: ncurses

add_wchstr test: view

addch test: blue bs ditto hashtest ncurses testaddch view worm

addchnstr -

addchstr -

addnstr -

addnwstr -

addstr test: blue bs cardfile gdc hanoi lrtest ncurses

addwstr test: ncurses

assume_default_colors test: ncurses

attr_get test: ncurses

attr_off test: ncurses

attr_on test: ncurses

attr_set test: ncurses

attroff test: filter gdc ncurses tclock

attron test: bs filter gdc ncurses

attrset test: bs firework gdc hanoi ncurses rain tclock testaddch testcurs

baudrate lib: ncurses

beep test: blue bs cardfile demo_forms demo_menus edit_field hanoi ins_wide inserts knight ncurses tclock testcurs view xmas

bkgd test: background cardfile demo_forms ncurses tclock view

bkgdset test: background ncurses testaddch

bkgrnd test: ncurses

bkgrndset test: ncurses

boolcodes progs: dump_entry

boolfnames progs: dump_entry

boolnames progs: dump_entry infocmp

border -

border_set -

box test: cardfile demo_forms demo_menus edit_field ins_wide inserts lrtest ncurses newdemo testcurs

box_set test: ncurses

can_change_color test: ncurses

cbreak test: background blue bs cardfile color_set demo_defkey demo_forms demo_keyok demo_menus ditto filter firework gdc hanoi hashtest ins_wide inserts knight lrtest ncurses newdemo tclock testcurs view worm xmas

chgat -

clear test: blue bs gdc ncurses testcurs xmas

clearok test: bs knight

clrtobot test: demo_menus ncurses

clrtoeol test: blue bs hanoi hashtest ncurses view

color_content test: ncurses

color_set test: color_set ncurses

copywin test: testcurs

cur_term test: dots lrtest progs: clear tic tput tset

curs_set test: firework gdc hanoi lrtest newdemo rain tclock testcurs worm xmas

curscr test: edit_field knight lrtest ncurses tclock view

curses_version test: ncurses progs: infocmp tic toe tput tset

def_prog_mode test: bs ncurses

def_shell_mode lib: ncurses

define_key test: demo_defkey

del_curterm lib: ncurses

delay_output -

delch -

deleteln -

delscreen -

delwin test: cardfile demo_forms demo_menus edit_field ins_wide inserts ncurses newdemo testcurs

derwin test: cardfile demo_forms demo_menus ins_wide inserts ncurses

doupdate test: cardfile edit_field ins_wide inserts knight ncurses

dupwin test: edit_field

echo test: bs hanoi ncurses testcurs testscanw

echo_wchar test: ncurses

echochar test: ncurses

endwin test: background blue bs cardfile color_set demo_defkey demo_forms demo_keyok demo_menus ditto filter firework firstlast gdc hanoi hashtest ins_wide inserts keynames knight lrtest ncurses newdemo rain tclock testaddch testcurs testscanw view worm xmas

erase test: cardfile filter firework firstlast hanoi lrtest ncurses tclock testcurs

erasechar lib: ncurses

erasewchar -

filter test: filter

flash test: cardfile lrtest ncurses tclock testcurs

flushinp test: ncurses newdemo testcurs

get_wch -

get_wstr -

getbkgd test: ncurses

getbkgrnd test: ncurses

getcchar test: ncurses view

getch test: background blue bs color_set ditto firework firstlast hanoi hashtest lrtest rain tclock testaddch testcurs view worm xmas

getmouse test: bs knight ncurses

getn_wstr -

getnstr test: filter ncurses

getstr -

getwin test: ncurses

halfdelay test: view

has_colors test: background bs cardfile color_set demo_forms demo_menus filter firework gdc hanoi ins_wide inserts knight ncurses newdemo rain tclock testcurs view worm xmas

has_ic test: lrtest

has_il lib: ncurses

has_key lib: ncurses

hline test: gdc ncurses

hline_set -

idcok -

idlok test: ncurses testscanw view

immedok -

in_wch -

in_wchnstr -

in_wchstr -

inch -

inchnstr -

inchstr -

init_color test: ncurses

init_pair test: background blue bs cardfile color_set demo_forms demo_menus filter firework gdc hanoi ins_wide inserts knight ncurses newdemo rain tclock testaddch testcurs view worm xmas

initscr test: background blue bs cardfile color_set demo_defkey demo_forms demo_keyok demo_menus firework firstlast gdc hanoi hashtest ins_wide inserts knight lrtest ncurses newdemo rain tclock testaddch testcurs testscanw view worm xmas

innstr -

innwstr -

ins_nwstr test: ins_wide

ins_wch test: ins_wide

ins_wstr test: ins_wide

insch test: ins_wide inserts

insdelln -

insertln -

insnstr test: inserts

insstr test: inserts

instr -

intrflush test: demo_forms

inwstr -

is_linetouched lib: form

is_term_resized -

is_wintouched lib: ncurses

isendwin -

key_defined test: demo_defkey

key_name test: ncurses

keybound test: demo_defkey

keyname test: demo_defkey demo_keyok edit_field keynames ncurses testcurs view progs: tic

keyok test: demo_keyok

keypad test: bs cardfile demo_defkey demo_forms demo_keyok demo_menus edit_field filter firework hashtest ins_wide inserts keynames knight lrtest ncurses tclock testcurs testscanw view

killchar lib: ncurses

killwchar -

leaveok test: hanoi

longname test: testcurs progs: tput

mcprint -

meta test: ncurses

mouse_trafo lib: menu

mouseinterval -

mousemask test: bs demo_menus knight ncurses

move test: blue bs cardfile demo_menus gdc hanoi hashtest ins_wide inserts knight lrtest ncurses testscanw view worm xmas

mvadd_wch test: ncurses

mvadd_wchnstr -

mvadd_wchstr -

mvaddch test: bs gdc hanoi lrtest ncurses rain tclock xmas

mvaddchnstr test: gdc

mvaddchstr -

mvaddnstr -

mvaddnwstr -

mvaddstr test: bs demo_forms gdc hanoi knight ncurses rain tclock testcurs xmas

mvaddwstr -

mvchgat -

mvcur lib: ncurses

mvdelch -

mvderwin lib: menu

mvget_wch -

mvget_wstr -

mvgetch -

mvgetn_wstr -

mvgetnstr -

mvgetstr -

mvhline test: ncurses

mvhline_set test: ncurses

mvin_wch -

mvin_wchnstr -

mvin_wchstr -

mvinch -

mvinchnstr test: gdc

mvinchstr -

mvinnstr -

mvinnwstr -

mvins_nwstr test: ins_wide

mvins_wch test: ins_wide

mvins_wstr test: ins_wide

mvinsch test: ins_wide inserts

mvinsnstr test: inserts

mvinsstr test: inserts

mvinstr -

mvinwstr -

mvprintw test: bs demo_menus firework hanoi ncurses tclock view

mvscanw -

mvvline test: ncurses

mvvline_set test: ncurses

mvwadd_wch -

mvwadd_wchnstr lib: form

mvwadd_wchstr -

mvwaddch test: newdemo testcurs xmas

mvwaddchnstr -

mvwaddchstr -

mvwaddnstr test: newdemo testcurs

mvwaddnwstr -

mvwaddstr test: firstlast ins_wide inserts knight ncurses newdemo testcurs xmas

mvwaddwstr -

mvwchgat -

mvwdelch test: ncurses

mvwget_wch -

mvwget_wstr -

mvwgetch -

mvwgetn_wstr -

mvwgetnstr -

mvwgetstr -

mvwhline lib: ncurses

mvwhline_set -

mvwin test: cardfile testcurs xmas

mvwin_wch -

mvwin_wchnstr lib: form

mvwin_wchstr -

mvwinch test: newdemo testcurs

mvwinchnstr -

mvwinchstr -

mvwinnstr test: testcurs

mvwinnwstr -

mvwins_nwstr test: ins_wide

mvwins_wch test: ins_wide

mvwins_wstr test: ins_wide

mvwinsch test: ins_wide inserts

mvwinsnstr test: inserts

mvwinsstr test: inserts testcurs

mvwinstr -

mvwinwstr -

mvwprintw test: ncurses testcurs

mvwscanw test: testcurs

mvwvline test: ins_wide inserts

mvwvline_set -

napms test: dots firework gdc hanoi lrtest ncurses newdemo railroad rain tclock testcurs view worm xmas progs: tset

newpad test: edit_field ncurses testcurs

newscr lib: ncurses

newterm test: ditto filter gdc keynames

newwin test: cardfile demo_defkey demo_forms demo_keyok demo_menus edit_field firstlast ins_wide inserts knight ncurses newdemo testcurs xmas

nl test: demo_forms ncurses rain testcurs

nocbreak test: testcurs

nodelay test: firework gdc lrtest ncurses newdemo rain tclock view xmas

noecho test: background bs cardfile color_set demo_defkey demo_forms demo_keyok demo_menus ditto firework firstlast gdc hanoi hashtest ins_wide inserts knight lrtest ncurses rain tclock testcurs view worm xmas

nonl test: bs demo_forms hashtest ncurses view worm xmas

noqiflush -

noraw test: demo_forms demo_menus ncurses testcurs

notimeout -

numcodes progs: dump_entry

numfnames progs: dump_entry

numnames progs: dump_entry infocmp

ospeed progs: tset

overlay test: testcurs xmas

overwrite test: ncurses

pair_content test: background color_set

pecho_wchar -

pechochar -

pnoutrefresh test: edit_field ncurses

prefresh test: testcurs

printw test: background blue bs color_set demo_defkey demo_keyok filter ncurses testcurs testscanw view

putp progs: tput

putwin test: ncurses

qiflush -

raw test: demo_forms ncurses testcurs

redrawwin -

refresh test: blue bs demo_defkey demo_forms demo_keyok demo_menus ditto filter firstlast gdc hanoi hashtest lrtest ncurses tclock testcurs view worm xmas

reset_prog_mode test: filter ncurses

reset_shell_mode test: bs filter

resetty -

resize_term test: view

resizeterm lib: ncurses

restartterm -

ripoffline test: ncurses

savetty -

scanw test: testcurs testscanw

scr_dump -

scr_init -

scr_restore -

scr_set -

scrl -

scroll test: testcurs

scrollok test: demo_defkey demo_keyok ditto hashtest knight ncurses testcurs testscanw view

set_curterm lib: ncurses

set_term test: ditto

setcchar test: ins_wide ncurses view

setscrreg test: view

setupterm test: dots progs: clear tput tset

slk_attr -

slk_attr_off -

slk_attr_on -

slk_attr_set -

slk_attroff lib: ncurses

slk_attron lib: ncurses

slk_attrset -

slk_clear test: ncurses

slk_color test: ncurses

slk_init test: ncurses

slk_label test: ncurses

slk_noutrefresh test: ncurses

slk_refresh test: ncurses

slk_restore test: ncurses

slk_set test: ncurses

slk_touch test: ncurses

slk_wset test: ncurses

standend test: blue gdc ncurses worm

standout test: blue ncurses

start_color test: background blue bs cardfile color_set demo_forms demo_menus filter firework gdc hanoi ins_wide inserts knight ncurses newdemo rain tclock testaddch testcurs view worm xmas

stdscr test: bs demo_forms ditto filter firework gdc hanoi hashtest ins_wide inserts keynames knight lrtest ncurses rain tclock testcurs testscanw view xmas

strcodes progs: dump_entry

strfnames progs: dump_entry

strnames progs: dump_entry infocmp tic

subpad test: testcurs

subwin test: ncurses newdemo testcurs

syncok -

term_attrs test: ncurses

termattrs test: ncurses testcurs

termname test: testcurs

tgetent test: demo_termcap railroad

tgetflag test: demo_termcap

tgetnum test: demo_termcap railroad

tgetstr test: demo_termcap railroad

tgoto test: railroad

tigetflag progs: tput

tigetnum test: ncurses progs: tput

tigetstr test: blue demo_defkey testcurs progs: tput

timeout test: rain

touchline lib: ncurses

touchwin test: demo_menus edit_field filter firstlast ins_wide inserts ncurses xmas

tparm test: dots progs: tic tput

tputs test: dots railroad progs: clear tset

trace test: demo_menus hanoi hashtest lrtest ncurses testcurs view worm

ttytype lib: ncurses

typeahead test: testcurs

unctrl test: ncurses testcurs

unget_wch -

ungetch test: bs knight

ungetmouse -

untouchwin lib: form

use_default_colors test: filter firework gdc hanoi knight ncurses rain tclock worm xmas

use_env progs: tput

use_extended_names progs: infocmp tic

vid_attr -

vid_puts -

vidattr lib: ncurses

vidputs lib: ncurses

vline test: gdc ncurses

vline_set -

vw_printw -

vw_scanw -

vwprintw lib: ncurses

vwscanw lib: ncurses

wadd_wch lib: ncurses

wadd_wchnstr lib: form

wadd_wchstr -

waddch test: demo_forms firstlast knight ncurses

waddchnstr lib: ncurses

waddchstr -

waddnstr lib: menu

waddnwstr test: ncurses

waddstr test: demo_forms edit_field firstlast ins_wide knight ncurses testcurs

waddwstr test: ins_wide

wattr_get -

wattr_off lib: ncurses

wattr_on lib: ncurses

wattr_set -

wattroff test: demo_forms ncurses testcurs xmas

wattron test: testcurs xmas

wattrset test: demo_forms ncurses newdemo testcurs xmas

wbkgd test: cardfile demo_forms ncurses newdemo testcurs

wbkgdset test: ins_wide inserts ncurses

wbkgrnd lib: ncurses

wbkgrndset lib: ncurses

wborder lib: ncurses

wborder_set lib: ncurses

wchgat test: view

wclear test: ncurses testcurs

wclrtobot test: firstlast ncurses testcurs

wclrtoeol test: demo_defkey demo_keyok firstlast ins_wide inserts knight ncurses testcurs

wcolor_set lib: ncurses

wcursyncup lib: form

wdelch test: ncurses testcurs

wdeleteln test: testcurs

wecho_wchar lib: ncurses

wechochar lib: ncurses

wenclose lib: menu

werase test: cardfile demo_forms edit_field firstlast knight ncurses newdemo testcurs xmas

wget_wch test: ins_wide ncurses

wget_wstr -

wgetch test: cardfile demo_defkey demo_keyok demo_menus edit_field gdc inserts knight ncurses newdemo testcurs

wgetn_wstr test: ncurses

wgetnstr test: ncurses

wgetstr -

whline test: testcurs

whline_set lib: ncurses

win_wch lib: form

win_wchnstr lib: form

win_wchstr -

winch test: knight testcurs

winchnstr lib: ncurses

winchstr -

winnstr test: demo_defkey

winnwstr lib: ncurses

wins_nwstr test: ins_wide

wins_wch test: ins_wide

wins_wstr test: ins_wide

winsch test: ins_wide inserts testcurs

winsdelln lib: ncurses

winsertln test: testcurs

winsnstr test: inserts

winsstr test: inserts

winstr -

winwstr lib: ncurses

wmouse_trafo lib: menu

wmove test: demo_defkey demo_keyok firstlast ins_wide inserts knight ncurses newdemo testcurs

wnoutrefresh test: edit_field ins_wide inserts knight ncurses

wprintw test: demo_defkey demo_forms demo_keyok edit_field ins_wide inserts knight ncurses testcurs

wredrawln lib: ncurses

wrefresh test: demo_forms demo_keyok demo_menus edit_field firstlast knight lrtest ncurses newdemo tclock testcurs view xmas

wresize test: cardfile ncurses

wscanw test: testcurs

wscrl test: ncurses testcurs view

wsetscrreg test: ncurses testcurs

wstandend test: xmas

wstandout test: xmas

wsyncdown lib: ncurses

wsyncup lib: form

wtimeout test: ncurses

wtouchln lib: ncurses

wunctrl -

wvline test: testcurs

wvline_set lib: ncurses

libpanel:

--------

bottom_panel test: ncurses

del_panel test: ncurses

hide_panel test: ncurses

move_panel test: ncurses

new_panel test: cardfile ncurses

panel_above -

panel_below -

panel_hidden -

panel_userptr test: ncurses

panel_window test: cardfile ncurses

replace_panel -

set_panel_userptr test: ncurses

show_panel test: ncurses

top_panel test: cardfile ncurses

update_panels test: cardfile ncurses