Changes between Version 7 and Version 8 of CommandLine

Timestamp:

10/14/12 21:43:25 (12 years ago)

Author:

hopscc

Comment:

--

CommandLine

@@ -1 @@
-== Command Line ==
+== Cobra Compiler Command Line ==
 
 Quick examples:
@@ -59 +59 @@
    options form : -[option or synonym]:value
 
-=== -Reference/-Ref ===
+=== '''-reference/-ref''' ===
   * Specifies a file (in .Net an assembly file) that can resolve 'using namespace' references.
 
@@ -93 +93 @@
 
 
-TODO Sections
-    * Files:file
-    * Controlling type of executable built -target/-t
-    * Providing references and library search path -reference/-ref -library-directory/-lib -embed-run-time/-ert
+=== '''-files:filename''' ===
+Specify a filename containing a list of files to compile.
+
+Files are specified one sourcefile name per line and lines may be space separated.
+Lines containing a leading '#' are ignored as comment or documentary information
+
+Source filenames should be given as specified on the command line ( filenames,partial or absolute pathnames with or without an explicit '.cobra' suffix').
+
+This option is an accumulator so multiple occurrences will specify multiple files whoose contents will aggregate together.
+
+e.g.
+Given a file named srcFiles containing
+{{{
+#srcFiles: cobra source files for ...
+
+main.cobra
+input
+
+#Useful utilities local to this project
+utils.cobra
+}}}
+
+the following compilation line
+{{{
+cobra -c -files:srcFiles
+}}}
+is exactly the same as 
+{{{
+cobra -c main.cobra input utils.cobra
+# which is the same as 
+#cobra -c main.cobra input.cobra utils.cobra
+}}}
+
+This is useful compiling an executable with a large number of or non trivial hierarchy of source files.
+
+
+
+=== '''-target/-t''' ===
+Specifies the types of executable built where such needs specifying explicitly (.Net).
+
+Current examples include: executable, GUI executable, Library.
+
+Defaults to 'normal' executable
+
+Values of this option can be a choice of one of :
+  * exe - build a normal executable
+  * winexe - build a windows executable ( .Net) 
+     * Program is assumed to be a GUI program providing its own windows.  
+     * Suppresses creation of a console window if not run from a console.
+  * lib - build a Library file (a .dll on .Net)
+  * module - build a module
+
+{{{
+e.g.
+cobra -c codeFile.cobra
+# build/compile a standard executable from cobra source in codeFile.cobra
+
+cobra -c -t:exe codeFile.cobra
+# same as above 
+
+cobra -c -t:winexe  codeFile.cobra
+# compile a windows(GUI) executable from cobra source in codeFile.cobra
+
+cobra -c -t:lib codeFile.cobra
+# build/compile a library file (dll) from cobra source in codeFile.cobra
+# this is intended to be used as the target of a -ref option
+}}}
+
+
+
+=== TODO Sections ===
+    * Providing references and library search path -library-directory/-lib -embed-run-time/-ert
     * Controlling compilation -include-{asserts, nil-checks, tests}  
        * -optimize/-o -debug/-d -turbo/-t