From 695f5dc28f7a5dfa0678cb48b0955fa5058dab97 Mon Sep 17 00:00:00 2001
From: Teun van den Brand <tahvdbrand@gmail.com>
Date: Tue, 17 Dec 2024 09:17:21 +0100
Subject: [PATCH] tweak docs

---
 R/limits.R  | 4 +++-
 man/lims.Rd | 4 +++-
 2 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/R/limits.R b/R/limits.R
index bca92392a9..57f2465018 100644
--- a/R/limits.R
+++ b/R/limits.R
@@ -4,7 +4,9 @@
 #' scales. By default, any values outside the limits specified are replaced with
 #' `NA`. Be warned that this will remove data outside the limits and this can
 #' produce unintended results. For changing x or y axis limits \strong{without}
-#' dropping data observations, see [coord_cartesian()].
+#' dropping data observations, see
+#' [`coord_cartesian(xlim, ylim)`][coord_cartesian], or use a full scale with
+#' [`oob = scales::oob_keep`][scales::oob_keep].
 #'
 #' @param ... For `xlim()` and `ylim()`: Two numeric values, specifying the left/lower
 #'  limit and the right/upper limit of the scale. If the larger value is given first,
diff --git a/man/lims.Rd b/man/lims.Rd
index b6d6559f65..c0a137058e 100644
--- a/man/lims.Rd
+++ b/man/lims.Rd
@@ -31,7 +31,9 @@ This is a shortcut for supplying the \code{limits} argument to the individual
 scales. By default, any values outside the limits specified are replaced with
 \code{NA}. Be warned that this will remove data outside the limits and this can
 produce unintended results. For changing x or y axis limits \strong{without}
-dropping data observations, see \code{\link[=coord_cartesian]{coord_cartesian()}}.
+dropping data observations, see
+\code{\link[=coord_cartesian]{coord_cartesian(xlim, ylim)}}, or use a full scale with
+\code{\link[scales:oob]{oob = scales::oob_keep}}.
 }
 \examples{
 # Zoom into a specified area