        	   The UConio Official Tutorial v0.0.5b
		   ~~~ ~~~~~~ ~~~~~~~~ ~~~~~~~~ ~~~~~~~
                 By Pablo J. Vidal <pablo@pablovidal.org>

LAST UPDATE: Tue Sep 19 22:49:09 ART 2000

                    
		         ||||||||||||||||||||
				INDEX
    
		         1. PREFACE
	 	         2. INTRODUCTION
	                 3. INSTALLING UCONIO
		         4. USING UCONIO
		         5. AUTHOR
		         6. LICENSE

                         ||||||||||||||||||||
    
    
-PREFACE
 ~~~~~~~		   
    Hello, my name is Pablo Vidal and i am the UConio programmer.
    I just wanna to thanks to my family, to my dear friends of
    ever, and to every single girl with i shared my love, and
    obviously to God.
 
    Pablo J. Vidal <pablo@pablovidal.org>
  
			    ....................

-INTRODUCTION
 ~~~~~~~~~~~~
    UConio is the implementation of Borland's Console Input/Output
    Header (CONIO) to Unix, but with some extra features it isn't
    in CONIO header.
    With this library you can port your CONIO programs to Unix
    systems simply prefixing an "u_" to the CONIO function.
    This is an Easy to learn library, because if you know how
    to code with CONIO, then you already know how to do with
    UConio; otherwise, if you don't know how to code with CONIO, 
    you go to learn UConio using this cute tutorial, reading the
    UConio Manpages and reading the UConio Examples.

    [NOTE]-[ This tutorial is for use in conjuction with the manpages ]
    
			    ....................
			    
-INSTALLING UCONIO
 ~~~~~~~~~~~~~~~~~			    
    To install sucessfully the UConio Library, you must accomplish
    with this requirements:
    
	*Any version of GNU C Compiler (GCC)
	*An ANSI capable terminal (like VT100)
	*An Unix system (like GNU/Linux)
	*Any version of GNU Make 
	*Any version of GNU Libc (GLIBC)
	
    If you accomplish with this requirements, you are ready to 
    compile and install the UConio Library.
    You must follow this steps:
    
	*> First, untar the UConio tarball, like this:
	    $ tar xvfz UConio-x.x.x-PR.tar.gz
		(NOTE: where 'x' goes the version number)
	
	*> Then, change to the newly UConio directory:
	    $ cd UConio-x.x.x-PR
	    
	*> Now you must type 'make' to compile the library:
	    $ make
	    
	*> Now, you must switch to root (or an equivalent) to 
	   install the library:
	    $ su
	
	*> Here, type 'make install' to install and configure the
	   UConio shared library:
	    # make install
	
    If the installation have no errors, UConio was compiled and
    installed sucessfully in your Unix Box.		

			    ....................
    
-USING UCONIO:
 ~~~~~~~~~~~~
    Now is the time to learn how to use UConio in your programs.
    First, you must know the currently working UConio Functions
    and for what they are:
    
	[*] u_clrscr()     -  Clear the Screen
	[*] u_beep()       -  Play a single or more beeps
	[*] u_gotoxy()     -  Move the cursor along the screen
	[*] u_textcolor()  -  Change the Text Colour
	[*] u_textattr()   -  Change the Text attributes
	[*] u_wherex()     -  Get the current 'x' position
	[*] u_wherey()     -  Get the current 'y' position
	[*] u_getch()      -  Gets a single character from the stdin
	[*] u_getche()     -  Gets and echo a single char from stdin to stdout
	[*] u_normvideo()  -  Reset the video attributes to defaults
	[*] u_clreol()     -  Clear the characters to the end of the line
	[*] u_puttext()    -  Create a BOX and put characters inside
	
    Now you must know each UConio function declaration (see uconio.h):
    
        void u_clrscr(void);
	void u_beep(register int times);
	void u_gotoxy(short x, short y);
	void u_textcolor(short int bg, short int fg);
	void u_textattr(register int attri);
	short int u_wherex(void);
	short int u_wherey(void);
	int u_getch(void);
	int u_getche(void);
	void u_normvideo(void);
	void u_clreol(void);
	int u_puttext(int left, int top, int right, int bottom, char *string);
	void u_vputc(char *format, ...);
	
    Well, now you know what functions are in UConio and they declaration,
    now you must know how to make an UConio program:
    
    First you must include the uconio header into your program:
    
	#include <uconio.h>
	
    And then, you must write the main block and inside the UConio
    functions.
    If you wanna know how to use each function , see the UConio
    Manpages (man uconio).
    To compile an UConio program, use this syntax:
    
	$ gcc -o <binary> -s <source> -luconio

    The '-luconio' parameter means that call uconio as a shared
    library.
    
			    ....................
			    
-AUTHOR
 ~~~~~~
    The author of this library is Pablo J. Vidal, an asiduous
    programmer from Argentina who has almost seventeen years
    old.
    The author was born in Buenos Aires, Argentina in the
    afternoon of the twenty first of September on 1983.
    He is an Unix phana-geek, he abuses of Mandrake Linux
    and likes also Debian.
    He loves all the GNU philosophy, and his idols are
    Richard Stallman, Richard Stevens, Linus Torvalds,
    Alan Cox, Miguel Icaza, tigert and Ian Jackson.
    His nickname is [Hellraiser], a proud member of
    Ezkracho and RaZa MeXiCaNa.
    
    E-Mail: pablo@pablovidal.org
    URL: www.pablovidal.org
    
			    ....................
			    
-LICENSE
 ~~~~~~~
    This library preaches the GNU/GPL user terms.
    For further information about the license, see
    the COPYING file into 'doc' directory at
    UConio root source directory.
    
    