Make internal status of three helper functions more explicit (#709)

* Make internal status of three helper functions more explicit

* Roll micro version, update NEWS [ci skip]

DESCRIPTION

@@ -1,6 +1,6 @@
 Package: tiledb
 Type: Package
-Version: 0.27.0
+Version: 0.27.0.1
 Title: Modern Database Engine for Complex Data Based on Multi-Dimensional Arrays
 Authors@R: c(person("TileDB, Inc.", role = c("aut", "cph")),
   person("Dirk", "Eddelbuettel", email = "[email protected]", role = "cre"))

NEWS.md

@@ -1,3 +1,12 @@
+# Ongoing development
+
+* This release of the R package builds against [TileDB 2.23.0](https://github.com/TileDB-Inc/TileDB/releases/tag/2.23.0), and has also been tested against earlier releases as well as the development version (#701, #704)
+
+## Improvements
+
+* Three internal and unexported helper functions now document more clearly how they can be called explicitly. (#709)
+
+
 # tiledb 0.27.0
 
 * This release of the R package builds against [TileDB 2.23.0](https://github.com/TileDB-Inc/TileDB/releases/tag/2.23.0), and has also been tested against earlier releases as well as the development version (#701, #704)

R/ArraySchema.R

@@ -530,7 +530,8 @@ tiledb_schema_get_types <- function(sch) {
 
 ##' Get Dimension or Attribute Status
 ##'
-##' Note that this function is an unexported internal function.
+##' Note that this function is an unexported internal function that can be called
+##' using the colons as in \code{tiledb:::tiledb_schema_get_dim_attr_status(sch)}.
 ##'
 ##' @param sch A TileDB Schema object
 ##' @return An integer vector where each element corresponds to a schema entry,
@@ -545,7 +546,8 @@ tiledb_schema_get_dim_attr_status <- function(sch) {
 
 ##' Get Dimension or Attribute Status
 ##'
-##' Note that this function is an unexported internal function.
+##' Note that this function is an unexported internal function that can be called
+##' using the colons as in \code{tiledb:::tiledb_schema_get_enumeration_status(sch)}.
 ##'
 ##' @param sch A TileDB Schema object
 ##' @return An integer vector where each element corresponds to a schema entry,
@@ -863,6 +865,9 @@ tiledb_schema_object <- function(array) {
 
 #' Describe a TileDB array schema via code to create it
 #'
+#' Note that this function is an unexported internal function that can be called
+#' using the colons as in \code{tiledb:::describe(arr)}.
+#'
 #' @param arr A TileDB Array object
 #' @return Nothing is returned as the function is invoked for the side effect
 #' of printing the schema via a sequence of R instructions to re-create it.