201 lines
5.3 KiB
Plaintext
201 lines
5.3 KiB
Plaintext
The Factor programming language
|
|
-------------------------------
|
|
|
|
This file covers installation and basic usage of the Factor
|
|
implementation. It is not an introduction to the language itself.
|
|
|
|
* Contents
|
|
|
|
- Platform support
|
|
- Compiling the Factor VM
|
|
- Bootstrapping the Factor image
|
|
- Running Factor on Unix with X11
|
|
- Running Factor on Mac OS X - Cocoa UI
|
|
- Running Factor on Mac OS X - X11 UI
|
|
- Running Factor on Windows
|
|
- Command line usage
|
|
- Source organization
|
|
- Community
|
|
- Credits
|
|
|
|
* Platform support
|
|
|
|
Factor supports the following platforms:
|
|
|
|
Linux/x86
|
|
Linux/AMD64
|
|
Linux/PowerPC
|
|
Linux/ARM
|
|
Mac OS X/x86
|
|
Mac OS X/PowerPC
|
|
FreeBSD/x86
|
|
FreeBSD/AMD64
|
|
OpenBSD/x86
|
|
Solaris/x86
|
|
Solaris/AMD64
|
|
MS Windows (XP and above)
|
|
|
|
Please donate time or hardware if you wish to see Factor running on
|
|
other platforms. In particular, we are interested in:
|
|
|
|
Windows/AMD64
|
|
Mac OS X/AMD64
|
|
Windows CE/ARM
|
|
Solaris/UltraSPARC
|
|
|
|
* Compiling the Factor VM
|
|
|
|
The Factor runtime is written in GNU C99, and is built with GNU make and
|
|
gcc.
|
|
|
|
Factor requires gcc 3.4 or later. On x86, it /will not/ build using gcc
|
|
3.3 or earlier.
|
|
|
|
Run 'make' (or 'gmake' on non-Linux platforms) with no parameters to see
|
|
a list of targets. Then run 'make' with the appropriate target for your
|
|
platform.
|
|
|
|
The following options can be given to make:
|
|
|
|
SITE_CFLAGS="..."
|
|
DEBUG=1
|
|
|
|
The former allows optimization flags to be specified, for example
|
|
"-march=pentium4 -ffast-math -O3". Nowadays most of the hard work is
|
|
done by Factor compiled code, so optimizing the runtime is not that
|
|
important. Usually the defaults are fine.
|
|
|
|
The DEBUG flag disables optimization and builds an executable with
|
|
debug symbols. This is probably only of interest to people intending to
|
|
hack on the runtime sources.
|
|
|
|
Compilation may print a handful of warnings about singled/unsigned
|
|
comparisons. They may safely be ignored.
|
|
|
|
Compilation will yield an executable named 'f' on Unix and 'f.exe' on
|
|
Windows.
|
|
|
|
* Bootstrapping the Factor image
|
|
|
|
The boot images are no longer included with the Factor distribution
|
|
due to size concerns. Instead, download a boot image from:
|
|
|
|
http://factorcode.org/images/
|
|
|
|
Once you have compiled the Factor runtime, you must bootstrap the Factor
|
|
system using the image that corresponds to your CPU architecture.
|
|
|
|
Once you download the right image, bootstrap the system with the
|
|
following command line:
|
|
|
|
./f -i=boot.image.<foo>
|
|
|
|
Bootstrap can take a while, depending on your system. When the process
|
|
completes, a 'factor.image' file will be generated. Note that this image
|
|
is both CPU and OS-specific, so in general cannot be shared between
|
|
machines.
|
|
|
|
* Running Factor on Unix with X11
|
|
|
|
On Unix, Factor can either run a graphical user interface using X11, or
|
|
a terminal listener.
|
|
|
|
If your DISPLAY environment variable is set, the UI will start
|
|
automatically:
|
|
|
|
./f
|
|
|
|
To run an interactive terminal listener:
|
|
|
|
./f -shell=tty
|
|
|
|
If you're inside a terminal session, you can start the UI with one of
|
|
the following two commands:
|
|
|
|
ui
|
|
[ ui ] in-thread
|
|
|
|
The latter keeps the terminal listener running.
|
|
|
|
* Running Factor on Mac OS X - Cocoa UI
|
|
|
|
On Mac OS X 10.4 and later, a Cocoa UI is available in addition to the
|
|
terminal listener. If you are using Mac OS X 10.3, you can only run the
|
|
X11 UI, as documented in the next section.
|
|
|
|
The 'f' executable runs the terminal listener:
|
|
|
|
./f
|
|
|
|
The Cocoa UI requires that after bootstrapping you build the Factor.app
|
|
application bundle:
|
|
|
|
make macosx.app
|
|
|
|
This copies the runtime executable into Factor.app. Note that Factor.app
|
|
is not self-contained, and must be run from the same directory which
|
|
contains factor.image and the library sources.
|
|
|
|
* Running Factor on Mac OS X - X11 UI
|
|
|
|
The X11 UI is available on Mac OS X, however its use is not recommended
|
|
since it does not integrate with the host OS. However, if you are
|
|
running Mac OS X 10.3, it is your only choice.
|
|
|
|
When compiling Factor, pass the X11=1 parameter:
|
|
|
|
make macosx-ppc X11=1
|
|
|
|
Then bootstrap with the following pair of switches:
|
|
|
|
./f -i=boot.image.ppc -no-cocoa -x11
|
|
|
|
Now if $DISPLAY is set, running ./f will start the UI.
|
|
|
|
* Running Factor on Windows
|
|
|
|
If you did not download the binary package, you can bootstrap Factor in
|
|
the command prompt:
|
|
|
|
f.exe -i=boot.image.pentium4 (or boot.image.x86)
|
|
|
|
Once bootstrapped, double-clicking f.exe starts the Factor UI.
|
|
|
|
To run the listener in the command prompt:
|
|
|
|
f.exe -shell=tty
|
|
|
|
* Command line usage
|
|
|
|
The Factor VM supports a number of command line switches. To read
|
|
command line usage documentation, either enter the following in the UI
|
|
listener,
|
|
|
|
"cli" help
|
|
|
|
Or visit <http://factorcode.org/responder/help/show-help?topic=cli>.
|
|
|
|
* Source organization
|
|
|
|
The following four directories are managed by the module system; consult
|
|
the documentation for details:
|
|
|
|
apps/ - user-contributed applications
|
|
libs/ - user-contributed libraries
|
|
demos/ - small examples illustrating various language features
|
|
core/ - sources for the library, written in Factor
|
|
fonts/ - TrueType fonts used by UI
|
|
vm/ - sources for the Factor runtime, written in C
|
|
|
|
* Community
|
|
|
|
The Factor homepage is located at <http://factorcode.org/>.
|
|
|
|
Factor developers meet in the #concatenative channel on the
|
|
irc.freenode.net server. Drop by if you want to discuss anything related
|
|
to Factor or language design in general.
|
|
|
|
Have fun!
|
|
|
|
:tabSize=2:indentSize=2:noTabs=true:
|