[docs] Add documentation for `RUNTIME_PATH`.
@@ -40,14 +40,17 @@ Additional switches to be passed to the compiler when this package is used as a
A file containing package information, such as checksum, maintainer, build variables, and other metadata specified in plan.sh as well as the contents of the plan.sh itself.
## PATH
-An absolute path to the `bin` folder for the package. A fully-qualified package identifier is used, so version and release information is included in the path.
+A file that contains all directories in the package which contain program binaries. The directories are seperated with the target platform's path seperator character (i.e. either `:` or `;`).
## RUNTIME_ENVIRONMENT
-A file containing the result of the layering operation of the current package's runtime environment variables on top of those of its dependencies. This is what the build process consults when it processes dependencies, and this is what the Supervisor consults when generating the runtime environment for a supervised process.
+A file containing the result of the layering operation of the current package's runtime environment variables on top of those of its dependencies. This is what the build process consults when it processes dependencies, and this is what the Supervisor consults in concert with `RUNTIME_PATH` when generating the full set of environment variables that should be added to an environment before running a supervised process.
## RUNTIME_ENVIRONMENT_PROVENANCE
A file that provides information on which specific dependencies have influenced the final value of a given variable in the RUNTIME_ENVIRONMENT file. This file is not currently consumed by any other software in the Habitat ecosystem, but can be used for troubleshooting and informative purposes.
+## RUNTIME_PATH
+A file that contains all directories that need to be prepended to an environment's `$PATH` before a program in this package can be expected to run correctly. The order of the elements are precise and meaningful so should not be altered. This file is used in concert with `RUNTIME_ENVIRONMENT` to compute the full set of environment variables that should be added to an environment before running a program in this package.
+
## TARGET
The CPU architecture and platform for the package. The format is `architecture-platform`. For example, x86_64-linux.
