add ada4hurd basic documentation

1 files changed, 63 insertions, 0 deletions

diff --git a/hurd/ada4hurd.mdwn b/hurd/ada4hurd.mdwn
new file mode 100644
index 00000000..784ad7fd
--- /dev/null
+++ b/hurd/ada4hurd.mdwn
@@ -0,0 +1,63 @@
+[[!meta copyright="Copyright © 2015 Free Software Foundation, Inc."]]
+
+[[!meta license="""[[!toggle id="license" text="GFDL 1.2+"]][[!toggleable
+id="license" text="Permission is granted to copy, distribute and/or modify this
+document under the terms of the GNU Free Documentation License, Version 1.2 or
+any later version published by the Free Software Foundation; with no Invariant
+Sections, no Front-Cover Texts, and no Back-Cover Texts.  A copy of the license
+is included in the section entitled
+[[GNU Free Documentation License|/fdl]]."]]"""]]
+
+# Ada4Hurd
+
+## Introduction
+
+Ada4Hurd provides tools and examples to ease Ada development in Hurd. It is at an early stage.
+
+### ada2def
+
+  * It is based on the [ASIS](http://libre.adacore.com/tools/gnat-gpl-edition/) standard
+  * It analyse an Ada specification and generates some .defs file
+
+### def2ada
+
+  * Using [opentoken](http://stephe-leake.org/ada/opentoken.html) it analyse a .defs file
+    * it can generate server skeleton
+    * it can generate a client library for easy connection to the server
+
+### xmladafs
+
+  * Mainly a translation of xmlfs in Ada
+    * write capabilities development is undergoing
+    * use [xmlada](http://libre.adacore.com/tools/xmlada/)
+
+### hello
+
+  * Hello World example translated in Ada
+
+### netfs_base
+
+  * Mainly a dummy translator to understand netfs mechanisms
+  * [[Some results of netfs experimentation|documentation/netfs_ada_results]]
+
+## Where to find the code
+
+  * Ada4Hurd is a [sourceforge](https://sourceforge.net/projects/ada4hurd/) based project
+  * Mercurial is used as DVCS
+
+    $ hg clone http://hg.code.sf.net/p/ada4hurd/code ada4hurd-code
+
+## Build the code
+
+  * Install the build dependencies as root
+
+    $ apt-get install gnat libopentoken4-dev libxmlada5-dev libasis2014-dev
+
+  * Build
+
+    $ cd ada4hurd-code
+    $ make
+
+  * Play with xmladafs
+
+    $ make trans_on
\ No newline at end of file