diff --git a/R/dataframe__frame.R b/R/dataframe__frame.R
index 51115b1b6..0743cf430 100644
--- a/R/dataframe__frame.R
+++ b/R/dataframe__frame.R
@@ -2436,6 +2436,9 @@ DataFrame_clear = function(n = 0) {
   out
 }
 
+
+# TODO: we can't use % in the SQL query
+# <https://github.com/r-lib/roxygen2/issues/1616>
 #' Execute a SQL query against the DataFrame
 #'
 #' @inherit LazyFrame_sql description details params seealso
@@ -2466,7 +2469,7 @@ DataFrame_clear = function(n = 0) {
 #'   query = r"(
 #' SELECT
 #' a,
-#' (a % 2 == 0) AS a_is_even,
+#' MOD(a, 2) == 0 AS a_is_even,
 #' CONCAT_WS(':', b, b) AS b_b,
 #' EXTRACT(year FROM c) AS year,
 #' 0::float AS 'zero'
diff --git a/R/lazyframe__lazy.R b/R/lazyframe__lazy.R
index 696f2a163..7c00410fd 100644
--- a/R/lazyframe__lazy.R
+++ b/R/lazyframe__lazy.R
@@ -2079,6 +2079,8 @@ LazyFrame_clear = function(n = 0) {
 }
 
 
+# TODO: we can't use % in the SQL query
+# <https://github.com/r-lib/roxygen2/issues/1616>
 #' Execute a SQL query against the LazyFrame
 #'
 #' The calling frame is automatically registered as a table in the SQL context
@@ -2121,7 +2123,7 @@ LazyFrame_clear = function(n = 0) {
 #'   query = r"(
 #' SELECT
 #'  a,
-#' (a % 2 == 0) AS a_is_even,
+#' MOD(a, 2) == 0 AS a_is_even,
 #' (b::float / 2) AS 'b/2',
 #' CONCAT_WS(':', c, c, c) AS c_c_c
 #' FROM frame
diff --git a/man/DataFrame_sql.Rd b/man/DataFrame_sql.Rd
index f3ce694e4..8c109b627 100644
--- a/man/DataFrame_sql.Rd
+++ b/man/DataFrame_sql.Rd
@@ -60,7 +60,7 @@ df1$sql(
   query = r"(
 SELECT
 a,
-(a \% 2 == 0) AS a_is_even,
+MOD(a, 2) == 0 AS a_is_even,
 CONCAT_WS(':', b, b) AS b_b,
 EXTRACT(year FROM c) AS year,
 0::float AS 'zero'
diff --git a/man/LazyFrame_sql.Rd b/man/LazyFrame_sql.Rd
index 93e1cf1ae..b8fbce85f 100644
--- a/man/LazyFrame_sql.Rd
+++ b/man/LazyFrame_sql.Rd
@@ -57,7 +57,7 @@ lf1$sql(
   query = r"(
 SELECT
  a,
-(a \% 2 == 0) AS a_is_even,
+MOD(a, 2) == 0 AS a_is_even,
 (b::float / 2) AS 'b/2',
 CONCAT_WS(':', c, c, c) AS c_c_c
 FROM frame