1 -------------------------------------------------------------------------------
2 -- Copyright (c) 1998-2005,2006 Free Software Foundation, Inc. --
4 -- Permission is hereby granted, free of charge, to any person obtaining a --
5 -- copy of this software and associated documentation files (the --
6 -- "Software"), to deal in the Software without restriction, including --
7 -- without limitation the rights to use, copy, modify, merge, publish, --
8 -- distribute, distribute with modifications, sublicense, and/or sell copies --
9 -- of the Software, and to permit persons to whom the Software is furnished --
10 -- to do so, subject to the following conditions: --
12 -- The above copyright notice and this permission notice shall be included --
13 -- in all copies or substantial portions of the Software. --
15 -- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS --
16 -- OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF --
17 -- MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN --
18 -- NO EVENT SHALL THE ABOVE COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, --
19 -- DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR --
20 -- OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE --
21 -- USE OR OTHER DEALINGS IN THE SOFTWARE. --
23 -- Except as contained in this notice, the name(s) of the above copyright --
24 -- holders shall not be used in advertising or otherwise to promote the --
25 -- sale, use or other dealings in this Software without prior written --
27 -------------------------------------------------------------------------------
28 -- $Id: README,v 1.28 2006/11/05 01:10:56 tom Exp $
29 -------------------------------------------------------------------------------
31 The programs in this directory are designed to test your newest toy :-)
32 Check the sources for any further details.
34 blue - Blue Moon, a nifty solitaire (uses color)
35 bs.c - the game of Battleships (uses color)
36 firework.c - multi-colored fireworks (uses color)
37 gdc.c - Great Digital Clock (uses color)
38 hanoi.c - the game of hanoi (uses color essentially)
39 knight.c - the game of Knight's Tour (uses color)
40 lrtest.c - test of access to the lower-right corner
41 ncurses.c - multi-test program (uses color)
42 newdemo.c - another test from PDCurses (uses color)
43 rain.c - rain drops keep falling on my head...
44 tclock.c - analog/digital clock
45 testcurs.c - a test from the PDCurses people (uses color)
46 worm.c - worms run all over your screen (uses color)
47 xmas.c - Xmas greeting card
49 The bs and knight games demonstrate processing of mouse events under xterm.
50 This directory also contains:
52 tracemunch - Perl script to crunch trace scripts to make them easier to read
54 -------------------------------------------------------------------------------
55 -------------------------------------------------------------------------------
57 These programs provide examples of use, but do not comprise a complete set of
58 tests. Here is a list of library externals, noting those that are used:
62 TYPE_ALNUM test: demo_forms
63 TYPE_ALPHA test: demo_forms ncurses
64 TYPE_ENUM test: demo_forms
65 TYPE_INTEGER test: demo_forms
66 TYPE_IPV4 test: demo_forms
67 TYPE_NUMERIC test: demo_forms
68 TYPE_REGEXP test: demo_forms
69 current_field test: demo_forms edit_field ncurses
70 data_ahead test: demo_forms
71 data_behind test: demo_forms
73 dynamic_field_info test: demo_forms
76 field_buffer test: cardfile demo_forms edit_field ncurses
79 field_index test: demo_forms
80 field_info test: ncurses
83 field_opts test: demo_forms ncurses
84 field_opts_off test: cardfile demo_forms
85 field_opts_on test: demo_forms
87 field_status test: demo_forms
89 field_type test: demo_forms
90 field_userptr test: ncurses
91 form_driver test: cardfile demo_forms edit_field ncurses
92 form_fields test: cardfile demo_forms
98 form_request_by_name -
99 form_request_name test: edit_field
100 form_sub test: cardfile demo_forms ncurses
103 form_win test: cardfile demo_forms edit_field ncurses
104 free_field test: cardfile demo_forms ncurses
105 free_fieldtype test: ncurses
106 free_form test: cardfile demo_forms ncurses
110 new_field test: cardfile demo_forms ncurses
111 new_fieldtype test: ncurses
112 new_form test: cardfile demo_forms ncurses
115 post_form test: cardfile demo_forms ncurses
116 scale_form test: demo_forms ncurses
117 set_current_field test: demo_forms
118 set_field_back test: cardfile demo_forms edit_field ncurses
119 set_field_buffer test: cardfile demo_forms edit_field ncurses
120 set_field_fore test: demo_forms
122 set_field_just test: cardfile demo_forms
123 set_field_opts test: demo_forms ncurses
125 set_field_status test: demo_forms
127 set_field_type test: demo_forms ncurses
128 set_field_userptr test: demo_forms ncurses
130 set_fieldtype_choice -
135 set_form_sub test: cardfile demo_forms ncurses
138 set_form_win test: cardfile demo_forms ncurses
139 set_max_field test: demo_forms
140 set_new_page test: demo_forms
141 unpost_form test: cardfile demo_forms ncurses
145 current_item test: demo_menus ncurses
146 free_item test: ncurses
147 free_menu test: demo_menus ncurses
148 item_count test: demo_menus
150 item_index test: demo_menus ncurses
152 item_name test: ncurses
158 item_value test: demo_menus ncurses
161 menu_driver test: demo_menus ncurses
166 menu_items test: demo_menus ncurses
167 menu_mark test: demo_menus
169 menu_opts_off test: demo_menus ncurses
170 menu_opts_on test: demo_menus
172 menu_pattern test: demo_menus
173 menu_request_by_name -
175 menu_spacing test: demo_menus
176 menu_sub test: demo_menus
179 menu_win test: demo_menus ncurses
180 new_item test: demo_menus ncurses
181 new_menu test: demo_menus ncurses
182 pos_menu_cursor lib: menu
183 post_menu test: demo_menus ncurses
184 scale_menu test: demo_menus ncurses
190 set_item_value test: demo_menus ncurses
191 set_menu_back test: demo_menus
192 set_menu_fore test: demo_menus
193 set_menu_format test: demo_menus ncurses
197 set_menu_mark test: demo_menus
202 set_menu_sub test: demo_menus ncurses
205 set_menu_win test: demo_menus ncurses
208 unpost_menu test: ncurses
213 COLORS test: echochar ncurses xmas
214 COLOR_PAIR test: background blue bs cardfile demo_forms demo_menus echochar filter firework gdc hanoi ins_wide inserts knight ncurses newdemo rain tclock testaddch testcurs view worm xmas
215 COLOR_PAIRS test: echochar ncurses newdemo
216 COLS test: cardfile demo_altkeys demo_defkey demo_forms demo_keyok demo_menus edit_field firework foldkeys hashtest ins_wide inserts lrtest movewindow ncurses newdemo rain tclock testcurs view worm
217 ESCDELAY lib: ncurses
218 LINES test: cardfile demo_defkey demo_keyok demo_menus edit_field firework hanoi hashtest ins_wide inserts lrtest movewindow ncurses newdemo rain tclock testcurs view worm xmas
219 PAIR_NUMBER test: ncurses
224 acs_map test: gdc ins_wide inserts knight movewindow ncurses newdemo testcurs
225 add_wch test: ncurses
226 add_wchnstr test: ncurses
227 add_wchstr test: view
228 addch test: blue bs ditto echochar hashtest ncurses testaddch view worm
233 addstr test: blue bs cardfile gdc hanoi lrtest ncurses
234 addwstr test: ncurses
235 assume_default_colors test: ncurses
236 attr_get test: ncurses
237 attr_off test: ncurses
238 attr_on test: ncurses
239 attr_set test: ncurses
240 attroff test: echochar filter gdc ncurses tclock
241 attron test: bs echochar filter gdc ncurses
242 attrset test: bs firework gdc hanoi ncurses rain tclock testaddch testcurs
243 baudrate lib: ncurses
244 beep test: blue bs cardfile chgat demo_forms demo_menus edit_field hanoi ins_wide inserts knight movewindow ncurses tclock testcurs view xmas
245 bkgd test: background cardfile demo_forms ncurses tclock view
246 bkgdset test: background ncurses testaddch
248 bkgrndset test: ncurses
249 boolcodes progs: dump_entry
250 boolfnames progs: dump_entry
251 boolnames progs: dump_entry infocmp
254 box test: cardfile chgat demo_forms demo_menus edit_field ins_wide inserts lrtest ncurses newdemo redraw testcurs
255 box_set test: ncurses
256 can_change_color test: ncurses
257 cbreak test: background blue bs cardfile chgat color_set demo_altkeys demo_defkey demo_forms demo_keyok demo_menus ditto filter firework foldkeys gdc hanoi hashtest ins_wide inserts knight lrtest movewindow ncurses newdemo tclock testcurs view worm xmas
259 clear test: blue bs gdc ncurses testcurs xmas
260 clearok test: bs knight
261 clrtobot test: demo_menus ncurses
262 clrtoeol test: blue bs demo_altkeys demo_menus foldkeys hanoi hashtest movewindow ncurses view
263 color_content test: ncurses
264 color_set test: color_set ncurses
265 copywin test: ncurses testcurs
266 cur_term test: dots echochar lrtest progs: clear tic tput tset
267 curs_set test: echochar firework gdc hanoi lrtest ncurses newdemo rain tclock testcurs worm xmas
268 curscr test: edit_field knight lrtest ncurses tclock view
269 curses_version test: ncurses progs: infocmp tic toe tput tset
270 def_prog_mode test: bs ncurses
271 def_shell_mode lib: ncurses
272 define_key test: demo_altkeys demo_defkey foldkeys
273 del_curterm lib: ncurses
278 delwin test: cardfile chgat demo_forms demo_menus edit_field ins_wide inserts movewindow ncurses newdemo redraw testcurs
279 derwin test: cardfile chgat demo_forms demo_menus ins_wide inserts movewindow ncurses
280 doupdate test: cardfile demo_menus edit_field ins_wide inserts knight movewindow ncurses redraw
281 dupwin test: edit_field
282 echo test: bs hanoi ncurses testcurs testscanw
283 echo_wchar test: ncurses
284 echochar test: echochar ncurses
285 endwin test: background blue bs cardfile chgat color_set demo_altkeys demo_defkey demo_forms demo_keyok demo_menus ditto echochar filter firework firstlast foldkeys gdc hanoi hashtest ins_wide inserts keynames knight lrtest movewindow ncurses newdemo rain redraw tclock testaddch testcurs testscanw view worm xmas
286 erase test: cardfile demo_menus filter firework firstlast hanoi lrtest ncurses tclock testcurs
287 erasechar lib: ncurses
290 flash test: cardfile lrtest ncurses tclock testcurs
291 flushinp test: ncurses newdemo testcurs
294 getbegx test: chgat demo_menus movewindow ncurses newdemo redraw testcurs
295 getbegy test: chgat demo_menus movewindow ncurses newdemo redraw testcurs
296 getbkgd test: ncurses
297 getbkgrnd test: ncurses
298 getcchar test: ncurses view
299 getch test: background blue bs chgat color_set demo_altkeys ditto filter firework firstlast foldkeys hanoi hashtest lrtest rain tclock testaddch testcurs view worm xmas
300 getcurx test: bs chgat demo_altkeys demo_defkey foldkeys movewindow ncurses redraw testcurs
301 getcury test: bs chgat demo_altkeys demo_defkey edit_field foldkeys movewindow ncurses redraw testcurs
302 getmaxx test: chgat movewindow ncurses newdemo redraw testcurs
303 getmaxy test: chgat demo_forms movewindow ncurses newdemo redraw testcurs
304 getmouse test: bs knight movewindow ncurses
306 getnstr test: filter ncurses
307 getparx test: movewindow
308 getpary test: movewindow
312 has_colors test: background bs cardfile chgat color_set demo_forms demo_menus echochar filter firework gdc hanoi ins_wide inserts knight ncurses newdemo rain tclock testcurs view worm xmas
316 hline test: gdc ncurses
319 idlok test: ncurses testscanw view
327 init_color test: ncurses
328 init_pair test: background blue bs cardfile chgat color_set demo_forms demo_menus echochar filter firework gdc hanoi ins_wide inserts knight ncurses newdemo rain tclock testaddch testcurs view worm xmas
329 initscr test: background blue bs cardfile chgat color_set demo_defkey demo_forms demo_keyok demo_menus echochar firework firstlast gdc hanoi hashtest ins_wide inserts knight lrtest movewindow ncurses newdemo rain redraw tclock testaddch testcurs testscanw view worm xmas
332 ins_nwstr test: ins_wide
333 ins_wch test: ins_wide
334 ins_wstr test: ins_wide
335 insch test: ins_wide inserts
338 insnstr test: inserts
341 intrflush test: demo_forms movewindow
343 is_linetouched lib: form
345 is_wintouched lib: ncurses
347 key_defined test: demo_defkey foldkeys
348 key_name test: ncurses
349 keybound test: demo_altkeys demo_defkey
350 keyname test: demo_altkeys demo_defkey demo_keyok demo_menus edit_field foldkeys keynames movewindow ncurses redraw testcurs view progs: tic
351 keyok test: demo_keyok foldkeys
352 keypad test: bs cardfile chgat demo_altkeys demo_defkey demo_forms demo_keyok demo_menus edit_field filter firework foldkeys hashtest ins_wide inserts keynames knight lrtest movewindow ncurses redraw tclock testcurs testscanw view
353 killchar lib: ncurses
356 longname test: testcurs progs: tput
361 mousemask test: bs demo_menus knight movewindow ncurses
362 move test: blue bs cardfile chgat demo_altkeys demo_menus echochar foldkeys gdc hanoi hashtest ins_wide inserts knight lrtest movewindow ncurses testscanw view worm xmas
363 mvadd_wch test: ncurses
366 mvaddch test: bs gdc hanoi lrtest ncurses rain tclock xmas
367 mvaddchnstr test: gdc
371 mvaddstr test: bs demo_forms gdc hanoi knight ncurses rain tclock testcurs xmas
376 mvderwin test: movewindow
383 mvhline test: ncurses
384 mvhline_set test: ncurses
393 mvins_nwstr test: ins_wide
394 mvins_wch test: ins_wide
395 mvins_wstr test: ins_wide
396 mvinsch test: ins_wide inserts
397 mvinsnstr test: inserts
398 mvinsstr test: inserts
401 mvprintw test: bs demo_menus firework hanoi ncurses tclock view
403 mvvline test: ncurses
404 mvvline_set test: ncurses
406 mvwadd_wchnstr lib: form
408 mvwaddch test: movewindow newdemo testcurs xmas
411 mvwaddnstr test: newdemo testcurs
413 mvwaddstr test: firstlast ins_wide inserts knight ncurses newdemo testcurs xmas
416 mvwdelch test: ncurses
423 mvwhline test: movewindow
425 mvwin test: cardfile demo_menus movewindow testcurs xmas
427 mvwin_wchnstr lib: form
429 mvwinch test: newdemo testcurs
432 mvwinnstr test: testcurs
434 mvwins_nwstr test: ins_wide
435 mvwins_wch test: ins_wide
436 mvwins_wstr test: ins_wide
437 mvwinsch test: ins_wide inserts
438 mvwinsnstr test: inserts
439 mvwinsstr test: inserts testcurs
442 mvwprintw test: chgat ncurses testcurs
443 mvwscanw test: testcurs
444 mvwvline test: ins_wide inserts movewindow
446 napms test: dots echochar firework gdc hanoi lrtest ncurses newdemo railroad rain tclock testcurs view worm xmas progs: tset
447 newpad test: edit_field ncurses testcurs
449 newterm test: demo_altkeys ditto filter foldkeys gdc keynames
450 newwin test: cardfile chgat demo_defkey demo_forms demo_keyok demo_menus edit_field firstlast ins_wide inserts knight movewindow ncurses newdemo redraw testcurs xmas
451 nl test: demo_forms ncurses rain testcurs
452 nocbreak test: testcurs
453 nodelay test: firework gdc lrtest ncurses newdemo rain tclock view xmas
454 noecho test: background bs cardfile chgat color_set demo_altkeys demo_defkey demo_forms demo_keyok demo_menus ditto firework firstlast foldkeys gdc hanoi hashtest ins_wide inserts knight lrtest movewindow ncurses rain redraw tclock testcurs view worm xmas
456 nonl test: bs demo_forms hashtest movewindow ncurses view worm xmas
458 noraw test: demo_forms demo_menus ncurses testcurs
460 numcodes progs: dump_entry
461 numfnames progs: dump_entry
462 numnames progs: dump_entry infocmp
464 overlay test: ncurses testcurs xmas
465 overwrite test: ncurses
466 pair_content test: background color_set
469 pnoutrefresh test: edit_field ncurses
470 prefresh test: testcurs
471 printw test: background blue bs color_set demo_altkeys demo_defkey demo_keyok demo_menus filter foldkeys ncurses testcurs testscanw view
475 raw test: demo_forms ncurses redraw testcurs
476 redrawwin test: redraw
477 refresh test: blue bs demo_defkey demo_forms demo_keyok demo_menus ditto echochar filter firstlast gdc hanoi hashtest lrtest movewindow ncurses tclock testcurs view worm xmas
478 reset_prog_mode test: filter ncurses
479 reset_shell_mode test: bs filter
481 resize_term test: view
482 resizeterm lib: ncurses
484 ripoffline test: demo_menus ncurses
486 scanw test: testcurs testscanw
492 scroll test: testcurs
493 scrollok test: demo_altkeys demo_defkey demo_keyok ditto foldkeys hashtest knight ncurses redraw testcurs testscanw view
494 set_curterm lib: ncurses
496 setcchar test: ins_wide ncurses view
498 setupterm test: dots progs: clear tput tset
503 slk_attroff lib: ncurses
504 slk_attron lib: ncurses
506 slk_clear test: ncurses
507 slk_color test: ncurses
508 slk_init test: ncurses
509 slk_label test: ncurses
510 slk_noutrefresh test: ncurses
511 slk_refresh test: ncurses
512 slk_restore test: ncurses
513 slk_set test: ncurses
514 slk_touch test: ncurses
515 slk_wset test: ncurses
516 standend test: blue gdc ncurses worm
517 standout test: blue ncurses
518 start_color test: background blue bs cardfile chgat color_set demo_forms demo_menus echochar filter firework gdc hanoi ins_wide inserts knight ncurses newdemo rain tclock testaddch testcurs view worm xmas
519 stdscr test: bs chgat demo_altkeys demo_forms demo_menus ditto filter firework foldkeys gdc hanoi hashtest ins_wide inserts keynames knight lrtest movewindow ncurses rain redraw tclock testcurs testscanw view xmas
520 strcodes progs: dump_entry
521 strfnames progs: dump_entry
522 strnames test: foldkeys progs: dump_entry infocmp tic
523 subpad test: testcurs
524 subwin test: movewindow ncurses newdemo testcurs
526 term_attrs test: ncurses
527 termattrs test: ncurses testcurs
528 termname test: testcurs
529 tgetent test: demo_termcap railroad
530 tgetflag test: demo_termcap
531 tgetnum test: demo_termcap railroad
532 tgetstr test: demo_termcap railroad
534 tigetflag progs: tput
535 tigetnum test: ncurses progs: tput
536 tigetstr test: blue demo_defkey foldkeys testcurs progs: tput
538 touchline test: chgat
539 touchwin test: chgat demo_menus edit_field filter firstlast ins_wide inserts movewindow ncurses redraw xmas
540 tparm test: dots progs: tic tput
541 tputs test: dots railroad progs: clear tset
542 trace test: demo_menus hanoi hashtest lrtest ncurses testcurs view worm
544 typeahead test: testcurs
545 unctrl test: ncurses redraw testcurs
547 ungetch test: bs knight
550 use_default_colors test: filter firework gdc hanoi knight ncurses rain tclock worm xmas
552 use_extended_names progs: infocmp tic
558 vline test: gdc ncurses
562 vwprintw test: movewindow
564 wadd_wch lib: ncurses
565 wadd_wchnstr lib: form
567 waddch test: demo_forms firstlast knight ncurses
568 waddchnstr lib: ncurses
571 waddnwstr test: ncurses
572 waddstr test: chgat demo_forms edit_field firstlast ins_wide knight ncurses redraw testcurs
573 waddwstr test: ins_wide
575 wattr_off lib: ncurses
576 wattr_on lib: ncurses
578 wattroff test: demo_forms ncurses testcurs xmas
579 wattron test: testcurs xmas
580 wattrset test: demo_forms ncurses newdemo testcurs xmas
581 wbkgd test: cardfile demo_forms demo_menus ncurses newdemo testcurs
582 wbkgdset test: ins_wide inserts ncurses
584 wbkgrndset lib: ncurses
586 wborder_set lib: ncurses
587 wchgat test: chgat view
588 wclear test: ncurses testcurs
589 wclrtobot test: firstlast ncurses testcurs
590 wclrtoeol test: chgat demo_defkey demo_keyok firstlast ins_wide inserts knight ncurses testcurs
591 wcolor_set lib: ncurses
593 wdelch test: ncurses testcurs
594 wdeleteln test: testcurs
595 wecho_wchar lib: ncurses
596 wechochar lib: ncurses
598 werase test: cardfile demo_forms demo_menus edit_field firstlast knight ncurses newdemo testcurs xmas
599 wget_wch test: ins_wide ncurses
601 wgetbkgrnd lib: ncurses
602 wgetch test: cardfile chgat demo_defkey demo_keyok demo_menus edit_field gdc inserts knight movewindow ncurses newdemo redraw testcurs
603 wgetn_wstr test: ncurses
604 wgetnstr test: ncurses
606 whline test: testcurs
607 whline_set lib: ncurses
609 win_wchnstr lib: form
611 winch test: knight testcurs
612 winchnstr lib: ncurses
614 winnstr test: demo_altkeys demo_defkey foldkeys
615 winnwstr lib: ncurses
616 wins_nwstr test: ins_wide
617 wins_wch test: ins_wide
618 wins_wstr test: ins_wide
619 winsch test: ins_wide inserts testcurs
620 winsdelln lib: ncurses
621 winsertln test: testcurs
622 winsnstr test: inserts
623 winsstr test: inserts
626 wmouse_trafo lib: menu
627 wmove test: chgat demo_altkeys demo_defkey demo_keyok demo_menus firstlast foldkeys ins_wide inserts knight movewindow ncurses newdemo redraw testcurs
628 wnoutrefresh test: demo_menus edit_field ins_wide inserts knight movewindow ncurses redraw
629 wprintw test: chgat demo_defkey demo_forms demo_keyok demo_menus edit_field ins_wide inserts knight movewindow ncurses testcurs
630 wredrawln test: redraw
631 wrefresh test: chgat demo_forms demo_keyok demo_menus edit_field firstlast knight lrtest movewindow ncurses newdemo redraw tclock testcurs view xmas
632 wresize test: cardfile ncurses
633 wscanw test: testcurs
634 wscrl test: ncurses testcurs view
635 wsetscrreg test: ncurses testcurs
638 wsyncdown test: movewindow
640 wtimeout test: ncurses
641 wtouchln lib: ncurses
643 wvline test: testcurs
644 wvline_set lib: ncurses
648 bottom_panel test: ncurses
649 del_panel test: ncurses
650 hide_panel test: ncurses
651 move_panel test: ncurses
652 new_panel test: cardfile ncurses
656 panel_userptr test: ncurses
657 panel_window test: cardfile ncurses
659 set_panel_userptr test: ncurses
660 show_panel test: ncurses
661 top_panel test: cardfile ncurses
662 update_panels test: cardfile ncurses