• Requirements
• Change Log
• Installation
• Building
• FAQ
• If You Use Trunk
• API Overview
  • Static And Dynamic Styles
  • Ambiguous Symbols
• API Reference
  • Base
  • Exceptions
  • static class Goldie
  • class Language
  • class Lexer
  • class Parser
  • struct Symbol
  • class Token
• Included Sample Apps
  • Calculator Dynamic
  • Calculator Static
  • Parse Anything
• Included Tools
  • DumpCGT
  • GenDocs
    • Template Format
  • JsonViewer
    • Parse Tree Mode
  • Parse
  • StaticLang
• Future Work
• Developers
  • Library Source and StaticLang

Installation

Assuming you already have DMD, Tango and xfBuild installed (xfBuild is only needed if you build the binaries yourself):

1. Download Goldie and SemiTwist D Tools.

   There are two ways to download these:

   • Pre-Packaged Downloads

     You can obtain pre-packaged releases that include Goldie, SemiTwist D Tools and pre-built local Goldie documentation on the Goldie downloads page. These pre-packaged releases are available with pre-built binaries for specific OSes. Pre-built binaries are not currently available for all OSes, but compiling from source is easy, and submissions of pre-built binaries are welcome.

     These are in .7z format because it provides much higher compression than .zip or .tar.bz2. For Goldie, a .7z is less than half the size a .zip or .tar.bz2 would be. Besides, these days, no programmer should be without a .7z tool.

     If you're on Windows, you can use 7-Zip or WinRAR. If you're on a Unix-like system, you can use P7ZIP. On Debian or Ubuntu, you can install P7ZIP with the command:

     >sudo apt-get install p7zip-full

     When P7ZIP is installed, it may already be integrated with your file manager's default compression tool.

   • Subversion

     Goldie and SemiTwist D Tools can both be obtained via Subversion:

     >svn co -r 132 http://svn.dsource.org/projects/semitwist/trunk SemiTwistDTools >svn co http://svn.dsource.org/projects/goldie/tags/latest-stable Goldie

     The Subversion releases include pre-built binaries for Windows. Read below to see how to build the binaries yourself. Pre-built local Goldie documentation is not included, but you can easily build it (after you finish installing Goldie) with the instructions on the GenDocs page.

2. Build SemiTwist D Tools.
   [You can skip this step if you obtained a release with pre-built binaries for your OS.]

   From the main SemiTwist D Tools directory:

   Windows: >buildAllXF.bat Unix: >./buildAllXF.sh

   If you wish to use Rebuild instead of xfBuild, then run buildAllRE instead.

   Make sure xfBuild (or Rebuild) is available in your PATH environment variable.

   On WinXP, environment variables can be accessed by: Right-Click on "My Computer", "Properties", "Advanced" tab, "Environment Variables" button. You'll need to start a new command prompt for it to take effect. You might also need to log out and back in again.

3. Add the executable directories for Goldie and SemiTwist D Tools to your PATH environment variable.

   These directories are:

   {main Goldie directory}/bin/ {main SemiTwistDTools directory}/bin/

   See step #2 above for how to access the environment variables on WinXP.

4. Tell your compiler where to find Goldie and SemiTwist D Tools.

   To do this for DMD:

   Go to DMD's bin directory and open sc.ini (Windows) or dmd.conf (All other OSes). On the line that starts with DFLAGS=, add the following flags:

   -Ipath_to_SemiTwistDTools/src -Ipath_to_Goldie/src

5. Build Goldie's tools and sample apps.
   [You can skip this step if you obtained a release with pre-built binaries for your OS.]

   From Goldie's root directory:

   >stbuild all

   To see how to build the debug versions of Goldie's tools and sample apps, or only build one tool, or perform a cleaning:

   >stbuild --help