Wrote "description"

README

@@ -0,0 +1,71 @@
+NAME
+
+    Blosxom::Header - Missing interface to modify HTTP headers
+
+SYNOPSIS
+
+        use Blosxom::Header;
+
+        my $header = Blosxom::Header->new();
+
+        $header->set(
+            type          => 'text/html;',
+            status        => '304',
+            cache_control => 'must-revalidate',
+        );
+        my $value = $header->get('status');           # 304 Not Modified
+        my $bool  = $header->exists('cache_control'); # 1
+        my @keys  = $header->keys();                  # ('type', 'status', 'cache_control')
+
+        $header->remove('cache_control');
+        @keys = $header->keys(); # ('type', 'status')
+
+        $header->remove_all();
+        @keys = $header->keys(); # ()
+
+DESCRIPTION
+
+    Blosxom, a weblog application, exports a global variable $header
+    which is a hash reference. This application passes $header CGI::header()
+    to generate HTTP headers.
+
+    When plugin writers modify HTTP headers, they must write as follows:
+
+        package foo;
+        $blosxom::header->{'-status'} = '304 Not Modified';
+
+    It's obviously bad practice. Blosxom misses the interface to modify
+    HTTP headers.  
+
+    This module allows you to modify them in an object-oriented way.
+    If loaded, you might write as follows:
+
+        my $header = Blosxom::Header->new();
+        $header->set('status' => '304');
+
+INSTALLATION
+
+        % perl Makefile.PL
+        % make
+        % make test
+
+DEPENDENCIES
+
+    *   Blosxom 2.1.2
+    *   HTTP::Status
+
+AUTHOR
+
+    Ryo Anazawa (r-anazawa@shochutairen.com)
+
+LICENSE AND COPYRIGHT
+
+    Copyright (c) 2011 Ryo Anazawa. All rights reserved.
+
+    This module is free software; you can redistribute it and/or
+    modify it under the same terms as Perl itself. See L<perlartistic>.
+
+    This program is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+

lib/Blosxom/Header.pm

@@ -75,7 +75,7 @@ __END__
 
 =head1 NAME
 
-Blosxom::Header - Set HTTP headers in an object-oriented way
+Blosxom::Header - Missing interface to modify HTTP headers
 
 =head1 SYNOPSIS
 
@@ -100,6 +100,24 @@ Blosxom::Header - Set HTTP headers in an object-oriented way
 
 =head1 DESCRIPTION
 
+Blosxom, a weblog application, exports a global variable $header
+which is a hash reference. This application passes $header CGI::header()
+to generate HTTP headers.
+
+When plugin writers modify HTTP headers, they must write as follows:
+
+  package foo;
+  $blosxom::header->{'-status'} = '304 Not Modified';
+
+It's obviously bad practice. Blosxom misses the interface to modify
+HTTP headers.  
+
+This module allows you to modify them in an object-oriented way.
+If loaded, you might write as follows:
+
+  my $header = Blosxom::Header->new();
+  $header->set('status' => '304');
+
 =head1 METHODS
 
 =over 4
@@ -119,14 +137,20 @@ has a value.
 
 =item $header->remove('foo', 'bar')
 
+Deletes the specified elements from HTTP headers.
+
 =item $header->set(%headers)
 
+Set values of the specified HTTP headers.
+
 =item $header->keys()
 
 Returns a list of all the keys of HTTP headers.
 
 =item $header->remove_all()
 
+Deletes all the elements of HTTP headers.
+
 =back
 
 =head1 DIAGOSTICS