-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathREADME.TXT
103 lines (60 loc) · 2.62 KB
/
README.TXT
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
##
## 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 <[email protected]>
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.