-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy pathREADME.txt
196 lines (119 loc) · 5.09 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
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
Alore ReadMe
============
What is Alore?
--------------
Alore is an object-oriented general-purpose programming language that aims to
combine the convenience and ease of Python with an optional static type system
and a clean and elegant design.
License
-------
Alore is licensed under the terms of the MIT license. See the file
LICENSE.txt in the distribution.
Quick start (Linux, OS X, Unix-like)
------------------------------------
To get started in a Unix-like operating system, clone the Alore git repository
or download a source tarball and type
./configure
make
You need a basic C development tool chain for the build.
You can now run the Alore interpreter as ./alore. To also install Alore
under /usr/local:
su root
make install
(or "sudo make install", depending on your configuration)
Now you can run an Alore program using the Alore interpreter:
alore program.alo
Quick start (Windows)
---------------------
The easiest way to use Alore in Windows is to download the Windows installer
from http://www.alorelang.org/ and use it to install Alore.
You may also wish to add c:\Alore to your PATH (assuming you used the default
target folder when installing). Do it like this in Command prompt:
C:\>set path=%path%;c:\alore
Now you can run an Alore program using the Alore interpreter:
C:\Work>alore program.alo
Building from source code (Windows)
-----------------------------------
Alternatively, you can build Alore from source code:
1. Install MinGW and MSYS (http://www.mingw.org/). These are free software
products that provide the GCC C compiler and a lightweight Unix-like build
environment for Windows.
2. Start MSYS shell.
3. Change to the source package root directory (that also contains
README.txt).
4. Type "./configure" (without the quotes, and followed by Enter). This
builds the Makefile.
5. Type "make" to build Alore.
You can now run the Alore interpreter as "alore". To also install Alore
under c:\Alore:
6. Type "make install".
Documentation
-------------
The documentation for the latest Alore release is available online at
http://www.alorelang.org/doc/.
You can build the documentation from sources using make:
make doc
The documentation is generated in directory doc/html.
Syntax highlighting in editors
------------------------------
The Alore Wiki explains how to enable Alore syntax highlighting in several
popular text editors:
https://github.com/JukkaL/alore/wiki/Editor-support-for-alore
Release notes
-------------
Alore is still pre-beta software. Although Alore developers try to avoid
unnecessary changes that break compatibility, this may happen occasionally.
Documentation may not always be up-to-date.
See also "Known bugs and limitations" below and the issue tracker.
Software requirements
---------------------
Alore has been successfully compiled and run on at least the following
operating systems:
* Linux (several distributions; 32-bit and 64-bit)
* Windows 7, Windows Vista and Windows XP (32-bit)
* Mac OS X (64-bit)
* OpenSolaris (32-bit)
* FreeBSD (32-bit)
The following tools are recommended for building Alore under Windows:
* MinGW (Minimalist GNU for Windows)
* MSYS (shell environment for Windows, part of the MinGW distribution)
On other operating systems, the standard C build environment is supported.
Discussion and feedback
-----------------------
Send any questions or comments about Alore and suggestions for future
improvements to the Alore mailing list:
https://groups.google.com/group/alorelang
Reporting bugs
--------------
Submit bug reports using the Alore issue tracker:
https://github.com/JukkaL/alore/issues
Credits
-------
Alore was conceived, designed and implemented by Jukka Lehtosalo, with help
and useful comments from many people; see the file CREDITS.txt for a list of
contributors.
Running tests
-------------
To run Alore test cases, first build Alore and then type (in the shell)
make test
Alore compiler
--------------
You can package the source files of a program and the Alore interpreter into
a single binary using the alorec tool:
alorec program.alo
This creates the executable "program" (or "program.exe"). You need to have
a supported C compiler (gcc) installed and in your PATH.
In Windows you can use MinGW (see above); you may have to add C:\MinGW\bin to
your PATH (the exact location of MinGW files may differ in your configuration):
C:\>set path=%path%;c:\mingw\bin
NOTE: The source code of your program is directly included in the generated
executable file.
Known bugs and limitations
--------------------------
A partial list of major bugs and limitations in the current Alore release:
* not much testing on some supported operating systems
* big-endian architectures not tested
* incomplete support for 64-bit operating systems
* 64-bit Windows builds not tested
* limited support for non-ASCII paths and file names
* file owner information cannot be accessed in Windows