Parsing System (v0.8)

-> ->

Download / Install

Assuming you already have DMD installed:

Download Goldie and SemiTwist D Tools.

There are two ways to download these:
- Prepackaged Downloads at Goldie downloads page
  These prepackaged releases include Goldie, SemiTwist D Tools and prebuilt local Goldie documentation. They're available with prebuilt binaries for specific OSes. While prebuilt binaries are not currently available for all OSes, compiling from source is easy, and submissions of prebuilt binaries are welcome.
  
  Why 7z?
  The prepackaged releases 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.
- Git
  Goldie and SemiTwist D Tools can both be obtained via Git. Just clone both repositories, and checkout the tags goldie-v0.8 and v0.8 for SemiTwistDTools and Goldie respectively. To do that on the command line:
  
  >git clone https://bitbucket.org/Abscissa/semitwistdtools.git SemiTwistDTools >git clone https://bitbucket.org/Abscissa/goldie.git Goldie >cd SemiTwistDTools >git checkout goldie-v0.8 >cd ../Goldie >git checkout v0.8
  
  You'll need to build the binaries yourself (see below). Prebuilt local Goldie documentation is not included either, but you can easily build it (after you finish installing Goldie) with the instructions on the GenDocs page.
Build SemiTwist D Tools.
[You can skip this step if you obtained a release with prebuilt binaries for your OS.]

From the main SemiTwist D Tools directory:

>buildAll

NOTE FOR USERS OF DMD 2.054 AND OLDER:

The versions of RDMD that come with DMD 2.054 and older have bugs that prevent it from working with the latest Goldie and SemiTwist D Tools. So if you're not using at least DMD 2.055, you will need to grab the RDMD from DMD 2.055 or newer.

To do this, download and extract the zip of DMD 2.058. Then, go into the bin subdirectory for your operating system, and copy rdmd into the bin subdirectory of your DMD installation. If you're on Windows and you don't want to overwrite your DMD's existing RDMD, you can simply copy rdmd.exe into both the main Goldie and the main SemiTwist D Tools directories.
Add the executable directories for Goldie and SemiTwist D Tools to your PATH environment variable.
[This is technically optional, but highly recommended.]

These directories are:

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

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

Having these on your PATH shouldn't cause any name collisions because all the executables for Goldie and SemiTwist D Tools are prefixed with goldie- and semitwist- respectively.

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.

If you're on a Posix OS, and don't want to modify PATH, you can just symlink the executables to your preferred bin directory. But make sure you symlink them, don't just copy them.

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

(See the note above regarding RDMD.)

From Goldie's root directory:

>semitwist-stbuild all -x:-I../SemiTwistDTools/src

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

>semitwist-stbuild --help