README

This is the top level README file.
This directory is structured as follows:

ncurses
   |
   |----> JustForFun         -- just for fun programs
   |----> basics             -- basic programs
   |----> demo               -- output files go into this directory after make
   |          |
   |          |----> exe     -- exe files of all example programs
   |----> forms              -- programs related to form library
   |----> menus              -- programs related to menus library
   |----> panels             -- programs related to panels library
   |----> perl               -- perl equivalents of the examples (contributed
   |                            by Anuradha Ratnaweera)
   |----> Makefile           -- the top level Makefile
   |----> README             -- the top level README file. contains instructions
   |			             -- to create executables for example programs

To compile and install all example programs, just run make in this directory.
	
	make

It installs all the exe files in demo/exe directory. You can go to that direcory
and see the examples in action.

Have Fun !!!
					-- Pradeep Padala

Description of files in each directory
--------------------------------------
JustForFun
    |
    |----> hanoi.c	-- The Towers of Hanoi Solver
    |----> life.c	-- The Game of Life demo
    |----> magic.c	-- An Odd Order Magic Square builder 
    |----> queens.c	-- The famous N-Queens Solver
    |----> shuffle.c	-- A fun game, if you have time to kill
    |----> tt.c		-- A very trivial typing tutor

  basics
    |
    |----> acs_vars.c	    -- ACS_ variables example
    |----> hello_world.c	-- Simple "Hello World" Program
    |----> init_func_example.c	-- Initialization functions example
    |----> key_code.c		-- Shows the scan code of the key pressed
    |----> mouse_menu.c		-- A menu accessible by mouse
    |----> other_border.c	-- Shows usage of other border functions apart
    |				        -- box()
    |----> printw_example.c	-- A very simple printw() example
    |----> scanw_example.c	-- A very simple getstr() example
    |----> simple_attr.c	-- A program that can print a c file with comments
    |				-- in attribute
    |----> simple_color.c	-- A simple example demonstrating colors
    |----> simple_key.c		-- A menu accessible with keyboard UP, DOWN arrows
    |----> temp_leave.c		-- Demonstrates temporarily leaving curses mode
    |----> win_border.c		-- Shows Creation of windows and borders
    |----> with_chgat.c		-- chgat() usage example

  forms 
    |
    |----> form_attrib.c	-- Usage of field attributes
    |----> form_options.c	-- Usage of field options
    |----> form_simple.c	-- A simple form example
    |----> form_win.c		-- Demo of windows associated with forms

  menus 
    |
    |----> menu_attrib.c	-- Usage of menu attributes
    |----> menu_item_data.c	-- Usage of item_name() etc.. functions
    |----> menu_multi_column.c	-- Creates multi columnar menus
    |----> menu_scroll.c	-- Demonstrates scrolling capability of menus
    |----> menu_simple.c	-- A simple menu accessed by arrow keys
    |----> menu_toggle.c	-- Creates multi valued menus and explains
    |				-- REQ_TOGGLE_ITEM
    |----> menu_userptr.c	-- Usage of user pointer
    |----> menu_win.c		-- Demo of windows associated with menus

  panels 
    |
    |----> panel_browse.c	-- Panel browsing through tab. Usage of user pointer
    |----> panel_hide.c		-- Hiding and Un hiding of panels
    |----> panel_resize.c	-- Moving and resizing of panels
    |----> panel_simple.c	-- A simple panel example
 
  perl
    |----> 01-10.pl	        -- Perl equivalents of first ten example programs