release.sh: document user-overriddable functions

This helps others attempting to customize the behavior of `release.sh`.

MFC after:	1 week
Differential Revision:	https://reviews.freebsd.org/D55450 (as part of a larger change)

1 files changed, 9 insertions, 0 deletions

diff --git a/release/release.sh b/release/release.sh
index 480d6b34f191..be3a0785d945 100755
--- a/release/release.sh
+++ b/release/release.sh
@@ -40,8 +40,17 @@ export PATH="/bin:/sbin:/usr/bin:/usr/sbin:/usr/local/bin"
 VERSION=3
 
 # Prototypes that can be redefined per-chroot or per-target.
+
+# load_chroot_env(): Set up the build environment needed.
+#
+# Done as part of chroot_env().
 load_chroot_env() { }
+
+# load_target_env(): set up the build environment needed for the
+# chroot_build_target() and `${chroot_build_release}` steps.
 load_target_env() { }
+
+# buildenv_setup(): set up the build environment needed for post-chroot_setup()
 buildenv_setup() { }
 
 usage() {