Improve documentation.

Author: danielecook

R/cache_aws_s3.r

@@ -1,11 +1,13 @@
 #' @name cache_aws_s3
-#' @title Initiate an Amazon Web Services Cache
+#' @title Amazon Web Services S3 Cache
+#' @description
+#' Initiate an Amazon Web Services Cache
 #' @usage
 #'
 #' Sys.setenv("AWS_ACCESS_KEY_ID" = "<access key>",
 #'            "AWS_SECRET_ACCESS_KEY" = "<access secret>")
 #'
-#' cache_aws_s3("unique-bucket-name")
+#' cache_aws_s3(cache_name = "unique-bucket-name")
 #'
 #' @param cache_name Bucket name for storing cache files.
 #' Use R to cache items.

R/cache_datastore.r

@@ -1,5 +1,6 @@
 #' @name cache_datastore
-#' @title Initiate a datastore cache.
+#' @title Google Datastore Cache
+#' @description Initiate a Google Datastore cache.
 #' @param project Google Cloud project
 #' @param cache_name datastore kind to use for storing cache entities.
 #' @usage

R/cache_filesystem.r

@@ -1,5 +1,7 @@
 #' @name cache_filesystem
-#' @title Initiate a filesystem cache.
+#' @title Filesystem Cache
+#' @description
+#' Initiate a filesystem cache.
 #' @usage
 #' cache_filesystem stores cached items within a directory. It can be used with
 #' Dropbox or Google Drive to allow for cache access from multiple computers.

R/cache_local.r

@@ -1,5 +1,6 @@
 #' @name cache_local
-#' @title Initiate an in memory cache.
+#' @title In Memory Cache
+#' @description Initiate an in memory cache.
 #'
 #' cache_local() stores cached items in memory.
 #'