Changeset 41

Timestamp:

04/06/06 02:45:23 (6 years ago)

Author:

Derek Parnell

Message:

Upload on version 2.10 (Build #1556)

See Docs/CHANGE_LOG.html for details
modified trunk/Source/build.cfg
modified trunk/Source/build.d
modified trunk/Source/build.def
modified trunk/Source/build.ksp
modified trunk/Source/build.rsp
modified trunk/Source/build_bn.d
modified trunk/Source/source.d
modified trunk/Source/source_bn.d
modified trunk/Source/util/fdt_bn.d
modified trunk/Source/util/fileex.d
modified trunk/Source/util/fileex_bn.d
modified trunk/Source/util/linetoken_bn.d
modified trunk/Source/util/pathex.d
modified trunk/Source/util/pathex_bn.d
modified trunk/Source/util/str.d
modified trunk/Source/util/str_bn.d
added downloads/build-2.10.doc.zip
added downloads/build-2.10.src.zip
added downloads/build_win_2.10.exe
added trunk/Docs/autobuild.html
added trunk/Docs/change_log.html
added trunk/Docs/command_line.html
added trunk/Docs/configuration_file.html
added trunk/Docs/dlls.html
added trunk/Docs/introduction.html
added trunk/Docs/pragmas.html
added trunk/Docs/response_file.html
added trunk/Docs/rules.html
added trunk/Docs/style.css
added trunk/Docs/switches.html
added trunk/Docs/todo.html
added trunk/Docs/User_Manual.html
added trunk/Source/docsrc
added trunk/Source/docsrc/autobuild.d
added trunk/Source/docsrc/change_log.d
added trunk/Source/docsrc/command_line.d
added trunk/Source/docsrc/configuration_file.d
added trunk/Source/docsrc/dlls.d
added trunk/Source/docsrc/introduction.d
added trunk/Source/docsrc/pragmas.d
added trunk/Source/docsrc/response_file.d
added trunk/Source/docsrc/rules.d
added trunk/Source/docsrc/style.css
added trunk/Source/docsrc/switches.d
added trunk/Source/docsrc/todo.d
added trunk/Source/docsrc/um.d
added trunk/Source/docsrc/User_Manual.d
added trunk/Source/docsrc/user_manual.ddoc
added trunk/Source/example_build.cfg
added trunk/Source/util/booltype.d

Files:

• downloads/build-2.10.doc.zip (added)
• downloads/build-2.10.src.zip (added)
• downloads/build_win_2.10.exe (added)
• trunk/Docs/User_Manual.html (added)
• trunk/Docs/autobuild.html (added)
• trunk/Docs/change_log.html (added)
• trunk/Docs/command_line.html (added)
• trunk/Docs/configuration_file.html (added)
• trunk/Docs/dlls.html (added)
• trunk/Docs/introduction.html (added)
• trunk/Docs/pragmas.html (added)
• trunk/Docs/response_file.html (added)
• trunk/Docs/rules.html (added)
• trunk/Docs/style.css (added)
• trunk/Docs/switches.html (added)
• trunk/Docs/todo.html (added)
• trunk/Source/build.cfg (modified) (1 diff)
• trunk/Source/build.d (modified) (136 diffs)
• trunk/Source/build.def (modified) (1 diff)
• trunk/Source/build.ksp (modified) (1 diff)
• trunk/Source/build.rsp (modified) (1 diff)
• trunk/Source/build_bn.d (modified) (1 diff)
• trunk/Source/docsrc (added)
• trunk/Source/docsrc/User_Manual.d (added)
• trunk/Source/docsrc/autobuild.d (added)
• trunk/Source/docsrc/change_log.d (added)
• trunk/Source/docsrc/command_line.d (added)
• trunk/Source/docsrc/configuration_file.d (added)
• trunk/Source/docsrc/dlls.d (added)
• trunk/Source/docsrc/introduction.d (added)
• trunk/Source/docsrc/pragmas.d (added)
• trunk/Source/docsrc/response_file.d (added)
• trunk/Source/docsrc/rules.d (added)
• trunk/Source/docsrc/style.css (added)
• trunk/Source/docsrc/switches.d (added)
• trunk/Source/docsrc/todo.d (added)
• trunk/Source/docsrc/um.d (added)
• trunk/Source/docsrc/user_manual.ddoc (added)
• trunk/Source/example_build.cfg (added)
• trunk/Source/source.d (modified) (25 diffs)
• trunk/Source/source_bn.d (modified) (1 diff)
• trunk/Source/util/booltype.d (added)
• trunk/Source/util/fdt_bn.d (modified) (1 diff)
• trunk/Source/util/fileex.d (modified) (9 diffs)
• trunk/Source/util/fileex_bn.d (modified) (1 diff)
• trunk/Source/util/linetoken_bn.d (modified) (1 diff)
• trunk/Source/util/pathex.d (modified) (7 diffs)
• trunk/Source/util/pathex_bn.d (modified) (1 diff)
• trunk/Source/util/str.d (modified) (27 diffs)
• trunk/Source/util/str_bn.d (modified) (1 diff)

trunk/Source/build.cfg

@@ -1 +1 @@
-CMDLINE=-info           # Show the version of build
-
+
+
+
-
-LIBCMD=%@D%\..\..\dm\bin\lib.exe
-
+
+BMD=@S\djp.bmd
+
-[dbg]
-unittest --release --inline
+-release --inline -unittest
-CMDLINE=-T{Target}_{Group}
-

trunk/Source/build.d

@@ -1 @@
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
-        This software is provided 'as-is', without any express or implied
-        warranty. In no event will the authors be held liable for damages
-        of any kind arising from the use of this software.
-
-        Permission is hereby granted to anyone to use this software for any
-        purpose, including commercial applications, and to alter it and/or
-
-
+
-        1. The origin of this software must not be misrepresented; you must
-           not claim that you wrote the original software. If you use this
-           software in a product, an acknowledgment within documentation of
-
-
+
-        2. Altered source versions must be plainly marked as such, and must
-
-
+
-        3. This notice may not be removed or altered from any distribution
-
-
+
-        4. Derivative works are permitted, but they must carry this notice
-           in full and credit the original source.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
-
-module build;
-private import build_bn;    // This module's build number
-
-
-
+ 
+ 
-version(linux)  version = Posix;
-version(darwin) version = Posix;
@@ -426 +39 @@
-    version(Windows) {
-        // OptLink Definition File
-9
+10
-    }
-}
@@ -433 +46 @@
-private{
-    // --------- imports ----------------
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
-
-    import std.c.stdio;
@@ -488 +102 @@
-        char[] kSrcExtention=`d`;
-        char[] kMacroExtention=`mac`;
+        char[] kDdocExtention=`ddoc`;
-
-    }
@@ -494 +109 @@
-    version(DigitalMars) {
-        version(Windows) {
-
-rSwitch
-=`dmd
+Exe
+OnlySwitch 
+Exe=`link
-            char[] vConfigFile=`sc.ini`;
-            char[] vCompilerPath=``;
+            char[] vLinkerPath=``;
+            char[] vLinkerDefSwitches=`/noi/map`;
-            char[] vConfigPath=``;
-            char[] vLibPaths = ``;
@@ -507 +124 @@
-
-        version(Posix) {
-
-r
-=`dm
+Exe
+Only
+Exe=`l
-            char[] vConfigFile=`dmd.conf`;
-            char[] vCompilerPath=``;
+            char[] vLinkerPath=``;
+            char[] vLinkerDefSwitches=`/noi/map`;
-            char[] vConfigPath=`/etc/`;
-            char[] vLibPaths = ``;
@@ -529 +148 @@
-    version(GNU) {
-        version(Windows) {
-
-r
-
+Exe
+Only
+Exe
-            char[] vConfigFile=null;
-            char[] vCompilerPath=``;
+            char[] vLinkerPath=``;
+            char[] vLinkerDefSwitches=``;
-            char[] vConfigPath=null;
-            char[] vLibPaths = ``;
@@ -542 +163 @@
-
-        version(Posix) {
-
-r
-=`gdc
+Exe
+Only
+Exe=`ld
-            char[] vConfigFile=null;
-            char[] vCompilerPath=`/opt/gdc/bin`;
+            char[] vLinkerPath=``;
+            char[] vLinkerDefSwitches=``;
-            char[] vConfigPath=null;
-            char[] vLibPaths = ``;
@@ -563 +186 @@
-    char[]       vBuildImportPathSwitch = "-I";
-    char[]       vTemporaryPathSwitch = "-od";
-run
+exec
-    char[]       vLibrarianPath = "";
-    char[]*      vDelayedValue = null;
-    char[]       vTemporaryPath = "";
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-    char[]       vRunParms;
-    char[]       vTargetExe;
@@ -590 +217 @@
-    char[]       vAppPath;
-    char[]       vAppName;
-9
+10
-    char[]       vTargetName;           // Output name from first file name.
-    char[]       vPragmaTargetName;     // Output name from pragma.
@@ -599 +226 @@
-    char[][]     vBuildArgs;            // Arguments passed to build
-    char[][]     vCompilerArgs;         // Arguments passed to compiler
-
-
+
-    char[]       vRDFName = "default.rdf";
-    bool[char[]] vNestedDelim;
@@ -612 +238 @@
-    Substitute[] vSubstitutions;
-
-
-
-
+
+
+
+
+
+
+
-    }
-
@@ -624 +254 @@
-//-------------------------------------------------------
-{
-
+ //todo
-
-    vDefaultCompArgs ~= vKeepPathSwitch;     // Keep object files in same folder as source.
-    vModulesToIgnore ~= "phobos";  // Assume phobos will be ignored.
+    vSourceScanList ~= "." ~ std.path.sep;
+    vNoLink = False;
+    vTestRun = False;
+    vScanImports = False;
+    vForceCompile = False;
+    vSilent = False;
+    vCleanup = False;
+    vVerbose = False;
+    vMacroInput = True;
+    vNames = False;
+    vAllObjects = False;
+    vNoDef = False;
+    vAutoImports = True;
+    vExecuteProgram = False;
+    vUseResponseFile = False;
+    vConsoleApp = True;
-
-    version(Posix){
@@ -640 +286 @@
-    version(DigitalMars) {
-        version(Windows) {
-t
+T
-        }
-        else
-        {
-f
+F
-        }
-     } else
-     {
-f
+F
-     }
-
@@ -657 +303 @@
-}
-
+static ~this()
+{
+    // Clean up any resources held by the source files.
+    Source.Finalize();
+}
-
-//-------------------------------------------------------
@@ -727 +378 @@
-    writefln("               -Rn will cause command line arguments to be used.");
-    writefln("               -R will reverse the current usage.");
+    writefln("  -PP<path>  Add a path to the Source Search List");
-
-  version(DigitalMars) {
@@ -737 +389 @@
-    writefln("               ** The default is to use command line arguments"); }
-
-run
+exec
-    writefln("               executable just created to run. You can give it ");
-run
+exec
-    writefln("               placed in the program's command line. You will need");
-    writefln("               to quote any embedded spaces.");
@@ -779 +431 @@
-    int lTrueRC;
-
-
+ == True
-        writefln("Command: '%s'",pCommand);
-        return 0;
@@ -787 +439 @@
-
-
-
+ == True
-            writefln("Running '%s'",pCommand);
-        }
@@ -795 +447 @@
-        version(Windows) lTrueRC = lRC;
-
-
+ == True
-            if (lTrueRC == 0){
-                writefln("Successful");
@@ -822 +474 @@
-    FileDateTime lModsTime = new FileDateTime();
-
-ourceIndex.keys
+canOrder
-    {
-        // Get the next Source object to examine.
@@ -832 +484 @@
-        lSource.search();
-
-
+ == True
-            writefln("source file[%d] %s", i,
-                    util.pathex.AbbreviateFileName(lFileName));
-        }
-
+ == True
-            writefln(" [ %s ]", util.pathex.AbbreviateFileName(lFileName));
-        }
@@ -842 +494 @@
-        if (lSource.DependantsTime > lModsTime)
-        {
-
+ == True
-                writefln("Newer time: from %s to %s",
-                    lModsTime.toString(),
@@ -858 +510 @@
-        FileDateTime lLinkTime = GetFileTime(lFileName);
-
-
+ == True
-            writefln("link file[%d] %s %s", i,
-                    util.pathex.AbbreviateFileName(lFileName), lLinkTime.toString());
-        }
-
+ == True
-            writefln(" [ %s ]", util.pathex.AbbreviateFileName(lFileName));
-        }
@@ -868 +520 @@
-        if (lLinkTime > lModsTime)
-        {
-
+ == True
-                writefln("Newer time: from %s to %s",
-                    lModsTime.toString(),
@@ -890 +542 @@
-};
-
+
-//-------------------------------------------------------
-Rule[] LoadRules()
@@ -898 +551 @@
-    char[] lRuleDefnFile;
-
+    static char[] kRuleKey = "rule=";
-
-    lRuleDefnFile = util.pathex.LocateFile(vRDFName,
-"PATH"
-
+kPathId
+ == True
-        writefln("Rule Definitions from %s", lRuleDefnFile);
-lRuleText = GetTextLines( lRuleDefnFile
+GetTextLines( lRuleDefnFile, lRuleText 
-    foreach(char[] lLine; lRuleText)
-    {
-std.string
-"rule=") > 0 
+util.str
+kRuleKey ) == True
-        {
-            lRules.length = lRules.length + 1;
@@ -914 +568 @@
-        else if (lRules.length > 0)
-        {
-> 0
+== True
-                lRules[$-1].Input = lLine[3..$];
-> 0
+== True
-                lRules[$-1].Output = lLine[4..$];
-> 0
+== True
-                lRules[$-1].Tool = lLine[5..$];
-        }
-    }
-
-
+ == True
-    {
-        foreach(Rule r; lRules)
@@ -984 +638 @@
-        lOutDate = new FileDateTime(lOutFile);
-
-vForceCompile
+(vForceCompile == True)
-        {
-            char[] lKeyValues;
@@ -1015 +669 @@
-//-------------------------------------------------------
-{
-
+
+
+
-    char[][]    lFilesToLink;
-    char[][]    lFilesToCompile;
@@ -1023 +679 @@
-    FileDateTime lTargetTime;
-    FileDateTime lMostRecentTime;
-
-
-
+
-    char[]      lDResponseFileName;
-    char[]      lLinkResponseFileName;
@@ -1031 +685 @@
-    char[]      lDefName;
-    char[]      lOutText;
+    char[]      lCompilerOpts;
-    char[]      lSourcesToCompile;
-    char[]      lCommand;
-
+
+
+
+
+
+
+
-
-    // Examine each supplied source file.
-    foreach( char[] lFile; vCmdLineSourceFiles)
-    {
-
+, vSourceScanList
-    }
-
@@ -1045 +706 @@
-    lLinking =  (vLibraryAction == LibOpt.Build) ||
-                (Source.WasMainFound == false) ||
-t
-false : t
+T
+False : T
-
-    lMostRecentTime = GetNewestDateTime();
@@ -1062 +723 @@
-
-    // I'm either creating a library, an executable or neither.
+
+    // If a target name was supplied in a pragma, use that as the
+    // default target name.
-    if (vPragmaTargetName.length != 0)
-        vTargetName = vPragmaTargetName;
+
+    // If a target name was supplied on the command line, use that
+    // instead of the default name.
-    if (vCommandTargetName.length != 0)
-    {
@@ -1080 +747 @@
-    }
-
+    // Ensure that the path to the target's location will exist.
-    util.pathex.MakePath(vTargetName);
-
+
-    if (vLibraryAction == LibOpt.Build)
+        // Target is a library.
-        lTargetName = ReplaceExtention(vTargetName, kLibExtention);
-
+
+
+
-        if (Source.WasMainFound)
-            if (Source.WasMainDLL)
+                // Target is a shared library.
-                lTargetName = ReplaceExtention(vTargetName, kShrLibExtention);
-
+
+
+
-                lTargetName = ReplaceExtention(vTargetName, kExeExtention);
-                vTargetExe = lTargetName;
-            }
-        else
-
+
+
+
+
+
+
+
+
-    else
+        // Not linking and not archiving, so no target is required.
-        lTargetName = "";
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
-        lTargetDir = getDirName(lTargetName);
-
+        // Show user if required to.
+        if((vVerbose == True) || (vNames == True) ) {
+            writefln("\nBuilding target '%s'", lTargetName);
+        }
+
+        // Shorten the target name for future usages.
+        lTargetName = util.pathex.AbbreviateFileName(lTargetName);
+
+
+        // If the target doesn't exist or it is older than
+        // most recently modified dependant file, we need to
+        // rebuild the target.
-        lTargetTime = util.fdt.GetFileTime (lTargetName);
-
+ == True
-            writefln("Time %s for %s (target)", lTargetTime.toString(), lTargetName);
-            writefln("Time %s (most recent)", lMostRecentTime.toString());
-        }
-
-        if(lTargetTime < lMostRecentTime) {
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
-    foreach( ExternRef lRef; vExternals)
-    {
-        lRunResult = ProcessExternal( lRef );
-        if (lRunResult != 0)
+            // If an external tool fails, stop immediately.
-            return lRunResult;
-    }
@@ -1142 +832 @@
-        {
-            // Only include OBJECT files.
->= 0
+== True
-                lFilesToLink ~= lFileName;
-        }
-    }
-ourceIndex.keys
+canOrder
-    {
-        // Check each source to see if we need to recompile it.
-        Source lCurrentSource;
-b
+B
-        char[] lShortFileName;
+        char[] lFileType;
-
-        lNeedsCompiling = vForceCompile;
@@ -1160 +851 @@
-
-        lShortFileName = util.pathex.AbbreviateFileName(lFileName);
-
+
+
-            continue;
-
-        // Only source files are examined from here on.
-
+
+
-            lNonLinkingSources ~= lCurrentSource;
+        }
-
-        if(lCurrentSource.FilesTime > lCurrentSource.ObjectsTime)
-        {
-
+ == True
-                writefln("%s newer than its object file", lShortFileName);
-=t
+ = T
-
-        } else if(lCurrentSource.DependantsTime > lCurrentSource.ObjectsTime) {
-
+ == True
-                writefln("%s has newer dependants than its object file.",
-                                lShortFileName);
-
-=t
-
-
-
-
-t
-t
+ = T
+
+
+ == True
+
+T
+T
-            lFilesToCompile ~= lShortFileName;
-
@@ -1191 +885 @@
-                lFilesToLink ~= util.pathex.AbbreviateFileName(lCurrentSource.ObjectName);
-
-! vTestRun
+vTestRun == False
-            {
-                if (lCurrentSource.IncrementBuildNumber())
-                {
-
+ == True
-                        writefln("New build number %d for %s",
-                               lCurrentSource.BuildNumber,
@@ -1210 +904 @@
-    }
-
-f
-
-f
+F
+
+F
-            writefln ("Files are up to date, no build required.");
-        return 0;
-    }
-
-    lOutText ~= GatherCompilerArgs(lLinking);
-
-    foreach(char[] lFileName; lFilesToCompile)
@@ -1245 +937 @@
-            AddBuildDef("DATA PRELOAD SINGLE WRITE");
-        }
-
+ == True
-            AddBuildDef(`EXETYPE DOS`);
-        }
-
-f
+F
-        {
-            lDefName = ReplaceExtention(lTargetName, "def");
@@ -1259 +951 @@
-            util.fileex.CreateTextFile(lDefName, vBuildDef);
-
-
-
-
-
+
+
+
+
+
+
+
-    // Add any library or external obj files required.
-
+
+
+
-
-        foreach (char[] lFileName; vLinkFiles.keys)
-        {
-            char[] lCmdItem;
-
-
-
-
+
+
+
-                lCmdItem = lFileName;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-        if (lSourcesToCompile.length > 0)
-        {
+            // Ok, I have some compiling to do!
-            char[] lCommandLine;
-
-
-
-
+
+
+
+
-                lDResponseFileName = ReplaceExtention(lTargetName, "rsp");
-                if (vTemporaryPath.length != 0)
@@ -1313 +1004 @@
-                lDResponseFileName = util.pathex.AbbreviateFileName(lDResponseFileName);
-                util.fileex.CreateTextFile(lDResponseFileName,lCommandLine);
- ~ vCompiler
+Exe ~ vCompileOnly
-            }
-            else
-            {   // using commandline; may run into limits
-                lCommandLine=std.string.replace(lCommandLine, "\n", " ");
-  ~ vCompiler
-
-
-
+Exe  ~ vCompileOnly
+
+
+ == True
-                writefln("Compiling with ..........\n%s\n", lCommandLine);
-            }
@@ -1328 +1019 @@
-            lRunResult = RunCommand(lCommand);
-            if (lRunResult != 0)
-
-
-
-
+
+
+
+
+
-        {
-            char[] lCommandLine;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-                lLinkResponseFileName = ReplaceExtention(lTargetName, "ksp");
-                if (vTemporaryPath.length != 0)
@@ -1400 +1184 @@
-                lLinkResponseFileName = util.pathex.AbbreviateFileName(lLinkResponseFileName);
-                util.fileex.CreateTextFile(lLinkResponseFileName,lCommandLine);
-CompilerPath ~ vLinker
+LinkerPath ~ vLinkerExe
-            }
-            else
-            {   // using commandline; may run into limits
-                lCommandLine=std.string.replace(lCommandLine, "\n", " ");
-CompilerPath ~ vLinker
-
-
-
+LinkerPath ~ vLinkerExe
+
+
+ == True
-                writefln("Linking with ..........\n%s\n", lCommandLine);
-            }
-
-            // Run Linker
-
+ == True
-            {
-                version(Posix) lCommand ~= " >/dev/null";
@@ -1421 +1205 @@
-            lRunResult = RunCommand(lCommand);
-            if (lRunResult != 0)
-f
+F
-        }
-
@@ -1427 +1211 @@
-    else
-    {
-f
+F
-            writefln("No build required.");
-        lRunResult = 0;
@@ -1439 +1223 @@
-        ulong[] lImpManf;
-
-f
-
-"PATH"
+F
+
+kPathId
-        if (util.fileex.FileExists(lImpLibPath))
-        {
@@ -1455 +1239 @@
-        }
-    }
-
-
-
-
-
-
+
+
+
+
+
+
+
-        lOutText ~= lTargetName ~  std.path.linesep;  // Create a new library
-
-
+
+
-            char[] lFileDir;
-
-            lFileDir = getDirName(lFileName);
-
+
+
-                if (lFileName.length > 1 + kSrcExtention.length)
-                {
@@ -1475 +1262 @@
-                    }
-                }
-
+
-                lOutText ~= lFileName ~ std.path.linesep;
-            }
-        }
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-    }
-
-    // Optional clean up.
-
+
+
-        char[][] lHitList;
-
-
+ == True
-            writefln("Cleaning up ...");
-        }
-ourceIndex.keys
+canOrder
-        {
-            Source lSource;
@@ -1538 +1329 @@
-                if (util.fileex.FileExists( lFilename ) )
-                {
-
+ == True
-                        writefln("  removing %s", lFilename);
-                    }
@@ -1553 +1344 @@
-
-// -------------------------------------------
-b
+B
-// -------------------------------------------
-{
@@ -1597 +1388 @@
-    }
-
-f
+F
-    { // No linking allowed.
-        if (vNoLinkSwitch.length > 0)
@@ -1632 +1423 @@
-        vExternals[$-1].FilePath = pPath;
-        vExternals[$-1].ToolOpts = pOpts;
-
+ == True
-            writef("Added external file to be built: %s", pPath);
-            foreach( char[] lOpt; pOpts)
@@ -1661 +1452 @@
-        vPragmaTargetName = pPath;
-    else if (vPragmaTargetName != pPath) {
-
+ == True
-            writefln("Multiple pragma(target,...) detected. '%s' will be used and '%s' rejected.",
-                    vPragmaTargetName, pPath );
@@ -1677 +1468 @@
-    static uint[ char[] ] lElementIdx;
-
-t
+T
-        return;
-
@@ -1742 +1533 @@
-    version(Windows) lSearchName = std.string.tolower(lFullName);
-    version(Posix)   lSearchName = lFullName;
-
+
+
-        vImportRoots ~= lFullName;
-        lRootHash[lSearchName] = true;
@@ -1752 +1544 @@
-}
-
-b
+B
-{
-    return vAutoImports;
@@ -1796 +1588 @@
-                else
-                {
-GetEnv(lSymName
+(GetEnv(std.utf.toUTF8(lSymName))
-                }
-                lLine ~= lSymName;
@@ -1886 +1678 @@
-                        vDefaultCompArgs ~= vImportPathSwitch ~ lRoot;
-                        */
-
+ == True
-                        if (lRootName.length > 0){
-                            writefln(" added root from config file %s", lRootName);
@@ -1897 +1689 @@
-                version(DigitalMars)
-                {
-
+ == True
-                {
-                    // Target name (eg. -oftestapp)
@@ -1917 +1709 @@
-                }
-
-
+ == True
-                {
-                    char[] lbRoot;
@@ -1929 +1721 @@
-                        lbRoot = AddRoot(vTemporaryPath);
-                        if (lbRoot.length > 0){
-
+ == True
-                                    writefln("Added root from config file Object Write Path = %s",lbRoot);
-                            }
@@ -1956 +1748 @@
-    if (lSymValue.length > 0 )
-    {
-
+ == True
-            writefln("Analyzing environment symbol DFLAGS=%s", lSymValue);
-        Process_DFLAGS( lSymValue );
@@ -1970 +1762 @@
-    int      lPos;
-
- is null
+.length == 0
-    {
-        // There is no configuration file to process
@@ -1977 +1769 @@
-
-    lPath = vConfigPath ~ vConfigFile ;
-lTextLines = util.fileex.GetTextLines(lPath
-
-
+util.fileex.GetTextLines(lPath, lTextLines
+
+ == True
-        writefln("Reading from config: %s", lPath);
-    }
@@ -1986 +1778 @@
-    {
-        // Strip off trailing whitespace.
-
-
-
+
+
-        // Replace any environment symbols with their value.
-
+ == True
-            writefln(" Line %d: %s", i+1, lLine);
-        }
@@ -2032 +1823 @@
-                        lPath = lPath[1..length-1];
-                    }
-
-
-
-
-
+
+
+
+
-            {
-                writefln(" use %s",vLibPaths);
@@ -2052 +1842 @@
-            }
-
-
-
-
-
-
-
-
+
+
+
+
+
+
-            }
-            continue;
@@ -2074 +1863 @@
-
-            vLibrarian = std.path.getBaseName(lLine[7..$]);
-
+ == True
-                writefln(" librarian path %s",vLibrarianPath);
-                writefln(" librarian is %s",vLibrarian);
-            }
-        }
+
+
+        if (vLinkerPath.length == 0)
+            vLinkerPath = vCompilerPath;
+        if (vLibrarianPath.length == 0)
+            vLibrarianPath = vLinkerPath;
-    }
-}
@@ -2129 +1924 @@
-
-// ------------------------------------------------
-
+
+
+
+
+
+
+
+
+
+
+
-// -------------------------------------------
-{
-    char[] lPossiblePath;
-    char[] lLocalPath;
+
+    if (util.pathex.IsRelativePath(pFileName) == True && pScanList.length > 0)
+    {
+        // Do explicit scanning of supplied paths.
+        foreach(char[] lNextRoot; pScanList) {
+            lPossiblePath = ( lNextRoot ~ pFileName );
+            if(util.fileex.FileExists(lPossiblePath)) {
+                return util.pathex.AbbreviateFileName(lPossiblePath);
+            }
+        }
+
+        // If not found in scan list, drop through to standard scan.
+    }
-
-    // Look for file in current folder first.
@@ -2213 +2031 @@
-    source.AddBuildDef      = &AddBuildDef;
-    source.GetFullPathname  = &GetFullPathname;
+    source.GetFullPathnameScan = &GetFullPathnameScan;
-    source.GetObjWritePath  = &GetTemporaryPath;
-    source.GetMacros        = &GetMacros;
@@ -2218 +2037 @@
-
-    // Scan the PATH env symbol to locate the D compiler.
-"PATH", vCompiler
+kPathId, vCompilerExe
-    if (lCompPath.length > 0){
-        if (lCompPath[length-1] != std.path.sep[0])
@@ -2257 +2076 @@
-    GatherArgs( pArgs );
-    source.mVerboseMode = vVerbose;
-
+ == True
-        writefln("*** build v%s (build %d)***", vAppVersion, build_bn.auto_build_number);
-    }
@@ -2266 +2085 @@
-
-    source.mMacroInput = vMacroInput;
-
+ == True
-        ProcessMacroDefs(vVerbose);
-
@@ -2273 +2092 @@
-    }
-
-vVerbose || vNames
+(vVerbose == True) || (vNames == True) 
-        writefln("Current Dir '%s'", util.pathex.GetInitCurDir());
-
-    if (lSetPath)
-    {
-
+ == True
-        {
-            writefln("%s not found in PATH symbol, so assuming current directory",
-
+Exe
-        }
-    }
@@ -2292 +2111 @@
-    {
-        vConfigPath = vCompilerPath;
-
+ == True
-        {
-            writefln("No configuration file path, so assuming current directory");
-        }
-    }
-vConfigPath[length-1] != std.path.sep[0]
+util.str.ends(vConfigPath, std.path.sep) is False
-        vConfigPath ~= std.path.sep;
-
@@ -2309 +2128 @@
-    }
-
-
+Exe
-    {
-        throw new Exception(std.string.format("The compiler '%s' was not found.",
-
-
-
-
+Exe
+
+
+ == True
-        writefln("Compiler installed in %s",vCompilerPath);
-        writefln("Configuration File installed in %s",vConfigPath);
@@ -2345 +2164 @@
-    foreach( char[] lFile; vCmdLineSourceFiles)
-    {
-lFile 
-
-f
+GetFullPathname(lFile, vSourceScanList)
+
+F
-                writefln("** File '%s' not found.", lFile);
-            lAllExist = false;
@@ -2360 +2179 @@
-    lBuildResult = Build();
-
-
+ == True
-        writefln("");
-        DisplayItems(vBuildArgs,      "build args: ...............");
-        DisplayItems(vCompilerArgs,   "compiler args: ................");
-        DisplayItems(vCmdLineSourceFiles,   "command line files: ...............");
-ourceIndex.keys
+canOrder
-                                      "source files: ...............");
-        DisplayItems(vLinkFiles.keys, "link files: ...............");
@@ -2374 +2193 @@
-    }
-
-vExecuteProgram
+(vExecuteProgram == True)
-    {
-        RunCommand( vTargetExe ~ " " ~ std.string.strip(vRunParms));
@@ -2384 +2203 @@
-}
-
-b
+B
-{
-    // A response file is being used.
@@ -2391 +2210 @@
-
-    if (pArg.length == 1)
-@
+
-    else
-        lRespFileName = pArg[1..length].dup;
@@ -2400 +2219 @@
-    }
-
-
+ == True
-        writefln("Response file %s", lRespFileName);
-
@@ -2416 +2235 @@
-        lArg = std.string.strip(lArg);
-        if (lArg.length > 1){
-
+ == True
-                writefln("Response file arg: %s", lArg);
-            GatherOneArg( lArg );
@@ -2427 +2246 @@
-    char[] lNewPath;
-    static char[] lImportSwitch;
-
-
-
+
+
-        char[] lVersionString;
-
@@ -2436 +2254 @@
-        pArg = vVersionSwitch ~ lVersionString;
-    }
-> 0
+== True
-        char[] lVersionString;
-
@@ -2452 +2270 @@
-        pArg = vDebugSwitch;
-    }
-> 0
+== True
-        char[] lDebugString;
-
@@ -2459 +2277 @@
-        pArg = vDebugSwitch ~ "=" ~ lDebugString;
-    }
-> 0
+== True
-        char[] lDebugString;
-
@@ -2469 +2287 @@
-    switch(pArg) {
-        case "-full":
-t
+T
-            vBuildArgs ~= pArg;
-            // Not passed thru.
@@ -2481 +2299 @@
-
-        case "-nolink":
-t
+T
-            vBuildArgs ~= pArg;
-            // Not passed thru.
@@ -2500 +2318 @@
-        case "-obj":
-            vLibraryAction = LibOpt.DontBuild;
-t
+T
-            vBuildArgs ~= pArg;
-            // Not passed thru.
@@ -2507 +2325 @@
-        case "-nounittest":
-            // Not passed thru. Deprecated switch is now ignored.
-f
+F
-                writefln("Note: '-nounittest' ignored. This switch is no longer used.");
-            break;
@@ -2518 +2336 @@
-
-        case "-silent":
-t
+T
-            vBuildArgs ~= pArg;
-            // Not passed thru.
@@ -2524 +2342 @@
-
-        case "-noautoimport":
-f
+F
-            vBuildArgs ~= pArg;
-            // Not passed thru
@@ -2530 +2348 @@
-
-        case "-nodef":
-t
+T
-            vBuildArgs ~= pArg;
-            // Not passed thru.
@@ -2536 +2354 @@
-
-        case "-nomacro":
-f
+F
-            vBuildArgs ~= pArg;
-            // Not passed thru.
@@ -2551 +2369 @@
-
-        case "-allobj":
-t
+T
-            vBuildArgs ~= pArg;
-            // Not passed thru.
@@ -2557 +2375 @@
-
-        case "-test":
-t
+T
-            vBuildArgs ~= pArg;
-            // Not passed thru.
@@ -2565 +2383 @@
-            // drop through ...
-        case "-clean":
-t
+T
-            vBuildArgs ~= pArg;
-            // Not passed thru.
@@ -2577 +2395 @@
-        case "-names":
-            vBuildArgs ~= pArg;
-t
+T
-            // Not passed thru.
-            break;
@@ -2585 +2403 @@
-            {
-            if (pArg[0] == '-') {
+                if (pArg == "-g")
+                {
+                    // Requires symbolic debug info.
+                    vLinkerDefSwitches ~= "/co";
+                    AddCompilerArg(pArg);
+                    break;
+                }
+
-                // Test for Librarian options.
-cast(dchar[])"-LIBOPT*")
+"-LIBOPT*"d) == True
-                {
-                    vLibrarianOpts ~= " " ~ pArg[7..$].dup;
@@ -2594 +2420 @@
-                }
-
->= 0
+== True
-                {
-                    vLibPaths ~= vConfigSep ~ pArg[9..$].dup;
@@ -2602 +2428 @@
-
-                // Test for alternate install locations.
-cast(dchar[])"-DCPATH*")
+"-DCPATH?*"d) == True
-                {
-                    lNewPath = pArg[7..length].dup;
-                    if (vCompilerPath == vConfigPath)
-                    {
-
+ == True
-                            writefln("CFPATH was %s now %s", vConfigPath, lNewPath);
-                        vConfigPath = lNewPath;
-                    }
-
+ == True
-                        writefln("DCPATH was %s now %s", vCompilerPath, lNewPath);
-                    vCompilerPath = lNewPath;
@@ -2619 +2445 @@
-                }
-
-cast(dchar[])"-CFPATH*")
-
-
+"-CFPATH?*"d) == True
+
+ == True
-                        writefln("CFPATH was %s now %s", vConfigPath, pArg[7..length]);
-                    vConfigPath = pArg[7..length].dup;
@@ -2629 +2455 @@
-                }
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-                        writefln("RDF was %s now %s", vRDFName, pArg[4..$]);
-                    vRDFName = pArg[4..$].dup;
@@ -2645 +2485 @@
-                    break;
-                }
-(lCut = util.str.begins(pArg, vBuildImportPathSwitch)) >= 0
+util.str.begins(pArg, vBuildImportPathSwitch) == True
-                {
-                    char [] lRoot;
-lCut..
+vBuildImportPathSwitch.length .. 
-                    {
-                        lRoot = AddRoot(lCmdRoot);
-                        if (lRoot.length > 0){
-
+ == True
-                                    writefln("Added root from command line = %s",lRoot);
-                            }
@@ -2659 +2499 @@
-                    break;
-                }
-
+
+
-                {
-                    vRunParms ~= pArg[vRunSwitch.length .. $] ~ " ";
-t
+T
-                    vBuildArgs ~= pArg;
-                    break;
@@ -2671 +2512 @@
-                version(DigitalMars)
-                {
-
+ == True
-                {
-                    char[] lRoot;
@@ -2681 +2522 @@
-                    lRoot = AddRoot(vTemporaryPath);
-                    if (lRoot.length > 0){
-
+ == True
-                                writefln("Added root from Object Write Path = %s",lRoot);
-                        }
@@ -2692 +2533 @@
-                }
-
-cast(dchar[])"-X*")
+"-X?*"d) == True
-                {
-                    // Modules to ignore (eg. -Xmylib)
@@ -2700 +2541 @@
-                }
-
-cast(dchar[])"-M*")
+"-M?*"d) == True
-                {
-                    // Modules to notice (eg. -Mphobos)
@@ -2708 +2549 @@
-                }
-
-cast(dchar[])"-T*")
+"-T?*"d) == True
-                {
-                    // Target name (eg. -Ttestapp)
@@ -2718 +2559 @@
-                version(DigitalMars)
-                {
-
+ == True
-                {
-                    // Target name (eg. -oftestapp)
@@ -2738 +2579 @@
-                }
-
-cast(dchar[])"-R*")
+"-R*"d) == True
-                {
-                    // Response file usage (eg. -Ry)
-                    if (pArg.length == 2)
-(vUseResponseFile ? false : true)
+~vUseResponseFile
-
-                    else if (pArg[2] == 'y')
-t
+T
-
-                    else
-f
+F
-
-                    vBuildArgs ~= pArg;
@@ -2755 +2596 @@
-
-                version(Windows) {
-cast(dchar[])"-gui*")
+"-gui*"d) == True
-                    {
-                            Source.WasMainGUI = true;
@@ -2767 +2608 @@
-                            break;
-                    }
+
-                    if (pArg == "-dll")
-                    {
@@ -2790 +2632 @@
-                            lRoot = AddRoot(lCmdRoot);
-                            if (lRoot.length > 0){
-
+ == True
-                                        writefln("Added root from command line = %s",lRoot);
-                                }
@@ -2805 +2647 @@
-                }
-
+                version(Windows)
+                {
+                    // Convert non-standard but sometimes used unix seps
+                    // with standard Windows seps.
+                    pArg = std.string.replace(pArg, "/", std.path.sep);
+                }
-                switch(std.path.getExt(pArg)) {
-                   case "":
@@ -2813 +2661 @@
-                   case kSrcExtention:
-                   case kMacroExtention:
+                   case kDdocExtention:
-                       vCmdLineSourceFiles ~= pArg;
-                       break;
@@ -2837 +2686 @@
-
-    if ((pArg == "-V") || (pArg == "-v"))
-t
+T
-
-    if ( pArg.length >= 2 && pArg[0..2] == "--")
@@ -2843 +2692 @@
-        pArg = pArg[1..$];
-        if ((pArg == "-V") || (pArg == "-v"))
-f
+F
-        for(int i = vCombinedArgs.length-1; i >= 0; i--)
-        {
-            if (pArg[$-1] == '*')
-            {
-> 0
+== True
-                {
-                    vCombinedArgs = vCombinedArgs[0..i] ~
@@ -2896 +2745 @@
-}
-
-b
+B
-{
-    // From build.exe location
@@ -2906 +2755 @@
-}
-
-b
+B
-{
-    char[] lMacroDefFileName;
@@ -2936 +2785 @@
-
-
-pVerbose
+(pVerbose == True)
-        writefln("Build Macro Definition file %s", lMacroDefFileName);
-    lMacroDefLines = util.fileex.GetTextLines(lMacroDefFileName, util.fileex.GetOpt.Always);
@@ -2957 +2806 @@
-        {
-
-> 0
+== True
-            {
-                int lStartPos;
@@ -3034 +2883 @@
-
-            }
-> 0
+== True
-            {
-
@@ -3072 +2921 @@
-                                break;
-                            default:
-
+ == True
-                                    writefln("Bad Macro 'delim' option '%s'",
-                                            lOption);
@@ -3081 +2930 @@
-                }
-            }
-
+ == True
-            {
-                writefln("Bad configuration command '%s'", lArg);
@@ -3089 +2938 @@
-}
-
-b
+B
-{
-    // From build.exe location
@@ -3097 +2946 @@
-    ProcessOneBuildConfig(pArg, pVerbose, vCompilerPath);
-
-
-
-
+
+
+
+
+
+
-{
-    char[] lConfigFileName;
@@ -3114 +2966 @@
-    lConfigFileName ~= "build.cfg";
-
-pVerbose
+(pVerbose == True)
-        writefln("Build Configuration file %s [%s]", lConfigFileName, pArg);
-
@@ -3154 +3006 @@
-                    break; // Don't process any more lines.
-
-
+ == True
-                    writefln("Build Configuration file arg: %s", lArg);
-
@@ -3163 +3015 @@
-                }
-
-> 0
+== True
-                {
-                    int lStartPos;
@@ -3196 +3048 @@
-
-                }
-> 0
+== True
-                {
-                    int lPos;
@@ -3208 +3060 @@
-
-                    vLibrarian = std.path.getBaseName(lArg[7..$]);
-
+ == True
-                        writefln(" librarian path %s",vLibrarianPath);
-                        writefln(" librarian is %s",vLibrarian);
-                    }
-                }
-
+
+
+
+
+
-                {
-                    writefln("Bad configuration command '%s'", lArg);
@@ -3221 +3077 @@
-    }
-}
-
-/* ============= The User Manual ======================================
-__ /topic Introduction
-__ /info
-__ This is a utility to build an application using the D programming language.
-__ It does this by examining the source file supplied on the command line
-__ to work out its dependant files, and then determines which need to be
-__  compiled and which need to be linked to create the executable.
-__
-__ Alternatively, it can be used to create a Library file rather than an
-__  executable.
-__
-__ The aim of the utility is to help remove the need for /i make files
-__  or similar devices.
-
-__ /topic Pragma
-__ /info
-__ The /b build utility supports the use of various pragma statements.
-__ A pragma is a special statement embedded in the source code that
-__  provides information to tools reading the source code.
-__
-__ They take the forms ...
-__ /code
-__       /b"pragma(" ~<name~> /b");"
-__       /b"pragma(" ~<name~> /b"," ~<option~> [ /b","~<option~>] /b");"
-__ /endcode
-__
-__ If the D compiler doesn't recognise the pragma, it will fail. So to
-__  'hide' them from the compiler, you need to wrap them in a /b version
-__  block. All the pragmas used by this utility need to be enclosed in
-__  a /i build version.
-__
-__ Example:
-__ /code
-__       version(build) { pragma(nolink); }
-__ /endcode
-
-__ /topic Pragma
-__ /pragma link
-__ /desc This nominates one or more libraries that are required to be linked in.
-__ If your applications needs code from a library to be linked in, rather than
-__  supplying source code, you can tell /i build which libraries are needed.
-__ This can happen when using a library provided by a third-party.
-__
-__ Example 1:
-__ /code
-__       /// This app needs the MyGUI.lib library to be used.
-__       version(build) { pragma(link, MyGUI); }
-__ /endcode
-__
-__ Example 2:
-__ /code
-__       /// This app needs the a DB library and TCP library to be used.
-__       version(build) { pragma(link, EuDB, TCP4Win); }
-__ /endcode
-
-__ /topic Pragma
-__ /pragma nolink
-__ /desc This identifies that the current module is not to be be linked in.
-__ Normally, each object file created by the compiler is linked in, but
-__  if the supplied source file is just a stub for code which is externally
-__  defined in a library, then you do not need the 'stub' object file.
-__
-__ Example:
-__ /code
-__       version(build) { pragma(nolink); }
-__ /endcode
-
-__ /topic Pragma
-__ /pragma include
-__ /desc This identifies a required file which is not otherwise imported.
-__ In some applications, especially ones converted over from C, it is
-__ possible that the file on the /i Build command line does not directly
-__ or indirectly import a required file. In those situations, you can
-__ use this pragma to tell build to include it in the compilation checking
-__ process.
-__
-__ Example:
-__ /code
-__       // Tell 'build' that prime.d must be included (it contains the main function.)
-__       version(build) { pragma(include, "prime"); }
-__ /endcode
-
-__ /topic Pragma
-__ /pragma target
-__ /desc This identifies the basename of the target file.
-__ By default, the target name is based on the first file on the command line.
-__ But if you include this pragma, the name identified in the pragma becomes
-__ the default name. In either case, the -T switch overrides the default name.
-__
-__  If two or more /i target pragmas are found, the first one is the one
-__  that is used and the others are ignored (though mentioned if in
-__  verbose mode).
-__ Example:
-__ /code
-__       //// Tell 'build' to create WhizzBang.exe
-__       version(build) { pragma(target, "WhizzBang"); }
-__ /endcode
-
-__ /topic Pragma
-__ /pragma build
-__ /desc This identifies a file that needs an external program to build it.
-__ Some applications need to link in object files created by C source, or
-__ by a /i resource compiler, or whatever. This pragma identifies a file
-__ that needs to be linked in, but cannot be created by the D compiler. The
-__ format is /n
-__ /code
-__     pragma(build, "FILENAME" [, "OPTIONS"] ...);
-__ /endcode
-__ where /i FILENAME is either the file to link in, or the file to use when
-__ creating the file to link in. For example, if you had a Windows resource file
-__ that needed to be compiled, you could code the pragma as either ...
-__
-__ /code
-__     //// Compile the images into a resource obj and add images.res to linker.
-__     pragma(build, "images.rc");
-__ /endcode
-__ or /n
-__ /code
-__     //// Compile the images into a resource obj and add images.res to linker.
-__     pragma(build, "images.res");
-__ /endcode
-__
-__ The first example specifies the source file to be passed to the resource
-__ compiler and the second example specifies the output of the resource compiler.
-__ In either case, this utility uses the rules in a /"Rule Definition File" to
-__ decide what to do.
-__
-__ The utility searches for the /i"FILENAME" in the currently defined 'import'
-__ paths.
-__
-__ The /i OPTIONS can be included if you need to pass any special values
-__ to the external tool. There can be any number of these, but each one must
-__ take the form ~<KEYWORD>=~<VALUE>. For example /n
-__ /code
-__       pragma(build, "dbapi.c", "COPT=-wc -x", "HDR=abc.hp");
-__ /endcode
-__ The OPTIONS values are used as replacement text for token in the
-__ Rule Definition File's 'tool' specification. In the example above,
-__ the tokens {COPT} and {HDR}, if found in the 'tool' line, would be
-__ replaced with /i"-wc -x" and /i"abc.hp" respectively.
-__
-__ The output file to the external tool is checked to see if it is still
-__ up to date.
-__
-__ The output file from the external tool is added to the linkage set.
-__
-__ All such external programs are run before the D compiler is invoked.
-__
-__ Example:
-__ /code
-__       //// Tell 'build' that it needs to call an external program
-__       //// to build an up-to-date version of 'images.rc'
-__       version(build) { pragma(build, "images.rc"); }
-__ /endcode
-
-__ /topic Rule Definition File
-__ /info
-__ Defines the rules used to build non-D source files.
-__ This is not as advanced as the typical /b makefile abilities and is
-__ only useful for simple situations. Specifically, it only caters for
-__ applications that take a single input file to create the required
-__ output file.
-__
-__ The default Rule Definition File is called "default.rdf". It is found by
-__ first looking in the directory where the utility is installed, and if
-__ it is not found there, the directories in the PATH environment symbol
-__ are scanned.
-__
-__ The default RDF can be overridden by the -RDF command line switch.
-__
-__ Each rule is defined in a set of four mandatory lines ... /n
-__ /li rule=~<name>
-__ /li source=~<extention>
-__ /li target=~<extention>
-__ /li tool=~<command pattern>
-__
-__ Any other line in the file, not starting with one of the above keywords
-__ is simply ignored (treated as comments).
-__
-__ The /i"tool" line can contain special tokens. These are keywords enclosed
-__ in braces. At compile time, the tokens are replaced by replacement text
-__ taken from the pragma(build) statement. There are two predefined tokens
-__ that can be used. /b"{@IN}" is replaced by the name of the input file,
-__ and /b"{@OUT}" is replaced by the name of the output file.
-__
-__ /code
-__  ----- Windows Resource Compiler -----
-__  This uses ` pragma(/b'build', ~<sourcefile>.rc); `
-__  -------------------------------------
-__  rule=Resources
-__  source=rc
-__  target=res
-__ tool=rc //r {@IN} //fo {@OUT}
-__
-__  -------------------------------------
-__  DMD C linkage
-__  This uses ` pragma(build, ~<sourcefile>.c, "COPT=~<options>", "HDR=~<whatever>"); `
-__  -------------------------------------
-__ rule=DMD C/C++
-__  source=c
-__  target=obj
-__  tool=dmc -c {COPT} {@IN} -o{@OUT} {HDR}
-__
-__ /endcode
-
-__ /topic Pragma
-__ /pragma export_version
-__ /desc This allows you to set a global version identifier.
-__ DMD allows you to set a version identifier in your code, but the scope
-__ of that is only for the module it is set in. This pragma gives you the
-__ ability to declare a version identifier which is applied to all modules
-__ being compiled, and not just the 'current' module.
-__
-__ Example:
-__ /code
-__     version(build) pragma(export_version, Unix);
-__     version(build) pragma(export_version, Limited);
-__ /endcode
-__ These lines will cause the compiler to have these version identifiers
-__ added to the command line switches, thus making them effectively global.
-__
-__ You can list more than one identifier on the pragma statement ...
-__ /code
-__     version(build) pragma(export_version, Unix, Limited);
-__ /endcode
-
-__ /topic Pragma
-__ /pragma build_def
-__ /desc This supplies an option to be placed in an OptLink definition file.
-__ You can have /i build create a customised OptLink definition file
-__ by coding as many /i build_def pragmas as required. However, /i build will
-__ only allow the first of each type of Definition File command to be used. THis
-__ means that if you code ... /n
-__ /code
-__       pragma (build_def, "EXETYPE DOS");
-__       pragma (build_def, "EXETYPE NT");
-__ /endcode
-__ Then the EXETYPE DOS will be used and the 'NT' line ignored. You can use
-__ explicit build_def pragmas to override the default ones generated by
-__  /i build for Windows programs or DLL libraries.
-__
-__ The syntax for these pragma is /n
-__ /code
-__           pragma(build_def, ~<QUOTED_STRING~> );
-__ /endcode
-__
-__ Example:
-__ /code
-__   version(build) {
-__     pragma (build_def, "VERSION 1.1");
-__     version(DOS) {
-__       pragma (build_def, "EXETYPE DOS");
-__     }
-__     version(WIN) {
-__       pragma (build_def, "EXETYPE NT");
-__       pragma (build_def, "SUBSYSTEM WINDOWS,4.0");
-__     }
-__   }
-__ /endcode
-__
-__ You can supply /b any text string and it is used verbatim. There is no
-__  restrictions on what you can include in the pragma.
-
-__ /topic Auto Build Number
-__ /info
-__ Automatically Incremented Build Numbering for Modules
-__ You can optionally specify that the /i build utility automatically
-__ increments a build number for any module. You do this by supplying
-__  a single line in your source code in the form ... /n
-__ /code
-__       private import /b"~<modulename~>"_bn;
-__ /endcode
-__ Typically this line is placed immediately after the source file's
-__ /b module statement, but that is not strictly necessary.
-__
-__ By having this line in your code, /i build then uses a file with the
-__  suffix "_bn.d" to maintain
-__ the current build number for the ~<modulename~>. Note that /i build
-__  will create this file if it doesn't exist. Also note that
-__  /i build will update this file whenever the module file has been
-__  updated or its object file needs to be rebuilt, so you really
-__ shouldn't modify it manually. Any manual changes will be deleted
-__  by /i build. /n
-__
-__ Example: /n
-__ If your module is called "parser.d" you would have the lines ...
-__ /code
-__   module parser;
-__   private import parser_bn;
-__ /endcode
-__
-__ You can access the build number from within the module thus ... /n
-__
-__ /code
-__           writefln("Build number is %d", auto_build_number);
-__ /endcode
-__ You can access the build numbers of other modules in you application
-__  by importing the appropriate file and prefixing the references with
-__  the module names. /n
-__ Example:
-__ /code
-__       module parser;  /// This module's name.
-__       private import parser_bn;   /// This module's B/N
-__       private import tokenizer_bn; /// Another module's B/N
-__       . . .
-__       writefln("Builds...");
-__       writefln("  Parser %d", parser_bn.auto_build_number);
-__       writefln("  Tokens %d", tokenizer_bn.auto_build_number);
-__ /endcode
-__
-__ The "_bn.d" file created by /i build for this module would look like ... /n
-__ /code
-__   module parser_bn;
-__   /// This file is automatically maintained by the BUILD utility,
-__   /// Please refrain from manually editing it.
-__   long auto_build_number = 77;
-__ /endcode
-__ Of course the number /i 77 is just an example. This number would actually
-__  start at 1 and increment whenever /i build needed to create a new object
-__ file for the module.
-
-__ /topic Command Line
-__ /info
-__ The /i build utility supplies the source file and optional switches via the command line.
-__ The typical format of the /i build utility's command line is ... /n
-__ /code
-__       /b build ~<sourcefile~> [ ~<switches~> ] [ ~<otherfiles~> ]
-__ /endcode
-__ You can however specify the files and switches in any order you like.
-__
-__ Normally you would only supply a single file name to /i build, that being
-__  the source file of the top-level file in the application. Typically
-__  the one that has the 'main()' or 'WinMain()' function, though this is
-__  not strictly necessary.
-__
-__ If you run the utility without any files and without any switches, it
-__  display a /i help screen with some details about the switches. That looks
-__  like this ...
-__ /code
-__   Path and Version : C:\Program Files\build.exe v3.6(339)
-__   Usage: build sourcefile [options objectfiles libraries]
-__     /b sourcefile D source file
-__     /b"-v"         Verbose (passed through to D)
-__     /b"-V"         Verbose (NOT passed through)
-__     /b"-names"     Displays the names of the files used to build the target.
-__     /b"-DCPATH~<path~> ~<path~>" is where the compiler has been installed.
-__                Only needed if the compiler is not in the system's
-__                PATH list. Used if you are testing an alternate
-__                version of the compiler.
-__     /b"-CFPATH~<path~> ~<path~>" is where the D config file has been installed.
-__     /b"-full"      Causes all source files, except ignored modules,
-__                 to be compiled.
-__     /b"-link"      Forces the linker to be called instead of the librarian.
-__                 (Only needed if the source files do not contain
-__                  main/WinMain)
-__     /b"-nolink"    Ensures that the linker is not called.
-__                 (Only needed if main/WinMain is found in the source
-__                  files and you do NOT want an executable created.)
-__     /b"-lib"       Forces the object files to be placed in a library.
-__                 (Only needed if main/WinMain is found in the source
-__                  files AND you want it in a library instead of
-__                  an executable.)
-__     /b"-nolib"     Ensures that the object files are not used to form
-__                 a library.
-__                 (Only needed if main/WinMain is not found in the source
-__                  files and you do NOT want a library.
-__     /b"-obj"       This is the same as having both -nolink and -nolib
-__                 switches on the command line. It is just a shorthand.
-__     /b"-allobj"    Ensures that all object files are added to a
-__                 library.
-__                 (Normally only those in the same directory are added.)
-__     /b"-cleanup"   Ensures that all object files created during the run
-__                 are removed at the end of the run, plus other work files.
-__     /b"-clean"     Same as -cleanup
-__     /b"-test"      Does everything as normal except it displays the commands
-__                   instead of running them. Also, the auto-build-numbers are
-__                   not incremented.
-__     /b"-RDF~<path~>"  Overrides the default Rule Definition File
-__     /b"-gui[:x.y]" Forces a GUI application to be created. The optional
-__                 :x.y can be used to build an application for a
-__                 specific version of Windows. eg. -gui:4.0
-__                 (Only needed if WinMain is not found in the source files
-__                 or if you wish to override the default Windows version)
-__     /b"-dll"       Forces a DLL library to be created.
-__                       (Only needed if DllMain is not found in the source files.
-__     /b"-LIBOPT~<opt~>" Allows you to pass ~<opt~> to the librarian
-__     /b"-LIBPATH=~<pathlist~>" Used to add a semi-colon delimited list
-__                 of search paths for library files.
-__     /b"-X~<module~>" Packages and Modules to ignore (eg. -Xmylib)
-__     /b"-M~<module~>" Packages and Modules to notice (eg. -Mphobos)
-__     /b"-T~<targetname~>" The name of the target file to create. Normally
-__                 the target name istaken from the first or only name
-__                 of the command line.
-__     /b"-R~<y|n~>" Indicates whether to use a response file or command line
-__                    arguments with the compiler tools.
-__                  /b"-Ry" will cause a response to be used.
-__                  /b"-Rn" will cause command line arguments to be used.
-__                  /b"-R" will reverse the current usage.
-__                   Note that the default for Windows DigitalMars is to use a response file
-__                   but for all other environments it is to use command line arguments.
-__     /b"-info"      Displays the version and path of the Build application
-__     /b"-help"      Displays the full 'usage' help text.
-__     /b"-h"         Same as /-help, displays the full 'usage' help text.
-__     /b"-?   "      Same as /-help, displays the full 'usage' help text.
-__     /b"-silent"    Avoids unnecessary messages being displayed.
-__     /b"-noautoimport" Turns off the automatic addition of source paths
-__                    to the list of Import Roots.
-__     /b"-run~<param~>"   If the link is successful, this will cause the
-__                    executable just created to run. You can give it
-__                    run time parameters. Anything after the '-run' will
-__                    placed in the program's command line. You will need
-__                    to quote any embedded spaces.
-__     /b"-od~<path~>"  Nominate the directory where temporary (work) files
-__                    are to be created. By default they are created in
-__                    the same directory as the target file.
-__     /b"-nodef"     Prevents a Module Definition File being automatically created.
-__                 This will override any pragma(/build_def) statements in the
-__                 source code.
-__     /b"[...]"      All other options, objectfiles and libraries are
-__                 passed to the compiler
-__ /endcode
-__
-__ See also /"Response File"
-
-__ /topic Switches
-__ /info
-__ /i Build supports a number of command line switches to control its default assumptions.
-
-
-__ /topic switches
-__ /switch -nodef
-__ /desc Prevent a Module Definition File being created.
-__ Normally, the utility will automatically create a Module Definition File
-__ for the linker. This will typically contain the EXETYPE command and any other
-__ commands as specified in any pragma(/build_def) statements found in the source files.
-__ If you specify this switch, you will have to provide your own Module Definition
-__ File or its equivalent on the command line.
-
-__ /topic switches
-__ /switch -v
-__ /desc Set /i verbose mode on for both /i build and for the compiler
-
-__ /topic switches
-__ /switch -V
-__ /desc Set /i verbose mode on for just /i build and not for the compiler
-
-__ /topic switches
-__ /switch -names
-__ /desc Displays the names of the files used in building the target.
-
-__ /topic switches
-__ /switch -DCPATH
-__ /desc  Identifies where the compiler has been installed.
-__ Normally, /i build scans the PATH environment symbol to find where the
-__  D compiler is located. However, if you need to use the compiler from
-__  a different location, you would use this switch to tell /i build where
-__  it is.
-__
-__ /b"Note:" If you use this switch, and the current CFPATH value is
-__ identical to the current DCPATH value, then this switch will change
-__ both to the new value. The assumption is that the configuration
-__ file is in the same directory as the compiler. If this is not the case,
-__ you will also need to use the /-CFPATH switch.
-__
-__ Example:
-__ /code
-__   -DCPATHc:\old\dmd\bin
-__ /endcode
-
-__ /topic switches
-__ /switch -CFPATH
-__ /desc Identifies where the D config file has been installed.
-__ Normally, /i build looks in the same place that the compiler is
-__  installed in, but if you need to use a different configuration
-__  path from that, you would use this switch to tell /i build where
-__  it is.
-__
-__ Example:
-__ /code
-__   -CFPATHc:\myproject\configs
-__ /endcode
-
-__ /topic switches
-__ /switch -full
-__ /desc Causes all source files, except ignored modules, to be compiled.
-__ Normally, /i build only compiles a source file if it's object file
-__ is out of date or missing. This switch forces all source files to be
-__  recompiled, even if not strictly required.
-__
-__ /b "Note:" Modules in the /i ignore list are still ignored though.
-
-__ /topic switches
-__ /switch -link
-__ /desc Forces the linker to be called instead of the librarian.
-__ Normally, if /i build does not find a main() or WinMain() function
-__  in the source files, it creates a library to contain the object
-__ files. But when this switch is used, /i build will attempt to
-__  create an application by calling the linker rather than the librarian.
-__
-__ You would typically use this if the main() function was being supplied
-__ from an existing library file rather than one you your source files.
-
-__ /topic switches
-__ /switch -run
-__ /desc Runs a program after successful linking.
-__ If the link is successful, this will cause the
-__ executable just created to run. You can give it
-__ run time parameters. Anything after the '-run' will
-__ placed in the program's command line. You will need
-__ to quote any embedded spaces.
-__
-__Example:
-__/code
-__     -run"abc.de second"
-__/endcode
-
-__ /topic switches
-__ /switch -od
-__ /desc Nominates the temporary file directory.
-__ By default, the utility creates any work files in the same directory
-__ as the target file. You can use this switch to nominate an alternative
-__ location for these files. The directory is created if it doesn't exist.
-__
-__ For the DigitalMars compiler, this also specifies the top-level
-__ location where object files are created. By default, object files
-__ are created in the same directory as the corresponding source file.
-__
-__ Example:
-__ /code
-__         -odC:\temp\workarea
-__ /endcode
-
-__ /topic switches
-__ /switch -nolink
-__ /desc  Ensures that the linker is not called.
-__ Normally, if /i build finds a main() or WinMain() function, it
-__ tries to create an application by calling the linker. If you use
-__  this switch however, the linker will not be called.
-__
-__ You would typically do this if you wanted to create a library that
-__ stores your 'main' function in it, in which case you'd also use the /-lib
-__  switch. But you could just create a set of object files without linking
-__  them with this switch.
-
-__ /topic switches
-__ /switch -lib
-__ /desc Forces the object files to be placed in a library.
-__ Normally, if /i build finds a main() or WinMain() function, it
-__ tries to create an application by calling the linker. But if you
-__  use this switch, the librarian is called instead of the linker.
-__
-__ You would typically do this if you wanted to create a library that
-__ stores your 'main' function in it, in which case you'd also use the /-nolink
-__ switch.
-
-__ /topic switches
-__ /switch -obj
-__ /desc Shorthand for using both /"-nolink" and /"-nolib" switches.
-__ This is literally the same has if you had placed both -nolink and
-__ -nolib on the command line. As this is a common way to just compile
-__ modules to get the object files for them, without doing anything else,
-__ a neat shorthand is available.
-
-__ /topic switches
-__ /switch -nolib
-__ /desc Ensures that the object files are not used to form a library.
-__ Normally, if /i build does not find a main() or WinMain() function,
-__  it calls the librarian to create a library for all your object files.
-__ But if you use this switch, the librarian is not called.
-__
-__ Typically, you would do this if you just wanted to create one or more
-__  object files and do nothing else.
-
-__ /topic switches
-__ /switch -allobj
-__ /desc Ensures that all object files are added to a library.
-__ Normally, /i build will only create a library using the object files
-__  that are in the same directory as the new library. You would use
-__  this switch if you wanted all object files created by this build
-__ session to be included in the library.
-
-__ /topic switches
-__ /switch -cleanup
-__ /desc Ensures that all working files created during the run are removed.
-__ Normally, /i build does not delete any object files or working files
-__ when it finishes a session. You can use this switch to have /i build
-__  clean up after itself. This will remove all object files created
-__  in this run, plus any .rsp, .lsp, .bak, .map, .lst, .def files.
-__
-__  /b Note: This can also be supplied as /b"-clean" as an alias.
-
-__ /topic switches
-__ /switch -LIBOPT
-__ /desc Allows commandline options to be passed to the librarian.
-__ Example:
-__ /code
-__     (Set the page size to 32Kb)
-__     -LIBOPT-p32
-__
-__     (Embedded spaces enclosed in quotes.)
-__     "-LIBOPT -l -i"
-__ /endcode
-
-__ /topic switches
-__ /switch -LIBPATH
-__ /desc Used to add a list of search paths for library files.
-__This might be used when you don't want to permanently update the
-__ standard search paths.
-__ Example:
-__ /code
-__     -LIBPATH=c:\mylibs;d:\3rdparty;c:\lib\debuglibs
-__ /endcode
-
-__ /topic switches
-__ /switch -R
-__ /desc Determines if the compiler tools use a response file or not.
-__ For /i DigitalMars tools in the Windows environment, a response file is
-__  the default, but for /i other tools and other operating systems the
-__  default is to use command line arguments.
-__
-__ The switch has three formats: /n
-__  -Ry to use a response file /n
-__  -Rn to use command line arguments /n
-__  -R to reverse the current setting.
-__
-__ The use of a response file is only really needed when the command line
-__ arguments are going to be more than the operating system can handle
-__ on a single command line. However, it is always a safe option, so if
-__ in doubt you may as well use it.
-__
-__ A response file contains all the arguments that would have gone on the
-__ command line. They are arranged as one argument per line.
-__
-__ Not all tools respect the response file idea however the Windows based
-__  DigitalMars tools do understand it.
-__
-__  Without a response file the compiler might be invoked thus:
-__ /code
-__   dmd -op -release appmain.d somemod.obj -IC:\DLibs
-__ /endcode
-__ But with a response file, these arguments are first written out to
-__ a text file (the response file) and the compiler is invoked :
-__ /code
-__   dmd @appmain.rsp
-__ /endcode
-__ The /i "appmain.rsp" would contain the lines :
-__ /code
-__   -op
-__   -release
-__   appmain.d
-__   somemod.obj
-__   -IC:\DLibs
-__ /endcode
-
-__ /topic switches
-__ /switch -test
-__ /desc Does a test run only. No compiling, linking or library work is done.
-__ This will display the command lines instead of running them. It can be used
-__ to see what would happen without actually building anything.
-
-__ /topic switches
-__ /switch -RDF
-__ /desc Defines a file to override the default /"Rule Definition File"
-__ The default file is called "default.rdf". If you need to provide
-__ an alternate file, you can use this switch.
-__
-__ Example:
-__ /code
-__     -RDFmyrules.xyz
-__ /endcode
-
-__ /topic switches
-__ /switch -dll
-__ /desc Forces a DLL library to be created.
-__ /b"Note:" This only applies to Windows environment.
-__
-__ Normally, if /i build finds a DllMain() function it automatically
-__  creates a DLL library. However, if you need to force a DLL
-__  library, you would use this switch.
-
-__ /topic switches
-__ /switch -gui
-__ /desc Forces a GUI application to be created.
-__ /b"Note:" This only applies to Windows environment.
-__
-__ Normally, if /i build finds a WinMain() function it automatically
-__  creates a GUI application. However, if you need to force a GUI
-__  application, you would use this switch.
-__
-__ This switch can also be used to specify which version of Windows to
-__  build the application for. To do this, it takes the format of
-__ -gui:X.Y where /i"X.Y" is the Windows version number. Use 4.0
-__  for Windows NT, 2000, and ME, and 5.0 for Windows XP.
-__
-__ By default, /i build uses the version of Windows it is running under.
-
-__ /topic switches
-__ /switch -info
-__ /desc Displays the version and path of the /i build application
-
-__ /topic switches
-__ /switch -help
-__ /desc Displays the full text of the Usage information.
-__ This has the aliases of "-h" and "-?"
-
-__ /topic switches
-__ /switch -silent
-__ /desc Prevents unnecessary messages being displayed.
-__ Some messages are just informational and under some circumstances they
-__ can interfer with reading the output.
-
-__ /topic switches
-__ /switch -noautoimport
-__ /desc Prevents source file paths from being added to the list of Import Roots
-__ By default, for each source file that imports a module, it's path is added
-__ to the list of paths that will be searched for module source files. If you
-__ do not wish that behaviour, you will need to use this switch. In that case,
-__ the compiler will only search the paths specified in the compiler's
-__ configuration file, the current directory, and any explicitly added paths
-__ on the command line.
-__
-__ Example:
-__ /code
-__      build myApp -noautoimport
-__ /endcode
-
-__ /topic switches
-__ /switch -X
-__ /desc Identifies a module or package to ignore
-__ Normally, /i build assumes that all imported modules are available
-__ to be recompiled if required. You would use this switch if you explictly
-__  did not want /i build to recompile a module.
-__
-__ /b"Note:" The /i Phobos package of modules is automatically ignored. This
-__  means that /i build does not try to recompile phobos.
-__
-__ Example - ignore the 'parser' module (or package)
-__ /code
-__       -Xparser
-__ /endcode
-
-__ /topic switches
-__ /switch -M
-__ /desc Identifies a module or a package to notice (not ignore)
-__ You would use this to name any module that is not part of the target's
-__ dependancies, or is one of the /i ignored modules.
-__
-__ You can use this switch to recompile /i phobos.
-__
-__ Example (notice the Phobos package):
-__ /code
-__   -Mphobos
-__ /endcode
-
-__ /topic switches
-__ /switch -T
-__ /desc Identifies the target name to build.
-__ Normally, /i build derives the target name from the first file name
-__ on the command line, or from the pragma(target) if present.
-__ If however, you wish to override that, use this switch.
-__
-__ /b"Note:" This switch allows the use of a special token, /b"{Target}",
-__ which is replaced by the default target name. You can use
-__ to create a generic /"Response File" that can be used for building
-__ any application.
-__
-__ Example
-__ /code
-__       -Ttestapp
-__
-__       -Ttest_(Target}  # Generate a name based on the default name.
-__ /endcode
-
-__ /topic Response File
-__ /info
-__ A response file is a file that contains command line values.
-__
-__ You can specify all or any command line values in a
-__ response file. Each value appears in its own line in the
-__ response file and you reference this file by prefixing
-__ its name with an '@' symbol on the command line.
-__
-__ You may place comments in a response file. A comment starts
-__  with a /b'#' character and extends to the end of the line.
-__
-__ Example:
-__ /code
-__    build @final
-__ /endcode
-__ where a file called 'final.brf' contains the command
-__ line values, including other response file references.
-__
-__ Example: (contents of final.brf)
-__ /code
-__     # This creates a production (release) edition of the app.
-__     -T{Target}_release  # Set the name of the executable.
-__     -release   # Don't generate runtime checks.
-__     -full      # Force compilation of all files.
-__     -cleanup   # remove work files when completed
-__     -inline    # Allow inlining to occur
-__ /endcode
-__
-__ The command line for your build could then look like ...
-__ /code
-__     build myapp @final
-__ /endcode
-__
-__ If the response file reference is just a single '@' then
-__  build looks for a file called 'build.brf'
-__
-__ You can any number of response file references on a command line. They
-__  are processed in the order they appear.
-
-
-__ /topic Configuration File
-__ /info
-__ The utility configuration file is used to specify your default options for the utility.
-__
-__ Each option is specified in a single text line, but you can have any
-__ number of option lines in the configuration file.
-__
-__ The options take the form of
-__ /code
-__      ~<COMMAND~>=~<VALUE~>
-__ /endcode
-__
-__ /b"Supported Commands" /n
-__ The commands currently supported are ... /n
-__ /b CMDLINE /n
-__ You can specify all command line switch values with this configuration
-__ option. You can also specify multiple switches on the same option line./n
-__ /code
-__     CMDLINE=-inline -w
-__ /endcode
-__
-__ /b LIBCMD /n
-__ This specifies the location and program name for the librarian application
-__ you want to invoke when creating libraries. /n
-__ /code
-__    LIBCMD=D:\Applications\dm\bin\lib.exe
-__ /endcode
-__
-__ /b"Environment Symbol Substitution" /n
-__ Before each configuration file option line is processed, it is first checked
-__ for any references to Environment symbols. Each reference is replaced by
-__ the value of that symbol. References take the form /b"%~<SYMNAME~>%" /n
-__ There are two special symbols: /b"@D" is replaced by the compiler's
-__ path, and /b"@P" is replaced by the compiler's configuration file's path.
-__
-__Example: Assuming you had set BUILDOPTS=-w -g
-__ /code
-__   CMDLINE=%BUILDOPTS%    # Allow switches to be passed via enviroment symbol.
-__ /endcode
-__ would mean that "-w -g" would be automatically placed on the utility's
-__ commandline whenever you ran it.
-__
-__ /b"Groups" /n
-__ It is possible to specify groups of configuration options that are only
-__ applied if explictly nominated on the command line. A group starts with
-__ a line in the format /b"[~<groupname~>]" where /i groupname can be any
-__ text that doesn't include spaces. A group ends on the last line before the
-__ next group in the file.
-__
-__ Example of a Group
-__ /code
-__    [dbg] # To produce a debug edition of an application.
-__    CMDLINE=-unittest
-__    CMDLINE=--release
-__    CMDLINE=--inline
-__    CMDLINE=-g
-__    CMDLINE=-w
-__    CMDLINE=-full
-__    CMDLINE=-T{Target}_{Group}
-__ /endcode
-__
-__ All the options lines before the first group are known as the default
-__ options because these are always applied. To apply the options in a group
-__ you need to specify which group(s) you want on the command line, or via
-__ a /"response file". The group name is prepended with a plus sign on
-__ the command line. To apply the 'debug' group in the above example, you
-__ place on the command line /b"+dbg"
-__
-__ /b"Comments" /n
-__ You may place comments in a configuration file. A comment starts
-__  with a /b'#' character and extends to the end of the line.
-__
-__ Example:
-__ /code
-__    build myapp.d +final
-__ /endcode
-__ where if a group called '[final]' is contained in any configuration
-__ file, the options in that group are used.
-__
-__ Example: (contents of [final])
-__ /code
-__     # This creates a production (release) edition of the app.
-__     [final]
-__     CMDLINE=-T{Target}_{Group}  # Set the name of the executable.
-__     CMDLINE=-release   # Don't generate runtime checks.
-__     CMDLINE=-full      # Force compilation of all files.
-__     CMDLINE=-cleanup   # remove work files when completed
-__     CMDLINE=-inline    # Allow inlining to occur
-__     CMDLINE=--debug*   # Turn off any debug switches
-__     CMDLINE=--unittest # Turn off any unittest switches
-__     CMDLINE=--w        # Turn off warnings
-__     CMDLINE=--g        # Turn off embedded debug symbolic info.
-__ /endcode
-__
-__ You can any number of configuration file group references on a command line. They
-__  are processed in the order they appear.
-
-__ /topic To Do
-__ /info
-__ Ideas that have yet to be implemented.
-__ Note that some of these may never be implemented but they are still
-__ listed here as a reminder.
-__
-__ /li Be able to update a library rather than just create libraries.
-__ /li Support the concept of a 'Plugin' block of code. /n
-__ /code
-__  version (build) pragma(plugin, ~<tool>[,delim=xxx],[, ~<parms>] ) { [body] }
-__ /endcode
-__ This block would be replaced by the stdout data of calling 'tool ~<params>' and
-__  sending it the content of ~<body> via stdin.
-__ /li Support limited preprocessor capability. /n
-__ Something like pragma(macro, ~<preprocessor commands>); and replacing
-__ source text of the form @{tokenname}@ with the value of the token.
-
-__ /topic DLL Libraries
-__ /info
-__ How to create a DLL library using Build.
-__ When Build finds a DllMain() function, or the -dll switch is used, it
-__ creates a special type of Module Definition file, and sets the target to
-__ to be a DLL file. The Module Definition file generated takes the form ...
-__ /code
-__     LIBRARY "~<targetname>.dll";
-__     EXETYPE NT
-__     SUBSYSTEM WINDOWS,~<version>
-__     CODE PRELOAD DISCARDABLE SHARED EXECUTE
-__     DATA PRELOAD SINGLE WRITE
-__ /endcode
-__
-__ You can replace any of these by explicitly coding a pragma(/build_def)
-__ with different options than these defaults shown here.
-__
-__ Also, if you have the program /b implib in your path, it will be run
-__ after the DLL file is created, in order to also create a /b".lib"
-__ library to interface with the DLL. Build currently supports both the
-__ DigitalMars version and the Borland (Inprise) version of /b implib.
-*/

trunk/Source/build.def

@@ -1 @@
-9
+10
-EXETYPE DOS

trunk/Source/build.ksp

@@ -1 @@
-
-
-
-
-
-
-
+
+
+
+
-build.def
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+

trunk/Source/build.rsp

@@ -1 @@
--release
--inline
--op
-
-
-
-
-
-
+
+
+
+
-build_bn.d
-util\pathex.d
-util\fileex.d
-util\str_bn.d
-util\macro.d
-source.d
-source_bn.d
-
+
+
+
+
+
-util\fdt.d
+util\fdt_bn.d
+util\pathex.d
-util\pathex_bn.d
-
-
-
+
-util\fileex_bn.d
+util\macro.d

trunk/Source/build_bn.d

@@ -2 +2 @@
-// This file is automatically maintained by the BUILD utility,
-// Please refrain from manually editing it.
-19
+55

trunk/Source/source.d

@@ -51 +51 @@
-    import util.fileex;
-    import util.macro;
+    import util.booltype;
-
-    import std.stdio;
@@ -96 +97 @@
-    void function(char[] pArg) AddCompilerArg;
-    char[][] function () GetImportRoots;
-b
+B
-    void function(char[] pPath) AddTarget;
-    void function(char[] pPath) AddLink;
@@ -102 +103 @@
-    void function(char[] pText, bool pReplace=false) AddBuildDef;
-    char[][] function( ) ModulesToIgnore;
-
+
+
-    char[] function() GetObjWritePath;
-    Substitute[] function() GetMacros;
-
-bool mVerboseMode = fals
-bool mMacroInput = false
+Bool mVerboseMod
+Bool mMacroInput
-
-}
@@ -122 +124 @@
-    AttributeBlocks["public"] = true;
-    AttributeBlocks["export"] = true;
+    mVerboseMode = False;
+    mMacroInput = False;
-    debug(1)
-    {
@@ -130 +134 @@
-public class Source {
-    private static Source[char[]] SourceIndex;
+    private static char[][] ScanOrder;
-
-    private {
@@ -180 +185 @@
-
-// --------------------------------------------------------------------
+    static void Finalize()
+// --------------------------------------------------------------------
+    {
+        for(int i = ScanOrder.length-1; i >= 0; i--)
+        {
+            Source x;
+            x = SourceIndex[ScanOrder[i]];
+            delete x;
+        }
+    }
+
+// --------------------------------------------------------------------
-    this(char[] pFileName)
-// --------------------------------------------------------------------
@@ -187 +204 @@
-        mReferencedImports.length = 0;
-        mHasBeenSearched = false;
-        mNoLink = false;
-        mIgnore = false;
-        mFileName = pFileName;
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
-        version(DigitalMars)
@@ -201 +228 @@
-           prepend the specified object location path.
-        */
-
+ && mObjectName.length != 0
-        {
-            if (mObjectName == lObjectName)
@@ -219 +246 @@
-        UpdateDependantTime(mObjectTime);
-
-
+ == True
-            writefln("Time %s for %s",mFileTime.toString(),mFileName);
-            writefln("Time %s for %s",mObjectTime.toString(),mObjectName);
@@ -230 +257 @@
-    }
-
+// --------------------------------------------------------------------
+    ~this()
+// --------------------------------------------------------------------
+    {
+        // writefln("Finis: %s", mFileName);
+    }
+
+
+// --------------------------------------------------------------------
-    void search() {
+// --------------------------------------------------------------------
-        char[] [] lFiles;
-        FileDateTime lCurFileTime;
@@ -237 +274 @@
-        char[] lFileText;
-
-
+
+
-            return;
-        }
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
-
-        // Check if any macro processing is required.
-mMacroInput
+(mMacroInput == True)
-        {
-            if (util.macro.RunMacro(lFileText, GetMacros()))
@@ -258 +299 @@
-                mHasBeenSearched = true;
-                mIgnore = true;
-
+ == True
-                  writefln("Macro output %s", lNewFile);
-                }
@@ -271 +312 @@
-        lCurFileTime = new FileDateTime();
-        // Examine each extracted module file.
-t
+T
-        {
-
-            AddRoot( std.path.getDirName(util.pathex.CanonicalPath(mFileName, false)) );
-        }
-
+
+
-            if(lNextFile in SourceIndex) {
-                // Known file so just grab its mod time
@@ -348 +390 @@
-
-                        if( lFindPos >= 0) {
-
+ == True
-                                writefln("Ignoring %s (%s: %s)", lNextFile, lType, lNextModule);
-
@@ -358 +400 @@
-                if (lCanUse){
-                    // Not known yet, so add it and grab its mod time
-(lNextFile
+Scan(lNextFile, ~0
-                    lCurFileTime = (new Source(lNextFile)).DependantsTime;
-                }
@@ -369 +411 @@
-
-        mHasBeenSearched = true;
-    
-
-
+
+
+
-    void UpdateDependantTime(FileDateTime pDateTime)
+// --------------------------------------------------------------------
-    {
-        if (pDateTime > mDependantsTime)
-        {
-
+ == True
-            {
-                writefln("Updating %s dependants time from %s to %s",
@@ -397 +440 @@
-    static void WasMainDLL(bool pValue) { mainDLL = pValue; }
-
+// --------------------------------------------------------------------
-    bool IncrementBuildNumber()
+// --------------------------------------------------------------------
-    {
-        char[] lFileName;
@@ -535 +580 @@
-
-        lblNextToken:
- {
-
+
+
-            switch(lCurToken) {
-                case kOpenBrace:
@@ -602 +647 @@
-                    break;
-
+                case "Ddoc":
+                    if (lPrevToken.length == 0)
+                    {
+                        // Only applies if 'Ddoc' is first token in file.
+                        mNoLink = true;
+                        break lblNextToken;
+                    }
+                    break;
+
-                case "pragma":
-                    doPragma(pFileText, pPos);
@@ -906 +960 @@
-        {
-            mModuleName = lModName;
-
+ == True
-            {
-                writefln("Module name set to '%s'", mModuleName);
@@ -1049 +1103 @@
-                {
-                    lCurrentToken = GetNextToken(pFileText,pPos);
-
+
+
-                        lCurrentToken = GetStringLit(pFileText,pPos, lCurrentToken[0]);
-                    }
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-                }
-
@@ -1260 +1335 @@
-    lFileName = util.str.ReplaceChar(pModuleName.dup, '.', std.path.sep[0]);
-    // Add the 'd' extention and append the full path
-( addExt( lFileName, "d" )
-
-
+Scan( addExt( lFileName, "d" ), ~0
+
+ == True
-        writefln(" module->file %s => %s",pModuleName,lFileName);
-    }
@@ -1297 +1372 @@
-    lModuleName = util.str.ReplaceChar(lModuleName, std.path.sep[0], '.');
-
-
+ == True
-        writefln(" file->module %s => %s",pFileName,lModuleName);
-    }
@@ -1324 +1399 @@
-        foreach (char[] lLine; lFileLines)
-        {
-
+== True 
-            {
-                for(int i = find(lLine,"=") + 2; i < lLine.length; i++)
@@ -1406 +1481 @@
-    version(D_InlineAsm)  ActivateVersion("D_InlineAsm");
-
-
+ == True
-        foreach(char[] k; vActiveVersions.keys){
-            writefln("Active Version: '%s'", k);

trunk/Source/source_bn.d

@@ -2 +2 @@
-// This file is automatically maintained by the BUILD utility,
-// Please refrain from manually editing it.
-04
+40

trunk/Source/util/fdt_bn.d

@@ -2 +2 @@
-// This file is automatically maintained by the BUILD utility,
-// Please refrain from manually editing it.
-81
+117

trunk/Source/util/fileex.d

@@ -45 +45 @@
-    import std.path;
-    import std.ctype;
-
-
-
-
-
-
-
+
+
+
+
+
-
-}
@@ -77 +75 @@
-{
-    char[] lFileText;
-
-    if (std.file.exists( pFileName))
-    {
@@ -97 +94 @@
-    char[][] lLines;
-    char[]   lText;
-
-    lText = GetText(pFileName, pOpt);
-std.string
+util.str
-    return lLines;
-}
+void GetTextLines(char[] pFileName, out dchar[][] pResult, GetOpt pOpt = GetOpt.Always)
+{
+    dchar[]   lText;
+
+    lText = std.utf.toUTF32(GetText(pFileName, pOpt));
+    pResult = util.str.splitlines( lText );
+}
+
+void GetTextLines(char[] pFileName, out wchar[][] pResult, GetOpt pOpt = GetOpt.Always)
+{
+    wchar[]   lText;
+
+    lText = std.utf.toUTF16(GetText(pFileName, pOpt));
+    pResult = util.str.splitlines( lText );
+}
+
+void GetTextLines(char[] pFileName, out char[][] pResult, GetOpt pOpt = GetOpt.Always)
+{
+    char[]   lText;
+
+    lText = GetText(pFileName, pOpt);
+    pResult = util.str.splitlines( lText );
+}
+
-
-enum CreateOpt
@@ -129 +149 @@
-        for(int i = lText.length-1; i >= 0; i--)
-        {
-
+std.string.
-            {
-                if (i != lText.length-1)
@@ -150 +170 @@
-
-    // Split into lines, disregarding line-end conventions.
-std.string
+util.str
-    // Write out the text using the opsys' line-end convention.
-    CreateTextFile(pFileName, lLines, pOpt);
+}
+
+int grep(char[] pData, char[] pPattern)
+{
+    return std.regexp.find(pData, pPattern, vGrepOpts[$-1]);
-}
-
@@ -163 +188 @@
-    auto char[] lBuffer;
-    int lPos;
+    int lStartPos;
-    ulong[] lResult;
-
-// TODO //
-
+
+char[] lGrepOpt;
+
-
-    lCaseSensitive = true;
-    if (find(pOptions, 'i') != -1)
-        lCaseSensitive = true;
-    if (find(pOptions, 'I') != -1)
-        lCaseSensitive = true;
-
-    lRegExp = false;
-
-
-
-
-
+
-    lWordOnly = false;
-    if (find(pOptions, 'w') != -1)
-        lWordOnly = true;
-    if (find(pOptions, 'W') != -1)
-        lWordOnly = true;
-
-    lCounting = true;
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-    lBuffer = cast(char[])std.file.read(pFileName);
-
-lPos = 0;
-
-while ( (lPos = find(lBuffer[lPos..$], pText)) != -1)
-{
+
+// Locate next instance and process it.
+
+{
+    lPos += lStartPos;
-        if (lWordOnly)
-        {
+            // A 'word' is an instance not surrounded by alphanumerics.
-            if (lPos > 0)
-            {
-                if (std.ctype.isalnum(lBuffer[lPos-1]) )
-                {
+                    // Instance preceeded by a alphanumic so I
+                    // move one place to the right and try to find
+                    // another instance.
-                    lPos++;
-                    continue;
@@ -212 +274 @@
-                if (std.ctype.isalnum(lBuffer[lPos + pText.length - 1]) )
-                {
+                    // Instance followed by a alphanumic so I
+                    // move one place to the right and try to find
+                    // another instance.
-                    lPos++;
-                    continue;
@@ -218 +283 @@
-        }
-
-
-
+
+
+
+
+
-        if (lCounting)
-        {
@@ -227 +295 @@
-        }
-
+        // Skip over current instance.
-        lPos += pText.length;
+
+        // If there is not enough characters left, then stop searching.
-        if ((lBuffer.length - lPos) < pText.length)
-            break;
-
+
+
+
+
+
-    return lResult;
-}

trunk/Source/util/fileex_bn.d

@@ -2 +2 @@
-// This file is automatically maintained by the BUILD utility,
-// Please refrain from manually editing it.
-758
+1243

trunk/Source/util/linetoken_bn.d

@@ -2 +2 @@
-// This file is automatically maintained by the BUILD utility,
-// Please refrain from manually editing it.
-859
+1322

trunk/Source/util/pathex.d

@@ -46 +46 @@
-    import util.str;
-    import util.fileex;
+    import util.booltype;
-
-    import std.path;
@@ -81 +82 @@
-    lCurDir =  getcwd();
-    // Ensure that it ends in a path separator.
-lCurDir[$-std.path.sep.le