Fix doc and tweak formatting (#1543)

Author: salim-b

R/remote.R

@@ -7,16 +7,16 @@
 #' the query plan (as computed by the remote database). `remote_src()` and
 #' `remote_con()` give the dplyr source and DBI connection respectively.
 #'
-#' @param x Remote table, currently must be a [tbl_sql].
+#' @param x Remote table, currently must be a [`tbl_sql`].
 #' @param null_if_local Return `NULL` if the remote table is created via
-#'   `tbl_lazy()` or `lazy_frame()`?
+#'   [tbl_lazy()] or [lazy_frame()]?
 #' @param cte `r lifecycle::badge("deprecated")`
-#'   Use the `render_otions` argument instead.
+#'   Use the `sql_options` argument instead.
 #' @param sql_options `r lifecycle::badge("experimental")`
-#'   SQL rendering options generated by `sql_options()`.
+#'   SQL rendering options generated by [sql_options()].
 #' @param ... Additional arguments passed on to methods.
-#' @return The value, or `NULL` if not remote table, or not applicable.
-#'    For example, computed queries do not have a "name"
+#' @return A string, or `NULL` if not a remote table, or not applicable.
+#'    For example, computed queries do not have a "name".
 #' @export
 #' @examples
 #' mf <- memdb_frame(x = 1:5, y = 5:1, .name = "blorp")