Recent changes to Conditional compilation

Conditional compilation modified by Will Pittenger

Will Pittenger — Tue, 18 Feb 2014 08:26:57 -0000

--- v9
+++ v10
@@ -18,7 +18,7 @@

 Deleting a **[conditional](keywords-conditional)** variable
 -----------------------------------
-Conditional compilation requires that you be able to cause the **[conditional](keywords-conditional)** variable to be deleted.  Use the syntax shown below.
+Conditional compilation requires that you be able to cause the **[conditional](keywords-conditional)** variable to be deleted.  Use the syntax shown below.  Please note a file can undeclare **[conditional](keywords-conditional)** variables only if those variables were declared in that file.  So **[conditional](keywords-conditional)** variables declared through a makefile or the compiler command line can't be undeclared.

 ~~~~
 :::text

Conditional compilation modified by Will Pittenger

Will Pittenger — Tue, 18 Feb 2014 08:05:50 -0000

--- v8
+++ v9
@@ -2,9 +2,9 @@

 Overview
 --------
-One thing that JAVA lacks is the ability to compile select parts of the code only when needed.  This is something that C, C++, and C# all have.  Now ASIL has something similar.  Unlike other #if in C, C++, and C#; ASIL's support is integrated.  This means that a conditional block must begin and end in the same parent block.  (This prevents the situation where a closing brace ends up outside the #if block.  A lot of syntax errors could hide that way.)  Unlike C and C++, no preprocessor is required.  Unlike C#, **[conditional](keywords-conditional)** variables can have values.
+One thing that JAVA lacks is the ability to compile select parts of the code only when needed.  This is something that C, C++, and C# all have.  Now ASIL has something similar.  Unlike other #if in C, C++, and C#; ASIL's support is integrated.  This means that a conditional block must begin and end in the same parent block.  (This prevents the situation where a closing brace ends up outside the #if block.  A lot of syntax errors could hide that way.)  

-Please note that ASIL doesn't have or need a preprocessor like C/C++.  The values in a **[conditional](keywords-conditional)** variable can't be treated as code!
+Please note that ASIL doesn't have or need a preprocessor like C/C++ does.  The values in a **[conditional](keywords-conditional)** variable can't be treated as code!  Yet, unlike C#, **[conditional](keywords-conditional)** variables can have values.

 Declaring a **[conditional](keywords-conditional)** variable
 ------------------------------------

Conditional compilation modified by Will Pittenger

Will Pittenger — Tue, 18 Feb 2014 08:04:47 -0000

--- v7
+++ v8
@@ -3,6 +3,8 @@
 Overview
 --------
 One thing that JAVA lacks is the ability to compile select parts of the code only when needed.  This is something that C, C++, and C# all have.  Now ASIL has something similar.  Unlike other #if in C, C++, and C#; ASIL's support is integrated.  This means that a conditional block must begin and end in the same parent block.  (This prevents the situation where a closing brace ends up outside the #if block.  A lot of syntax errors could hide that way.)  Unlike C and C++, no preprocessor is required.  Unlike C#, **[conditional](keywords-conditional)** variables can have values.
+
+Please note that ASIL doesn't have or need a preprocessor like C/C++.  The values in a **[conditional](keywords-conditional)** variable can't be treated as code!

 Declaring a **[conditional](keywords-conditional)** variable
 ------------------------------------

Conditional compilation modified by Will Pittenger

Will Pittenger — Tue, 18 Feb 2014 08:01:01 -0000

--- v6
+++ v7
@@ -6,7 +6,7 @@

 Declaring a **[conditional](keywords-conditional)** variable
 ------------------------------------
-You can use any type needed as long as that type was compiled by a different project.  There are two syntax options.  The first declares a variable that can only be used in one way: was the variable declared or not.  The second stores a value and can be referenced anywhere you'd use a normal variable.  All conditional variables must be global in nature.  Compiler developers should provide a means to "declare" any conditional variable outside the file.  Conditional variables declared in this manner may not be duplicated in the code.  All typed conditional variables must be initialized immediately.  Conditional variables may not be changed once declared.
+You can use any **[const](keywords-const)** type needed as long as that type was compiled by a different project.  There are two syntax options.  The first declares a variable that can only be used in one way: was the variable declared or not.  The second stores a value and can be referenced anywhere you'd use a normal variable.  All conditional variables must be global in nature.  Compiler developers should provide a means to "declare" any conditional variable outside the file.  Conditional variables declared in this manner may not be duplicated in the code.  All typed conditional variables must be initialized immediately.  Conditional variables may not be changed once declared.

 ~~~~
 :::text

