logical_volume: docs cleanup

Author: kenyon

manifests/logical_volume.pp

@@ -1,22 +1,36 @@
+# @summary Manage a logical volume.
+#
 # @param volume_group The volume group name associated with this logical volume.
 # This will automatically set this volume group as a dependency,
 # but it must be defined elsewhere using the volume_group resource type.
+#
 # @param size  Configures the size of the filesystem. Supports filesystem resizing. The size will be rounded up to the nearest multiple of
 # the partition size.
+#
 # @param initial_size The initial size of the logical volume. This will only apply to newly-created volumes
 #
 # @param ensure
+#
 # @param options Params for the mkfs command
 #
 # @param pass
+#
 # @param dump
+#
 # @param fs_type The file system type. eg. ext3.
+#
 # @param mkfs_options
+#
 # @param mountpath
+#
 # @param mountpath_require
+#
 # @param mounted If puppet should mount the volume. This only affects what puppet will do, and not what will be mounted at boot-time.
+#
 # @param createfs
+#
 # @param extents The number of logical extents to allocate for the new logical volume. Set to undef to use all available space
+#
 # @param stripes The number of stripes to allocate for the new logical volume.
 #
 # @param stripesize  The stripesize to use for the new logical volume.
@@ -27,30 +41,26 @@
 # (if the LV found is larger then the size requests this is just logged not causing a FAIL)
 #
 # @param size_is_minsize Lists strings for access control for connection method, users, databases, IPv4 addresses;
+#
 # @param type Configures the logical volume type. AIX only
 #
 # @param thinpool - Set to true to create a thin pool or to pool name to create thin volume
+#
 # @param poolmetadatasize Set the initial size of the logical volume pool metadata on creation
-
+#
 # @param mirror The number of mirrors of the volume.
+#
 # @param mirrorlog How to store the mirror log (Allowed values: core, disk, mirrored).
-
+#
 # @param no_sync An optimization in lvcreate, at least on Linux.
-
+#
 # @param region_size A mirror is divided into regions of this size (in MB), the mirror log uses this granularity to track which regions
-# are in sync.
-# CAN NOT BE CHANGED on already mirrored volume.
+# are in sync. Cannot be changed on already mirrored volume.
 # Take your mirror size in terabytes and round up that number to the next power of 2, using that number as the -R argument
-
-# @param alloc Selects the allocation policy when a command needs to allocate Physical Extents from the Volume Group. Allowed Values:
-# :anywhere
-# :contiguous
-# :cling
-# :inherit
-# :normal
-
+#
+# @param alloc The allocation policy when a command needs to allocate Physical Extents from the Volume Group.
+#
 # @param yes_flag If set to true, do not prompt for confirmation interactively but always assume the answer yes.
-
 #
 define lvm::logical_volume (
   String[1] $volume_group,