Update NEWS and docstrings

NEWS.md

@@ -7,13 +7,16 @@
 * Ignore `.env`, `.venv`, and `venv` files only when they reference Python
   virtual environments. (#972)
 
-* Add `envManagement`, `envManagementR` and `envManagementPy` args when writing
-  the `manifest.json`. These args whether Connect should install packages in the
-  package cache. If `envManagement` is `FALSE` then Connect will not perform any
-  package installation and it is the administrators responsibility to ensure the
-  required R/Python packages are available in the runtime environment.
-  This is especially useful if off-host execution is enabled, when the execution
-  environment (specified by `--image`) already contains the required packages. 
+* `deployApp()` and `writeManifest()` accept optional `envManagement`,
+  `envManagementR`, and `envManagementPy` arguments. These args specify whether
+  Posit Connect should install packages in the package cache.
+  If `envManagement` is `FALSE` then Connect will not perform any package
+  installation and it is the administrator's responsibility to ensure the
+  required R/Python packages are available in the runtime environment. This is
+  especially useful if off-host execution is enabled, when the execution
+  environment (specified by the `image` argument) already contains the required
+  packages. These values are ignored when
+  `Applications.ManifestEnvironmentManagementSelection = false`.
   Requires Posit Connect `>=2023.07.0`. (#977)
 
 # rsconnect 1.0.2

R/deployApp.R

@@ -142,11 +142,12 @@
 #' @param image Optional. The name of the image to use when building and
 #'   executing this content. If none is provided, Posit Connect will
 #'   attempt to choose an image based on the content requirements.
-#' @param envManagement Optional. Should Connect install R and Python packages
-#'   for this content? (`TRUE`, `FALSE`, or `NULL`). The default, `NULL`, will
-#'   not write any values to the bundle manifest, and Connect will fall back to
-#'   the application default environment management strategy, or the server
-#'   default if no application default is defined.
+#' @param envManagement Optional. Should Posit Connect install R and Python
+#'   packages for this content? (`TRUE`, `FALSE`, or `NULL`).
+#'   The default, `NULL`, will not write any values to the bundle manifest,
+#'   and Connect will fall back to the application default environment
+#'   management strategy, or the server default if no application default
+#'   is defined.
 #'
 #'   (This option is a shorthand flag which overwrites the values of both
 #'   `envManagementR` and `envManagementPy`.)
@@ -155,11 +156,15 @@
 #'   not write any values to the bundle manifest, and Connect will fall back to
 #'   the application default R environment management strategy, or the server
 #'   default if no application default is defined.
+#'
+#'   (This option is ignored when `envManagement` is non-`NULL`.)
 #' @param envManagementPy Optional. Should Connect install Python packages
 #'   for this content? (`TRUE`, `FALSE`, or `NULL`). The default, `NULL`, will
 #'   not write any values to the bundle manifest, and Connect will fall back to
 #'   the application default Python environment management strategy, or the server
 #'   default if no application default is defined.
+#'
+#'   (This option is ignored when `envManagement` is non-`NULL`.)
 #' @examples
 #' \dontrun{
 #'