for #1932

rhijmans · rhijmans · commit 3ad07907143e · 2025-10-20T17:32:49.000-07:00
diff --git a/man/sample.Rd b/man/sample.Rd
@@ -14,7 +14,7 @@ Take a spatial sample from a SpatRaster, SpatVector or SpatExtent. Sampling a Sp
 
 With a SpatRaster, you can get cell values, cell numbers (\code{cells=TRUE}), coordinates (\code{xy=TRUE}) or (when \code{method="regular"} and \code{as.raster=TRUE}) get a new SpatRaster with the same extent, but fewer cells. 
 
-In order to assure regularity when requesting a regular sample, the number of cells or points returned may not be exactly the same as the \code{size} requested unless you use \code{exact=TRUE}.
+In order to assure regularity when requesting a regular sample, the number of cells or points returned may not be exactly the same as the \code{size} requested unless you use \code{exact=TRUE} (and do not use \code{na.rm=TRUE}). Alternatively, use \code{method="spread"} to get an approximately regular sample for the cells that are not \code{NA}.
 }
 
 \usage{

Original file line number	Diff line number	Diff line change
`@@ -14,7 +14,7 @@ Take a spatial sample from a SpatRaster, SpatVector or SpatExtent. Sampling a Sp`
`14`	`14`
`15`	`15`	`With a SpatRaster, you can get cell values, cell numbers (\code{cells=TRUE}), coordinates (\code{xy=TRUE}) or (when \code{method="regular"} and \code{as.raster=TRUE}) get a new SpatRaster with the same extent, but fewer cells.`
`16`	`16`
`17`		`-In order to assure regularity when requesting a regular sample, the number of cells or points returned may not be exactly the same as the \code{size} requested unless you use \code{exact=TRUE}.`
	`17`	`+In order to assure regularity when requesting a regular sample, the number of cells or points returned may not be exactly the same as the \code{size} requested unless you use \code{exact=TRUE} (and do not use \code{na.rm=TRUE}). Alternatively, use \code{method="spread"} to get an approximately regular sample for the cells that are not \code{NA}.`
`18`	`18`	`}`
`19`	`19`
`20`	`20`	`\usage{`