Changes from Version 1 of PosixDmdBuildOlderVersions

Author:

fawzi (IP: 87.234.81.105)

Timestamp:

08/04/09 20:51:52 (15 years ago)

Comment:

--

PosixDmdBuildOlderVersions

@@ +1 @@
+== Installers ==
+
+There are two types of installers available for a given release. Which one you choose, depends on your existing setup.
+
+ * Installers for those only wishing to upgrade Tango, but otherwise have a complete system
+ * Installers for those wishing to upgrade DMD.
+
+ 1. [wiki:DmdDownloads#Linux Download] a Tango installer.
+ 2. All installers are shell scripts with an embedded tar.gz and should be made executable once downloaded.
+
+{{{
+chmod +x <name of installer>.sh
+}}}
+
+ 3. Run the installer. For most setups this will probably require the use of the root account, e.g. by using sudo.
+
+{{{
+sudo ./<name of installer>.sh
+}}}
+
+ 4. If you don't specify a prefix, the installer will ask if {{{ /usr/local }}} is ok, or if you want to specify one.
+
+At this point, Tango and the necessary tooling should be installed. 
+
+== Manual Build and Install ==
+
+ 1. [wiki:SourceDownloads Download or check out] Tango sources.
+ 2. Enter the Tango directory where the build files are:
+{{{
+$ cd <tango base>/lib
+}}}
+
+ * ''At this point you can run install-dmd.sh with various arguments to automate all of the following steps, to see the instructions do''
+{{{
+$ ./install-dmd.sh --help
+}}}
+
+ 3. Run build-dmd.sh to build the core Tango library.
+{{{
+$ ./build-dmd.sh
+}}}
+
+ 4. Install .a (library) files
+{{{
+$ cp -Rf <tango base>/lib/libtango-base-dmd.a <DMD install prefix>/lib
+}}}
+
+ 5. Install object.di
+{{{
+$ cp -f <tango base>/object.di <DMD install prefix>/include/d
+}}}
+
+ 6. Make .d source files accessible by copying the .d source into this path like so:
+{{{
+$ cp -Rf <tango base>/tango <DMD install prefix>/include/d
+$ cp -Rf <tango base>/std <DMD install prefix>/include/d
+}}}
+
+ 7. Update your dmd.conf (either alongside your DMD binary, or in /etc)
+{{{
+[Environment]
+DFLAGS=-I<DMD install prefix>/include/d -defaultlib=tango-base-dmd -debuglib=tango-base-dmd -version=Tango -version=Posix
+}}}
+
+ 8. You can now build libtango-user-dmd.a, the library with Tango's user API. 
+{{{
+./build-tango.sh dmd
+}}} 
+
+ 9. From within {{{ <tango-distribution-dir>/lib }}}, install libtango-user-dmd.a to {{{<DMD install prefix>/lib}}}
+{{{
+$ cp -f libtango-user-dmd.a <DMD install prefix>/lib
+}}}
+
+Add {{{ -L-ltango-user-dmd -L-L<DMD install prefix>/lib }}} to your DFLAGS line in dmd.conf. The library path may be omitted if the library is installed to a directory that the linker already checks, for instance /usr/lib.
+
+Without libtango-user-dmd.a, a buildtool like rebuild or build will be required.
+
+'''NOTE 1:''' With DMD 1.013, the compiler started to handle library arguments to the linker properly, if they're put in dmd.conf. (With earlier DMD versions you will need to add {{{ <DMD install prefix>/lib/libtango.a }}} to your DFLAGS line in dmd.conf.)
+
+'''NOTE 2:''' The installers accompanying Tango 0.97 installed imports to {{{ import/<DMD version> }}} instead of {{{ include/d }}}. Later installers tries to clean up this when detected during uninstall. Only shipped DMD versions are checked though, so there may be stale files if the previous above instructions have been used for other versions of DMD.
+