Replace README.txt with readme.html
Slava Pestov
parent
978647dc39
commit
a1db31402e
154
README.txt
154
README.txt
|
|
@ -1,154 +0,0 @@
|
||||||
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
|
|
||||||
|
|
||||||
- Compiling the Factor VM
|
|
||||||
- Libraries needed for compilation
|
|
||||||
- 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
|
|
||||||
- The Factor FAQ
|
|
||||||
- Source organization
|
|
||||||
- Community
|
|
||||||
|
|
||||||
* Compiling the Factor VM
|
|
||||||
|
|
||||||
Factor supports various platforms. For an up-to-date list, see
|
|
||||||
<http://factorcode.org>.
|
|
||||||
|
|
||||||
The Factor VM is written in C++ and uses GNU extensions. When compiling
|
|
||||||
with GCC 3.x, boost::unordered_map must be installed. On GCC 4.x, Factor
|
|
||||||
uses std::tr1::unordered_map which is shipped as part of GCC.
|
|
||||||
|
|
||||||
Run 'make' ('gmake' on *BSD) with no parameters to build the Factor VM.
|
|
||||||
|
|
||||||
* Bootstrapping the Factor image
|
|
||||||
|
|
||||||
Once you have compiled the Factor VM, you must bootstrap the Factor
|
|
||||||
system using the image that corresponds to your CPU architecture.
|
|
||||||
|
|
||||||
Boot images can be obtained from <http://factorcode.org/images/latest/>.
|
|
||||||
|
|
||||||
Once you download the right image, bootstrap Factor with the
|
|
||||||
following command line:
|
|
||||||
|
|
||||||
./factor -i=boot.<cpu>.image
|
|
||||||
|
|
||||||
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.
|
|
||||||
|
|
||||||
For X11 support, you need recent development libraries for libc,
|
|
||||||
Pango, X11, and OpenGL. On a Debian-derived Linux distribution
|
|
||||||
(like Ubuntu), you can use the following line to grab everything:
|
|
||||||
|
|
||||||
sudo apt-get install libc6-dev libpango1.0-dev libx11-dev libgl1-mesa-dev
|
|
||||||
|
|
||||||
Note that if you are using a proprietary OpenGL driver, you should
|
|
||||||
probably leave out the last package in the list.
|
|
||||||
|
|
||||||
If your DISPLAY environment variable is set, the UI will start
|
|
||||||
automatically when you run Factor:
|
|
||||||
|
|
||||||
./factor
|
|
||||||
|
|
||||||
To run an interactive terminal listener:
|
|
||||||
|
|
||||||
./factor -run=listener
|
|
||||||
|
|
||||||
* Running Factor on Mac OS X - Cocoa UI
|
|
||||||
|
|
||||||
On Mac OS X, a Cocoa UI is available in addition to the terminal
|
|
||||||
listener.
|
|
||||||
|
|
||||||
The 'factor' executable runs the terminal listener:
|
|
||||||
|
|
||||||
./factor
|
|
||||||
|
|
||||||
The 'Factor.app' bundle runs the Cocoa UI. Note that this is not a
|
|
||||||
self-contained bundle, it 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 also available on Mac OS X, however its use is not
|
|
||||||
recommended since it does not integrate with the host OS.
|
|
||||||
|
|
||||||
When compiling Factor, pass the X11=1 parameter:
|
|
||||||
|
|
||||||
make X11=1
|
|
||||||
|
|
||||||
Then bootstrap with the following switches:
|
|
||||||
|
|
||||||
./factor -i=boot.<cpu>.image -ui-backend=x11
|
|
||||||
|
|
||||||
Now if $DISPLAY is set, running ./factor will start the UI.
|
|
||||||
|
|
||||||
* Running Factor on Windows XP/Vista
|
|
||||||
|
|
||||||
The Factor runtime is compiled into two binaries:
|
|
||||||
|
|
||||||
factor.com - a Windows console application
|
|
||||||
factor.exe - a Windows native application, without a console
|
|
||||||
|
|
||||||
If you did not download the binary package, you can bootstrap Factor in
|
|
||||||
the command prompt using the console application:
|
|
||||||
|
|
||||||
factor.com -i=boot.<cpu>.image
|
|
||||||
|
|
||||||
Once bootstrapped, double-clicking factor.exe or factor.com starts
|
|
||||||
the Factor UI.
|
|
||||||
|
|
||||||
To run the listener in the command prompt:
|
|
||||||
|
|
||||||
factor.com -run=listener
|
|
||||||
|
|
||||||
* The Factor FAQ
|
|
||||||
|
|
||||||
The Factor FAQ is available at the following location:
|
|
||||||
|
|
||||||
<http://concatenative.org/wiki/view/Factor/FAQ>
|
|
||||||
|
|
||||||
* Command line usage
|
|
||||||
|
|
||||||
Factor supports a number of command line switches. To read command line
|
|
||||||
usage documentation, enter the following in the UI listener:
|
|
||||||
|
|
||||||
"command-line" about
|
|
||||||
|
|
||||||
* Source organization
|
|
||||||
|
|
||||||
The Factor source tree is organized as follows:
|
|
||||||
|
|
||||||
build-support/ - scripts used for compiling Factor
|
|
||||||
vm/ - Factor VM
|
|
||||||
core/ - Factor core library
|
|
||||||
basis/ - Factor basis library, compiler, tools
|
|
||||||
extra/ - more libraries and applications
|
|
||||||
misc/ - editor modes, icons, etc
|
|
||||||
unmaintained/ - unmaintained contributions, please help!
|
|
||||||
|
|
||||||
* 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:
|
|
||||||
|
|
@ -0,0 +1,72 @@
|
||||||
|
<html>
|
||||||
|
<head><title>Factor</title></head>
|
||||||
|
|
||||||
|
<body>
|
||||||
|
<h1>The Factor programming language</h1>
|
||||||
|
|
||||||
|
<h2>Getting started</h2>
|
||||||
|
|
||||||
|
<p>If you are reading this README file, you either downloaded a binary
|
||||||
|
package, or checked out Factor sources from the GIT repository.</p>
|
||||||
|
|
||||||
|
<ul>
|
||||||
|
<li><a href="http://concatenative.org/wiki/view/Factor/Getting%20started">Getting started</a></li>
|
||||||
|
<li><a href="http://concatenative.org/wiki/view/Factor/Requirements">System requirements</a></li>
|
||||||
|
<li><a href="http://concatenative.org/wiki/view/Factor/Building%20Factor">Building Factor from source</a> (don't do this if you're using a binary package)</li>
|
||||||
|
</ul>
|
||||||
|
|
||||||
|
<p>To run Factor:<p>
|
||||||
|
|
||||||
|
<ul>
|
||||||
|
<li>Windows: Double-click <code>factor.exe</code>, or run
|
||||||
|
<code>.\factor.com</code> in a command prompt</li>
|
||||||
|
<li>Mac OS X: Double-click <code>Factor.app</code>code> or run <code>open
|
||||||
|
Factor.app</code> in a Terminal</li>
|
||||||
|
<li>Unix: Run <code>./factor</code>code> in a shell</li>
|
||||||
|
</ul>
|
||||||
|
|
||||||
|
<h2>Documentation</h2>
|
||||||
|
|
||||||
|
<p>The Factor environment includes extensive reference documentation and
|
||||||
|
a short "cookbook" to help you get started. The best way to read the
|
||||||
|
documentation is in the UI; press F1 in the UI listener to open the help
|
||||||
|
browser tool. You can also <a href="http://docs.factorcode.org">browse
|
||||||
|
the documentation online</a>.</p>
|
||||||
|
|
||||||
|
<h2>Command line usage</h2>
|
||||||
|
|
||||||
|
<p>Factor supports a number of command line switches. To read command line
|
||||||
|
usage documentation, enter the following in the UI listener:</p>
|
||||||
|
|
||||||
|
<pre>"command-line" about</pre>
|
||||||
|
|
||||||
|
<h2>Source organization</h2>
|
||||||
|
|
||||||
|
The Factor source tree is organized as follows:
|
||||||
|
|
||||||
|
<li><code>build-support/</code> - scripts used for compiling Factor (not
|
||||||
|
present in binary packages)</li>
|
||||||
|
<li><code>vm/</code> - Factor VM source code (not present in binary
|
||||||
|
packages)</li>
|
||||||
|
<li><code>core/</code> - Factor core library</li>
|
||||||
|
<li><code>basis/</code> - Factor basis library, compiler, tools</li>
|
||||||
|
<li><code>extra/</code> - more libraries and applications</li>
|
||||||
|
<li><code>misc/</code> - editor modes, icons, etc</li>
|
||||||
|
<li><code>unmaintained/</code> - unmaintained contributions, please
|
||||||
|
help!</li>
|
||||||
|
|
||||||
|
<h2>Community</h2>
|
||||||
|
|
||||||
|
<p>Factor developers meet in the <code>#concatenative</code> channel on <a
|
||||||
|
href="http://freenode.net">irc.freenode.net</a>. Drop by if you want to discuss
|
||||||
|
anything related to Factor or language design in general.</p>
|
||||||
|
|
||||||
|
<ul>
|
||||||
|
<li><a href="http://factorcode.org">Factor homepage</a></li>
|
||||||
|
<li><a href="http://concatenative.org">Concatenative languages wiki</a></li>
|
||||||
|
</ul>
|
||||||
|
|
||||||
|
<p>Have fun!</p>
|
||||||
|
|
||||||
|
</body>
|
||||||
|
</html>
|
||||||
Loading…
Reference in New Issue