Update stdlib and concat to 6.1.0 both

[mirror/dsa-puppet.git] / 3rdparty / modules / stdlib / lib / puppet / parser / functions / delete.rb

diff --git a/3rdparty/modules/stdlib/lib/puppet/parser/functions/delete.rb b/3rdparty/modules/stdlib/lib/puppet/parser/functions/delete.rb
index d3fddd8..bf614f7 100644 (file)
--- a/3rdparty/modules/stdlib/lib/puppet/parser/functions/delete.rb
+++ b/3rdparty/modules/stdlib/lib/puppet/parser/functions/delete.rb
@@ -3,38 +3,47 @@
 #
 module Puppet::Parser::Functions
   newfunction(:delete, :type => :rvalue, :doc => <<-DOC
-    Deletes all instances of a given element from an array, substring from a
-    string, or key from a hash.
+    @summary
+      Deletes all instances of a given element from an array, substring from a
+      string, or key from a hash.
 
-    *Examples:*
+    @example Example usage
 
-        delete(['a','b','c','b'], 'b')
-        Would return: ['a','c']
+      delete(['a','b','c','b'], 'b')
+      Would return: ['a','c']
 
-        delete({'a'=>1,'b'=>2,'c'=>3}, 'b')
-        Would return: {'a'=>1,'c'=>3}
+      delete({'a'=>1,'b'=>2,'c'=>3}, 'b')
+      Would return: {'a'=>1,'c'=>3}
 
-        delete({'a'=>1,'b'=>2,'c'=>3}, ['b','c'])
-        Would return: {'a'=>1}
+      delete({'a'=>1,'b'=>2,'c'=>3}, ['b','c'])
+      Would return: {'a'=>1}
 
-        delete('abracadabra', 'bra')
-        Would return: 'acada'
+      delete('abracadabra', 'bra')
+      Would return: 'acada'
 
-    Note that from Puppet 4.0.0 the minus (-) operator deletes values from arrays and keys from a hash:
+      ['a', 'b', 'c', 'b'] - 'b'
+      Would return: ['a', 'c']
 
-        ['a', 'b', 'c', 'b'] - 'b'
-        # would return ['a', 'c']
+      {'a'=>1,'b'=>2,'c'=>3} - ['b','c'])
+      Would return: {'a' => '1'}
 
-        {'a'=>1,'b'=>2,'c'=>3} - ['b','c'])
-        # would return {'a' => '1'}
+      'abracadabra'.regsubst(/bra/, '', 'G')
+      Would return: 'acada'
 
-    A global delete from a string can be performed with the regsubst() function:
+    > *Note:*
+    From Puppet 4.0.0 the minus (-) operator deletes values from arrays and keys from a hash
+    `{'a'=>1,'b'=>2,'c'=>3} - ['b','c'])`
+    >
+    A global delete from a string can be performed with the
+    [`regsubst`](https://puppet.com/docs/puppet/latest/function.html#regsubst) function:
+    `'abracadabra'.regsubst(/bra/, '', 'G')`
 
-        'abracadabra'.regsubst(/bra/, '', 'G')
-        # would return 'acada'
-
-    In general, the filter() function can filter out entries from arrays and hashes based on keys and/or values.
+    In general, the built-in [`filter`](https://puppet.com/docs/puppet/latest/function.html#filter)
+    function can filter out entries from arrays and hashes based on keys and/or values.
 
+    @return [String] The filtered String, if one was given.
+    @return [Hash] The filtered Hash, if one was given.
+    @return [Array] The filtered Array, if one was given.
   DOC
              ) do |arguments|