Introduction
============

This procedure is intended to explain how to run ComputerEngineer.pl on your computer.
Scope
============

The procedure currently covers Windows Linux and Mac  (No Smart Phones... Yet).
Pre Procedure
============

Download ComputerEngineer.pl and extract it to a directory on your computer.
Procedure
============

Windows Users:

Install Strawberry Perl on your system (use THIS link).
When done Go to start -> run and type "cmd".
In the command window type 'cpan' (your prompt would change to something like 'CPAN>').
In CPAN prompt type "install Term::ReadKey" and press ENTER
Wait until its done.
When done you are ready - for simple usage just double click "ComputerEngineer.pl" (the file that you have downloaded).

Linux or Mac Users:

You guys probably already have perl installed (find out by typing "perl -v" in your terminal window).
If you don't ( not likely ) install perl ( apt-get install perl for ubuntu , yum install perl for fedora or use THIS link for Mac).
Now that you have perl installed - install the Term::ReadKey perl module
Open your terminal , and type 'cpan' .
If you have not set CPAN yet - accept default to all prompts (type enter to all ).
(your prompt would change to something like 'CPAN>' ).
In CPAN prompt type "install Term::ReadKey" and press ENTER .
Wait until its done .
Now make sure that the ComputerEngineer.pl file you have downloaded is executable
if not just open a terminal , cd to its directory and run "chmod +x ComputerEngineer.pl".
Now you are ready - for simple usage just run it from terminal as ( /full/path/to/ComputerEngineer.pl ).
More complex execution
============

General

This section is intended to provide more complex operations of ComputerEngineer.pl , So if you are a Windows user you probably want to stop here .
If you are still here , then that's where the fun part begins .
To run ComputerEngineer.pl with more complex operations you need to work from terminal (Linux or Mac) or command prompt (Windows).
Command Options and their meaning :

ComputerEngineer.pl accepts the bellow options in the order they are presented ONLY !
help - to display program usage
phos=[y/n] - y (yes ) if you run it under phosphor (will be explained later ) and n (no) if you do not .
delay= - the number must be a full integer (no floating point ) that would control the display speed (0 = fast ... onwards will be ... less fast , 5 is the default ) , NOTE that if you are running under phosphor - you should set the delay to "0" .
cont=[y/n] - y (yes) if you want to control the display yourself , n (no) if you want it to display automatically with no human intervention , If you chose to control the display (cont=y) the program would stop after each line and wait until you hit any key (if you are searching for an any key , you should have stopped in the beginning of this sections .
As a rule you can run the program by typing its name (ComputerEngineer.pl) if you placed it under your search path , if you do not know what I am talking about ,try running it from command line with no arguments , if you succeeded , it is in your search path , if not than on Windows you have to "cd" to the directory where you placed the program and on Linux you have to run it by its full path .
Here are some examples .
#> ComputerEngineer.pl phos=n delay=5 cont=n # This is the command default - it is equivalent to running ComputerEngineer.pl (or to double clicking it )
#> ComputerEngineer.pl phos=y delay=0 cont=y # This is the correct way to run it under phosphor (explained in the next bulit )
#> ComputerEngineer.pl phos=n delay=3 cont=y # This would display a character at a time - quite fast and it would stop each line and wait for you to press any key . Running under phosphore (Linux Only)

If you are running under Linux you mite want to check this .
If you have installed the xscreensaver-gl package then you have a "screensaver" called "phosphor" (Yeah , the one that this project was made with ) .
Phosphor is located in "/usr/lib/xscreensaver/phosphor" , if not use "locate" to ... locate it ...
Phosphor can receive command line arguments (-scale , -tick , -geom , -delay , -program)
While you should read the manual for phosphor to better understand how to run it you can see that it receives -program as an argument , it was intended so that you would be able to provide it a command that display files which it would print . So instead of a program like "cat" or "find" , you can enter bash - and it would become a VT100 terminal emulator .
You can control phosphor behavior with "delay" and "geometry" and "scale" - see manual for details .
Phosphor takes file inputs one line at a time and displays it one character at a time , so if you want to run ComputerEngineer under phosphor - provide the phos=y option , so it will receive one line at a time and not one character at a time .

Instruction :
Open Console
Run the bellow in Console Window
#> /usr/lib/xscreensaver/phosphor -scale 2 -tick 3 -geom =1280x1024 -delay 35000 -program bash
Once phosphor provides you with a prompt - start ComputerEngineer.pl with the following options:
#> /path/to/ComputerEngineer.pl phos=y delay=0 cont=y
Enjoy


on , so it will receive one line at a time and not one character at a time .

Instruction :
Open Console
Run the bellow in Console Window
#> /usr/lib/xscreensaver/phosphor -scale 2 -tick 3 -geom =1280x1024 -delay 35000 -program bash
Once phosphor provides you with a prompt - start ComputerEngineer.pl with the following options:
#> /path/to/ComputerEngineer.pl phos=y delay=0 cont=y
Enjoy