[scripts-audit] vcpkg_add_to_path (#16189)

* [scripts-audit] vcpkg_add_to_path

* regenerate docs

1 files changed, 9 insertions, 9 deletions

diff --git a/docs/maintainers/vcpkg_add_to_path.md b/docs/maintainers/vcpkg_add_to_path.md
index af1727821..243757638 100644
--- a/docs/maintainers/vcpkg_add_to_path.md
+++ b/docs/maintainers/vcpkg_add_to_path.md
@@ -1,20 +1,20 @@
 # vcpkg_add_to_path
 
-Add a directory to the PATH environment variable
+Add a directory or directories to the PATH environment variable
 
-## Usage
 ```cmake
-vcpkg_add_to_path([PREPEND] <${PYTHON3_DIR}>)
+vcpkg_add_to_path([PREPEND] [<path>...])
 ```
 
-## Parameters
-### <positional>
-The directory to add
+`vcpkg_add_to_path` adds all of the paths passed to it to the PATH environment variable.
+If PREPEND is passed, then those paths are prepended to the PATH environment variable,
+so that they are searched first; otherwise, those paths are appended, so they are
+searched after the paths which are already in the environment variable.
 
-### PREPEND
-Prepends the directory.
+The paths are added in the order received, so that the first path is always searched
+before a later path.
 
-The default is to append.
+If no paths are passed, then nothing will be done.
 
 ## Examples:
 * [curl](https://github.com/Microsoft/vcpkg/blob/master/ports/curl/portfile.cmake#L75)