tidyverse · Hzanib · Sep 19, 2025
diff --git a/R/drive_upload.R b/R/drive_upload.R
@@ -60,7 +60,7 @@
 #' # Clean up
 #' drive_rm(chicken)
 #'
-#' # `overwrite = FALSE` errors if something already exists at target filepath
+#' # `overwrite = FALSE` errors if something already exists at target filepath.
 #' # THIS WILL ERROR!
 #' drive_create("name-squatter-upload")
 #' drive_example_local("chicken.jpg") |>
@@ -70,6 +70,7 @@
 #'   )
 #'
 #' # `overwrite = TRUE` moves the existing item to trash, then proceeds
+#' #Use `drive_update()` or `drive_put()` if you want to permissions and file is from an already existing file.
 #' chicken <- drive_example_local("chicken.jpg") |>
 #'   drive_upload(
 #'     name = "name-squatter-upload",

diff --git a/man-roxygen/overwrite.R b/man-roxygen/overwrite.R
@@ -9,7 +9,8 @@
 #'     zero or one, move a pre-existing file to the trash, then carry on. Note
 #'     that the new file does not inherit any properties from the old one, such
 #'     as sharing or publishing settings. It will have a new file ID. An error is
-#'     thrown if two or more pre-existing files are found.
+#'     thrown if two or more pre-existing files are found. Use `drive_update()` or
+#'     `drive_put()` if you want to keep permissions and sharing from an already existing file.
 #'   * `FALSE`: Error if there is any pre-existing file at the filepath.
 #'
 #' Note that existence checks, based on filepath, are expensive operations, i.e.

diff --git a/man/drive_cp.Rd b/man/drive_cp.Rd
diff --git a/man/drive_create.Rd b/man/drive_create.Rd
diff --git a/man/drive_mkdir.Rd b/man/drive_mkdir.Rd
diff --git a/man/drive_mv.Rd b/man/drive_mv.Rd
diff --git a/man/drive_rename.Rd b/man/drive_rename.Rd
diff --git a/man/drive_upload.Rd b/man/drive_upload.Rd
diff --git a/man/shortcut_create.Rd b/man/shortcut_create.Rd