Conditional compilation modified by Will Pittenger

Will Pittenger — Tue, 18 Feb 2014 07:59:56 -0000

--- v5
+++ v6
@@ -6,7 +6,7 @@

 Declaring a **[conditional](keywords-conditional)** variable
 ------------------------------------
-You can use any type needed as long as instances of the type aren't needed to decide if the type should be compiled.  There are two syntax options.  The first declares a variable that can only be used in one way: was the variable declared or not.  The second storage a value and can be referenced anywhere you'd use a normal variable.  All conditional variables must be global in nature.  Compiler developers should provide a means to "declare" any conditional variable outside the file.  Conditional variables declared in this manner may not be duplicated in the code.  All typed conditional variables must be initialized immediately.  Conditional variables may not be changed once declared.
+You can use any type needed as long as that type was compiled by a different project.  There are two syntax options.  The first declares a variable that can only be used in one way: was the variable declared or not.  The second stores a value and can be referenced anywhere you'd use a normal variable.  All conditional variables must be global in nature.  Compiler developers should provide a means to "declare" any conditional variable outside the file.  Conditional variables declared in this manner may not be duplicated in the code.  All typed conditional variables must be initialized immediately.  Conditional variables may not be changed once declared.

 ~~~~
 :::text
@@ -28,7 +28,7 @@

 Referencing a **[conditional](keywords-conditional)** variable
 --------------------------------------
-Conditional compilation requires use of the **[conditionalif](keywords-conditionalif)** keyword in place of **[if](keywords-if)**.  It's ASIL's counterpart of #if in C, C++, and C#.  It works like a normal **[if](keywords-if)** statement and even uses **[then](keywords-then)** and **[else](keywords-else)** keywords.  However, it can only reference **[conditional](keywords-conditional)** variables.  Normal variables are unavailable.  Note: If you want to test for a **[conditional](keywords-conditional)**'s existence, prefix the **[conditional](keywords-conditional)**'s identifier with the **[exists](keywords-exists)** keyword.  If the **[conditional](keywords-conditional)**'s identifier is used alone, it must be a boolean.
+Conditional compilation requires use of the **[conditionalif](keywords-conditionalif)** keyword in place of **[if](keywords-if)**.  It's ASIL's counterpart of #if in C, C++, and C#.  It works like a normal **[if](keywords-if)** statement and even uses **[then](keywords-then)** and **[else](keywords-else)** keywords.  However, it can only reference **[conditional](keywords-conditional)** variables.  Normal variables are unavailable.  Note: If you want to test for a **[conditional](keywords-conditional)**'s existence, prefix the **[conditional](keywords-conditional)**'s identifier with the **[exists](keywords-exists)** keyword.  If the **[conditional](keywords-conditional)**'s identifier is used alone, it must be a boolean or the expression must evaluate to a boolean.  Any **[conditional](keywords-conditional)** variable that's referenced without the **[exists](keywords-exists)** keyword must exist.  If it doesn't, the compiler must issue an error.

 ~~~~
 :::text

Conditional compilation modified by Will Pittenger

Will Pittenger — Sun, 16 Feb 2014 10:20:14 -0000

--- v4
+++ v5
@@ -28,7 +28,7 @@

 Referencing a **[conditional](keywords-conditional)** variable
 --------------------------------------
