rio 0.3.1

data/VERSION

@@ -0,0 +1 @@
+0.3.1

data/doc/README_MSWIN32.txt

@@ -0,0 +1,39 @@
+Copyright (c) 2005, Christopher Kleckner
+All rights reserved
+
+This file is part of the Rio library for ruby.
+
+Rio is free software; you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation; either version 2 of the License, or
+(at your option) any later version.
+
+Rio 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.  See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with Rio; if not, write to the Free Software
+Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+
+
+<b>Rio is pre-alpha software. 
+The documented interface and behavior is subject to change without notice.</b>
+
+Currently support for MSWin paths involves simply ignoring the drive portion (C: etc)
+of paths returned by by the underlying ruby libraries (that's right, it just
+lopps that sob right off) While this is clearly unacceptable behavior, it is unclear
+to the author whether support for paths that can not be represented per RFC1738 is
+a feature of interest to anyone.
+
+There is a relatively small amount of code that would have to change to add this
+support in the future, and such support may be included in a future release.
+
+For the time being, the subset of tests in 'test/mswin32.rb' do pass when running 
+under the mswin32 port of ruby. By far the majority of the tests that are excluded
+are excluded because they use symlinks, not because of the differences in path
+representations.
+
+
+

data/doc/RELEASE_NOTES

@@ -0,0 +1,130 @@
+!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+Rio is pre-alpha software. 
+The documented interface and behavior is subject to change without notice.
+!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
+
+=== Rio - Ruby I/O Comfort Class
+
+Rio is a convenience class wrapping much of the functionality of 
+IO, File, Dir, Pathname, FileUtils, Tempfile, StringIO, OpenURI, Zlib, and CSV.
+
+To create the documentation for Rio run the command
+  rake rdoc
+from the distribution directory. 
+
+If your don't have rake installed, install it, until you do try:
+  ruby RUNME.1st.rb
+from the distribution directory.
+
+Then point your browser at the 'doc/rdoc' directory.
+
+Suggested Reading
+* RIO::Doc::SYNOPSIS
+* RIO::Doc::INTRO
+* RIO::Doc::HOWTO
+* RIO::Rio
+
+== SYNOPSIS
+
+For the following assume:
+ astring = ""
+ anarray = []
+
+Copy a file into a string
+ rio('afile') > astring 
+
+Copy the chomped lines of a file into an array
+ rio('afile').chomp > anarray
+ 
+Copy a file into another file
+ rio('afile') > rio('another_file')
+
+Copy a file into a directory
+ rio('afile') > rio('adir')
+
+Copy an entire directory structure into another directory
+ rio('adir') > rio('another_directory')
+
+Copy a web page into a file
+ rio('http://rubydoc.org/') > rio('afile')
+
+Copy a file from a ftp server into a file
+ rio('ftp://host/afile.gz') > rio('afile.gz')
+
+Copy a gzipped file un-gzipping it
+ rio('afile.gz').gzip > rio('afile')
+
+Copy a file from a ftp server into a local file un-gzipping it
+ rio('ftp://host/afile.gz').gzip > rio('afile')
+
+Copy a plain file, gzipping it
+ rio('afile.gz').gzip < rio('afile')
+
+Iterate over the entries in a directory
+ rio('adir').entries { |entrio| ... }
+
+Iterate over only the files in a directory
+ rio('adir').files { |entrio| ... }
+
+Iterate over only the .rb files in a directory
+ rio('adir').files('*.rb') { |entrio| ... }
+
+Create an array of the .rb entries in a directory
+ anarray = rio('adir')['*.rb']
+
+Iterate over the .rb files in a directory and its subdirectories
+ rio('adir').all.files('*.rb') { |entrio| ... }
+
+Create an array of the .rb entries in a directory and its subdirectories
+ anarray = rio('adir').all['*.rb']
+
+Create an array of the .rb files in a directory and its subdirectories
+ anarray = rio('adir').all.files['*.rb']
+
+Copy an entire directory structure but only the .rb files from a directory and its subdirectories 
+into another directory
+ rio('adir').dirs.files('*.rb') > rio('another_directory')
+
+Iterate over the chomped lines of a file
+ rio('afile').chomp.lines { |line| ... }
+
+Put the chomped lines of a file into an array
+ anarray = rio('afile').chomp.lines[]
+
+Iterate over the first 10 chomped lines of a file
+ rio('afile').chomp.lines(0..9) { |line| ... }
+
+Put the first 10 chomped lines of a file into an array
+ anarray = rio('afile').chomp.lines[0..9]
+
+Copy the first 10 lines of a file into another file
+ rio('afile').lines(0..9) > rio('another_file')
+
+Copy the first 10 lines of a file to stdout
+ rio('afile').lines(0..9) > rio(?-)
+
+Copy the first 10 lines of a gzipped file to stdout
+ rio('afile.gz').gzip.lines(0..9) > rio(?-)
+
+Copy the first 10 lines of a gzipped file on an ftp server to stdout
+ rio('ftp://host/afile.gz').gzip.lines(0..9) > rio(?-)
+
+Put the first 100 chomped lines of a gzipped file into an array
+ anarray =  rio('afile.gz').gzip[0...100] 
+
+Copy the output of th ps command into an array, skipping the header line and the ps command entry
+ rio(?-,'ps -a').nolines(0,/ps$/) > anarray 
+
+Prompt for input and return what was typed
+ ans = rio(?-).print("Type Something: ").chomp.gets 
+
+Change the extension of all files with the extension '.htm' in a directory and its
+subdirectories to have the extension '.html'
+ rio('adir').rename.all.files('*.htm') do |htmfile|
+   htmfile.extname = '.html'
+ end
+
+Create a symbolic link 'asymlink' in 'adir' which refers to 'adir/afile'
+ rio('adir/afile').symlinke('adir/asymlink')
+
+

