Added documentation for print classes

[arvados.git] / sdk / R / R / ArvadosFile.R

diff --git a/sdk/R/R/ArvadosFile.R b/sdk/R/R/ArvadosFile.R
index 53321efbaf786798c3aaa346f9c67905cc4e6b76..e28ba9606cfebd95a89a436b7ac9953c98d63fb8 100644 (file)
--- a/sdk/R/R/ArvadosFile.R
+++ b/sdk/R/R/ArvadosFile.R
@@ -14,12 +14,12 @@ source("./R/util.R")
 #' 
 #' @section Methods:
 #' \describe{
-#'   \item{getName()}{Returns name of the file}
+#'   \item{getName()}{Returns name of the file.}
 #'   \item{getRelativePath()}{Returns file path relative to the root.}
 #'   \item{read(contentType = "raw", offset = 0, length = 0)}{Read file content.}
 #'   \item{write(content, contentType = "text/html")}{Write to file (override current content of the file).}
 #'   \item{connection(rw)}{Get connection opened in "read" or "write" mode.}
-#'   \item{flush()}{Write content of the connecitons buffer to a file (override current content of the file).}
+#'   \item{flush()}{Write connections content to a file (override current content of the file).}
 #'   \item{remove(name)}{Removes ArvadosFile or Subcollection specified by name from the subcollection.}
 #'   \item{getSizeInBytes()}{Returns file size in bytes.}
 #'   \item{move(newLocation)}{Moves file to a new location inside collection.}
@@ -33,8 +33,7 @@ source("./R/util.R")
 #' myFile$write("This is new file content")
 #' fileContent <- myFile$read()
 #' fileContent <- myFile$read("text")
-#' fileContent <- myFile$read("raw", offset = 1024, length = 512)
-#'
+#' fileContent <- myFile$read("raw", offset = 8, length = 4) 
 #'
 #' #Write a table:
 #' arvConnection <- myFile$connection("w")
@@ -246,20 +245,26 @@ ArvadosFile <- R6::R6Class(
     cloneable = FALSE
 )
 
-#' @export print.ArvadosFile
-print.ArvadosFile = function(arvadosFile)
+#' print.ArvadosFile
+#'
+#' Custom print function for ArvadosFile class
+#'
+#' @param x Instance of ArvadosFile class
+#' @param ... Optional arguments.
+#' @export 
+print.ArvadosFile = function(x, ...)
 {
     collection   <- NULL
-    relativePath <- arvadosFile$getRelativePath()
+    relativePath <- x$getRelativePath()
 
-    if(!is.null(arvadosFile$getCollection()))
+    if(!is.null(x$getCollection()))
     {
-        collection <- arvadosFile$getCollection()$uuid
+        collection <- x$getCollection()$uuid
         relativePath <- paste0("/", relativePath)
     }
 
     cat(paste0("Type:          ", "\"", "ArvadosFile",         "\""), sep = "\n")
-    cat(paste0("Name:          ", "\"", arvadosFile$getName(), "\""), sep = "\n")
+    cat(paste0("Name:          ", "\"", x$getName(),           "\""), sep = "\n")
     cat(paste0("Relative path: ", "\"", relativePath,          "\""), sep = "\n")
     cat(paste0("Collection:    ", "\"", collection,            "\""), sep = "\n")
 }