update doc

README.md

@@ -1,132 +1,203 @@
-# dotSCAD 1.3
+# dotSCAD 2.3
 
-> Reduce the burden of 3D modeling in mathematics. Compatible with OpenSCAD 2015.03 or laters.
+> **Reduce the burden of mathematics when playing OpenSCAD.**
 
-![dotSCAD](WhirlingTaiwan.JPG)
+![dotSCAD](featured_img/TaiwanPangolin.JPG)
 
-[![license/LGPL](https://img.shields.io/badge/license-LGPL-blue.svg)](https://github.com/JustinSDK/lib-openscad/blob/master/LICENSE)
+[![license/LGPL](LICENSE.svg)](https://github.com/JustinSDK/lib-openscad/blob/master/LICENSE)
 
 ## Introduction
 
+**Based on OpenSCAD 2019.05.** 
+
 OpenSCAD uses three library locations, the installation library, built-in library, and user defined libraries. It's convenient to set `OPENSCADPATH`. Check [Setting OPENSCADPATH](https://en.wikibooks.org/wiki/OpenSCAD_User_Manual/Libraries#Setting_OPENSCADPATH) in [OpenSCAD User Manual/Libraries](https://en.wikibooks.org/wiki/OpenSCAD_User_Manual/Libraries) for details.
 
-Every module or function is located in the file which has the same name as the module or the function. For example, if you want to use the `line2d` module to draw a line, `include <line2d.scad>;` first. 
+Every module or function is located in the file which has the same name as the module or the function. For example, if you want to use the `line2d` module to draw a line, `use <line2d.scad>;` first. 
 
-	include <line2d.scad>;
+	use <line2d.scad>;
 
 	line2d(p1 = [0, 0], p2 = [5, 0], width = 1);
 
-Some modules depend on other modules. For example, the `polyline2d` module depends on the `line2d` module, so you also have to `include <line2d.scad>;` besides `include <polyline3d.scad>;`. 
+Some module files are organized in a directory. For example, px_circle.scad exists in `pixel` directory. You have to prefix the directory name when including `px_circle`.
 
-	include <line2d.scad>;
-	include <polyline3d.scad>;
+    use <pixel/px_circle.scad>;
+	
+	points = px_circle(radius = 10);
+	for(pt = points) {
+        translate(pt) square(1);
+	}
 
-	polyline2d(points = [[1, 2], [-5, -4], [-5, 3], [5, 5]], width = 1);
+## Examples
 
-If OpenSCAD generates "WARNING: Ignoring unknown xxx function" or "WARNING: Ignoring unknown xxx module" when using one module of dotSCAD. Just try to `include <xxx.scad>;`.
+See [examples](examples).
 
-Too many dependencies? Because OpenSCAD doesn't provide namespace management, I personally think that exposing dependencies is better than hiding them. In this way, users can have their own way to manage dependencies. How to categorize dependencies is up to you. For example, you can include your commonly-used modules and functions in "commonly_used.scad" and then `include <commonly_used.scad>;` in the ".scad" file of your project.
+![examples](examples/images/gallery.JPG)
 
 ## Documentation
 
-- 2D
-    - [arc](https://openhome.cc/eGossip/OpenSCAD/lib-arc.html)
-	- [pie](https://openhome.cc/eGossip/OpenSCAD/lib-pie.html)
-	- [rounded_square](https://openhome.cc/eGossip/OpenSCAD/lib-rounded_square.html)
-	- [line2d](https://openhome.cc/eGossip/OpenSCAD/lib-line2d.html)
-	- [polyline2d](https://openhome.cc/eGossip/OpenSCAD/lib-polyline2d.html)
-	- [hull_polyline2d](https://openhome.cc/eGossip/OpenSCAD/lib-hull_polyline2d.html)
-	- [hexagons](https://openhome.cc/eGossip/OpenSCAD/lib-hexagons.html)
-	- [polytransversals](https://openhome.cc/eGossip/OpenSCAD/lib-polytransversals.html)
-    - [multi_line_text](https://openhome.cc/eGossip/OpenSCAD/lib-multi_line_text.html)
-	- [voronoi2d](https://openhome.cc/eGossip/OpenSCAD/lib-voronoi2d.html)
+### 2D Module
+- [arc](https://openhome.cc/eGossip/OpenSCAD/lib2x-arc.html)
+- [pie](https://openhome.cc/eGossip/OpenSCAD/lib2x-pie.html)
+- [rounded_square](https://openhome.cc/eGossip/OpenSCAD/lib2x-rounded_square.html)
+- [line2d](https://openhome.cc/eGossip/OpenSCAD/lib2x-line2d.html)
+- [polyline2d](https://openhome.cc/eGossip/OpenSCAD/lib2x-polyline2d.html)
+- [hull_polyline2d](https://openhome.cc/eGossip/OpenSCAD/lib2x-hull_polyline2d.html)
+- [hexagons](https://openhome.cc/eGossip/OpenSCAD/lib2x-hexagons.html)
+- [polytransversals](https://openhome.cc/eGossip/OpenSCAD/lib2x-polytransversals.html)
+- [multi_line_text](https://openhome.cc/eGossip/OpenSCAD/lib2x-multi_line_text.html)
+- [voronoi2d](https://openhome.cc/eGossip/OpenSCAD/lib2x-voronoi2d.html)
 
-- 3D
-	- [rounded_cube](https://openhome.cc/eGossip/OpenSCAD/lib-rounded_cube.html)
-    - [rounded_cylinder](https://openhome.cc/eGossip/OpenSCAD/lib-rounded_cylinder.html)
-    - [crystal_ball](https://openhome.cc/eGossip/OpenSCAD/lib-crystal_ball.html)
-	- [line3d](https://openhome.cc/eGossip/OpenSCAD/lib-line3d.html)
-	- [polyline3d](https://openhome.cc/eGossip/OpenSCAD/lib-polyline3d.html)
-	- [hull_polyline3d](https://openhome.cc/eGossip/OpenSCAD/lib-hull_polyline3d.html)
-	- [function_grapher](https://openhome.cc/eGossip/OpenSCAD/lib-function_grapher.html)
-	- [polysections](https://openhome.cc/eGossip/OpenSCAD/lib-polysections.html)
-	- [starburst](https://openhome.cc/eGossip/OpenSCAD/lib-starburst.html)
-	- [voronoi3d](https://openhome.cc/eGossip/OpenSCAD/lib-voronoi3d.html)
-	
-- Transformation
-    - [along_with](https://openhome.cc/eGossip/OpenSCAD/lib-along_with.html)
-	- [hollow_out](https://openhome.cc/eGossip/OpenSCAD/lib-hollow_out.html)
-	- [bend](https://openhome.cc/eGossip/OpenSCAD/lib-bend.html)
-	- [shear](https://openhome.cc/eGossip/OpenSCAD/lib-shear.html)
+### 3D Module
+- [rounded_cube](https://openhome.cc/eGossip/OpenSCAD/lib2x-rounded_cube.html)
+- [rounded_cylinder](https://openhome.cc/eGossip/OpenSCAD/lib2x-rounded_cylinder.html)
+- [crystal_ball](https://openhome.cc/eGossip/OpenSCAD/lib2x-crystal_ball.html)
+- [line3d](https://openhome.cc/eGossip/OpenSCAD/lib2x-line3d.html)
+- [polyline3d](https://openhome.cc/eGossip/OpenSCAD/lib2x-polyline3d.html)
+- [hull_polyline3d](https://openhome.cc/eGossip/OpenSCAD/lib2x-hull_polyline3d.html)
+- [function_grapher](https://openhome.cc/eGossip/OpenSCAD/lib2x-function_grapher.html)
+- [sweep](https://openhome.cc/eGossip/OpenSCAD/lib2x-sweep.html)
+- [loft](https://openhome.cc/eGossip/OpenSCAD/lib2x-loft.html)
+- [starburst](https://openhome.cc/eGossip/OpenSCAD/lib2x-starburst.html)
+- [voronoi3d](https://openhome.cc/eGossip/OpenSCAD/lib2x-voronoi3d.html)
 
-- Functon
-	- [rotate_p](https://openhome.cc/eGossip/OpenSCAD/lib-rotate_p.html)
-	- [sub_str](https://openhome.cc/eGossip/OpenSCAD/lib-sub_str.html)
-	- [split_str](https://openhome.cc/eGossip/OpenSCAD/lib-split_str.html)
-	- [parse_number](https://openhome.cc/eGossip/OpenSCAD/lib-parse_number.html)
-	- [cross_sections](https://openhome.cc/eGossip/OpenSCAD/lib-cross_sections.html)
-	- [paths2sections](https://openhome.cc/eGossip/OpenSCAD/lib-paths2sections.html)
-	- [path_scaling_sections](https://openhome.cc/eGossip/OpenSCAD/lib-path_scaling_sections.html)
-	- [bijection_offset](https://openhome.cc/eGossip/OpenSCAD/lib-bijection_offset.html)
-	- [in_polyline](https://openhome.cc/eGossip/OpenSCAD/lib-in_polyline.html)
-	- [in_shape](https://openhome.cc/eGossip/OpenSCAD/lib-in_shape.html)
-	- [midpt_smooth](https://openhome.cc/eGossip/OpenSCAD/lib-midpt_smooth.html)
-	- [trim_shape](https://openhome.cc/eGossip/OpenSCAD/lib-trim_shape.html)
-	- [triangulate](https://openhome.cc/eGossip/OpenSCAD/lib-triangulate.html)
-	
-- Path
-    - [arc_path](https://openhome.cc/eGossip/OpenSCAD/lib-arc_path.html)
-	- [circle_path](https://openhome.cc/eGossip/OpenSCAD/lib-circle_path.html)
-    - [bezier_curve](https://openhome.cc/eGossip/OpenSCAD/lib-bezier_curve.html)
-	- [bezier_surface](https://openhome.cc/eGossip/OpenSCAD/lib-bezier_surface.html)
-	- [bezier_smooth](https://openhome.cc/eGossip/OpenSCAD/lib-bezier_smooth.html)
-    - [helix](https://openhome.cc/eGossip/OpenSCAD/lib-helix.html)
-    - [golden_spiral](https://openhome.cc/eGossip/OpenSCAD/lib-golden_spiral.html)
-    - [archimedean_spiral](https://openhome.cc/eGossip/OpenSCAD/lib-archimedean_spiral.html)
-    - [sphere_spiral](https://openhome.cc/eGossip/OpenSCAD/lib-sphere_spiral.html)
-	- [torus_knot](https://openhome.cc/eGossip/OpenSCAD/lib-torus_knot.html)
+### Transformation
+- [along_with](https://openhome.cc/eGossip/OpenSCAD/lib2x-along_with.html)
+- [hollow_out](https://openhome.cc/eGossip/OpenSCAD/lib2x-hollow_out.html)
+- [bend](https://openhome.cc/eGossip/OpenSCAD/lib2x-bend.html)
+- [shear](https://openhome.cc/eGossip/OpenSCAD/lib2x-shear.html)
 
-- Extrusion
-    - [box_extrude](https://openhome.cc/eGossip/OpenSCAD/lib-box_extrude.html)
-	- [ellipse_extrude](https://openhome.cc/eGossip/OpenSCAD/lib-ellipse_extrude.html)
-    - [stereographic_extrude](https://openhome.cc/eGossip/OpenSCAD/lib-stereographic_extrude.html)
-	- [rounded_extrude](https://openhome.cc/eGossip/OpenSCAD/lib-rounded_extrude.html)
+### 2D Function
+- [in_shape](https://openhome.cc/eGossip/OpenSCAD/lib2x-in_shape.html)
+- [bijection_offset](https://openhome.cc/eGossip/OpenSCAD/lib2x-bijection_offset.html)	
+- [trim_shape](https://openhome.cc/eGossip/OpenSCAD/lib2x-trim_shape.html)
+- [triangulate](https://openhome.cc/eGossip/OpenSCAD/lib2x-triangulate.html)
+- [contours](https://openhome.cc/eGossip/OpenSCAD/lib2x-contours.html)
 
-- 2D Shape
-    - [shape_taiwan](https://openhome.cc/eGossip/OpenSCAD/lib-shape_taiwan.html)
-	- [shape_arc](https://openhome.cc/eGossip/OpenSCAD/lib-shape_arc.html)
-	- [shape_pie](https://openhome.cc/eGossip/OpenSCAD/lib-shape_pie.html)
-	- [shape_ellipse](https://openhome.cc/eGossip/OpenSCAD/lib-shape_ellipse.html)
-    - [shape_square](https://openhome.cc/eGossip/OpenSCAD/lib-shape_square.html)
-	- [shape_trapezium](https://openhome.cc/eGossip/OpenSCAD/lib-shape_trapezium.html)
-	- [shape_cyclicpolygon](https://openhome.cc/eGossip/OpenSCAD/lib-shape_cyclicpolygon.html)
-    - [shape_pentagram](https://openhome.cc/eGossip/OpenSCAD/lib-shape_pentagram.html)	
-    - [shape_starburst](https://openhome.cc/eGossip/OpenSCAD/lib-shape_starburst.html)	    
-	- [shape_superformula](https://openhome.cc/eGossip/OpenSCAD/lib-shape_superformula.html)
-	- [shape_glued2circles](https://openhome.cc/eGossip/OpenSCAD/lib-shape_glued2circles.html)
-	- [shape_path_extend](https://openhome.cc/eGossip/OpenSCAD/lib-shape_path_extend.html)		
+### 2D/3D Function
+- [cross_sections](https://openhome.cc/eGossip/OpenSCAD/lib2x-cross_sections.html)
+- [paths2sections](https://openhome.cc/eGossip/OpenSCAD/lib2x-paths2sections.html)
+- [path_scaling_sections](https://openhome.cc/eGossip/OpenSCAD/lib2x-path_scaling_sections.html)
+- [bezier_surface](https://openhome.cc/eGossip/OpenSCAD/lib2x-bezier_surface.html)	
+- [bezier_smooth](https://openhome.cc/eGossip/OpenSCAD/lib2x-bezier_smooth.html)	
+- [midpt_smooth](https://openhome.cc/eGossip/OpenSCAD/lib2x-midpt_smooth.html)
+- [in_polyline](https://openhome.cc/eGossip/OpenSCAD/lib2x-in_polyline.html)
 
-- 2D Shape Extrusion
-	- [bend_extrude](https://openhome.cc/eGossip/OpenSCAD/lib-bend_extrude.html)
-	- [path_extrude](https://openhome.cc/eGossip/OpenSCAD/lib-path_extrude.html)
-	- [ring_extrude](https://openhome.cc/eGossip/OpenSCAD/lib-ring_extrude.html)
-	- [helix_extrude](https://openhome.cc/eGossip/OpenSCAD/lib-helix_extrude.html)
-	- [golden_spiral_extrude](https://openhome.cc/eGossip/OpenSCAD/lib-golden_spiral_extrude.html)
-	- [archimedean_spiral_extrude](https://openhome.cc/eGossip/OpenSCAD/lib-archimedean_spiral_extrude.html)
-	- [sphere_spiral_extrude](https://openhome.cc/eGossip/OpenSCAD/lib-sphere_spiral_extrude.html)
+### Path
+- [arc_path](https://openhome.cc/eGossip/OpenSCAD/lib2x-arc_path.html)
+- [bspline_curve](https://openhome.cc/eGossip/OpenSCAD/lib2x-bspline_curve.html)
+- [bezier_curve](https://openhome.cc/eGossip/OpenSCAD/lib2x-bezier_curve.html)
+- [helix](https://openhome.cc/eGossip/OpenSCAD/lib2x-helix.html)
+- [golden_spiral](https://openhome.cc/eGossip/OpenSCAD/lib2x-golden_spiral.html)
+- [archimedean_spiral](https://openhome.cc/eGossip/OpenSCAD/lib2x-archimedean_spiral.html)
+- [sphere_spiral](https://openhome.cc/eGossip/OpenSCAD/lib2x-sphere_spiral.html)
+- [torus_knot](https://openhome.cc/eGossip/OpenSCAD/lib2x-torus_knot.html)
 
-- Matrix
-	- [m_cumulate](https://openhome.cc/eGossip/OpenSCAD/lib-m_cumulate.html)	
-	- [m_translation](https://openhome.cc/eGossip/OpenSCAD/lib-m_translation.html)
-	- [m_rotation](https://openhome.cc/eGossip/OpenSCAD/lib-m_rotation.html)
-	- [m_scaling](https://openhome.cc/eGossip/OpenSCAD/lib-m_scaling.html)
-	- [m_mirror](https://openhome.cc/eGossip/OpenSCAD/lib-m_mirror.html)
-	- [m_shearing](https://openhome.cc/eGossip/OpenSCAD/lib-m_shearing.html)
+### Extrusion
+- [box_extrude](https://openhome.cc/eGossip/OpenSCAD/lib2x-box_extrude.html)
+- [ellipse_extrude](https://openhome.cc/eGossip/OpenSCAD/lib2x-ellipse_extrude.html)
+- [stereographic_extrude](https://openhome.cc/eGossip/OpenSCAD/lib2x-stereographic_extrude.html)
+- [rounded_extrude](https://openhome.cc/eGossip/OpenSCAD/lib2x-rounded_extrude.html)
+- [bend_extrude](https://openhome.cc/eGossip/OpenSCAD/lib2x-bend_extrude.html)	
 
-- Other
-    - [turtle2d](https://openhome.cc/eGossip/OpenSCAD/lib-turtle2d.html)
-    - [turtle3d](https://openhome.cc/eGossip/OpenSCAD/lib-turtle3d.html)
-	- [log](https://openhome.cc/eGossip/OpenSCAD/lib-log.html)
+### 2D Shape
+- [shape_taiwan](https://openhome.cc/eGossip/OpenSCAD/lib2x-shape_taiwan.html)
+- [shape_arc](https://openhome.cc/eGossip/OpenSCAD/lib2x-shape_arc.html)
+- [shape_pie](https://openhome.cc/eGossip/OpenSCAD/lib2x-shape_pie.html)
+- [shape_circle](https://openhome.cc/eGossip/OpenSCAD/lib2x-shape_circle.html)
+- [shape_ellipse](https://openhome.cc/eGossip/OpenSCAD/lib2x-shape_ellipse.html)
+- [shape_square](https://openhome.cc/eGossip/OpenSCAD/lib2x-shape_square.html)
+- [shape_trapezium](https://openhome.cc/eGossip/OpenSCAD/lib2x-shape_trapezium.html)
+- [shape_cyclicpolygon](https://openhome.cc/eGossip/OpenSCAD/lib2x-shape_cyclicpolygon.html)
+- [shape_pentagram](https://openhome.cc/eGossip/OpenSCAD/lib2x-shape_pentagram.html)	
+- [shape_starburst](https://openhome.cc/eGossip/OpenSCAD/lib2x-shape_starburst.html)	    
+- [shape_superformula](https://openhome.cc/eGossip/OpenSCAD/lib2x-shape_superformula.html)
+- [shape_glued2circles](https://openhome.cc/eGossip/OpenSCAD/lib2x-shape_glued2circles.html)
+- [shape_path_extend](https://openhome.cc/eGossip/OpenSCAD/lib2x-shape_path_extend.html)
+
+### 2D Shape Extrusion
+- [path_extrude](https://openhome.cc/eGossip/OpenSCAD/lib2x-path_extrude.html)
+- [ring_extrude](https://openhome.cc/eGossip/OpenSCAD/lib2x-ring_extrude.html)
+- [helix_extrude](https://openhome.cc/eGossip/OpenSCAD/lib2x-helix_extrude.html)
+- [golden_spiral_extrude](https://openhome.cc/eGossip/OpenSCAD/lib2x-golden_spiral_extrude.html)
+- [archimedean_spiral_extrude](https://openhome.cc/eGossip/OpenSCAD/lib2x-archimedean_spiral_extrude.html)
+- [sphere_spiral_extrude](https://openhome.cc/eGossip/OpenSCAD/lib2x-sphere_spiral_extrude.html)
+
+### Util
+- [util/sub_str](https://openhome.cc/eGossip/OpenSCAD/lib2x-sub_str.html)
+- [util/split_str](https://openhome.cc/eGossip/OpenSCAD/lib2x-split_str.html)
+- [util/parse_number](https://openhome.cc/eGossip/OpenSCAD/lib2x-parse_number.html)
+- [util/reverse](https://openhome.cc/eGossip/OpenSCAD/lib2x-reverse.html)
+- [util/slice](https://openhome.cc/eGossip/OpenSCAD/lib2x-slice.html)
+- [util/sort](https://openhome.cc/eGossip/OpenSCAD/lib2x-sort.html)
+- [util/rand](https://openhome.cc/eGossip/OpenSCAD/lib2x-rand.html)
+- [util/fibseq](https://openhome.cc/eGossip/OpenSCAD/lib2x-fibseq.html)	
+- [util/bsearch](https://openhome.cc/eGossip/OpenSCAD/lib2x-bsearch.html)	
+- [util/has](https://openhome.cc/eGossip/OpenSCAD/lib2x-has.html)
+- [util/dedup](https://openhome.cc/eGossip/OpenSCAD/lib2x-dedup.html)
+- [util/flat](https://openhome.cc/eGossip/OpenSCAD/lib2x-flat.html)
+
+### Matrix
+- [matrix/m_cumulate](https://openhome.cc/eGossip/OpenSCAD/lib2x-m_cumulate.html)	
+- [matrix/m_translation](https://openhome.cc/eGossip/OpenSCAD/lib2x-m_translation.html)
+- [matrix/m_rotation](https://openhome.cc/eGossip/OpenSCAD/lib2x-m_rotation.html)
+- [matrix/m_scaling](https://openhome.cc/eGossip/OpenSCAD/lib2x-m_scaling.html)
+- [matrix/m_mirror](https://openhome.cc/eGossip/OpenSCAD/lib2x-m_mirror.html)
+- [matrix/m_shearing](https://openhome.cc/eGossip/OpenSCAD/lib2x-m_shearing.html)
+
+### Point Transformation
+- [ptf/ptf_rotate](https://openhome.cc/eGossip/OpenSCAD/lib2x-ptf_rotate.html)
+- [ptf/ptf_x_twist](https://openhome.cc/eGossip/OpenSCAD/lib2x-ptf_x_twist.html)
+- [ptf/ptf_y_twist](https://openhome.cc/eGossip/OpenSCAD/lib2x-ptf_y_twist.html)
+- [ptf/ptf_circle](https://openhome.cc/eGossip/OpenSCAD/lib2x-ptf_circle.html)
+- [ptf/ptf_bend](https://openhome.cc/eGossip/OpenSCAD/lib2x-ptf_bend.html)
+- [ptf/ptf_ring](https://openhome.cc/eGossip/OpenSCAD/lib2x-ptf_ring.html)
+- [ptf/ptf_sphere](https://openhome.cc/eGossip/OpenSCAD/lib2x-ptf_sphere.html)
+- [ptf/ptf_torus](https://openhome.cc/eGossip/OpenSCAD/lib2x-ptf_torus.html)
+
+----
+
+### Turtle
+- [turtle/turtle2d](https://openhome.cc/eGossip/OpenSCAD/lib2x-turtle2d.html)
+- [turtle/turtle3d](https://openhome.cc/eGossip/OpenSCAD/lib2x-turtle3d.html)
+- [turtle/t2d](https://openhome.cc/eGossip/OpenSCAD/lib2x-t2d.html)
+- [turtle/t3d](https://openhome.cc/eGossip/OpenSCAD/lib2x-t3d.html)
+
+### Pixel
+- [pixel/px_line](https://openhome.cc/eGossip/OpenSCAD/lib2x-px_line.html)
+- [pixel/px_polyline](https://openhome.cc/eGossip/OpenSCAD/lib2x-px_polyline.html)
+- [pixel/px_circle](https://openhome.cc/eGossip/OpenSCAD/lib2x-px_circle.html)
+- [pixel/px_cylinder](https://openhome.cc/eGossip/OpenSCAD/lib2x-px_cylinder.html)
+- [pixel/px_sphere](https://openhome.cc/eGossip/OpenSCAD/lib2x-px_sphere.html)
+- [pixel/px_polygon](https://openhome.cc/eGossip/OpenSCAD/lib2x-px_polygon.html)
+- [pixel/px_from](https://openhome.cc/eGossip/OpenSCAD/lib2x-px_from.html)
+- [pixel/px_ascii](https://openhome.cc/eGossip/OpenSCAD/lib2x-px_ascii.html)
+- [pixel/px_gray](https://openhome.cc/eGossip/OpenSCAD/lib2x-px_gray.html)
+
+### Part
+- [part/connector_peg](https://openhome.cc/eGossip/OpenSCAD/lib2x-connector_peg.html)
+- [part/cone](https://openhome.cc/eGossip/OpenSCAD/lib2x-cone.html)
+- [part/joint_T](https://openhome.cc/eGossip/OpenSCAD/lib2x-joint_T.html)
+
+### Surface
+- [surface/sf_square](https://openhome.cc/eGossip/OpenSCAD/lib2x-sf_square.html)
+- [surface/sf_bend](https://openhome.cc/eGossip/OpenSCAD/lib2x-sf_bend.html)
+- [surface/sf_ring](https://openhome.cc/eGossip/OpenSCAD/lib2x-sf_ring.html)
+- [surface/sf_sphere](https://openhome.cc/eGossip/OpenSCAD/lib2x-sf_sphere.html)
+- [surface/sf_torus](https://openhome.cc/eGossip/OpenSCAD/lib2x-sf_torus.html)
+- [surface/sf_solidify](https://openhome.cc/eGossip/OpenSCAD/lib2x-sf_solidify.html)
+
+### Noise
+- [noise/nz_perlin1](https://openhome.cc/eGossip/OpenSCAD/lib2x-nz_perlin1.html)
+- [noise/nz_perlin1s](https://openhome.cc/eGossip/OpenSCAD/lib2x-nz_perlin1s.html)
+- [noise/nz_perlin2](https://openhome.cc/eGossip/OpenSCAD/lib2x-nz_perlin2.html)
+- [noise/nz_perlin2s](https://openhome.cc/eGossip/OpenSCAD/lib2x-nz_perlin2s.html)
+- [noise/nz_perlin3](https://openhome.cc/eGossip/OpenSCAD/lib2x-nz_perlin3.html)
+- [noise/nz_perlin3s](https://openhome.cc/eGossip/OpenSCAD/lib2x-nz_perlin3s.html)
+- [noise/nz_worley2](https://openhome.cc/eGossip/OpenSCAD/lib2x-nz_worley2.html)
+- [noise/nz_worley2s](https://openhome.cc/eGossip/OpenSCAD/lib2x-nz_worley2s.html)
+- [noise/nz_worley3](https://openhome.cc/eGossip/OpenSCAD/lib2x-nz_worley3.html)
+- [noise/nz_worley3s](https://openhome.cc/eGossip/OpenSCAD/lib2x-nz_worley3s.html)
+- [noise/nz_cell](https://openhome.cc/eGossip/OpenSCAD/lib2x-nz_cell.html)
 
 ## Bugs and Feedback
 
@@ -134,6 +205,6 @@ For bugs, questions and discussions please use the [Github Issues](https://githu
 
 ## About dotSCAD
 
-I've been using OpenSCAD for years and created some funny things. Some of them include several important ideas and details. To prevent forgetfulness, I decided to [write them down](https://openhome.cc/eGossip/OpenSCAD/). Some examples developed in the documentation are useful so I elaborate them into this library.
+I've been using OpenSCAD for years. Some of [my works](https://github.com/JustinSDK/dotSCAD/tree/master/examples) include reusable implementations so I elaborate them into this library.
 
 The idea of the name dotSCAD comes from the filename extension ".scad" of OpenSCAD. 

RELEASE.md

@@ -1,5 +1,124 @@
 > Version numbers are based on [Semantic Versioning](https://semver.org/).
 
+# v2.3
+Bugfixes:
+- `helix_extrude`: wrong orientation when `CLK`.
+
+Deprecated:
+- polysections: use [sweep](https://openhome.cc/eGossip/OpenSCAD/lib2x-sweep.html) instead.
+- rotate_p: use [ptf_rotate](https://openhome.cc/eGossip/OpenSCAD/lib2x-ptf_rotate.html) instead.
+- circle_path: use [shape_circle](https://openhome.cc/eGossip/OpenSCAD/lib2x-shape_circle.html) instead.
+
+New modules and functions:
+- 3D Module
+  - [sweep](https://openhome.cc/eGossip/OpenSCAD/lib2x-sweep.html)
+  - [loft](https://openhome.cc/eGossip/OpenSCAD/lib2x-loft.html)
+- 2D Function
+  - [contours](https://openhome.cc/eGossip/OpenSCAD/lib2x-contours.html)
+- Path
+  - [shape_circle](https://openhome.cc/eGossip/OpenSCAD/lib2x-shape_circle.html)
+- Util
+  - [util/bsearch](https://openhome.cc/eGossip/OpenSCAD/lib2x-bsearch.html)
+  - [util/has](https://openhome.cc/eGossip/OpenSCAD/lib2x-has.html)
+  - [util/dedup](https://openhome.cc/eGossip/OpenSCAD/lib2x-dedup.html)
+  - [util/flat](https://openhome.cc/eGossip/OpenSCAD/lib2x-flat.html)
+- Point transformation
+  - [ptf/ptf_rotate](https://openhome.cc/eGossip/OpenSCAD/lib2x-ptf_rotate.html)
+  - [ptf/ptf_x_twist](https://openhome.cc/eGossip/OpenSCAD/lib2x-ptf_x_twist.html)
+  - [ptf/ptf_y_twist](https://openhome.cc/eGossip/OpenSCAD/lib2x-ptf_y_twist.html)
+  - [ptf/ptf_circle](https://openhome.cc/eGossip/OpenSCAD/lib2x-ptf_circle.html)
+  - [ptf/ptf_bend](https://openhome.cc/eGossip/OpenSCAD/lib2x-ptf_bend.html)
+  - [ptf/ptf_ring](https://openhome.cc/eGossip/OpenSCAD/lib2x-ptf_ring.html)
+  - [ptf/ptf_sphere](https://openhome.cc/eGossip/OpenSCAD/lib2x-ptf_sphere.html)
+  - [ptf/ptf_torus](https://openhome.cc/eGossip/OpenSCAD/lib2x-ptf_torus.html)
+- Surface
+  - [surface/sf_square](https://openhome.cc/eGossip/OpenSCAD/lib2x-sf_square.html)
+  - [surface/sf_bend](https://openhome.cc/eGossip/OpenSCAD/lib2x-sf_bend.html)
+  - [surface/sf_ring](https://openhome.cc/eGossip/OpenSCAD/lib2x-sf_ring.html)
+  - [surface/sf_sphere](https://openhome.cc/eGossip/OpenSCAD/lib2x-sf_sphere.html)
+  - [surface/sf_torus](https://openhome.cc/eGossip/OpenSCAD/lib2x-sf_torus.html)
+  - [surface/sf_solidify](https://openhome.cc/eGossip/OpenSCAD/lib2x-sf_solidify.html)
+- Noise
+  - [noise/nz_perlin1](https://openhome.cc/eGossip/OpenSCAD/lib2x-nz_perlin1.html)
+  - [noise/nz_perlin1s](https://openhome.cc/eGossip/OpenSCAD/lib2x-nz_perlin1s.html)
+  - [noise/nz_perlin2](https://openhome.cc/eGossip/OpenSCAD/lib2x-nz_perlin2.html)
+  - [noise/nz_perlin2s](https://openhome.cc/eGossip/OpenSCAD/lib2x-nz_perlin2s.html)
+  - [noise/nz_perlin3](https://openhome.cc/eGossip/OpenSCAD/lib2x-nz_perlin3.html)
+  - [noise/nz_perlin3s](https://openhome.cc/eGossip/OpenSCAD/lib2x-nz_perlin3s.html)
+  - [noise/nz_worley2](https://openhome.cc/eGossip/OpenSCAD/lib2x-nz_worley2.html)
+  - [noise/nz_worley2s](https://openhome.cc/eGossip/OpenSCAD/lib2x-nz_worley2s.html)
+  - [noise/nz_worley3](https://openhome.cc/eGossip/OpenSCAD/lib2x-nz_worley3.html)
+  - [noise/nz_worley3s](https://openhome.cc/eGossip/OpenSCAD/lib2x-nz_worley3s.html)
+  - [noise/nz_cell](https://openhome.cc/eGossip/OpenSCAD/lib2x-nz_cell.html)
+
+# v2.2.1
+Bugfixes:
+- `util/sort`: z not sorted.
+
+Improvements:
+- Faster when the `style` of `function_grapher` is `"LINES"` or `"HULL_LINES"`.
+- Dedup pixels of `pixel/px_polyline`, `pixel/px_circle`, `pixel/px_cylinder`, `pixel/px_sphere`, `pixel/px_polygon`.
+
+# v2.2
+- Bugfixes
+  - `util/sort`: fix "search term not found" warning when `by` is `"idx"`.
+- Better dependency management. Just `use` modules you want. Existing scripts are not required to do any change.
+
+# v2.1
+- Bugfixes
+  - `bend_extrude`: fix wrong rotation.
+  - `bijection_offset`: fix point order.
+- New parameters.
+  - `box_extrude`: new `twist` parameter.
+  - `crystall_ball`: new `thickness` parameter.
+- New modules and functions.
+  - [bspline_curve](https://openhome.cc/eGossip/OpenSCAD/lib2-bspline_curve.html)
+  - [util/rand](https://openhome.cc/eGossip/OpenSCAD/lib2-rand.html)
+  - [util/fibseq](https://openhome.cc/eGossip/OpenSCAD/lib2-fibseq.html)
+  - [pixel/px_from](https://openhome.cc/eGossip/OpenSCAD/lib2-px_from.html)
+  - [pixel/px_ascii](https://openhome.cc/eGossip/OpenSCAD/lib2-px_ascii.html)
+  - [pixel/px_gray](https://openhome.cc/eGossip/OpenSCAD/lib2-px_gray.html)
+  - [part/connector_peg](https://openhome.cc/eGossip/OpenSCAD/lib2-connector_peg.html)
+  - [part/cone](https://openhome.cc/eGossip/OpenSCAD/lib2-cone.html)
+  - [part/joint_T](https://openhome.cc/eGossip/OpenSCAD/lib2-joint_T.html)
+  - [turtle/t2d](https://openhome.cc/eGossip/OpenSCAD/lib2-t2d.html)
+  - [turtle/t3d](https://openhome.cc/eGossip/OpenSCAD/lib2-t3d.html)  
+
+# v2.0
+- Use new features of OpenSCAD-2019.05 to refactor internal implementation.
+- Delete the `log` module which is never used.
+- Directory changed.
+  - `m_cumulate`, `m_mirror`, `m_rotation`, `m_scaling`, `m_shearing` and `m_translation` are moved into the `matrix` directory.
+  - `turtle2d` and `turtle3d` are moved into the `turtle` directory.
+  - `parse_number`, `split_str` and `sub_str` are moved into the `util` directory.
+- New modules and functions.
+  - [pixel/px_line](https://openhome.cc/eGossip/OpenSCAD/lib2-px_line.html)
+  - [pixel/px_polyline](https://openhome.cc/eGossip/OpenSCAD/lib2-px_polyline.html)
+  - [pixel/px_circle](https://openhome.cc/eGossip/OpenSCAD/lib2-px_circle.html)
+  - [pixel/px_cylinder](https://openhome.cc/eGossip/OpenSCAD/lib2-px_cylinder.html)
+  - [pixel/px_sphere](https://openhome.cc/eGossip/OpenSCAD/lib2-px_sphere.html)
+  - [pixel/px_polygon](https://openhome.cc/eGossip/OpenSCAD/lib2-px_polygon.html)
+  - [util/reverse](https://openhome.cc/eGossip/OpenSCAD/lib2-reverse.html)
+  - [util/slice](https://openhome.cc/eGossip/OpenSCAD/lib2-slice.html)
+  - [util/sort](https://openhome.cc/eGossip/OpenSCAD/lib2-sort.html)  
+
+# v1.3.3
+- Bugfixes
+  - `in_shape`: Wrong variable name.
+
+# v1.3.2
+- All-in-one source file.
+  - You can use `include <dotSCAD.scad>;` or `use <dotSCAD.scad>;` if you really don't want to care about dependencies.
+
+- Bugfixes
+  - `along_with`: Wrong variable scope.
+  
+# v1.3.1
+- Bugfixes
+  - `in_polyline`: Wrong parameter name.
+  - `in_shape`: Missing dependency.
+  - `along_with`: Avoid warning when using 2D points.
+  
 # v1.3
 - New modules:
   - [bend_extrude](https://openhome.cc/eGossip/OpenSCAD/lib-bend_extrude.html)