From 5540a693d0ee7ff7154da7b7474bfffb89d64c60 Mon Sep 17 00:00:00 2001 From: Claire Cadman Date: Mon, 3 Dec 2018 16:26:53 +0000 Subject: [PATCH 1/5] Add HTML anchor tag --- README.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/README.md b/README.md index 0023c2cc3..164cf530e 100644 --- a/README.md +++ b/README.md @@ -16,6 +16,7 @@ 1. [Contributors](#contributors) + ## Module Description This module provides a standard library of resources for Puppet modules. Puppet modules make heavy use of this standard library. The stdlib module adds the following resources to Puppet: @@ -29,12 +30,14 @@ This module provides a standard library of resources for Puppet modules. Puppet > *Note:* As of version 3.7, Puppet Enterprise no longer includes the stdlib module. If you're running Puppet Enterprise, you should install the most recent release of stdlib for compatibility with Puppet modules. + ## Setup [Install](https://puppet.com/docs/puppet/latest/modules_installing.html) the stdlib module to add the functions, facts, and resources of this standard library to Puppet. If you are authoring a module that depends on stdlib, be sure to [specify dependencies](https://puppet.com/docs/puppet/latest/modules_metadata.html#specifying-dependencies-in-modules) in your metadata.json. + ## Usage Most of stdlib's features are automatically loaded by Puppet. To use standardized run stages in Puppet, declare this class in your manifest with `include stdlib`. @@ -61,6 +64,7 @@ node default { } ``` + ## Reference * [Public classes](#public-classes) @@ -70,6 +74,7 @@ node default { * [Facts](#facts) * [Functions](#functions) + ### Classes #### Public classes @@ -80,6 +85,7 @@ The `stdlib` class has no parameters. * `stdlib::stages`: Manages a standard set of run stages for Puppet. + ### Defined types #### `file_line` @@ -269,6 +275,7 @@ Replaces all lines matched by `match` parameter, even if `line` already exists i Default value: `false`. + ### Data types #### `Stdlib::Absolutepath` @@ -655,6 +662,7 @@ Match an IPv6 address formatted in the "alternative form" allowing for represent Match an IPv6 address which may contain `::` used to compress zeros as documented in section 2.2.2 of [RFC 2373](https://www.ietf.org/rfc/rfc2373.txt). It will only match addresses without an address prefix as documented in section 2.3 of [RFC 2373](https://www.ietf.org/rfc/rfc2373.txt). + ### Facts #### `package_provider` @@ -703,6 +711,7 @@ Determines the root home directory, which depends on your operating system. Gene Returns the default provider Puppet uses to manage services on this system + ### Functions #### `abs` @@ -3107,12 +3116,14 @@ A negative value is taken to be "from the end" of the array, for example: Takes one element from first array given and merges corresponding elements from second array given. This generates a sequence of n-element arrays, where *n* is one more than the count of arguments. For example, `zip(['1','2','3'],['4','5','6'])` results in ["1", "4"], ["2", "5"], ["3", "6"]. *Type*: rvalue. + ## Limitations As of Puppet Enterprise 3.7, the stdlib module is no longer included in PE. PE users should install the most recent release of stdlib for compatibility with Puppet modules. For an extensive list of supported operating systems, see [metadata.json](https://github.com/puppetlabs/puppetlabs-stdlib/blob/master/metadata.json) + ## Development Puppet modules on the Puppet Forge are open projects, and community contributions are essential for keeping them great. We can’t access the huge number of platforms and myriad hardware, software, and deployment configurations that Puppet is intended to serve. We want to keep it as easy as possible to contribute changes so that our modules work in your environment. There are a few guidelines that we need contributors to follow so that we can have a chance of keeping on top of things. For more information, see our [module contribution guide](https://docs.puppet.com/forge/contributing.html). @@ -3120,6 +3131,7 @@ Puppet modules on the Puppet Forge are open projects, and community contribution To report or research a bug with any part of this module, please go to [http://tickets.puppetlabs.com/browse/MODULES](http://tickets.puppetlabs.com/browse/MODULES). + ## Contributors The list of contributors can be found at: [https://github.com/puppetlabs/puppetlabs-stdlib/graphs/contributors](https://github.com/puppetlabs/puppetlabs-stdlib/graphs/contributors). From 2b4c74cb3ce5fef3dff8f62cab58409f22d097ba Mon Sep 17 00:00:00 2001 From: ehom Date: Tue, 4 Dec 2018 14:13:14 -0800 Subject: [PATCH 2/5] Update README.md --- README.md | 30 +++++++++++++++++++++--------- 1 file changed, 21 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index 164cf530e..64b04b154 100644 --- a/README.md +++ b/README.md @@ -15,8 +15,8 @@ 1. [Development - Guide for contributing to the module](#development) 1. [Contributors](#contributors) + - ## Module Description This module provides a standard library of resources for Puppet modules. Puppet modules make heavy use of this standard library. The stdlib module adds the following resources to Puppet: @@ -31,6 +31,7 @@ This module provides a standard library of resources for Puppet modules. Puppet > *Note:* As of version 3.7, Puppet Enterprise no longer includes the stdlib module. If you're running Puppet Enterprise, you should install the most recent release of stdlib for compatibility with Puppet modules. + ## Setup [Install](https://puppet.com/docs/puppet/latest/modules_installing.html) the stdlib module to add the functions, facts, and resources of this standard library to Puppet. @@ -38,6 +39,7 @@ This module provides a standard library of resources for Puppet modules. Puppet If you are authoring a module that depends on stdlib, be sure to [specify dependencies](https://puppet.com/docs/puppet/latest/modules_metadata.html#specifying-dependencies-in-modules) in your metadata.json. + ## Usage Most of stdlib's features are automatically loaded by Puppet. To use standardized run stages in Puppet, declare this class in your manifest with `include stdlib`. @@ -65,6 +67,7 @@ node default { ``` + ## Reference * [Public classes](#public-classes) @@ -74,18 +77,24 @@ node default { * [Facts](#facts) * [Functions](#functions) - + + ### Classes + + #### Public classes The `stdlib` class has no parameters. + + #### Private classes * `stdlib::stages`: Manages a standard set of run stages for Puppet. - + + ### Defined types #### `file_line` @@ -203,7 +212,9 @@ Values: String specifying a valid Ruby character encoding. Default: 'UTF-8'. -##### `ensure`: Specifies whether the resource is present. +##### `ensure` + +Specifies whether the resource is present. Values: 'present', 'absent'. @@ -275,7 +286,8 @@ Replaces all lines matched by `match` parameter, even if `line` already exists i Default value: `false`. - + + ### Data types #### `Stdlib::Absolutepath` @@ -663,6 +675,7 @@ Match an IPv6 address formatted in the "alternative form" allowing for represent Match an IPv6 address which may contain `::` used to compress zeros as documented in section 2.2.2 of [RFC 2373](https://www.ietf.org/rfc/rfc2373.txt). It will only match addresses without an address prefix as documented in section 2.3 of [RFC 2373](https://www.ietf.org/rfc/rfc2373.txt). + ### Facts #### `package_provider` @@ -1083,8 +1096,7 @@ Deletes all instances of a given element from an array or hash that match a prov *Note:* This function is an implementation of a Ruby class and might not be UTF8 compatible. To ensure compatibility, use this function with Ruby 2.4.0 or greater. - -For example +For example: * `delete_regex(['a','b','c','b'], 'b')` returns ['a','c']. * `delete_regex({'a' => 1,'b' => 2,'c' => 3},['b','c'])` returns {'a'=> 1}. @@ -1908,7 +1920,7 @@ $metadata = load_module_metadata('archive') notify { $metadata['author']: } ``` -When a module's metadata file is absent, the catalog compilation fails. To avoid this failure: +When a module's metadata file is absent, the catalog compilation fails. To avoid this failure, do the following: ``` $metadata = load_module_metadata('mysql', true) @@ -3117,7 +3129,7 @@ A negative value is taken to be "from the end" of the array, for example: Takes one element from first array given and merges corresponding elements from second array given. This generates a sequence of n-element arrays, where *n* is one more than the count of arguments. For example, `zip(['1','2','3'],['4','5','6'])` results in ["1", "4"], ["2", "5"], ["3", "6"]. *Type*: rvalue. -## Limitations +## Limitations x As of Puppet Enterprise 3.7, the stdlib module is no longer included in PE. PE users should install the most recent release of stdlib for compatibility with Puppet modules. From a99e5d5ade6f357f41e733046e21c05fe2de6eb2 Mon Sep 17 00:00:00 2001 From: ehom Date: Tue, 4 Dec 2018 14:38:40 -0800 Subject: [PATCH 3/5] Update README.md --- README.md | 10 +--------- 1 file changed, 1 insertion(+), 9 deletions(-) diff --git a/README.md b/README.md index 64b04b154..8aca672eb 100644 --- a/README.md +++ b/README.md @@ -39,7 +39,6 @@ This module provides a standard library of resources for Puppet modules. Puppet If you are authoring a module that depends on stdlib, be sure to [specify dependencies](https://puppet.com/docs/puppet/latest/modules_metadata.html#specifying-dependencies-in-modules) in your metadata.json. - ## Usage Most of stdlib's features are automatically loaded by Puppet. To use standardized run stages in Puppet, declare this class in your manifest with `include stdlib`. @@ -67,7 +66,6 @@ node default { ``` - ## Reference * [Public classes](#public-classes) @@ -78,23 +76,19 @@ node default { * [Functions](#functions) - ### Classes - #### Public classes The `stdlib` class has no parameters. - #### Private classes * `stdlib::stages`: Manages a standard set of run stages for Puppet. - ### Defined types #### `file_line` @@ -287,7 +281,6 @@ Replaces all lines matched by `match` parameter, even if `line` already exists i Default value: `false`. - ### Data types #### `Stdlib::Absolutepath` @@ -675,7 +668,6 @@ Match an IPv6 address formatted in the "alternative form" allowing for represent Match an IPv6 address which may contain `::` used to compress zeros as documented in section 2.2.2 of [RFC 2373](https://www.ietf.org/rfc/rfc2373.txt). It will only match addresses without an address prefix as documented in section 2.3 of [RFC 2373](https://www.ietf.org/rfc/rfc2373.txt). - ### Facts #### `package_provider` @@ -3129,7 +3121,7 @@ A negative value is taken to be "from the end" of the array, for example: Takes one element from first array given and merges corresponding elements from second array given. This generates a sequence of n-element arrays, where *n* is one more than the count of arguments. For example, `zip(['1','2','3'],['4','5','6'])` results in ["1", "4"], ["2", "5"], ["3", "6"]. *Type*: rvalue. -## Limitations x +## Limitations As of Puppet Enterprise 3.7, the stdlib module is no longer included in PE. PE users should install the most recent release of stdlib for compatibility with Puppet modules. From 42d5cc9526c916ce4c747a7e77a75b1b48593c16 Mon Sep 17 00:00:00 2001 From: ehom Date: Tue, 4 Dec 2018 14:50:39 -0800 Subject: [PATCH 4/5] Update README.md --- README.md | 1 - 1 file changed, 1 deletion(-) diff --git a/README.md b/README.md index 8aca672eb..2d0d82b03 100644 --- a/README.md +++ b/README.md @@ -31,7 +31,6 @@ This module provides a standard library of resources for Puppet modules. Puppet > *Note:* As of version 3.7, Puppet Enterprise no longer includes the stdlib module. If you're running Puppet Enterprise, you should install the most recent release of stdlib for compatibility with Puppet modules. - ## Setup [Install](https://puppet.com/docs/puppet/latest/modules_installing.html) the stdlib module to add the functions, facts, and resources of this standard library to Puppet. From 7815dbc513402b2546c377e5d8e344d71577eea0 Mon Sep 17 00:00:00 2001 From: ehom Date: Tue, 4 Dec 2018 14:52:38 -0800 Subject: [PATCH 5/5] Update README.md --- README.md | 1 - 1 file changed, 1 deletion(-) diff --git a/README.md b/README.md index 2d0d82b03..6b507907e 100644 --- a/README.md +++ b/README.md @@ -16,7 +16,6 @@ 1. [Contributors](#contributors) - ## Module Description This module provides a standard library of resources for Puppet modules. Puppet modules make heavy use of this standard library. The stdlib module adds the following resources to Puppet: