get_targets.rb in bolt-1.28.0

- old
+ new

@@ -1,9 +1,13 @@
 # frozen_string_literal: true
 
 require 'bolt/error'
 
 # Parses common ways of referring to targets and returns an array of Targets.
+#
+# **NOTE:** Calling `get_targets` inside an `apply` block with a
+# version 2 inventory creates a new Target object.
+# `get_targets('all')` returns an empty array.
 Puppet::Functions.create_function(:get_targets) do
   # @param names A pattern or array of patterns identifying a set of targets.
   # @return A list of unique Targets resolved from any target URIs and groups.
   # @example Resolve a group
   #   get_targets('group1')