data/doc/generators/template/html/rio.rb

@@ -0,0 +1,895 @@
+#
+# = CSS2 RDoc HTML template
+#
+# This is a template for RDoc that uses XHTML 1.0 Transitional and dictates a
+# bit more of the appearance of the output to cascading stylesheets than the
+# default. It was designed for clean inline code display, and uses DHTMl to
+# toggle the visbility of each method's source with each click on the '[source]'
+# link.
+#
+# == Authors
+#
+# * Michael Granger <ged@FaerieMUD.org>
+#
+# Copyright (c) 2002, 2003 The FaerieMUD Consortium. Some rights reserved.
+#
+# This work is licensed under the Creative Commons Attribution License. To view
+# a copy of this license, visit http://creativecommons.org/licenses/by/1.0/ or
+# send a letter to Creative Commons, 559 Nathan Abbott Way, Stanford, California
+# 94305, USA.
+#
+
+# Modified by Christopher Kleckner
+# Copyright (c) 2005. Some rights reserved.
+# Licensed under the same terms as the original
+
+
+module RDoc
+  module Page
+
+    FONTS = "Verdana,Arial,Helvetica,sans-serif"
+
+STYLE = %{
+body {
+  font-family: Verdana,Arial,Helvetica,sans-serif;
+  font-size:   90%;
+  margin: 0;
+  margin-left: 40px;
+  padding: 0;
+  background: white;
+}
+
+h1,h2,h3,h4 { margin: 0; color: #8b4726; background: transparent; }
+h1 { font-size: 150%; }
+h2 { font-size: 140%; }
+h3 { font-size: 130%; }
+h4 { font-size: 120%; }
+h2,h3,h4 { margin-top: 1em; }
+
+a { 
+  background: transparent; 
+  color: #8b4500;  
+  text-decoration: none; 
+}
+a:hover { 
+  color: #ffa500;
+  background: #8b4500; 
+}
+
+/* Override the base stylesheet's Anchor inside a table cell */
+td > a {
+  background: transparent;
+  color: #099;
+  text-decoration: none;
+}
+
+small { 
+  font-size: 0.7em;
+}
+/* and inside a section title */
+.section-title > a {
+  background: transparent;
+  color: #8b4500; 
+  text-decoration: none;
+}
+
+/* === Structural elements =================================== */
+
+div#index {
+  margin: 0;
+  margin-left: -40px;
+  padding: 0;
+  font-size: 90%;
+  background: #ffdead;
+}
+
+
+div#index a {
+  margin-left: 0.7em;
+}
+div#index-entries a {
+  background: transparent;
+  margin-left: 0.7em;
+  color: #8b4500; 
+}
+div#index-entries a:hover {
+  background: transparent;
+  margin-left: 0.7em;
+  /*   color: #ffdead;  */
+  color: #ffdead; 
+  background: #8b4500; 
+  /*background: #ffdead;*/
+}
+.name-list a {
+  margin-left: 0.7em;
+  background: #ffdead; 
+  color: #8b4500; 
+}
+.name-list a:hover {
+  margin-left: 0.7em;
+  color: #ffdead; 
+  background: #8b4500; 
+}
+.section-bar {
+  color: #555;
+  /*   background: #8b4500; */
+  
+  border-bottom: 1px solid #999;
+  margin-left: -20px;
+}
+
+div#index .section-bar {
+  margin-left: 0px;
+  padding-left: 0.7em;
+  background: #8b4500; 
+  color: #ffdead;
+  font-size: small;
+}
+
+
+.section-title {
+  /*background: #8b4500; */
+  background: #ffdead;
+  color: #eee;
+  padding: 3px;
+  margin-top: 2em;
+  margin-left: -30px;
+  border: 1px solid #999;
+}
+
+div#classHeader, div#fileHeader {
+  width: auto;
+  color: white;
+  padding: 0.5em 1.5em 0.5em 1.5em;
+  margin: 0;
+  margin-left: -40px;
+  border-bottom: 3px solid #006;
+}
+
+div#classHeader a, div#fileHeader a {
+  background: inherit;
+  color: white;
+}
+
+div#classHeader td, div#fileHeader td {
+  background: inherit;
+  color: white;
+}
+
+
+div#fileHeader {
+  background: #8b4500; 
+
+}
+#fileHeader h1,#fileHeader h2,#fileHeader h3,#fileHeader h4 { 
+  margin: 0; 
+  color: #ffdead;
+}
+
+div#classHeader {
+  background: #8b4500; 
+}
+td.class-header-space-col {
+  width: 2em;
+}
+
+
+.class-mod {
+  font-size:  110%;
+  font-weight: bold;
+  font-family: monospace;
+  text-transform: lowercase;
+  text-align: bottom;
+             
+}
+.class-name-in-header {
+  font-size:  150%;
+  font-weight: bold;
+  font-family: monospace;
+}
+.in-url { 
+  font-size: 80%
+}
+
+div#bodyContent {
+    padding: 0 1.5em 0 1.5em;
+}
+
+
+div#description {
+    padding: 0.5em 1.5em;
+    /* background: #efefef; */
+    background: #ffdead;
+    border: 1px dotted #999;
+}
+
+div#description h1,h2,h3,h4,h5,h6 {
+    color: #8b4500;
+    background: transparent;
+}
+
+div#validator-badges {
+    text-align: center;
+}
+div#validator-badges img { border: 0; }
+
+div#copyright {
+    color: #333;
+    background: #efefef;
+    font: 0.75em sans-serif;
+    margin-top: 5em;
+    margin-bottom: 0;
+    padding: 0.5em 2em;
+}
+
+
+/* === Classes =================================== */
+
+table.header-table {
+    color: white;
+    font-size: small;
+}
+
+.type-note {
+    font-size: small;
+    color: #DEDEDE;
+}
+
+.xxsection-bar {
+    background: #eee;
+    color: #333;
+    padding: 3px;
+}
+
+
+
+.section-title {
+    background: #79a;
+    color: #eee;
+    padding: 3px;
+    margin-top: 2em;
+    margin-left: -30px;
+    border: 1px solid #999;
+}
+
+.top-aligned-row {  vertical-align: top }
+.bottom-aligned-row { vertical-align: bottom }
+
+/* --- Context section classes ----------------------- */
+
+.context-row { }
+.context-item-name { font-family: monospace; font-weight: bold; color: black; }
+.context-item-value { font-size: small; color: #448; }
+.context-item-desc { color: #333; padding-left: 2em; }
+
+/* --- Method classes -------------------------- */
+.method-detail {
+    background: #ffdead;
+    padding: 0;
+    margin-top: 0.5em;
+    margin-bottom: 1em;
+    border: 1px dotted #ccc;
+}
+.method-heading {
+  font-family: monospace; 
+  font-weight: bold;
+  font-size: 130%;
+  color: #191970;
+  /* background: #b0c4de; */
+  background: #ffa07a;
+  border-bottom: 1px solid #666;
+  padding: 0.2em 0.5em 0 0.5em;
+}
+.method-heading a {
+   text-decoration: none;
+}
+.method-heading a:hover {
+   text-decoration: underline;
+  background: inherit;
+  color: inherit;
+}
+.method-signature { color: black; background: inherit; }
+.method-name { font-weight: bold; }
+.method-args { font-style: italic; }
+
+.method-description { padding: 0 0.5em 0 0.5em; }
+pre.method-description 
+{ 
+  padding: 0 0.5em 0 0.5em; 
+  color: #ee2222;
+                    
+}
+#description pre
+{ 
+  padding: 0.2em 0 0.2em 0; 
+  margin: 0.3em 0 0.3em 0;  
+  background: #fff8dc;
+  border-left: 2px solid #8b6508; 
+  /* border-bottom: 1px solid #8b6508; */
+  /*  border-top: 1px solid #8b6508; */
+}
+#description h1 { 
+   color: #8b4500; 
+  margin: 0.5em 0 0.2em 0;
+  /*border: 1px solid red;*/
+  }
+#description h2 { 
+   color: #8b4500; 
+  margin: 0.5em 0 0.2em 0;
+  /*border: 1px solid red;*/
+  }
+#description h3 { 
+   color: #8b4500; 
+  margin: 0.5em 0 0.2em 0;
+  /*border: 1px solid red;*/
+  }
+#description h4 { 
+   color: #8b4500; 
+  margin: 0.5em 0 0.2em 0;
+  /*border: 1px solid red;*/
+  }
+#description p { 
+  margin: 0.5em 0 0.2em 0;
+  /*border: 1px solid red;*/
+  }
+#description ul { 
+  margin: 0.2em 0 0.5em 0;
+  /* border: 1px solid red; */
+  }
+#description a { 
+    background: #ffdead;
+                 /* background: #eef; */
+    color: #8b4500; 
+    text-decoration: none; 
+}
+#description a:hover {     text-decoration: underline;  }
+.method-description a { 
+    background: #ffdead;
+                 /* background: #eef; */
+    color: #8b4500; 
+    text-decoration: none; 
+}
+.method-description a:hover {     text-decoration: underline;  }
+
+.method-description pre
+{ 
+  padding: 0.2em 0 0.2em 0; 
+  margin: 0.3em 0 0.3em 0;  
+  background: #fff8dc;
+  border-left: 2px solid #8b6508; 
+}
+
+.method-description table
+{ 
+  border-top: 1px solid brown; 
+  border-bottom: 1px solid brown; 
+  margin: 0.4em 2em 0.4em 2em;
+}
+.method-description li
+{ 
+  padding: 0 0 0 0; 
+  margin: 0 0 0 0; 
+                    
+}
+.method-description p { 
+  margin: 0.5em 0 0.2em 0;
+  /* border: 1px solid red; */
+  }
+.method-description tt { 
+  margin: 0.5em 0 0.2em 0;
+  font-weight: bold;                     
+  color: navy;                       
+  }
+.method-description ul { 
+  margin: 0.2em 0 0.5em 0;
+  /* border: 1px solid red; */
+  }
+
+
+/* --- Source code sections -------------------- */
+
+a.source-toggle { font-size: 90%; }
+div.method-source-code {
+    background: #262626;
+    color: #ffdead;
+    margin: 1em;
+    padding: 0.5em;
+    border: 1px dashed #999;
+    overflow: hidden;
+}
+
+div.method-source-code pre { color: #ffdead; overflow: hidden; }
+
+/* --- Ruby keyword styles --------------------- */
+
+.standalone-code { background: #221111; color: #ffdead; overflow: hidden; }
+
+.ruby-constant  { color: #7fffd4; background: transparent; }
+.ruby-keyword { color: #00ffff; background: transparent; }
+.ruby-ivar    { color: #eedd82; background: transparent; }
+.ruby-operator  { color: #00ffee; background: transparent; }
+.ruby-identifier { color: #ffdead; background: transparent; }
+.ruby-node    { color: #ffa07a; background: transparent; }
+.ruby-comment { color: #b22222; font-weight: bold; background: transparent; }
+.ruby-regexp  { color: #ffa07a; background: transparent; }
+.ruby-value   { color: #7fffd4; background: transparent; }
+}
+
+
+#####################################################################
+### H E A D E R   T E M P L A T E  
+#####################################################################
+
+XHTML_PREAMBLE = %{<?xml version="1.0" encoding="%charset%"?>
+<!DOCTYPE html 
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+}
+
+HEADER = XHTML_PREAMBLE + %{
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <title>%title%</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=%charset%" />
+  <meta http-equiv="Content-Script-Type" content="text/javascript" />
+  <link rel="stylesheet" href="%style_url%" type="text/css" media="screen" />
+  <script type="text/javascript">
+  // <![CDATA[
+
+  function popupCode( url ) {
+    window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
+  }
+
+  function toggleCode( id ) {
+    if ( document.getElementById )
+      elem = document.getElementById( id );
+    else if ( document.all )
+      elem = eval( "document.all." + id );
+    else
+      return false;
+
+    elemStyle = elem.style;
+    
+    if ( elemStyle.display != "block" ) {
+      elemStyle.display = "block"
+    } else {
+      elemStyle.display = "none"
+    }
+
+    return true;
+  }
+  
+  // Make codeblocks hidden by default
+  document.writeln( "<style type=\\"text/css\\">div.method-source-code { display: none }</style>" )
+  
+  // ]]>
+  </script>
+
+</head>
+<body>
+}
+
+
+#####################################################################
+### C O N T E X T   C O N T E N T   T E M P L A T E
+#####################################################################
+
+CONTEXT_CONTENT = %{
+}
+
+
+#####################################################################
+### F O O T E R   T E M P L A T E
+#####################################################################
+FOOTER = %{
+<div id="validator-badges">
+   <p><small>Copyright &copy; 2005 Christopher Kleckner.  <a href="http://www.gnu.org/licenses/gpl.html">All rights reserved</a>.</small></p>
+</div>
+
+</body>
+</html>
+}
+
+
+#####################################################################
+### F I L E   P A G E   H E A D E R   T E M P L A T E
+#####################################################################
+
+FILE_PAGE = %{
+  <div id="fileHeader">
+    <h1>%short_name%</h1>
+    <table class="header-table">
+    <tr class="top-aligned-row">
+      <td><strong>Path:</strong></td>
+      <td>%full_path%
+IF:cvsurl
+        &nbsp;(<a href="%cvsurl%">CVS</a>)
+ENDIF:cvsurl
+      </td>
+    </tr>
+    <tr class="top-aligned-row">
+      <td><strong>Last Update:</strong></td>
+      <td>%dtm_modified%</td>
+    </tr>
+    </table>
+  </div>
+}
+
+
+#####################################################################
+### C L A S S   P A G E   H E A D E R   T E M P L A T E
+#####################################################################
+
+CLASS_PAGE = %{
+    <div id="classHeader">
+        <table class="header-table">
+        <tr class="top-aligned-row">
+          <td class="class-mod"><strong>%classmod%</strong></td>
+          <td class="class-name-in-header">%full_name%</td>
+            <td rowspan="2" class="class-header-space-col"></td>
+            <td rowspan="2">
+START:infiles
+IF:full_path_url
+                <a class="in-url" href="%full_path_url%">
+ENDIF:full_path_url
+                %full_path%
+IF:full_path_url
+                </a>
+ENDIF:full_path_url
+IF:cvsurl
+        &nbsp;(<a href="%cvsurl%">CVS</a>)
+ENDIF:cvsurl
+        &nbsp;&nbsp;
+END:infiles
+            </td>
+        </tr>
+
+IF:parent
+        <tr class="top-aligned-row">
+            <td><strong>Parent:</strong></td>
+            <td>
+IF:par_url
+                <a href="%par_url%">
+ENDIF:par_url
+                %parent%
+IF:par_url
+               </a>
+ENDIF:par_url
+            </td>
+        </tr>
+ENDIF:parent
+        </table>
+    </div>
+}
+
+
+#####################################################################
+### M E T H O D   L I S T   T E M P L A T E
+#####################################################################
+
+METHOD_LIST = %{
+
+  <div id="contextContent">
+IF:diagram
+    <div id="diagram">
+      %diagram%
+    </div>
+ENDIF:diagram
+
+IF:description
+    <div id="description">
+      %description%
+    </div>
+ENDIF:description
+
+IF:requires
+    <div id="requires-list">
+      <h3 class="section-bar">Required files</h3>
+
+      <div class="name-list">
+START:requires
+      HREF:aref:name:&nbsp;&nbsp;
+END:requires
+      </div>
+    </div>
+ENDIF:requires
+
+IF:toc
+    <div id="contents-list">
+      <h3 class="section-bar">Contents</h3>
+      <ul>
+START:toc
+      <li><a href="#%href%">%secname%</a></li>
+END:toc
+     </ul>
+ENDIF:toc
+   </div>
+
+IF:methods
+    <div id="method-list">
+      <h3 class="section-bar">Methods</h3>
+
+      <div class="name-list">
+START:methods
+      HREF:aref:name:&nbsp;&nbsp;
+END:methods
+      </div>
+    </div>
+ENDIF:methods
+
+  </div>
+
+
+    <!-- if includes -->
+IF:includes
+    <div id="includes">
+      <h3 class="section-bar">Included Modules</h3>
+
+      <div id="includes-list">
+START:includes
+        <span class="include-name">HREF:aref:name:</span>
+END:includes
+      </div>
+    </div>
+ENDIF:includes
+
+START:sections
+    <div id="section">
+IF:sectitle
+      <h2 class="section-title"><a name="%secsequence%">%sectitle%</a></h2>
+IF:seccomment
+      <div class="section-comment">
+        %seccomment%
+      </div>      
+ENDIF:seccomment
+ENDIF:sectitle
+
+IF:classlist
+    <div id="class-list">
+      <h3 class="section-bar">Classes and Modules</h3>
+
+      %classlist%
+    </div>
+ENDIF:classlist
+
+IF:constants
+    <div id="constants-list">
+      <h3 class="section-bar">Constants</h3>
+
+      <div class="name-list">
+        <table summary="Constants">
+START:constants
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">%name%</td>
+          <td>=</td>
+          <td class="context-item-value">%value%</td>
+IF:desc
+          <td width="3em">&nbsp;</td>
+          <td class="context-item-desc">%desc%</td>
+ENDIF:desc
+        </tr>
+END:constants
+        </table>
+      </div>
+    </div>
+ENDIF:constants
+
+IF:aliases
+    <div id="aliases-list">
+      <h3 class="section-bar">External Aliases</h3>
+
+      <div class="name-list">
+                        <table summary="aliases">
+START:aliases
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">%old_name%</td>
+          <td>-></td>
+          <td class="context-item-value">%new_name%</td>
+        </tr>
+IF:desc
+      <tr class="top-aligned-row context-row">
+        <td>&nbsp;</td>
+        <td colspan="2" class="context-item-desc">%desc%</td>
+      </tr>
+ENDIF:desc
+END:aliases
+                        </table>
+      </div>
+    </div>
+ENDIF:aliases
+
+
+IF:attributes
+    <div id="attribute-list">
+      <h3 class="section-bar">Attributes</h3>
+
+      <div class="name-list">
+        <table>
+START:attributes
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">%name%</td>
+IF:rw
+          <td class="context-item-value">&nbsp;[%rw%]&nbsp;</td>
+ENDIF:rw
+IFNOT:rw
+          <td class="context-item-value">&nbsp;&nbsp;</td>
+ENDIF:rw
+          <td class="context-item-desc">%a_desc%</td>
+        </tr>
+END:attributes
+        </table>
+      </div>
+    </div>
+ENDIF:attributes
+      
+
+
+    <!-- if method_list -->
+IF:method_list
+    <div id="methods">
+START:method_list
+IF:methods
+      <h3 class="section-bar">%type% %category% methods</h3>
+
+START:methods
+      <div id="method-%aref%" class="method-detail">
+        <a name="%aref%"></a>
+
+        <div class="method-heading">
+IF:codeurl
+          <a href="%codeurl%" target="Code" class="method-signature"
+            onclick="popupCode('%codeurl%');return false;">
+ENDIF:codeurl
+IF:sourcecode
+          <a href="#%aref%" class="method-signature">
+ENDIF:sourcecode
+IF:callseq
+          <span class="method-name">%callseq%</span>
+ENDIF:callseq
+IFNOT:callseq
+          <span class="method-name">%name%</span><span class="method-args">%params%</span>
+ENDIF:callseq
+IF:codeurl
+          </a>
+ENDIF:codeurl
+IF:sourcecode
+          </a>
+ENDIF:sourcecode
+        </div>
+      
+        <div class="method-description">
+IF:m_desc
+          %m_desc%
+ENDIF:m_desc
+IF:sourcecode
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('%aref%-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="%aref%-source">
+<pre>
+%sourcecode%
+</pre>
+          </div>
+ENDIF:sourcecode
+        </div>
+      </div>
+
+END:methods
+ENDIF:methods
+END:method_list
+
+    </div>
+ENDIF:method_list
+END:sections
+}
+#def mlist(*args)
+  #p(args)
+#  METHOD_LIST0
+#end
+#module_function :mlist
+#METHOD_LIST = mlist()
+
+#####################################################################
+### B O D Y   T E M P L A T E
+#####################################################################
+
+BODY = HEADER + %{
+
+!INCLUDE!  <!-- banner header -->
+
+  <div id="bodyContent">
+
+} +  METHOD_LIST + %{
+
+  </div>
+
+} + FOOTER
+
+
+
+#####################################################################
+### S O U R C E   C O D E   T E M P L A T E
+#####################################################################
+
+SRC_PAGE = XHTML_PREAMBLE + %{
+<html>
+<head>
+  <title>%title%</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=%charset%" />
+  <link rel="stylesheet" href="%style_url%" type="text/css" media="screen" />
+</head>
+<body class="standalone-code">
+  <pre>%code%</pre>
+</body>
+</html>
+}
+
+
+#####################################################################
+### I N D E X   F I L E   T E M P L A T E S
+#####################################################################
+
+FR_INDEX_BODY = %{
+!INCLUDE!
+}
+
+FILE_INDEX = XHTML_PREAMBLE + %{
+<!--
+
+    %list_title%
+
+  -->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <title>%list_title%</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=%charset%" />
+  <link rel="stylesheet" href="%style_url%" type="text/css" />
+  <base target="docwin" />
+</head>
+<body>
+<div id="index">
+  <h1 class="section-bar">%list_title%</h1>
+  <div id="index-entries">
+START:entries
+    <a href="%href%">%name%</a><br />
+END:entries
+  </div>
+</div>
+</body>
+</html>
+}
+
+CLASS_INDEX = FILE_INDEX
+METHOD_INDEX = FILE_INDEX
+
+INDEX = %{<?xml version="1.0" encoding="%charset%"?>
+<!DOCTYPE html 
+     PUBLIC "-//W3C//DTD XHTML 1.0 Frameset//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-frameset.dtd">
+
+<!--
+
+    %title%
+
+  -->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <title>%title%</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=%charset%" />
+</head>
+<frameset rows="20%, 80%">
+    <frameset cols="25%,35%,45%">
+        <frame src="fr_file_index.html"   title="Files" name="Files" />
+        <frame src="fr_class_index.html"  name="Classes" />
+        <frame src="fr_method_index.html" name="Methods" />
+    </frameset>
+    <frame src="%initial_page%" name="docwin" />
+</frameset>
+</html>
+}
+
+
+
+  end # module Page
+end # class RDoc
+
+require 'rdoc/generators/template/html/one_page_html'