From ee8373d9a9175f5f4f6553b9e253daf62e76610c Mon Sep 17 00:00:00 2001 From: Andrew Cady Date: Wed, 13 Mar 2019 01:58:08 -0400 Subject: bring in OpenSCAD (forward-ported) --- openscad/README.md | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) create mode 100644 openscad/README.md (limited to 'openscad/README.md') diff --git a/openscad/README.md b/openscad/README.md new file mode 100644 index 0000000..2a72291 --- /dev/null +++ b/openscad/README.md @@ -0,0 +1,28 @@ +# What's Graphics.OpenSCAD + +This is a library whose primary component is an algebraic data type +for describing [OpenSCAD](http://openscad.org) models, and a function +that converts that data type into a string. There are convenience +functions to make building the model easier. + +## What's different + +Given the primitive and quirky nature of the OpenSCAD language, the +idea of "using OpenSCAD" as an assembler is both obvious, and promoted +in lieu of adding major extensions to OpenSCAD. So there are a number +of such projects, for a variety of languages. + +Any compiler that generated "assembler" that caused the assembler +program to generate errors would be considered buggy. However, none of +the alternative projects I looked at seemed to do anything about that +(my apologies if I missed one - I only looked at languages I was +interested in using). Graphics.OpenSCAD takes the attitude that errors +from OpenSCAD on the generated code are errors in +Graphics.OpenSCAD. If you manage to generate code that causes OpenSCAD +to issue an error message, please open an issue here. + +## More info + +Read the +[online docs](https://hackage.haskell.org/package/OpenSCAD-0.2.1.0/docs/Graphics-OpenSCAD.html) +at [hackage](http://hackage.haskell.org/). -- cgit v1.2.3