diff --git a/docs/exemples.md b/docs/exemples.md
new file mode 100644
index 0000000..49631d9
--- /dev/null
+++ b/docs/exemples.md
@@ -0,0 +1,24 @@
+# Genplotting exemples
+
+## Spiral
+
+Code source : [spirale.f90](spirale.f90) / if you change the parameter
+in the call to `do_spirale`, you can see some nice variations on the
+spiraling thing.
+
+![#UselessGraphic : la spirale](picz/spirale.png)
+
+This was my first testbed for this new *disruptive* technology, but
+there was so many variations of spirales, and i'm thinking about
+a powerfull spiral generator. *Stay tuned, film at 11*.
+
+## Dessins numériques
+
+By the way, I'm using all that *futilo-technology* for trying to
+make some
+[numeric pictures](http://maison.tth.netlib.re/dessins/numerique.html)
+(aka #UselessGraphic). I try to use various mathematic fundations, and
+I hack and divert and modify and ignore all that for just make
+[UselessGraphic](https://mastodon.tetaneutral.net/tags/uselessgraphic).
+*Feel free to share and enjoy*.
+
diff --git a/docs/usage.md b/docs/usage.md
new file mode 100644
index 0000000..45ed196
--- /dev/null
+++ b/docs/usage.md
@@ -0,0 +1,30 @@
+# Usage
+
+The genplotting library use, as a backend, an external 
+[software](https://git.tetalab.org/tTh/libtthimage/src/branch/master/Tools/genplot2.c)
+who can be installed with the [libtthimage](https://git.tetalab.org/tTh/libtthimage) and convert scratchfiles to
+[Targa](https://en.wikipedia.org/wiki/Truevision_TGA) image file. 
+
+Three steps : initialize, use and terminating.
+
+## Initialize
+
+Call the subroutine `genp_init` with two parameters.
+The first is an integer and must be 0. 
+The second is the filename for recording the plottings instructions,
+if this filename is an empty string, *stdout* will be used.
+
+## Use it
+
+- real xa, ya, xb, yb
+- integer color
+- call genp_move(xa, ya)
+- call genp_draw(xa, ya, color)
+- call genp_line(xa, ya, xb, yb, color)
+
+## Terminator
+
+- call genp_end(0)
+
+
+