-Conditional compilation requires use of the **[conditionalif](keywords-conditionalif)** keyword in place of **[if](keywords-if)**.  It's ASIL's counterpart of #if in C, C++, and C#.  It works like a normal **[if](keywords-if)** statement and even uses **[then](keywords-then)** and **[else](keywords-else)** keywords.  However, it can only reference **[conditional](keywords-conditional)** variables.  Normal variables are unavailable.  Note: If you want to test for a **[conditional](keywords-conditional)**'s existence, prefix the **[conditional](keywords-conditional)**'s identifier with the **[exists](keywords-exists]** keyword.  If the **[conditional](keywords-conditional)**'s identifier is used alone, it must be a boolean.
+Conditional compilation requires use of the **[conditionalif](keywords-conditionalif)** keyword in place of **[if](keywords-if)**.  It's ASIL's counterpart of #if in C, C++, and C#.  It works like a normal **[if](keywords-if)** statement and even uses **[then](keywords-then)** and **[else](keywords-else)** keywords.  However, it can only reference **[conditional](keywords-conditional)** variables.  Normal variables are unavailable.  Note: If you want to test for a **[conditional](keywords-conditional)**'s existence, prefix the **[conditional](keywords-conditional)**'s identifier with the **[exists](keywords-exists)** keyword.  If the **[conditional](keywords-conditional)**'s identifier is used alone, it must be a boolean.

 ~~~~
 :::text

Conditional compilation modified by Will Pittenger

Will Pittenger — Sun, 16 Feb 2014 10:19:44 -0000

--- v3
+++ v4
@@ -9,6 +9,7 @@
 You can use any type needed as long as instances of the type aren't needed to decide if the type should be compiled.  There are two syntax options.  The first declares a variable that can only be used in one way: was the variable declared or not.  The second storage a value and can be referenced anywhere you'd use a normal variable.  All conditional variables must be global in nature.  Compiler developers should provide a means to "declare" any conditional variable outside the file.  Conditional variables declared in this manner may not be duplicated in the code.  All typed conditional variables must be initialized immediately.  Conditional variables may not be changed once declared.

 ~~~~
+:::text
 conditional test ' Can only be referenced inside **conditionalif** statements.  May not be compared.
 conditional int test2 = 7 ' Can be used anywhere below the point where it is declared.
 ~~~~
@@ -18,6 +19,7 @@
 Conditional compilation requires that you be able to cause the **[conditional](keywords-conditional)** variable to be deleted.  Use the syntax shown below.

 ~~~~
+:::text
 conditional test ' now it's here
 conditional - test ' now it's gone
 conditional int test2 = 7 ' Now we have this one
@@ -26,13 +28,14 @@

 Referencing a **[conditional](keywords-conditional)** variable
 --------------------------------------
-Conditional compilation requires use of the **[conditionalif](keywords-conditionalif)** keyword in place of **[if](keywords-if)**.  It's ASIL's counterpart of #if in C, C++, and C#.  It works like a normal **[if](keywords-if)** statement and even uses **[then](keywords-then)** and **[else](keywords-else)** keywords.  However, it can only reference **[conditional](keywords-conditional)** variables.  Normal variables are unavailable.
+Conditional compilation requires use of the **[conditionalif](keywords-conditionalif)** keyword in place of **[if](keywords-if)**.  It's ASIL's counterpart of #if in C, C++, and C#.  It works like a normal **[if](keywords-if)** statement and even uses **[then](keywords-then)** and **[else](keywords-else)** keywords.  However, it can only reference **[conditional](keywords-conditional)** variables.  Normal variables are unavailable.  Note: If you want to test for a **[conditional](keywords-conditional)**'s existence, prefix the **[conditional](keywords-conditional)**'s identifier with the **[exists](keywords-exists]** keyword.  If the **[conditional](keywords-conditional)**'s identifier is used alone, it must be a boolean.

 ~~~~
+:::text
 conditional b
 conditional int c = 43

-conditionalif b then
+conditionalif exists b then
   class conditonalClass
     conditionalif c then ' If c doesn't exist, it is false; if it does exist, it is true; it's value doesn't matter
       ' Some code that only compiles if c is declared

Conditional compilation modified by Will Pittenger

Will Pittenger — Thu, 13 Feb 2014 23:24:47 -0000

--- v2
+++ v3
@@ -2,20 +2,20 @@

 Overview
 --------
