MAJOR: Function definitions are now scanned

Author: Diego Contreras

README.md

@@ -13,15 +13,17 @@ RobotCDocs is a tool developed for the purpose of attaching descriptions to user
 
 ## What it can do
 ### Scan / Parse Files
-RobotCDocs recursively searches for any header (.h) or source (.c) files in a directory. Each file will be scanned for comments detailing a _declaration_ of a function or variable, like so:
+RobotCDocs recursively searches for any header (.h) or source (.c) files in a directory. Each file will be scanned for comments detailing a _declaration_ or _definition_ of a function or variable, like so:
 
     FooLibrary / Foo.h - 
 
     /*
      * This function does some really cool stuff!
      * This sentence will be added to the ladder.
     */
-    void Foo();
+    void Foo() {
+        ... code ...
+    }
 
     /*
      * This function does some really cool stuff!
@@ -33,11 +35,16 @@ RobotCDocs recursively searches for any header (.h) or source (.c) files in a di
      * A very cool variable!
     */
     bool testVariable;
+
+    /*
+     * The second cool variable!
+    */
+    bool testVariable2 = false; // Will not look nice; Initialization is not supported.
 
 ![Preview Image](/Images/Foo_Image.png)
 
 ### Custom Naming Schemes
-By default, the documentation of a declaration will be listed under its file's name. This is seen in the above example, where Foo(parameter) is listed under the _Foo_ category. You can change the category of a declaration with the addition of `@`. In the code below, the addition of `@setup` means that the declaration will be listed under _Setup_, no matter what file it's in. As you can see, `setup` is automatically capitalized to `Setup`.
+By default, the documentation of a function or variable will be listed under its file's name. This is seen in the above example, where Foo(parameter) is listed under the _Foo_ category. You can change the category of a function or variable with the addition of `@`. In the code below, the addition of `@setup` means that the declaration will be listed under _Setup_, no matter what file it's in. As you can see, `setup` is automatically capitalized to `Setup`.
 
     FooLibrary / Foo.h - 
 

RobotCDocs/FileScanner.py

@@ -82,12 +82,13 @@ def Parse(self):
 
 
             if '*/' in line:
-                # Check that the comment was right before a function or variable declaration.
+                # Check that the comment was right before a function or variable declaration or definition.
                 doc.declaration = self.GetNextLine().strip()
-                if ';' in doc.declaration:
+                if ';' in doc.declaration or '{' in doc.declaration:
+                    doc.declaration = doc.declaration.replace(";", "").replace("{", "")
                     self.docs.append(doc)
                 else:
-                    print('FileScanner.py: Warning: Line %s of %s was skipped due to missing a declaration.' % (self.currentLine + 1, self.docFileName))
+                    print('FileScanner.py: Warning: Line %s of %s was skipped due to missing a declaration or definition.' % (self.currentLine + 1, self.docFileName))
 
                 doc = Doc()
                 doc.category = self.categoryName