Update documentation, provisionally add ruby-2.4 for Travis (yajl prevents clean run).

Author: gkellogg

.travis.yml

@@ -4,8 +4,9 @@ script: "bundle exec rspec spec"
 env:
   - CI=true
 rvm:
-  - 2.2.5
-  - 2.3.1
+  - 2.2.6
+  - 2.3.3
+  - 2.4
   - jruby
   - rbx
 cache: bundler
@@ -14,3 +15,4 @@ matrix:
   allow_failures:
     - rvm: jruby
     - rvm: rbx
+    - rvm: 2.4

example-files/identityProfile.jsonld

@@ -0,0 +1,23 @@
+{
+  "@context": "...",
+  "id": "person1",
+  "type": "IdentityProfile",
+  "credential": [{
+    "@graph": {
+      "id": "cred1",
+      "claim": {
+        "id": "person1",
+        "ageOver": 21
+      },
+      "signature": { ... }
+    }, {
+    "@graph": {    
+      "id": "cred2",
+      "claim": {
+        "id": "person1",
+        "passport": { ... },
+      },
+      "signature": { ... }
+    }
+  }]
+}

example-files/identityProfileFrame.jsonld

@@ -0,0 +1,23 @@
+{
+  "@context": {"@vocab": "http://example.org/"},
+  "id": "person1",
+  "type": "IdentityProfile",
+  "credential": [{
+    "@graph": {
+      "id": "cred1",
+      "claim": {
+        "id": "person1",
+        "ageOver": 21
+      },
+      "signature": { ... }
+    }, {
+    "@graph": {    
+      "id": "cred2",
+      "claim": {
+        "id": "person1",
+        "passport": { ... },
+      },
+      "signature": { ... }
+    }
+  }]
+}

lib/json/ld/api.rb

@@ -189,7 +189,8 @@ def inspect
     ##
     # Create a new context by parsing a context.
     #
-    # @see {#initialize}, {#parse}
+    # @see #initialize
+    # @see #parse
     # @param [String, #read, Array, Hash, Context] local_context
     # @raise [JsonLdError]
     #   on a remote context load error, syntax error, or a reference to a term which is not defined.

lib/json/ld/context.rb

@@ -14,8 +14,6 @@ module Expand
     # @param [Context] context
     # @param [Boolean] ordered (true)
     #   Ensure output objects have keys ordered properly
-    # @param [Hash{Symbol => Object}] options
-    #   See {JSON::LD::API.expand}
     # @return [Array<Hash{String => Object}>]
     def expand(input, active_property, context, ordered: true)
       framing = @options[:processingMode].include?("expand-frame")

lib/json/ld/expand.rb

@@ -31,10 +31,10 @@ def run_tc(man, tc, options)
 
   if options[:verbose]
     puts "\nTestCase: #{tc.inspect}"
-    puts "\nInput:\n" + tc.input.read 
-    puts "\nContext:\n" + tc.context.read if tc.context
-    puts "\nFrame:\n" + tc.frame.read if tc.frame
-    puts "\nExpected:\n" + tc.expect.read if tc.positiveTest?
+    puts "\nInput:\n" + tc.input
+    puts "\nContext:\n" + tc.context if tc.context
+    puts "\nFrame:\n" + tc.frame if tc.frame
+    puts "\nExpected:\n" + tc.expect if tc.positiveTest?
   end
 
   output = ""