Index: documentation/content/en/books/porters-handbook/pkg-files/_index.adoc
===================================================================
--- documentation/content/en/books/porters-handbook/pkg-files/_index.adoc
+++ documentation/content/en/books/porters-handbook/pkg-files/_index.adoc
@@ -230,15 +230,15 @@
 `$2` can be tested to determine which mode the script is being run in.
 The `PKG_PREFIX` environmental variable will be set to the package installation directory.
 
-If you use [.filename]#pkg-pre-install# or [.filename]#pkg-post-install# instead, the script is only run once, before or after installation of the package.
-You can also use [.filename]#pkg-pre-install.lua# or [.filename]#pkg-post-install.lua# to run a lua script instead of a shell script.
-Lua scripts run by `pkg` provide some extensions and a few restrictions, for these see man:pkg-lua-script[5].
+If using [.filename]#pkg-pre-install# or [.filename]#pkg-post-install# instead, the script is only run once (before or after installing the package) and gets passed a single argument, `${PKGNAME}`.
+Using [.filename]#pkg-pre-install.lua# or [.filename]#pkg-post-install.lua# will run a lua script instead of a shell script.
+Lua scripts run by `pkg` provide some extensions and a few restrictions, both explained in man:pkg-lua-script[5].
 
-These scripts will automatically be added to the package.
+These scripts will automatically be added to the packing list.
 
 [IMPORTANT]
 ====
-These scripts are here to help you set up the package so that it is as ready to use as possible.
+These scripts are here to help set up the package so that it is as ready to use as possible.
 They _must not_ be abused to start services, stop services, or run any other commands that will modify the currently running system.
 ====
 
@@ -252,15 +252,15 @@
 `$2` can be tested to determine which mode the script is being run in.
 The `PKG_PREFIX` environmental variable will be set to the package installation directory.
 
-If you use [.filename]#pkg-pre-deinstall# or [.filename]#pkg-post-deinstall# instead, the script is only run once, before or after removal of the package.
-You can also use [.filename]#pkg-pre-deinstall.lua# or [.filename]#pkg-post-deinstall.lua# to run a lua script instead of a shell script.
-Lua scripts run by `pkg` provide some extensions and a few restrictions, for these see man:pkg-lua-script[5].
+If using [.filename]#pkg-pre-deinstall# or [.filename]#pkg-post-deinstall# instead, the script is only run once (before or after deinstalling the package) and gets passed a single argument, `${PKGNAME}`.
+Using [.filename]#pkg-pre-deinstall.lua# or [.filename]#pkg-post-deinstall.lua# will run a lua script instead of a shell script.
+Lua scripts run by `pkg` provide some extensions and a few restrictions, both explained in man:pkg-lua-script[5].
 
-These scripts will automatically be added to the package.
+These scripts will automatically be added to the packing list.
 
 [IMPORTANT]
 ====
-These scripts are here to help you set up the package so that it is as ready to use as possible.
+These scripts are here to help set up the package so that it is as ready to use as possible.
 They _must not_ be abused to start services, stop services, or run any other commands that will modify the currently running system.
 ====