Recent changes to CompilingProject

CompilingProject modified by Romiras

Romiras — Thu, 19 Jun 2014 10:32:44 -0000

--- v4
+++ v5
@@ -6,14 +6,16 @@

 ## Sample Hello module

+For example, we create a module Hello what is part of subsystem Priv (e.g. it located at path Priv/Mod/Hello.cp). 
+
 **Hello.cp**

-    MODULE Hello;
+    MODULE PrivHello;
     IMPORT Out;
     BEGIN
-      Out.String ("Hello world!");  Out.Ln
-    END Hello.
+      Out.String ("Hello world!"); Out.Ln
+    END PrivHello.

 ## Project

CompilingProject modified by Romiras

Romiras — Thu, 19 Jun 2014 10:32:44 -0000

--- v3
+++ v4
@@ -69,20 +69,20 @@

 ### Sample Project

-In order to build program for native system you need create a project document for module "Hello". 
+In order to build program for native OS you need create a project document for module "PrivHello". 

 **Hello.prj**

     [Project]
-    ProjectName=hello
+    Name=<project name>

     [Compiler]
-    Module=Examples/Mod/Hello.cp
-    CompilerOptions=
+    Modules=PrivHello
+    Options=<compiler options>

     [Linker]
-    LinkedModules=Kernel$+ Math Strings Console WinConsole HostInit Init Out Hello#
+    InterfaceModules=Kernel$+ Math Strings Console WinConsole HostInit Init Out PrivHello
     OutputMode=Exe
     OutputFile=hello.exe

CompilingProject modified by Romiras

Romiras — Thu, 19 Jun 2014 10:32:43 -0000

--- v2
+++ v3
@@ -22,15 +22,15 @@

     [Project]
-    ProjectName=<project name>
+    Name=<project name>

     [Compiler]
-    Module=<relative path to module>
-    CompilerOptions=<compiler options>
+    Modules=<ModuleName1 ModuleName2 ModuleNameN>
+    Options=<compiler options>

     [Linker]
-    LinkedModules=<list of modules, like: Kernel$+ Math Strings Console WinConsole HostInit Init Out Hello#>
-    OutputMode=<name of output file>
+    InterfaceModules=<list of modules, like: Kernel$+ Math Strings Console WinConsole HostInit Init Out Hello#>
+    OutputMode=<name of output file e.g. demo.exe, mpeg4.plg, libexport.so>

 ### Parameters

CompilingProject modified by Romiras

Romiras — Thu, 19 Jun 2014 10:32:43 -0000

--- v1
+++ v2
@@ -37,16 +37,31 @@

 #### CompilerOptions

+  * **checks** \- (0): Enable index range checks and type guard checks (inxchk, typchk & ptrinit in DevCPC486) (default). 
+  * **allchecks** \- (1): Enable overflow checks and range checks (ovflchk & ranchk in DevCPC486). 
+  * **assert** \- (2): Execute ASSERT instructions (assert in DevCPV486) (default). 
+  * **obj** \- (3): Enable code output (outObj in DevCPE) (default except in interface modules). 
+  * **ref** \- (4): Record references to variables (outRef in DevCPE) (default). 
+  * **allref** \- (5): Record more references, about RECORDs & static ARRAYs (outAllRef & outURef in DevCPE) (default). 
+  * **srcpos** \- (6): Record positions in source (outSrc in DevCPE) (default). 
+  * **hint** \- (29): Insert additional error marks (warnings) in source text (hint in DevCompiler.Module & hints in DevCPC486). 
+  * **oberon** \- (30): Compatibility with Oberon, relative to the use of IN and OUT (oberon in DevCPM.options). 
+  * **errorTrap** \- (31): Makes the compiler trap (HALT(100)) if an error in the source is detected (trap in DevCPM.options). 
+
+Default compiler options are _{checks, assert, obj, ref, allref, srcpos, signatures}_. 
+
 **CompilerOptions** is a combination of options in one string. Valid characters are '-', '!', '+', '$', '?' and '@'. 

-  * **-** \- (no description yet) 
-  * **!** \- (no description yet) 
-  * **+** \- all checks 
-  * **?** \- hint 
-  * **@** \- error trap 
-  * **$** \- oberon 
-
-Default compiler options are _{checks, assert, obj, ref, allref, srcpos, signatures}_. 
+  * first '-' excludes srcpos from compiler options. 
+  * second '-' excludes allref from compiler options. 
+  * third '-' excludes ref from compiler options. 
+  * fourth '-' excludes obj from compiler options. 
+  * first '!' excludes assert from compiler options. 
+  * second '!' excludes checks from compiler options. 
+  * '+' includes allchecks into compiler options. 
+  * '?' includes hint into compiler options. 
+  * '@' includes errorTrap into compiler options. 
+  * '$' includes oberon into compiler options. 

 #### Paths

CompilingProject modified by Romiras

Romiras — Thu, 19 Jun 2014 10:32:43 -0000

Note

Note

This document is a draft version.

Sample Hello module

Hello.cp

MODULE Hello;
IMPORT Out;
BEGIN
  Out.String ("Hello world!");  Out.Ln
END Hello.

Project

Template for project

[Project]
ProjectName=&lt;project name&gt;

[Compiler]
Module=&lt;relative path to module&gt;
CompilerOptions=&lt;compiler options&gt;

[Linker]
LinkedModules=&lt;list of modules, like: Kernel$+ Math Strings Console WinConsole HostInit Init Out Hello#&gt;
OutputMode=&lt;name of output file&gt;

Parameters

CompilerOptions

CompilerOptions is a combination of options in one string. Valid characters are '-', '!', '+', '$', '?' and '@'.

- - (no description yet)
! - (no description yet)
+ - all checks
? - hint
@ - error trap
$ - oberon

Default compiler options are {checks, assert, obj, ref, allref, srcpos, signatures}.

Paths

All paths are relative to root directory of all subsystems.

Sample Project

In order to build program for native system you need create a project document for module "Hello".

Hello.prj

[Project]
ProjectName=hello

[Compiler]
Module=Examples/Mod/Hello.cp
CompilerOptions=

[Linker]
LinkedModules=Kernel$+ Math Strings Console WinConsole HostInit Init Out Hello#
OutputMode=Exe
OutputFile=hello.exe