From 5762b07a5447684ab75b4cf0d2ed989d37b25459 Mon Sep 17 00:00:00 2001 From: Gabriel Nagy Date: Thu, 30 Sep 2021 19:34:09 +0300 Subject: (MODULES-8183) Fix ToC truncation in REFERENCE.md Puppet Strings prefers a `@summary` tag with a max of 140 characters to fill in the Table of Contents summary. Without this, the description will appear truncated. Add `@summary` and `@example` tags to the type documentation. --- lib/puppet/type/augeas.rb | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-) (limited to 'lib') diff --git a/lib/puppet/type/augeas.rb b/lib/puppet/type/augeas.rb index 2303fdc..ef93bce 100644 --- a/lib/puppet/type/augeas.rb +++ b/lib/puppet/type/augeas.rb @@ -23,25 +23,24 @@ Puppet::Type.newtype(:augeas) do feature :execute_changes, 'Actually make the changes' @doc = <<-'EOT' - Apply a change or an array of changes to the filesystem - using the augeas tool. + @summary Apply a change or an array of changes to the filesystem using the augeas tool. Requires: - [Augeas](http://www.augeas.net) - The ruby-augeas bindings - Sample usage with a string: + @example Sample usage with a string: - augeas{"test1" : + augeas { "test1": context => "/files/etc/sysconfig/firstboot", changes => "set RUN_FIRSTBOOT YES", onlyif => "match other_value size > 0", } - Sample usage with an array and custom lenses: + @example Sample usage with an array and custom lenses: - augeas{"jboss_conf": + augeas { "jboss_conf": context => "/files", changes => [ "set etc/jbossas/jbossas.conf/JBOSS_IP $ipaddress", -- cgit v1.2.3