##
## The Programmers Scroll
##
If you learn a new programming language it can be painfull because you know already one. But within the new one all is just a little bit different from
what you already know. - Would it be nice to have just a little note: How
do I XY in Perl and PHP side by side?
How do I XY in C and C# side by side?
Usefull for programmers on Windows, Mac OS X and Linux, etc. with C/C++, PHP, Perl, C#, etc. (put your own language here).
Target: To have little code snippets for every day usage - just copy&paste and share it from PDF or .txt files!
The Programmers Scroll is released by Michael Mustun <michael.mustun@gmail.com>
Based on a very old idea and project of mine the qi (Quick Info) copyright (c) 1990 - 2011 based on simple ASCII-Text source code files and little comments.
CAUTION: Works only on Mac OS X right now. Need to change physical path from /Applications/a2pdf to more common way used also in Windows and Linux systems.
NOTE: This projekt is in a very alpha state. Use at your own risk NO WARRANTY.
This is also experimental project if git can be used for *fast* code knowledge sharing around the globe.
INSTALL
-------
1) Install a2pdf
See http://perl.jonallen.info/projects/a2pdf
On Windows: See homepage. Make sure that a2pdf is in your PATH.
On a Mac: See homeage. Install (just copy) a2pdf.app to the /Applications folder.
On Linux: See homepage.
2) Get the Programmers Scroll
Mac/Lin:
$ git clone git://github.com/flagsoft/Programmers-Scroll
Win: c:\> git ....
3) Use it
Mac:
$ cd ./Programmers-Scroll
$ bash ./doit.sh
Read the generated files in ./perl/*.txt and ./perl/*.pdf.
4) Change or add new files (a "Scroll")
Mac/Lin:
$ cd ./Programmers-Scroll
$ (edit or add some files)
$ git add (files)
$ git commit -m 'Explain what you changed/added'
Use the git manuals and faqs for more information, see: http://git-scm.com/
5) Add your code and or languages and share with many others!
The sky is the limit ;)
USAGE
-----
$ cd ./Programmers-Scroll
$ cd ./perl/ see *.txt and *.pdf files there.
Re-create (compile/run) all files, maybe not all source codes Scrolls are working on your system out of the box.
$ ./doit.sh
Generates .txt and .txt.pdf files.
View the files and happy hacking :)
TODO
----
* Generalize the program.
* Add all programming languages... ;)
* Write a cool tcl/tk GUI for Windows, Linux and Mac OS X. Side-by-side language compare, etc.
* create better PDF output
* make PDF output possible to print a PDF e-book and real book.
Changelog
---------
v0.0.1 (18.OCT.2011) - 1st release on github.com.
## EOF.