update roxygen2 and document, fixing some roxygen2 complaints

Author: Aariq

DESCRIPTION

@@ -12,12 +12,12 @@ Description: Work with 'GitHub' 'gists' from 'R' (e.g.,
     <https://gist.github.com/>.
 Version: 0.9.0.93
 Authors@R: c(
-    person("Scott", "Chamberlain", role = c("aut", "cre"), 
-        email = "[email protected]", 
-        comment = c(ORCID="0000-0003-1444-9135")),
+    person("Scott", "Chamberlain", , "[email protected]", role = c("aut", "cre"),
+           comment = c(ORCID = "0000-0003-1444-9135")),
     person("Ramnath", "Vaidyanathan", role = "aut"),
     person("Karthik", "Ram", role = "aut"),
-    person("Milgram", "Eric", role = "aut")
+    person("Milgram", "Eric", role = "aut"),
+    person("Eric R.", "Scott", role = "ctb")
   )
 License: MIT + file LICENSE
 URL: https://github.com/ropensci/gistr (devel),
@@ -40,7 +40,7 @@ Imports:
 Suggests:
     git2r,
     testthat
-RoxygenNote: 7.1.1
+RoxygenNote: 7.3.2
 X-schema.org-applicationCategory: Web
 X-schema.org-keywords: http, https, API, web-services, GitHub, GitHub API, gist, gists, code, script, snippet
 X-schema.org-isPartOf: https://ropensci.org

R/gist_auth.R

@@ -5,15 +5,15 @@
 #'
 #' There are two ways to authorise gistr to work with your GitHub account:
 #'
-#' - Generate a personal access token with the gist scope selected, and set it
-#' as the `GITHUB_PAT` environment variable per session using `Sys.setenv`
-#' or across sessions by adding it to your `.Renviron` file or similar.
-#' See
+#' - Generate a personal access token with the gist scope selected, and store it
+#' with `gitcreds::gitcreds_set()`. Alternatively you can set it as the
+#' `GITHUB_PAT` environment variable per session using `Sys.setenv()` or across
+#' sessions by adding it to your `.Renviron` file or similar. See
 #' https://help.github.com/articles/creating-an-access-token-for-command-line-use
-#' for help
-#' - Interactively login into your GitHub account and authorise with OAuth.
+#' for help or use `usethis::create_github_token()`.
+#' - Interactively log in into your GitHub account and authorise with OAuth.
 #'
-#' Using `GITHUB_PAT` is recommended.
+#' Using `gitcreds::gitcreds_set()` is recommended.
 #'
 #' @export
 #' @param app An [httr::oauth_app()] for GitHub. The default uses an

R/gistr-package.R

@@ -22,13 +22,12 @@
 #' @importFrom jsonlite fromJSON flatten
 #' @name gistr-package
 #' @aliases gistr
-#' @docType package
 #' @title R client for GitHub gists
 #' @author Scott Chamberlain \email{myrmecocystus@@gmail.com}
 #' @author Ramnath Vaidyanathan \email{ramnath.vaidya@@gmail.com}
 #' @author Karthik Ram \email{karthik.ram@@gmail.com}
 #' @keywords package
-NULL
+"_PACKAGE"
 
 #' @title Create gists
 #'
@@ -43,7 +42,7 @@ NULL
 #' - [gist_create_git()] - Create gists from files or code
 #'  blocks, using  git. Because this function uses git, you have more
 #'  flexibility than with the above function: you can include any binary files,
-#'  and can easily upload all artifacts. 
+#'  and can easily upload all artifacts.
 #' - [gist_create_obj()] - Create gists from R objects: data.frame, list,
 #'  character string, matrix, or numeric. Uses the GitHub HTTP API.
 #'