-One thing that JAVA lacks is the ability to compile select parts of the code only when needed.  This is something that C, C++, and C# all have.  Now ASIL has something similar.  Unlike other #if in C, C++, and C#; ASIL's support is integrated.  This means that a conditional block must begin and end in the same parent block.  Unlike C and C++, no preprocessor is required.  Unlike C#, [**conditional**] variables can have values.
+One thing that JAVA lacks is the ability to compile select parts of the code only when needed.  This is something that C, C++, and C# all have.  Now ASIL has something similar.  Unlike other #if in C, C++, and C#; ASIL's support is integrated.  This means that a conditional block must begin and end in the same parent block.  (This prevents the situation where a closing brace ends up outside the #if block.  A lot of syntax errors could hide that way.)  Unlike C and C++, no preprocessor is required.  Unlike C#, **[conditional](keywords-conditional)** variables can have values.

-Declaring a [**conditional**] variable
+Declaring a **[conditional](keywords-conditional)** variable
 ------------------------------------
 You can use any type needed as long as instances of the type aren't needed to decide if the type should be compiled.  There are two syntax options.  The first declares a variable that can only be used in one way: was the variable declared or not.  The second storage a value and can be referenced anywhere you'd use a normal variable.  All conditional variables must be global in nature.  Compiler developers should provide a means to "declare" any conditional variable outside the file.  Conditional variables declared in this manner may not be duplicated in the code.  All typed conditional variables must be initialized immediately.  Conditional variables may not be changed once declared.

 ~~~~
-conditional test ' Can only be referenced inside [**conditionalif**] statements.  May not be compared.
+conditional test ' Can only be referenced inside **conditionalif** statements.  May not be compared.
 conditional int test2 = 7 ' Can be used anywhere below the point where it is declared.
 ~~~~

-Deleting a [**conditional**] variable
+Deleting a **[conditional](keywords-conditional)** variable
 -----------------------------------
-Conditional compilation requires that you be able to cause the [**conditional**] variable to be deleted.  Use the syntax shown below.
+Conditional compilation requires that you be able to cause the **[conditional](keywords-conditional)** variable to be deleted.  Use the syntax shown below.

 ~~~~
 conditional test ' now it's here
@@ -24,9 +24,9 @@
 conditional - test2 ' Now it's gone too
 ~~~~

-Referencing a [**conditional**] variable
+Referencing a **[conditional](keywords-conditional)** variable
 --------------------------------------
-Conditional compilation requires use of the [**conditionalif**] keyword in place of [**if**].  It's ASIL's counterpart of #if in C, C++, and C#.  It works like a normal [**if**] statement and even uses [**then**] and [**else**] keywords.  However, it can only reference [**conditional**] variables.  Normal variables are unavailable.
+Conditional compilation requires use of the **[conditionalif](keywords-conditionalif)** keyword in place of **[if](keywords-if)**.  It's ASIL's counterpart of #if in C, C++, and C#.  It works like a normal **[if](keywords-if)** statement and even uses **[then](keywords-then)** and **[else](keywords-else)** keywords.  However, it can only reference **[conditional](keywords-conditional)** variables.  Normal variables are unavailable.

 ~~~~
 conditional b

Conditional compilation modified by Will Pittenger

Will Pittenger — Sat, 08 Feb 2014 13:47:33 -0000

--- v1
+++ v2
@@ -2,20 +2,20 @@

 Overview
 --------
-One thing that JAVA lacks is the ability to compile select parts of the code only when needed.  This is something that C, C++, and C# all have.  Now ASIL has something similar.  Unlike other #if in C, C++, and C#; ASIL's support is integrated.  This means that a conditional block must begin and end in the same parent block.  Unlike C and C++, no preprocessor is required.  Unlike C#, **conditional** variables can have values.
+One thing that JAVA lacks is the ability to compile select parts of the code only when needed.  This is something that C, C++, and C# all have.  Now ASIL has something similar.  Unlike other #if in C, C++, and C#; ASIL's support is integrated.  This means that a conditional block must begin and end in the same parent block.  Unlike C and C++, no preprocessor is required.  Unlike C#, [**conditional**] variables can have values.

-Declaring a **conditional** variable
+Declaring a [**conditional**] variable
 ------------------------------------
