Added DESCRIPTION and some minor edits.

runtime/parrot/include/green_threads.pir

@@ -1,10 +1,10 @@
 # Copyright (C) 2010-2012, Parrot Foundation.
 
-=head1 green_threads.pir
+=head1 DESCRIPTION
 
 Provides an implementation of preempting green threads in pure PIR.
 
-=head1 Summary
+=head1 SUMMARY
 
     include 'green_threads.pir'
 

runtime/parrot/include/hllmacros.pir

@@ -1,10 +1,10 @@
-# Copyright (C) 2006-2009, Parrot Foundation.
+# Copyright (C) 2006-2012, Parrot Foundation.
 
-=head1 High Level Language Macros
+=head1 DESCRIPTION
 
-These macros are to make it easier to write readable and maintainable PIR by
-preprocessing common HLL forms into their low level PIR forms.  These are
-B<not> actually high level constructs, but merely preprocessor directives.
+High-level language macros make it easier to write readable and maintainable
+PIR by preprocessing common HLL forms into their low level PIR forms. These
+are B<not> actually high level constructs, but merely preprocessor directives.
 
 =head2 Conditionals
 
@@ -22,7 +22,7 @@ code that contains commas or right parenthesis, C<)>, without causing an error.
 This allows for nesting macros to near infinite depths.  And macro parameter
 that uses a comma or right parenthesis must be enclosed in braces.
 
-=head1 Macros
+=head1 MACROS
 
 =over 4
 
@@ -237,7 +237,7 @@ Using C<.NL()>
     })
 
 
-=head1 Caveats
+=head1 CAVEATS
 
 The .Foreach macro is not nestable within itself currently.  You can use other macros inside a .Foreach loop, and the .Foreach loop can be nested inside other macros.
 

runtime/parrot/include/test_more.pir

@@ -1,15 +1,19 @@
-# Copyright (C) 2007-2008, Parrot Foundation.
+# Copyright (C) 2007-2012, Parrot Foundation.
+
+=head1 DESCRIPTION
+
+This file contains all the boilerplate code for starting off a test written in
+PIR using Test::More's subs.
 
 =head1 Purpose
 
-This file contains all the boilerplate code for starting off a test written in PIR using
-Test::More's subs. In order to use it, simply include it in the :main routine of your test script.
+In order to use it, simply include it in the :main routine of your test script.
 
 Imports several subs into the current namespace from Test::More.
 
-This is intended to be broadly usable. Feel free to use Test::More
-directly, of course, but this provides a handy shortcut for setting up
-simple test file written in parrot.
+This is intended to be broadly usable. Feel free to use Test::More directly,
+of course, but this provides a handy shortcut for setting up simple test file
+written in parrot.
 
 =cut