help descriptions now understood by the cog files, no implementation yet, don't try to build this

include/help.hpp

@@ -0,0 +1,15 @@
+#ifndef __HELP_HPP
+#define __HELP_HPP
+#pragma once
+
+#include <string>
+
+using namespace std;
+
+namespace cellar {
+    namespace help {
+        extern void set_description(string,string);
+    }
+}
+
+#endif // __HELP_HPP

src/bottles/commands.cpp.cog

@@ -22,6 +22,14 @@ DLL_PUBLIC map<string, CommandFunction> cellar::commands::bottles_commands() {
                 func = linesplit[1]
 
                 cog.outl("result.insert(pair<string,CommandFunction>(\"{0}\", &{1}));".format(name, func))
+
+                if (len(linesplit) > 2):
+                    desc = " ".join(linesplit[2:]) # Rest of line assumed to be description
+                    cog.outl("cellar::help::set_description(\"{0}\", \"{1}\");"
+                             .format(name, desc
+                             .replace("\"", "\\\"")
+                             .replace("\\", "\\\\")))
+                             # the replace methods escape " and \ characters
       ]]]*/
     //[[[end]]]
     return result;

src/commands.cpp.cog

@@ -6,6 +6,7 @@
 #include "commands.hpp"
 #include "internal/core.hpp"
 #include "cellar.hpp"
+#include "help.hpp"
 
 using namespace std;
 using namespace cellar::commands;
@@ -32,6 +33,14 @@ map<string, CommandFunction> cellar::commands::core_commands() {
                 func = linesplit[1]
 
                 cog.outl("result.insert(pair<string,CommandFunction>(\"{0}\", &{1}));".format(name, func))
+
+                if (len(linesplit) > 2):
+                    desc = " ".join(linesplit[2:]) # Rest of line assumed to be description
+                    cog.outl("cellar::help::set_description(\"{0}\", \"{1}\");"
+                             .format(name, desc
+                             .replace("\"", "\\\"")
+                             .replace("\\", "\\\\")))
+                             # the replace methods escape " and \ characters
       ]]]*/
     //[[[end]]]
     return result;

src/commands.txt

@@ -1,2 +1,2 @@
-version print_version
+version print_version Prints version information.
 help help_command

src/help/help.cpp

@@ -3,6 +3,7 @@
 
 #include "cellar.hpp"
 #include "internal/core.hpp"
+#include "help.cpp"
 
 using namespace std;
 

src/launch/commands.cpp.cog

@@ -22,6 +22,14 @@ DLL_PUBLIC map<string, CommandFunction> cellar::commands::launch_commands() {
                 func = linesplit[1]
 
                 cog.outl("result.insert(pair<string,CommandFunction>(\"{0}\", &{1}));".format(name, func))
+
+                if (len(linesplit) > 2):
+                    desc = " ".join(linesplit[2:]) # Rest of line assumed to be description
+                    cog.outl("cellar::help::set_description(\"{0}\", \"{1}\");"
+                             .format(name, desc
+                             .replace("\"", "\\\"")
+                             .replace("\\", "\\\\")))
+                             # the replace methods escape " and \ characters
       ]]]*/
     //[[[end]]]
     return result;