-You can use any type needed as long as instances of the type aren't needed to decide if the type should be compiled.  There are two syntax options.  The first declares a variable that can only be used in one way: was the variable declared or not.  The second storage a value and can be referenced anywhere you'd use a normal variable.  All conditional variables must be global in nature.  Compiler developers should provide a means to "declare" any conditional variable outside the file.  Conditional variables declared in this manner may not be duplicated in the code.  All typed conditional variables must be initialized immediately.
+You can use any type needed as long as instances of the type aren't needed to decide if the type should be compiled.  There are two syntax options.  The first declares a variable that can only be used in one way: was the variable declared or not.  The second storage a value and can be referenced anywhere you'd use a normal variable.  All conditional variables must be global in nature.  Compiler developers should provide a means to "declare" any conditional variable outside the file.  Conditional variables declared in this manner may not be duplicated in the code.  All typed conditional variables must be initialized immediately.  Conditional variables may not be changed once declared.

 ~~~~
-conditional test ' Can only be referenced inside **[conditionalif]** statements.  May not be compared.
+conditional test ' Can only be referenced inside [**conditionalif**] statements.  May not be compared.
 conditional int test2 = 7 ' Can be used anywhere below the point where it is declared.
 ~~~~

-Deleting a **conditional** variable
+Deleting a [**conditional**] variable
 -----------------------------------
-Conditional compilation requires that you be able to cause the **conditional** variable to be deleted.  Use the syntax shown below.
+Conditional compilation requires that you be able to cause the [**conditional**] variable to be deleted.  Use the syntax shown below.

 ~~~~
 conditional test ' now it's here
@@ -24,9 +24,9 @@
 conditional - test2 ' Now it's gone too
 ~~~~

-Referencing a **conditional** variable
+Referencing a [**conditional**] variable
 --------------------------------------
-Conditional compilation requires use of the **[conditionalif]** keyword in place of **[if]**.  It's ASIL's counterpart of #if in C, C++, and C#.  It works like a normal if statement and even uses **[then]** and **[else]** keywords.  However, it can only reference **[conditional]** variables.  Normal variables are unavailable.
+Conditional compilation requires use of the [**conditionalif**] keyword in place of [**if**].  It's ASIL's counterpart of #if in C, C++, and C#.  It works like a normal [**if**] statement and even uses [**then**] and [**else**] keywords.  However, it can only reference [**conditional**] variables.  Normal variables are unavailable.

 ~~~~
 conditional b

Conditional compilation modified by Will Pittenger

Will Pittenger — Thu, 06 Feb 2014 16:57:26 -0000

Overview
Declaring a conditional variable
Deleting a conditional variable
Referencing a conditional variable

Overview

One thing that JAVA lacks is the ability to compile select parts of the code only when needed. This is something that C, C++, and C# all have. Now ASIL has something similar. Unlike other #if in C, C++, and C#; ASIL's support is integrated. This means that a conditional block must begin and end in the same parent block. Unlike C and C++, no preprocessor is required. Unlike C#, conditional variables can have values.

Declaring a conditional variable

You can use any type needed as long as instances of the type aren't needed to decide if the type should be compiled. There are two syntax options. The first declares a variable that can only be used in one way: was the variable declared or not. The second storage a value and can be referenced anywhere you'd use a normal variable. All conditional variables must be global in nature. Compiler developers should provide a means to "declare" any conditional variable outside the file. Conditional variables declared in this manner may not be duplicated in the code. All typed conditional variables must be initialized immediately.

conditional test ' Can only be referenced inside **[conditionalif]** statements.  May not be compared.
conditional int test2 = 7 ' Can be used anywhere below the point where it is declared.

Deleting a conditional variable

Conditional compilation requires that you be able to cause the conditional variable to be deleted. Use the syntax shown below.

conditional test ' now it's here
conditional - test ' now it's gone
conditional int test2 = 7 ' Now we have this one
conditional - test2 ' Now it's gone too

Referencing a conditional variable

Conditional compilation requires use of the [conditionalif] keyword in place of [if]. It's ASIL's counterpart of #if in C, C++, and C#. It works like a normal if statement and even uses [then] and [else] keywords. However, it can only reference [conditional] variables. Normal variables are unavailable.

conditional b
conditional int c = 43

conditionalif b then
  class conditonalClass
    conditionalif c then ' If c doesn't exist, it is false; if it does exist, it is true; it's value doesn't matter
      ' Some code that only compiles if c is declared

    conditionalif c = 34 then
      ' Some code that only compiles if c equals 34
    else
      ' Some code that only compiles if c doesn't equal 34