Merge: Document the doc/ directory

The directory is empty except an outdated README.
So, maybe not the best user-experience for people that look for documentation and naively open the `doc/` directory...

So update the README and offer a `Makefile` to generate something in the directory.

Pull-Request: #942
Reviewed-by: Alexandre Terrasa <alexandre@moz-code.org>

diff --git a/doc/Makefile b/doc/Makefile
new file mode 100644 (file)
index 0000000..91ae0c8
--- /dev/null
+++ b/doc/Makefile
@@ -0,0 +1,2 @@
+all:
+       ${MAKE} docs -C ..

diff --git a/doc/README b/doc/README
deleted file mode 100644 (file)
index 0e23e6a..0000000
--- a/doc/README
+++ /dev/null
@@ -1,6 +0,0 @@
-This directory contains various documentation for Nit
-
-* advanced_options [TXT]: documentation for advanced options of the compiler and run-time execution.
-* stdlib [HTML]: Autodocumentation for the Nit standard library.
-
-For more documentation, visit http://nitlanguage.org/doc/

diff --git a/doc/README.md b/doc/README.md
new file mode 100644 (file)
index 0000000..406cb02
--- /dev/null
+++ b/doc/README.md
@@ -0,0 +1,12 @@
+This directory contains auto-documentation generated by nitdoc.
+
+ * [stdlib](http://nitlanguage.org/doc/stdlib/): the Nit libraries (from `../lib/`).
+ * [nitc](http://nitlanguage.org/doc/nitc/): the Nit tools (from `../src/`).
+
+Run `make` to produce them.
+
+Specific documentation can be found elsewhere:
+
+ * The manpages of the Nit tools are in the directory `../share/man`
+ * The documentation of the other tools and programs are in their subdirectories in `../examples` and `../contrib`
+ * For more documentation, visit <http://nitlanguage.org/doc/>