Changes between Version 6 and Version 7 of UseDirective

Timestamp:

03/29/14 05:47:34 (11 years ago)

Author:

hopscc

Comment:

--

UseDirective

@@ -2 +2 @@
 
 {{{
+use [ <alias = ] <namespace> [ from <library-name> ]
+
 use <namespace>
 use <namespace> from <library-name>
+use <alias> = <namespace>
 }}}
 
 Specify a namespace whose contents are made available to this module.
 
-When using the first form if the compiler cannot immediately locate the namespace,[[BR]]
+When using a form without a 'from' clause, if the compiler cannot immediately locate the namespace,[[BR]]
 i.e if its not in the default loaded libraries,[[BR]]
-it will look for a (platform dependent) library-name of the same form as 
-the namespace.
-
-
-If the filename of the library differs from the namespace, you can specify 
-it with the second form.[[BR]]
- 
-<library-name> can be a simple identifier, qualified identifier (Foo.Bar) 
-or a string literal.
+The compiler will look for a (platform dependent) library-name of the same form as the namespace.
+
+
+If the filename of the library differs from the namespace, you can specify it with the second form.[[BR]]
+<library-name> can be a simple identifier, qualified identifier (Foo.Bar)  or a string literal.
+
 
 {{{
@@ -24 +24 @@
 use Foo.Bar from SomeLib
 }}}
-You can put single or double quotes around the file name if its components 
-are not legal identifiers [[BR]]
+You can put single or double quotes around the file name if its components are not legal identifiers [[BR]]
 (for example, the filename has a space or punctuation mark in it).
 {{{
@@ -32 +31 @@
 }}}
 
+The alias clause (third form above)  can be used where you want to use a different (or simplified) name for the namespace than that provided.[[BR]]
+This is useful for a lengthy fully qualified namespace name that is widely used.
 
 == Platform ==
@@ -109 +110 @@
 }}}
 
+{{{
+#!cobra
+
+use Cons = System.Console
+use CC = Cobra.Core.CobraCore
+        
+class Test
+    def main is shared
+        Cons.writeLine('Display Version')
+        ver = CC.version
+        v1 = Cobra.Core.CobraCore.version
+        assert ver == v1
+        Cons.writeline(ver)
+}}}
+
 
 
@@ -114 +130 @@
 
 In most cases this syntax means you dont need to specify the commandline
--reference switch to provide the filename for a referenced namespace.
+-reference switch to provide the filename for a referenced namespace if the namespace dll follows
+usual naming conventions.
 
 
@@ -136 +153 @@
 cobra MyProg.cobra
 }}}
+
+[[BR]]
+[[BR]]
+
+
+
+
+If the dll filename containing the namespace code differs from the namespace name you can wire the namespace/filename relationship into the
+source file rather than having to always remember (or script) a specific separate compiler commandline reference..
+
+e.g Assuming a namespace Augmented.!ExtendedConsole kept in a utility dll (!AugmentationLibrary.dll) say [[BR]]
+
+rather than program !MyProg.cobra containing something like
+{{{
+#!cobra
+...
+use Augmented.ExtendedConsole
+...
+    # use as 
+    input = ExtendedConsole.input('Enter text:')
+
+}}}
+and compilation commandline 
+{{{
+cobra -ref:AugmentationLibrary MyProg.cobra
+}}}
+
+you can just have:
+{{{
+#!cobra
+...
+use Augmented.ExtendedConsole from AugmentionLibrary
+...
+}}}
+and use a non -ref compilation invocation.
+
+{{{
+cobra MyProg.cobra
+}}}
+
+[[BR]]
+[[BR]]
+
+
+Here (where the name is a lttle cumbersome) for more convenience use both features...
+{{{
+#!cobra
+...
+use AugCons = Augmented.ExtendedConsole from AugmentationLibrary
+...
+    # use as 
+    input = AugCons.input('Enter text:')
+
+}}}