uc/lc consistency, typo and style fixes for Moose::Manual documents
[gitmo/Moose.git] / lib / Moose / Manual / Attributes.pod
index cc43ed2..011b01f 100644 (file)
@@ -36,7 +36,7 @@ Use the C<has> function to declare an attribute:
 This says that all C<Person> objects have an optional read-write
 "first_name" attribute.
 
-=head2 Read-write Vs Read-only
+=head2 Read-write Vs read-only
 
 The options passed to C<has> define the properties of the
 attribute. There are a many options, but in the simplest form you just
@@ -47,7 +47,7 @@ need to set C<is>, which can be either C<rw> (read-write) or C<ro>
 that has no accessors, which is pointless unless you're doing some
 deep, dark magic).
 
-=head2 Accessor Methods
+=head2 Accessor methods
 
 Each attribute has one or more accessor methods. An accessor lets you
 read and write the value of that attribute for an object.
@@ -94,7 +94,7 @@ tedious, you're right! Fortunately, Moose provides a powerful
 extension system that lets override the default naming
 conventions. See L<Moose::Manual::MooseX> for more details.
 
-=head2 Predicate and Clearer Methods
+=head2 Predicate and clearer methods
 
 Moose allows you to explicitly distinguish between a false or
 undefined attribute value and an attribute which has not been set. If
@@ -145,7 +145,7 @@ predicate, and clearer method.
 By default, Moose does not make a predicate or clearer for you. You
 must explicitly provide names for them.
 
-=head2 Required or Not?
+=head2 Required or not?
 
 By default, all attributes are optional, and do not need to be
 provided at object construction time. If you want to make an attribute
@@ -172,7 +172,7 @@ clearer doesn't make much sense. In some cases, it might be handy to
 have a I<private> C<clearer> and C<predicate> for a required
 attribute.
 
-=head2 Default and Builder Methods
+=head2 Default and builder methods
 
 Attributes can have default values, and Moose provides two ways to
 specify that default.
@@ -256,7 +256,7 @@ subclasses.
 We strongly recommend that you use a C<builder> instead of a
 C<default> for anything beyond the most trivial default.
 
-=head2 Laziness and lazy_build
+=head2 Laziness and C<lazy_build>
 
 Moose lets you defer attribute population by making an attribute
 C<lazy>:
@@ -337,7 +337,7 @@ always provide your own:
 Options that you explicitly provide are always used in favor of
 Moose's internal defaults.
 
-=head2 Constructor Parameters (init_arg)
+=head2 Constructor parameters (C<init_arg>)
 
 By default, each attribute can be passed by name to the class's
 constructor. On occasion, you may want to use a different name for
@@ -366,7 +366,7 @@ the constructor. This is particularly handy for private attributes:
 By setting the C<init_arg> to C<undef>, we make it impossible to set
 this attribute when creating a new object.
 
-=head2 Weak References
+=head2 Weak references
 
 Moose has built-in support for weak references. If you set the
 C<weak_ref> option to a true value, then it will call
@@ -407,7 +407,7 @@ trigger is only called when the attribute is set, as opposed to
 whenever the accessor is called. Second, it is also called if the
 attribute is set via a lazy default or builder.
 
-=head2 Attribute Types
+=head2 Attribute types
 
 Attributes can be restricted to only accept certain types:
 
@@ -563,7 +563,7 @@ You can provide a piece of documentation as a string for an attribute:
 Moose does absolutely nothing with this information other than store
 it.
 
-=head2 The C<auto_deref> Option
+=head2 The C<auto_deref> option
 
 If your attribute is an array reference or hash reference, the
 C<auto_deref> option will make Moose dereference the value when it is