Factor/Building FactorOnce you have a clone of the GIT repository, there are two ways to build Factor; you can build a clean branch, or the bleeding-edge sources. Build requirementsSee Requirements. Building and updating Factor the easy wayOnce you have a GIT checkout of the Factor source tree, you can use the Unix: ./build.sh update Windows: build.cmd This utility automatically updates your repository, rebuilds the Factor VM, downloads the latest boot image, and bootstraps Factor. This utility will work on Windows if Visual Studio 2012 or later is installed. Building and updating Factor the hard wayIf you don't want to, or can't, use the
If you did a Boot imagesFactor is partially self-hosting; all of the code in http://downloads.factorcode.org/images/master/ for the latest images, Boot images are CPU- and OS-specific
You will need to download either a clean boot image, or the latest boot image, depending on whether you're building from a clean branch or the latest branch. See below for details. Once you have built Factor, you can generate a new boot image if you choose. Building from a clean branchClean branches should be tracked by users who do not wish to use the binary packages, but nevertheless require a high degree of confidence that the source will compile and work. See Build farm for details of the process used to create clean branches. The currently available clean branches are
Step 1: To track a clean branch, you will need to clone a repository first, then issue the following two commands to stay up to date: git checkout -b clean-os-cpu origin/clean-os-cpu git pull git://factorcode.org/git/factor.git clean-os-cpu Step 2: Download the latest clean boot image for your architecture from http://downloads.factorcode.org/images/clean/. Place the boot image in the Factor directory. Step 3: Compile the Factor VM by running make: make # Linux, Mac OS X gmake # BSD nmake /f Nmakefile # Windows Step 4: Bootstrap Factor by issuing a command like the following, where ./factor -i=boot.<arch>.image Building from bleeding-edge sourcesInstead of tracking a clean branch, you can also track the latest sources. Keep in mind that these might not always build or work correctly, so pay attention to the Concatenative IRC channel and Mailing list if you plan on doing this. Step 1: To pull the latest patches, issue the following command in a cloned repository: git pull origin master Step 2: Download the latest boot image for your architecture from http://downloads.factorcode.org/images/master/. Place the boot image in the Factor directory. Step 3: Compile the Factor VM by running make: make # Linux, Mac OS X gmake # \*BSD nmake /f Nmakefile # Windows Step 4: Bootstrap Factor by issuing a command like the following, where ./factor -i=boot.<arch>.image Verify the buildAfter running your new build, verify it can create an image. Step 1: Execute like the following, where "unix-x86.64" make-image Step 2: After the image has been built execute Step 4 as described above. Step 3: Run factor as described below, if it runs successfully you're good to go. Building from historic sourcesFor some points in the source history, boot images marked by their corresponding SHA1 commit tag are available at http://downloads.factorcode.org/images/build/ Once the SHA1 is checked out from Git, building is similar to building bleeding-edge sources. Running FactorSee Running Factor. This revision created on Mon, 28 Oct 2019 11:22:11 by nomennescio (Added building from historic sources) |
|
All content is © 2008-2010 by its respective authors. By adding content to this wiki, you agree to release it under the BSD license. |