heading level refactor

use =TITLE as top level heading, and then start with =head1 methods

this effectively lowers the rank of most headings by one

Author: moritz

lib/Any.pod

@@ -1,34 +1,34 @@
 =begin pod
 
-=head1 Any
+=TITLE class Any
 
     class Any is Mu { ... }
 
 While C<Mu> is the root of the Perl 6 class hirarchy, C<Any> is the class
 that serves as a default base class for new classes, and as the base class for
 most built-in classes.
 
-=head2 Methods
+=head1 Methods
 
-=head3 ACCEPTS
+=head2 ACCEPTS
 
     multi method ACCEPTS(Any:D: Mu $other)
 
 Returns C<True> if C<$other === self> (ie it checks object identity).
 
-=head3 any
+=head2 any
 
 Interprets the invocant as a list and creates an C<any>-Junction from it.
 
-=head3 all
+=head2 all
 
 Interprets the invocant as a list and creates an C<all>-Junction from it.
 
-=head3 one
+=head2 one
 
 Interprets the invocant as a list and creates an C<one>-Junction from it.
 
-=head3 none
+=head2 none
 
 Interprets the invocant as a list and creates an C<none>-Junction from it.
 

lib/Bool.pod

@@ -1,20 +1,20 @@
 =begin pod
 
-=head1 Bool
+=TITLE enum Bool
 
     enum Bool <False True>
 
 An enum for boolean true/false decisions
 
-=head2 Operators
+=head1 Operators
 
-=head3 prefix:<?>
+=head2 prefix:<?>
 
     multi sub prefix:<?>(Mu) returns Bool:D
 
 Coerces its argument to C<Bool>.
 
-=head3 prefix:<so>
+=head2 prefix:<so>
 
     multi sub prefix:<so>(Mu) returns Bool:D
 

lib/Buf.pod

@@ -1,6 +1,6 @@
 =begin pod
 
-=head1 Buf
+=TITLE class Buf
 
     class Buf does Positional { ... }
 
@@ -11,27 +11,27 @@ It can be used to for writing to IO handles as C<$io.write($buf)>.
 In the abstract it is just a list of integers, so
 for example indexing into a C<Buf> with C<.[$idx]> returns an C<Int>.
 
-=head2 Methods
+=head1 Methods
 
-=head3 new
+=head2 new
 
     method new(*@codes)
 
 Creates a C<Buf> from a list of integers.
 
-=head3  Bool
+=head2  Bool
 
     multi method Bool(Buf:D:)
 
 Returns C<False> if and only if the buffer is empty.
 
-=head3 elems
+=head2 elems
 
     multi method elems(Buf:D:) returns Int:D
 
 Returns the number of elements of the buffer.
 
-=head3 decode
+=head2 decode
 
     multi method decode(Buf:D: Str:D $encoding = 'UTF-8') returns Str:D
 

lib/Code.pod

@@ -1,6 +1,6 @@
 =begin pod
 
-=head1 Code
+=TITLE Code
 
     class Code is Any does Callable { ... }
 
@@ -10,9 +10,9 @@ directly of type C<Code>, most code objects (such as those resulting
 from blocks, subroutines or methods) will be of some subclass of C<Code>.
 
 
-=head2 Methods
+=head1 Methods
 
-=head3 ACCEPTS
+=head2 ACCEPTS
 
     multi method ACCEPTS(Code:D: Mu $topic)
 
@@ -21,7 +21,7 @@ However, when called on a code object that takes no arguments, the code
 object is invoked with no arguments and C<$topic> is dropped. The
 result of the call is returned.
 
-=head3 arity
+=head2 arity
 
     method arity(Code:D:) returns Int:D
 
@@ -36,7 +36,7 @@ code object's C<Signature> do not contribute, nor do named parameters.
     say &args.arity;                # 1
     say &slurpy.arity;              # 2
 
-=head3 count
+=head2 count
 
     method count(Code:D:) returns Real:D
 
@@ -52,14 +52,14 @@ C<count> will return C<Inf>. Named parameters do not contribute.
     say &args.count;                # 2
     say &slurpy.count;              # Inf
 
-=head3 signature
+=head2 signature
 
     multi method signature(Code:D:) returns Signature:D
 
 Returns the C<Signature> object for this code object, which describes
 its parameters.
 
-=head3 Str
+=head2 Str
 
     multi method Str(Code:D:) returns Str:D
 

lib/Cool.pod

@@ -1,6 +1,6 @@
 =begin pod
 
-=head1 Cool
+=TITLE Cool
 
     class Cool is Any { }
 

lib/Enum.pod

@@ -1,27 +1,27 @@
 =begin pod
 
-=head1 Enum
+=TITLE class Enum
 
     class Enum does Associative { ... }
 
 An C<Enum> consists of a key and a value. It is the immutable version of
 C<Pair> (which inherits from Enum).
 
-=head2 Methods
+=head1 Methods
 
-=head3 key
+=head2 key
 
     multi method key(Enum:D:)
 
 Returns the key part of the Enum.
 
-=head3 value
+=head2 value
 
     multi method value(Enum:D:)
 
 Returns the value part of the Enum.
 
-=head3 invert
+=head2 invert
 
     multi method invert(Enum:D:) returns Enum:D
 

lib/Int.pm

@@ -1,14 +1,14 @@
 =begin pod
 
-=head1 Int
+=TITLE class Int
 
     class Int is Cool does Real { ... }
 
 C<Int> objects store integral numbers of arbitrary size. C<Int>s are immutable.
 
-=head2 Operators
+=head1 Operators
 
-=head3 div
+=head2 div
 
     multi sub infix:<div>(Int:D, Int:D) returns Int:D