Add Javadoc for Assembler indicating that Model is advisory
Project: http://git-wip-us.apache.org/repos/asf/jena/repo Commit: http://git-wip-us.apache.org/repos/asf/jena/commit/6db00161 Tree: http://git-wip-us.apache.org/repos/asf/jena/tree/6db00161 Diff: http://git-wip-us.apache.org/repos/asf/jena/diff/6db00161 Branch: refs/heads/JENA-507 Commit: 6db001614d0943a3214f7861403436b9f3fa2db7 Parents: 03d6e99 Author: ajs6f <[email protected]> Authored: Mon Jan 25 08:46:51 2016 -0500 Committer: ajs6f <[email protected]> Committed: Mon Jan 25 10:12:06 2016 -0500 ---------------------------------------------------------------------- .../src/main/java/org/apache/jena/assembler/Assembler.java | 5 +++++ 1 file changed, 5 insertions(+) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/jena/blob/6db00161/jena-core/src/main/java/org/apache/jena/assembler/Assembler.java ---------------------------------------------------------------------- diff --git a/jena-core/src/main/java/org/apache/jena/assembler/Assembler.java b/jena-core/src/main/java/org/apache/jena/assembler/Assembler.java index 0e6aee4..6966faa 100644 --- a/jena-core/src/main/java/org/apache/jena/assembler/Assembler.java +++ b/jena-core/src/main/java/org/apache/jena/assembler/Assembler.java @@ -25,6 +25,11 @@ import org.apache.jena.rdf.model.* ; An Assembler creates objects from their RDF descriptions. The root motivation is to create Models, but other objects are required as sub-components of those Models, so a general mechanism is available. + + @apiNote Methods accepting {@link Model} as a parameter treat appropriate values of {@code Model} as passing down + to sub-assemblers a requirement to share for certain setups that work as tightly coordinated groups. It's a hint, + not an instruction. + */ public interface Assembler {
