doc review named range / named region

man/createName-methods.Rd

@@ -5,15 +5,15 @@
 \alias{createName,workbook-method}
 \title{Creating names in a workbook}
 \description{
-Creates a name for a specified formula in a \code{\linkS4class{workbook}}.
+Creates a named range for a specified formula in a \code{\linkS4class{workbook}}.
 }
 \usage{
 \S4method{createName}{workbook}(object, name, formula, overwrite, worksheetScope)
 }
 
 \arguments{
   \item{object}{The \code{\linkS4class{workbook}} to use}
-  \item{name}{The name's name to create}
+  \item{name}{The name of the range to be created}
   \item{formula}{Excel formula specifying the value / data the name refers to}
   \item{overwrite}{If a name with the same \code{name} already exists
     and \code{overwrite = TRUE}, then this name is removed first before
@@ -25,7 +25,7 @@ Creates a name for a specified formula in a \code{\linkS4class{workbook}}.
 }
 
 \details{
-Creates a name named \code{name} for the specified \code{formula}. 
+Creates a named range called \code{name} for the specified \code{formula}. 
 
 The \code{formula} should be specified as you would type it
 in Excel. Make sure that the worksheets, functions, ...

man/existsName-methods.Rd

@@ -3,9 +3,9 @@
 \alias{existsName}
 \alias{existsName-methods}
 \alias{existsName,workbook-method}
-\title{Checking existence of names in a workbook}
+\title{Checking existence of named ranges in a workbook}
 \description{
-Checks the existence of a name in a \code{\linkS4class{workbook}}.
+Checks the existence of a named range in a \code{\linkS4class{workbook}}.
 }
 
 \usage{

man/getReferenceCoordinates-methods.Rd

@@ -5,7 +5,7 @@
 \alias{getReferenceCoordinates,workbook-method}
 \title{Querying the coordinates of the range reference by an Excel name}
 \description{
-(DEPRECATED) Queries the coordinates of an Excel name in a \code{\linkS4class{workbook}}.
+(DEPRECATED) Queries the coordinates of an Excel named range in a \code{\linkS4class{workbook}}.
 }
 \usage{
 \S4method{getReferenceCoordinates}{workbook}(object,name)

man/getReferenceCoordinatesForName-methods.Rd

@@ -5,7 +5,7 @@
 \alias{getReferenceCoordinatesForName,workbook-method}
 \title{Querying the coordinates of the range reference by an Excel name}
 \description{
-Queries the coordinates of an Excel name in a \code{\linkS4class{workbook}}.
+Queries the coordinates of an Excel named range in a \code{\linkS4class{workbook}}.
 }
 \usage{
 \S4method{getReferenceCoordinatesForName}{workbook}(object,name, worksheetScope)
@@ -18,8 +18,8 @@ Queries the coordinates of an Excel name in a \code{\linkS4class{workbook}}.
   \item{worksheetScope}{Optional, the name of the worksheet to use for resolving the named region}
 }
 \details{
-  If \code{worksheetScope} is defined, only coordinates for a name scoped strictly to the specified worksheet are 
-  returned. To explicitly match only if the name is in the global scope, pass \code{""} as the value.
+  If \code{worksheetScope} is defined, only coordinates for a range scoped strictly to the specified worksheet are 
+  returned. To explicitly only query for named ranges in the global scope, pass \code{""} as the value.
 }
 
 \author{

man/readNamedRegion-methods.Rd

@@ -84,7 +84,7 @@ readStrategy, worksheetScope)
 }
 
 \details{
-The arguments \code{name} and \code{header} are vectorized. As such,
+The arguments \code{name}, \code{header}, and \code{worksheetScope} are vectorized. As such,
 multiple named regions can be read with one method call. If only one
 single named region is read, the return value is a \code{data.frame}.If
 multiple named regions are specified, the return value is a (named)

man/removeName-methods.Rd

@@ -5,7 +5,7 @@
 \alias{removeName,workbook-method}
 \title{Removing names from workbooks}
 \description{
-Removes a name from a \code{\linkS4class{workbook}}.
+Removes a named range reference from a \code{\linkS4class{workbook}}.
 }
 \usage{
 \S4method{removeName}{workbook}(object,name,worksheetScope)
@@ -15,12 +15,12 @@ Removes a name from a \code{\linkS4class{workbook}}.
   \item{object}{The \code{\linkS4class{workbook}} to use}
   \item{name}{The name to delete}
   \item{worksheetScope}{Optional - the name of the worksheet in which the name is scoped;
-  useful if different sheets have scoped regions with the same name.}
+  useful if different sheets have locally-scoped named ranges with the same name.}
 }
 
 \details{
-Removes the name named \code{name} from the specified workbook
-\code{object} if it does exist. Multiple names can be specified to be removed.
+Removes the named range reference \code{name} from the specified workbook \code{object} if it does exist.
+Data in the referenced cells remains unchanged. Multiple names can be specified to be removed.
 Use \code{worksheetScope = ""} to only target names defined in the global scope.
 }
 \author{

man/writeNamedRegion-methods.Rd

@@ -6,7 +6,7 @@
 \alias{writeNamedRegion,workbook,ANY-method}
 \title{Writing named regions to a workbook}
 \description{
-Writes named regions to a \code{\linkS4class{workbook}}.
+Writes data to the named regions defined in a \code{\linkS4class{workbook}}.
 }
 \usage{
 \S4method{writeNamedRegion}{workbook,ANY}(object, data, name, header, 
@@ -26,7 +26,7 @@ Writes named regions to a \code{\linkS4class{workbook}}.
   no row names will be included. May also be a \code{list} in case multiple data objects are
   written in one call (see below).}
   \item{worksheetScope}{Optional character vector with worksheet name(s) to limit the scope in 
-  which the \code{name} is defined. By default the name is defined workbook-global.}  
+  which the \code{name}(s) to write to is/are expected to be found}.
 }
 
 \details{