comment on use of init() for plugin handlers

client/logmon/z_logmon_cmd.go

@@ -8,6 +8,11 @@ import (
 	"github.com/hashicorp/nomad/plugins/base"
 )
 
+// Install a plugin cli handler to ease working with tests
+// and external plugins.
+// This init() must be initialized last in package required by the child plugin
+// process. It's recommended to avoid any other `init()` or inline any necessary calls
+// here. See eeaa95d commit message for more details.
 func init() {
 	if len(os.Args) > 1 && os.Args[1] == "logmon" {
 		logger := hclog.New(&hclog.LoggerOptions{

drivers/docker/docklog/z_docker_logger_cmd.go

@@ -8,6 +8,11 @@ import (
 	"github.com/hashicorp/nomad/plugins/base"
 )
 
+// Install a plugin cli handler to ease working with tests
+// and external plugins.
+// This init() must be initialized last in package required by the child plugin
+// process. It's recommended to avoid any other `init()` or inline any necessary calls
+// here. See eeaa95d commit message for more details.
 func init() {
 	if len(os.Args) > 1 && os.Args[1] == PluginName {
 		logger := log.New(&log.LoggerOptions{

drivers/shared/executor/z_executor_cmd.go

@@ -11,6 +11,11 @@ import (
 	"github.com/hashicorp/nomad/plugins/base"
 )
 
+// Install a plugin cli handler to ease working with tests
+// and external plugins.
+// This init() must be initialized last in package required by the child plugin
+// process. It's recommended to avoid any other `init()` or inline any necessary calls
+// here. See eeaa95d commit message for more details.
 func init() {
 	if len(os.Args) > 1 && os.Args[1] == "executor" {
 		if len(os.Args) != 3 {