More documentation

  - Add future example
  - Remove hard coded `javaHome` path and document how to set
    up SBT to use Java 8.

Author: retronym

README.md

@@ -4,3 +4,27 @@ A set of [Functional Interfaces](http://download.java.net/jdk8/docs/api/java/lan
 for `scala.FunctionN`. These are designed for convenient construction of Scala functions
 using Java 8 lambda syntax.
 
+### Usage
+
+```java
+import scala.concurrent.*;
+import static scala.runtime.F.func;
+
+class Test {
+	private static Future<Integer> futureExample(Future<String> future, ExecutionContext ec) {
+	    return future.map(func(s -> s.toUpperCase()), ec).map(func(s -> s.length()), ec);
+	}
+}
+```
+
+[More Examples / Documentation](https://github.com/retronym/java-8-function1/blob/master/src/test/java/scala/runtime/test/Test.java)
+
+### Hacking
+
+[Code Generator](https://github.com/retronym/java-8-function1/blob/master/project/CodeGen.scala)
+
+#### Running Examples
+
+```
+% (export JAVA_HOME=`java_home 1.8`; export PATH=$JAVA_HOME/bin:$PATH; sbt 'test:runMain scala.runtime.test.Test')
+```

build.sbt

@@ -1,7 +1,5 @@
 scalaVersion := "2.11.0-RC1"
 
-javaHome := Some(file("/Library/Java/JavaVirtualMachines/jdk1.8.0.jdk/Contents/Home"))
-
 sourceGenerators in Compile <+= sourceManaged in Compile map { dir =>
   def write(name: String, content: String) = {
     val f = dir / "scala" / "runtime" / s"${name}.java"

src/test/java/scala/runtime/test/Test.java

@@ -93,6 +93,11 @@ public static void main(String[] args) {
         acceptFunction22Unit(   proc((v1, v2, v3, v4, v5, v6, v7, v8, v9, v10, v11, v12, v13, v14, v15, v16, v17, v18, v19, v20, v21, v22) -> {v1.toUpperCase(); return;}));
     }
 
+    private static scala.concurrent.Future<Integer> futureExample(
+        scala.concurrent.Future<String> future, scala.concurrent.ExecutionContext ec) {
+        return future.map(func(s -> s.toUpperCase()), ec).map(func(s -> s.length()), ec);
+    }
+
     private static void sideEffect() {
     }