README.md in rdf-3.1.7 vs README.md in rdf-3.1.8
- old
+ new
@@ -4,13 +4,13 @@
(RDF)][RDF] data.
* <https://ruby-rdf.github.com/rdf>
[](https://badge.fury.io/rb/rdf)
-[](https://travis-ci.org/ruby-rdf/rdf)
-[](https://coveralls.io/r/ruby-rdf/rdf)
-[](https://gitter.im/ruby-rdf/rdf?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
+[](https://github.com/ruby-rdf/rdf/actions?query=workflow%3ACI)
+[](https://coveralls.io/github/ruby-rdf/rdf)
+[](https://gitter.im/ruby-rdf/rdf)
## Features
* 100% pure Ruby with minimal dependencies and no bloat.
* Fully compatible with [RDF 1.1][] specifications.
@@ -37,10 +37,26 @@
[RestClient][] gem is included, that will be used instead to retrieve remote
resources. Clients may also consider using [RestClient Components][] to enable
client-side caching of HTTP results using [Rack::Cache][] or other Rack
middleware.
+See {RDF::Util::File} for configuring other mechanisms for retrieving resources.
+
+### Term caching and configuration.
+
+RDF.rb uses a weak-reference cache for storing internalized versions of URIs and Nodes. This is particularly useful for Nodes as two nodes are equivalent only if they're the same node.
+
+By default, each cache can grow to an unlimited size, but this can be configured using {RDF.config}, for general limits, along with URI- or Node-specific limits.
+
+For example, to limit the size of the URI intern cache only:
+
+ RDF.config.uri_cache_size = 10_000
+
+The default for creating new caches without a specific initialization size can be set using:
+
+ RDF.config.cache_size = 100_000
+
## Differences between RDF 1.0 and RDF 1.1
This version of RDF.rb is fully compatible with [RDF 1.1][], but it creates some
marginal incompatibilities with [RDF 1.0][], as implemented in versions prior to
the 1.1 release of RDF.rb:
@@ -244,22 +260,15 @@
graph = RDF::Graph.new do |graph|
RDF::NTriples::Reader.new(nt) {|reader| graph << reader}
end
# => RDF::ReaderError
-Readers support a `rdfstar` option with either `:PG` (Property Graph) or `:SA` (Separate Assertions) modes. In `:PG` mode, statements that are used in the subject or object positions are also implicitly added to the graph:
+Readers support a boolean valued `rdfstar` option.
graph = RDF::Graph.new do |graph|
- RDF::NTriples::Reader.new(nt, rdfstar: :PG) {|reader| graph << reader}
+ RDF::NTriples::Reader.new(nt, rdfstar: true) {|reader| graph << reader}
end
- graph.count #=> 2
-
-When using the `:SA` mode, only one statement is asserted, although the reified statement is contained within the graph.
-
- graph = RDF::Graph.new do |graph|
- RDF::NTriples::Reader.new(nt, rdfstar: :SA) {|reader| graph << reader}
- end
graph.count #=> 1
## Documentation
<https://rubydoc.info/github/ruby-rdf/rdf>
@@ -476,10 +485,10 @@
[RDF::RDFXML]: https://ruby-rdf.github.com/rdf-rdfxml
[RDF::TriG]: https://ruby-rdf.github.com/rdf-trig
[RDF::TriX]: https://ruby-rdf.github.com/rdf-trix
[RDF::Turtle]: https://ruby-rdf.github.com/rdf-turtle
[RDF::Raptor]: https://ruby-rdf.github.com/rdf-raptor
-[RDF*]: https://lists.w3.org/Archives/Public/public-rdf-star/
+[RDF*]: https://w3c.github.io/rdf-star/rdf-star-cg-spec.html
[LinkedData]: https://ruby-rdf.github.com/linkeddata
[JSON::LD]: https://ruby-rdf.github.com/json-ld
[RestClient]: https://rubygems.org/gems/rest-client
[RestClient Components]: https://rubygems.org/gems/rest-client-components
[Rack::Cache]: https://rtomayko.github.io/rack-cache/
\ No newline at end of file