Lots of docs tweaks for openscad-docsgen v2

Author: revarbat

.openscad_gendocs_rc .openscad_docsgen_rc.openscad_gendocs_rc renamed to .openscad_docsgen_rc

@@ -1,4 +1,7 @@
 DocsDirectory: BOSL2.wiki/
+TargetProfile: githubwiki
+ProjectName: The Belfry OpenScad Library, v2. (BOSL2)
+GenerateDocs: Files, TOC, Index, Topics, CheatSheet
 IgnoreFiles:
   affine.scad
   foo.scad
@@ -8,43 +11,44 @@ IgnoreFiles:
   tmp_*.scad
 PrioritizeFiles:
   transforms.scad
-  distributors.scad
-  mutators.scad
   attachments.scad
-  drawing.scad
   shapes2d.scad
   shapes3d.scad
+  drawing.scad
   masks2d.scad
   masks3d.scad
+  distributors.scad
+  partitions.scad
+  mutators.scad
+  paths.scad
+  regions.scad
+  vnf.scad
+  beziers.scad
+  rounding.scad
+  skin.scad
+  turtle3d.scad
   math.scad
-  comparisons.scad
-  coords.scad
   linalg.scad
-  lists.scad
   vectors.scad
   quaternions.scad
-  edges.scad
+  coords.scad
   geometry.scad
   trigonometry.scad
-  hull.scad
-  paths.scad
-  regions.scad
-  vnf.scad
-  skin.scad
-  utility.scad
   constants.scad
-  strings.scad
   version.scad
-  beziers.scad
-  knurling.scad
-  partitions.scad
-  rounding.scad
-  threading.scad
-  turtle3d.scad
+  comparisons.scad
+  lists.scad
+  utility.scad
+  strings.scad
   structs.scad
   fnliterals.scad
+  threading.scad
+  screws.scad
+  metric_screws.scad
+  bottlecaps.scad
+  screw_drive.scad
 DefineHeader(BulletList): Side Effects
-DefineHeader(Table:Anchor Name|Position): Extra Anchors
-DefineHeader(Table:Name|Definition): Terminology
+DefineHeader(Table;Headers=Anchor Name|Position): Extra Anchors
+DefineHeader(Table;Headers=Name|Definition): Terminology
 DefineHeader(BulletList): Requirements
 

attachments.scad

@@ -7,6 +7,9 @@
 //   are both written to support attachment.  Also included in this file  are the tools to make your own "attachable" objects.
 // Includes:
 //   include <BOSL2/std.scad>
+// FileGroup: Basic Modeling
+// FileSummary: Positioning objects on or relative to other objects.  Making your own objects support attachment.
+// FileFootnotes: STD=Included in std.scad
 //////////////////////////////////////////////////////////////////////
 
 

beziers.scad

@@ -4,6 +4,8 @@
 // Includes:
 //   include <BOSL2/std.scad>
 //   include <BOSL2/beziers.scad>
+// FileGroup: Advanced Modeling
+// FileSummary: Support for bezier curves and surfaces.
 //////////////////////////////////////////////////////////////////////
 
 // Terminology:

bottlecaps.scad

@@ -4,6 +4,8 @@
 // Includes:
 //   include <BOSL2/std.scad>
 //   include <BOSL2/bottlecaps.scad>
+// FileGroup: Threaded Parts
+// FileSummary: Standard bottle caps and necks.
 //////////////////////////////////////////////////////////////////////
 
 

comparisons.scad

@@ -3,6 +3,9 @@
 //   Functions for comparisons with lists, ordering and sorting
 // Includes:
 //   include <BOSL2/std.scad>
+// FileGroup: Data Management
+// FileSummary: Comparisons and sorting.
+// FileFootnotes: STD=Included in std.scad
 //////////////////////////////////////////////////////////////////////
 
 

coords.scad

@@ -3,6 +3,9 @@
 //   Coordinate transformations and coordinate system conversions.
 // Includes:
 //   include <BOSL2/std.scad>
+// FileGroup: Math
+// FileSummary: Conversions between coordinate systems.
+// FileFootnotes: STD=Included in std.scad
 //////////////////////////////////////////////////////////////////////
 
 

cubetruss.scad

@@ -4,6 +4,8 @@
 // Includes:
 //   include <BOSL2/std.scad>
 //   include <BOSL2/cubetruss.scad>
+// FileGroup: Parts
+// FileSummary: Modular open-framed trusses and joiners.
 //////////////////////////////////////////////////////////////////////////
 
 $cubetruss_size = 30;

distributors.scad

@@ -3,6 +3,9 @@
 //   Functions and modules to distribute children or copies of children.
 // Includes:
 //   include <BOSL2/std.scad>
+// FileGroup: Basic Modeling
+// FileSummary: Shortcuts for translation, rotation, etc.  Can act on geometry, paths, or can return a matrix.
+// FileFootnotes: STD=Included in std.scad
 //////////////////////////////////////////////////////////////////////
 
 

drawing.scad

@@ -8,6 +8,9 @@
 //   and helix() produces helix paths.
 // Includes:
 //   include <BOSL2/std.scad>
+// FileGroup: Basic Modeling
+// FileSummary: Attachable cubes, cylinders, spheres, ruler, and text.  Many can produce a VNF.
+// FileFootnotes: STD=Included in std.scad
 //////////////////////////////////////////////////////////////////////
 
 

fnliterals.scad

@@ -4,7 +4,9 @@
 // Includes:
 //   include <BOSL2/std.scad>
 //   include <BOSL2/fnliterals.scad>
-// DefineHeader(Table:Positional|Definition||Named|Definition): FunctionLiteral Args
+// FileGroup: Data Management
+// FileSummary: Function Literal Algorithms, and factories for generating function literals for builtin functions.
+// DefineHeader(Table;Headers=Positional|Definition||Named|Definition): FunctionLiteral Args
 //////////////////////////////////////////////////////////////////////