Doc comments

Author: simonoakesepimorphics

binary-array-ld-lib/src/main/kotlin/net/bald/context/ModelContext.kt

@@ -5,21 +5,29 @@ import org.apache.jena.rdf.model.Resource
 import org.apache.jena.shared.PrefixMapping
 
 /**
- * TODO
+ * The external context in which a binary array can be resolved.
+ * This includes resource and property aliases as defined by [AliasDefinition]
+ * and the available namespace prefix mappings.
  * @see AliasDefinition
  */
 interface ModelContext: AliasDefinition {
     /**
-     * TODO
+     * Prefix mappings that are available in this context.
      */
     val prefixMapping: PrefixMapping
 
+    /**
+     * A substitute [ModelContext] implementation that represents a null or empty context.
+     */
     object Empty: ModelContext {
         override val prefixMapping: PrefixMapping get() = PrefixMapping.Factory.create()
         override fun property(identifier: String): Property? = null
         override fun resource(identifier: String): Resource? = null
     }
 
+    /**
+     * A basic [ModelContext] implementation that simply composes the prefix mapping and alias elements.
+     */
     class Base(
         override val prefixMapping: PrefixMapping,
         private val alias: AliasDefinition

binary-array-ld-netcdf/src/main/kotlin/net/bald/netcdf/NetCdfBinaryArray.kt

@@ -66,7 +66,7 @@ class NetCdfBinaryArray(
          * The resulting [NetCdfBinaryArray] should be closed after use.
          * @param fileLoc The location of the NetCDF file on the local file system.
          * @param uri The URI which identifies the dataset.
-         * @param context TODO
+         * @param context The external context in which to resolve the binary array.
          * @return A [BinaryArray] representation of the NetCDF file.
          */
         @JvmStatic

binary-array-ld-netcdf/src/main/kotlin/net/bald/netcdf/NetCdfRootContainer.kt

@@ -12,7 +12,7 @@ class NetCdfRootContainer(
     private val ba: NetCdfBinaryArray,
     group: Group,
 ): NetCdfContainer(group) {
-    override val uri: String get() = ba.uri + "/" // TODO trailing slash???
+    override val uri: String get() = ba.uri + "/"
     override val context: ModelContext get() = ba.context
     override val uriParser: UriParser get() = UriParser(ba.prefixMapping)