Ticket #277: namespace-docstr.patch

Source/NameSpace.cobra

@@ -151 +151 @@
             .addDecl(ns)
         return ns
 
+    def addDocString(docString as String)
+        require docString.length
+        if not docString.trim.length, return
+        if not .docString.length
+            .docString = docString
+        else if .docString <> docString
+            sb = StringBuilder( .docString)
+            sb.append('\n')
+            sb.append(docString)
+            .docString = sb.toString
+            
+        
     get typeForIdentifier as IType? is override
         # TODO: in reality, you can't say "x = SomeNameSpace" or pass a
         # namespace as an argument. That should be fixed by allowing those

Source/CobraParser.cobra

@@ -1124 +1124 @@
             _nameSpaceStack.push(curNameSpace)          
         try
             .indent
+            docString = .docString
+            if docString and docString.length, curNameSpace.addDocString(docString to !)
+            .zeroOrMore('EOL')
             while true
                 peek = .peek
                 if peek is nil, .throwError('Expecting a namespace member, but source code ended.')

Tests/120-classes/920-doc-strings-namespace-0.cobra

@@ +1 @@
+namespace DocStrTest
+    """ 
+    Namespace Docstring test
+    """
+    class Test
+        def main is shared
+            assert true

Tests/120-classes/920-doc-strings-namespace-2.cobra

@@ +1 @@
+namespace DocStrTest
+    """ A oneline namespace Docstring """
+
+    class Test
+        def main is shared
+            assert true

Tests/120-classes/920-doc-strings-namespace-1.cobra

@@ +1 @@
+namespace DocStrTest
+    """ 
+    A Test Docstring
+    """
+
+    class Test
+        def main is shared
+            assert true

Tests/120-classes/920-doc-strings-namespace-3.cobra

@@ +1 @@
+"""
+Module Docstring 
+Test for Ticket:277
+"""
+
+namespace NamespaceDocStrTest
+    """ 
+    Namespace Docstring
+    """
+
+    class Test
+        """My Test class docstr. - oneline"""
+
+        var anI =10
+            """docStr on anIfield"""
+        
+        def main is shared
+            """
+            My main method docstr.
+            multiline
+            """
+
+            assert true