(PDOC-37) Refactor and add additional tests

All according to Henrik's comments on the GitHub PR.

spec/unit/puppet_x/puppetlabs/strings/yard/puppet_4x_function_handler_spec.rb

@@ -72,8 +72,7 @@ def max(num_a, num_b)
       }.to output("#{expected_output_not_a_param}\n#{expected_output_also_not_a_param}\n").to_stdout_from_any_process
   end
 
-
-  it "should not issue a warning if the parameter names do  match the docstring" do
+  it "should not issue a warning when the parameter names match the docstring" do
       expect {
         parse <<-RUBY
           # @param num_a [Integer] the first number to be compared
@@ -87,10 +86,38 @@ def max(num_a, num_b)
       }.to output("").to_stdout_from_any_process
   end
 
+  it "should not issue a warning when there are parametarized types and parameter names are the same" do
+      expect {
+        parse <<-RUBY
+          # @param num_a Integer[1,2] the first number to be compared
+          # @param num_b Integer[1,2] the second number to be compared
+          Puppet::Functions.create_function(:max) do
+            def max(num_a, num_b)
+              num_a >= num_b ? num_a : num_b
+            end
+          end
+        RUBY
+      }.to output("").to_stdout_from_any_process
+  end
+
+  it "should issue a warning when there are parametarized types and parameter names differ" do
+      expected_output_not_num_a = "[warn]: @param tag has unknown parameter" +
+        " name: not_num_a \n    in file `(stdin)' near line 3"
+      expect {
+        parse <<-RUBY
+          # @param not_num_a Integer[1,2] the first number to be compared
+          # @param num_b Integer[1,2] the second number to be compared
+          Puppet::Functions.create_function(:max) do
+            def max(num_a, num_b)
+              num_a >= num_b ? num_a : num_b
+            end
+          end
+        RUBY
+      }.to output("#{expected_output_not_num_a}\n").to_stdout_from_any_process
+  end
 
 
-  it "should issue a warning if the parameter names do not match the " +
-        "docstring in dispatch method" do
+  it "should issue a warning if the parameter names do not match the docstring in dispatch method" do
       expected_output_not_a_param = "[warn]: @param tag has unknown parameter" +
         " name: not_a_param \n    in file `(stdin)' near line 3"
       expected_output_also_not_a_param = "[warn]: @param tag has unknown " +