diff --git a/lib/puppet/type/augeas.rb b/lib/puppet/type/augeas.rb
index 930235f0c..47cb58f17 100644
--- a/lib/puppet/type/augeas.rb
+++ b/lib/puppet/type/augeas.rb
@@ -1,188 +1,189 @@
 #
 #   Copyright 2011 Bryan Kearney <bkearney@redhat.com>
 #
 #   Licensed under the Apache License, Version 2.0 (the "License");
 #   you may not use this file except in compliance with the License.
 #   You may obtain a copy of the License at
 #
 #       http://www.apache.org/licenses/LICENSE-2.0
 #
 #   Unless required by applicable law or agreed to in writing, software
 #   distributed under the License is distributed on an "AS IS" BASIS,
 #   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 #   See the License for the specific language governing permissions and
 #   limitations under the License.
 
 Puppet::Type.newtype(:augeas) do
   include Puppet::Util
 
   feature :parse_commands, "Parse the command string"
   feature :need_to_run?, "If the command should run"
   feature :execute_changes, "Actually make the changes"
 
   @doc = <<-'EOT'
     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:
 
         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:
 
         augeas{"jboss_conf":
           context   => "/files",
           changes   => [
               "set etc/jbossas/jbossas.conf/JBOSS_IP $ipaddress",
               "set etc/jbossas/jbossas.conf/JAVA_HOME /usr",
             ],
           load_path => "$/usr/share/jbossas/lenses",
         }
 
   EOT
 
   newparam (:name) do
     desc "The name of this task. Used for uniqueness."
     isnamevar
   end
 
   newparam (:context) do
     desc "Optional context path. This value is prepended to the paths of all
       changes if the path is relative. If the `incl` parameter is set,
       defaults to `/files + incl`; otherwise, defaults to the empty string."
     defaultto ""
     munge do |value|
       if value.empty? and resource[:incl]
         "/files" + resource[:incl]
       else
         value
       end
     end
   end
 
   newparam (:onlyif) do
     desc "Optional augeas command and comparisons to control the execution of this type.
       Supported onlyif syntax:
 
       * `get <AUGEAS_PATH> <COMPARATOR> <STRING>`
       * `match <MATCH_PATH> size <COMPARATOR> <INT>`
       * `match <MATCH_PATH> include <STRING>`
       * `match <MATCH_PATH> not_include <STRING>`
       * `match <MATCH_PATH> == <AN_ARRAY>`
       * `match <MATCH_PATH> != <AN_ARRAY>`
 
       where:
 
       * `AUGEAS_PATH` is a valid path scoped by the context
       * `MATCH_PATH` is a valid match synatx scoped by the context
       * `COMPARATOR` is one of `>, >=, !=, ==, <=,` or `<`
       * `STRING` is a string
       * `INT` is a number
       * `AN_ARRAY` is in the form `['a string', 'another']`"
     defaultto ""
   end
 
 
   newparam(:changes) do
     desc "The changes which should be applied to the filesystem. This
     can be a command or an array of commands. The following commands are supported:
 
     * `set <PATH> <VALUE>` --- Sets the value `VALUE` at loction `PATH`
     * `setm <PATH> <SUB> <VALUE>` --- Sets multiple nodes (matching `SUB` relative to `PATH`) to `VALUE`
     * `rm <PATH>` --- Removes the node at location `PATH`
     * `remove <PATH>` --- Synonym for `rm`
     * `clear <PATH>` --- Sets the node at `PATH` to `NULL`, creating it if needed
     * `clearm <PATH> <SUB>` --- Sets multiple nodes (matching `SUB` relative to `PATH`) to `NULL`
     * `ins <LABEL> (before|after) <PATH>` --- Inserts an empty node `LABEL` either before or after `PATH`.
     * `insert <LABEL> <WHERE> <PATH>` --- Synonym for `ins`
     * `mv <PATH> <OTHER PATH>` --- Moves a node at `PATH` to the new location `OTHER PATH`
     * `move <PATH> <OTHER PATH>` --- Synonym for `mv`
     * `defvar <NAME> <PATH>` --- Sets Augeas variable `$NAME` to `PATH`
     * `defnode <NAME> <PATH> <VALUE>` --- Sets Augeas variable `$NAME` to `PATH`, creating it with `VALUE` if needed
 
     If the `context` parameter is set, that value is prepended to any relative `PATH`s."
   end
 
 
   newparam(:root) do
     desc "A file system path; all files loaded by Augeas are loaded underneath `root`."
     defaultto "/"
   end
 
   newparam(:load_path) do
     desc "Optional colon-separated list or array of directories; these directories are searched for schema definitions. The agent's `$libdir/augeas/lenses` path will always be added to support pluginsync."
     defaultto ""
   end
 
   newparam(:force) do
     desc "Optional command to force the augeas type to execute even if it thinks changes
     will not be made. This does not overide the `onlyif` parameter."
 
     defaultto false
   end
 
   newparam(:type_check) do
     desc "Whether augeas should perform typechecking. Defaults to false."
     newvalues(:true, :false)
 
     defaultto :false
   end
 
   newparam(:lens) do
     desc "Use a specific lens, e.g. `Hosts.lns`. When this parameter is set, you
-      must also set the `incl` parameter to indicate which file to load."
+      must also set the `incl` parameter to indicate which file to load.
+      The Augeas documentation includes [a list of available lenses](http://augeas.net/stock_lenses.html)."
   end
 
   newparam(:incl) do
     desc "Load only a specific file, e.g. `/etc/hosts`. This can greatly speed
       up the execution the resource. When this parameter is set, you must also
       set the `lens` parameter to indicate which lens to use."
   end
 
   validate do
     has_lens = !self[:lens].nil?
     has_incl = !self[:incl].nil?
     self.fail "You must specify both the lens and incl parameters, or neither." if has_lens != has_incl
   end
 
   # This is the actual meat of the code. It forces
   # augeas to be run and fails or not based on the augeas return
   # code.
   newproperty(:returns) do |property|
     include Puppet::Util
     desc "The expected return code from the augeas command. Should not be set."
 
     defaultto 0
 
     # Make output a bit prettier
     def change_to_s(currentvalue, newvalue)
       "executed successfully"
     end
 
     # if the onlyif resource is provided, then the value is parsed.
     # a return value of 0 will stop exection because it matches the
     # default value.
     def retrieve
       if @resource.provider.need_to_run?()
         :need_to_run
       else
         0
       end
     end
 
     # Actually execute the command.
     def sync
       @resource.provider.execute_changes
     end
   end
 
 end