Changeset 20798 for lang/cplusplus

Timestamp:

10/05/08 16:53:59 (2 months ago)

Author:

tokuhirom

Message:

show synopsis & description

Location:

lang/cplusplus/llv8call/trunk

Files:

• ext/sqlite3/sqlite3.cc (modified) (1 diff)
• manual/ext/clearsilver/clearsilver.html (modified) (1 diff)
• manual/ext/fs/dir.html (modified) (1 diff)
• manual/ext/fs/file.html (modified) (1 diff)
• manual/ext/libmemcached/libmemcached.html (modified) (1 diff)
• manual/ext/shttpd/shttpd.html (modified) (1 diff)
• manual/ext/sqlite3/sqlite3.html (modified) (1 diff)
• tools/makedoc/make-docs.js (modified) (4 diffs)
• tools/makedoc/tmpl/doc.cs (modified) (1 diff)

lang/cplusplus/llv8call/trunk/ext/sqlite3/sqlite3.cc

@@ -25 +25 @@
 //   http://www.python.org/dev/peps/pep-0249/
 //   http://www.python.jp/doc/contrib/peps/pep-0249.txt
+
+/** DESCRIPTION:
+ *
+ * SQLite3 is embeddable RDBMS =)
+ *
+ */
+
+/** SYNOPSIS:
+ *
+ * v8ext.LoadBinary("org.coderepos.sqlite3");
+ * var db = new SQLite3(":memory:");
+ * var cursor = db.Cursor();
+ * cursor.Execute("SELECT COUNT(*) FROM foo");
+ * p( cursor.FetchOne()[0] );
+ * cursor.Close();
+ * db.Close();
+ *
+ */
 
 #include "sqlite3.h"

lang/cplusplus/llv8call/trunk/manual/ext/clearsilver/clearsilver.html

@@ -15 +15 @@
     <div class="main container">
         <h1>llv8call docs</h1>
+
+        
 
         

lang/cplusplus/llv8call/trunk/manual/ext/fs/dir.html

@@ -15 +15 @@
     <div class="main container">
         <h1>llv8call docs</h1>
+
+        
 
         

lang/cplusplus/llv8call/trunk/manual/ext/fs/file.html

@@ -15 +15 @@
     <div class="main container">
         <h1>llv8call docs</h1>
+
+        
 
         

lang/cplusplus/llv8call/trunk/manual/ext/libmemcached/libmemcached.html

@@ -15 +15 @@
     <div class="main container">
         <h1>llv8call docs</h1>
+
+        
 
         

lang/cplusplus/llv8call/trunk/manual/ext/shttpd/shttpd.html

@@ -15 +15 @@
     <div class="main container">
         <h1>llv8call docs</h1>
+
+        
 
         

lang/cplusplus/llv8call/trunk/manual/ext/sqlite3/sqlite3.html

@@ -16 +16 @@
         <h1>llv8call docs</h1>
 
+        
+            <div class="description">SQLite3 is embeddable RDBMS =)
+</div>
+        
+
+        
+            <pre>v8ext.LoadBinary("org.coderepos.sqlite3");
+var db = new SQLite3(":memory:");
+var cursor = db.Cursor();
+cursor.Execute("SELECT COUNT(*) FROM foo");
+p( cursor.FetchOne()[0] );
+cursor.Close();
+db.Close();
+</pre>
         
 

lang/cplusplus/llv8call/trunk/tools/makedoc/make-docs.js

@@ -21 +21 @@
         var modules = [];
         var currentmodule;
-        var mode = "SYNOPSIS";
         var parser;
+        var sections = {};
         var parser_normal;
-        var synopsis = '';
-        var parser_synopsis = function (line) {
-            if (line.match(/\*\//)) {
-                parser = parser_normal;
-            } else if (line.match(/^\s*\*\s*(.+)/)) {
-                synopsis += RegExp.$1 + "\n";
-            }
+        var section_parser_generator = function (name) {
+            return function (line) {
+                if (line.match(/\*\//)) {
+                    parser = parser_normal;
+                } else if (line.match(/^\s*\*\s*(.+)/)) {
+                    if (!sections[name]) { sections[name] = '' }
+                    sections[name] += RegExp.$1 + "\n";
+                }
+            };
         };
         parser_normal = function (line) {
@@ -37 +39 @@
                 currentmodule['CLASSNAME'] = RegExp.$1;
                 modules.push(currentmodule);
-            } else if (line.match(/\/\*\*\s*SYNOPSIS/)) {
-                parser = parser_synopsis;
+            } else if (line.match(/\/\*\*\s*(SYNOPSIS|DESCRIPTION)/)) {
+                parser = section_parser_generator(RegExp.$1);
             } else if (line.match(/CLASS(?:_WITH_CONSTRUCTOR)?\(/)) {
-                currentmodule = {"CCV" : [], "CM" : [], "IM" : [], "CLASSNAME" : "", "SYNOPSIS":"" };
+                currentmodule = {"CCV" : [], "CM" : [], "IM" : [], "CLASSNAME" : "" };
             } else if (line.match(/BIND_([IC]M)\("([^"]+)"/)) {
                 currentmodule[RegExp.$1].push(RegExp.$2);
@@ -52 +54 @@
         }
         file.Close();
-        return {"modules":modules, "synopsis":synopsis};
+        return {"modules":modules, "sections":sections};
     };
 
@@ -66 +68 @@
             hdf.AddArray(basekey + ".IM",  entry["IM"]);
         }
-        hdf.SetValue("data.synopsis", data.synopsis);
+        if(data.sections.SYNOPSIS) {
+            hdf.SetValue("data.sections.SYNOPSIS", data.sections.SYNOPSIS);
+        }
+        if(data.sections.DESCRIPTION) {
+            hdf.SetValue("data.sections.DESCRIPTION", data.sections.DESCRIPTION);
+        }
         // p(hdf.DumpStr(undefined, 0));
         var cs = new clearsilver.CS(hdf);

lang/cplusplus/llv8call/trunk/tools/makedoc/tmpl/doc.cs

@@ -16 +16 @@
         <h1>llv8call docs</h1>
 
-        <?cs if:data.synopsis ?>
-            <pre><?cs var:data.synopsis ?></pre>
+        <?cs if:data.sections.DESCRIPTION ?>
+            <div class="description"><?cs var:data.sections.DESCRIPTION ?></div>
+        <?cs /if ?>
+
+        <?cs if:data.sections.SYNOPSIS ?>
+            <pre><?cs var:data.sections.SYNOPSIS ?></pre>
         <?cs /if ?>