Cleanup doc structure .. adding ABOUT.txt and top-level README.txt .. / Adding JEP161/OpenJDK8 notes ..

7 files changed, 133 insertions, 3 deletions

diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..5504873
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,2 @@
+jdk8/*
+jigsaw/*
diff --git a/ABOUT.txt b/ABOUT.txt
new file mode 100644
index 0000000..1ee9b62
--- /dev/null
+++ b/ABOUT.txt
@@ -0,0 +1,99 @@
+We have just kicked off the new project 'Ji Gong' to 'free'
+the use of OpenJDK/Java across devices:
+  <https://jogamp.org/bugzilla/showdependencytree.cgi?id=790>
+  <http://forum.jogamp.org/Project-Ji-Gong-td4029738.html>
+
+Bug 790 <https://jogamp.org/bugzilla/show_bug.cgi?id=790>
+  Bug 698 <https://jogamp.org/bugzilla/show_bug.cgi?id=698>
+
++++
+
+Current Ji Gong Dependency
+including the OpenJDK API subset, etc:
+  <https://jogamp.org/bugzilla/showdependencytree.cgi?id=790&hide_resolved=1>
+
++++
+
+1st Milestone - Core JRT for all platforms ..
+
+<https://jogamp.org/bugzilla/show_bug.cgi?id=791>
+  <https://jogamp.org/bugzilla/show_bug.cgi?id=792>
+
+Calling for volunteers.
+
+We are looking for sponsors!
+
++++
+
+Preface
+========
+
+Bug 698 was written due to the "Fear, uncertainty and doubt" (FUD)
+strategy of Oracle of not giving express permission to use OpenJDK 
+in compliance w/ the 4 freedoms of software (FSF definition).
+
+On the contrary, Oracle gives a patent grant for using OpenJDK for desktop only,
+implying mobile use may be prohibited.
+
+This implication is highly likely non-sense, especially in the light of
+the latest Oracle vs Google case where Oracle was not able to 
+substantiate a patent infringement by Google's Dalvik VM.
+
+However .. the current situation lacks of:
+  - OpenJDK builds for Windows, OSX, Android, ..
+  - IcedTea-Web builds for Windows, OSX, Android, ..
+
+As Xerxes put it: The horse is bound to a chair and is not running ..
+
+
+Project Name
+============
+Ji Gong <https://en.wikipedia.org/wiki/Ji_Gong>
+"Unlike a traditional Buddhist monk, Daoji did not like following  traditional monastic codes. Daoji had a penchant for openly eating meat  and drinking wine; his robes were often tattered and dirty from  travelling from place to place, and stumbling while intoxicated.  However, Daoji was kind hearted and was always ready to lend a helping  hand to ordinary people. He would often treat the sick and fight against  injustice. The monks, bewildered and fed up with his behavior, expelled  Daoji from the monastery. From then on, Daoji roamed the streets and  helped people whenever he could." 
+
+Hence Daoji does people good while not necessarily conforming to certain arbitrary rules,
+while maintaining sanity and being kind hearted.
+
+The character is quite popular in the Asian culture.
+
+Project Spirit
+==============
+
+This project shall match the kind direction of it's name giving character,
+while also serving w/ JogAmp's goals of being a technology enabler.
+
+Ji Gong shall enable the VM technology across platform and devices.
+
+This project must not necessarily being maintained by the JogAmp community.
+On the contrary .. we would prefer this effort to be done from the original authors,
+i.e. OpenJDK and IcedTea-Web.
+
+However, until the goals below and this spirit of a free solution is being picked 
+up, we may continue pushing it forward from here.
+
+Note: Bug 698 sadly wasn't being replied to by neither Oracle nor the OpenJDK team.
+Of course, no surprise here, since for Oracle it might be a conflict of interest 
+due to their 'goals' to market their ARM hotspot proprietary solution
+and the OpenJDK team consist mainly of Oracle and RedHat members.
+The latter focuses on server solutions and is highly cooperating w/ Oracle.
+
+
+Project Goal
+============
+
+- Availability of the GPLv2 based OpenJDK runtime environment (JRT/JVM)
+  - Desktop (Linux, Windows, OSX, ..)
+  - Mobile (Android, other phones and tablet OS [maybe even iOS])
+  - VM CPU support:
+    - Intel/AMD 32bit and 64bit
+    - ARM based CPUs [Hotspot client/server n/a at time of writing. May need to use JamVM or AvianVM, ..]
+  
+- Optional AWT/Swing/etc - maybe added at a later time
+
+- Web Plugin based on IcedTea-Web (JWeb)
+  - Capable to run w/o AWT using a pluggable windowing subsystem implementation
+  - Optional AWT/Swing/etc - maybe added at a later time
+
++++
+
+
diff --git a/README.JEP161.txt b/README.JEP161.txt
deleted file mode 100644
index 2316bb8..0000000
--- a/README.JEP161.txt
+++ /dev/null
@@ -1,3 +0,0 @@
-JEP 161 got included in OpenJDK 8 M7 2013/06/13 (b94) 
-Feature Complete milestone http://openjdk.java.net/projects/jdk8/milestones
-thus... it should be possible to compile a compact1 profile using the openjdk 8 sourcecode without the modular system added using jigsaw
diff --git a/README.txt b/README.txt
new file mode 100644
index 0000000..05b9872
--- /dev/null
+++ b/README.txt
@@ -0,0 +1,14 @@
+
+Documentation:
+    ./ABOUT.txt              - About Ji-Gong
+    ./README.txt             - This document
+
+    ./doc/README.JEP161.txt  - OpenJDK8 JEP161 Build ..
+    ./doc/README.Jigsaw.txt  - OpenJDK8 Jigsaw Build
+    ./doc/README.JVM.txt     - Notes about custom JVM
+
+Bug 792: OpenJDK Subset - JRT Core
+    https://jogamp.org/bugzilla/show_bug.cgi?id=792
+
+    Currently testing OpenJDK8 JEP161:
+        ./doc/README.JEP161.txt
diff --git a/doc/README.JEP161.txt b/doc/README.JEP161.txt
new file mode 100644
index 0000000..acedddc
--- /dev/null
+++ b/doc/README.JEP161.txt
@@ -0,0 +1,18 @@
+JEP 161 got included in OpenJDK 8 M7 2013/06/13 (b94) 
+Feature Complete milestone http://openjdk.java.net/projects/jdk8/milestones
+thus... it should be possible to compile a compact1 profile using the openjdk 8 sourcecode without the modular system added using jigsaw
+
+JEP 161 does not require Project Jigsaw. 
+<https://blogs.oracle.com/jtc/entry/a_first_look_at_compact>
+
++++
+
+hg clone http://hg.openjdk.java.net/jdk8/jdk8
+cd jdk8/
+sh ./get_source.sh 
+
+./jdk8/README-builds.html
+http://hg.openjdk.java.net/jdk8/jdk8/raw-file/tip/README-builds.html
+
+sh configure && make all
+# make test TEST=jdk_jigsaw
diff --git a/README.JVM.txt b/doc/README.JVM.txt
index a2baa30..a2baa30 100644
--- a/README.JVM.txt
+++ b/doc/README.JVM.txt
diff --git a/README.Jigsaw.txt b/doc/README.Jigsaw.txt
index ac11672..ac11672 100644
--- a/README.Jigsaw.txt
+++ b/doc/README.Jigsaw.txt