bindata 0.11.1 → 1.0.0

data/lib/bindata/float.rb

@@ -37,7 +37,7 @@ module BinData
 
     def self.define_methods(float_class, nbytes, read, to_binary_s)
       float_class.module_eval <<-END
-        def _do_num_bytes(ignored)
+        def _do_num_bytes
           #{nbytes}
         end
 

data/lib/bindata/int.rb

@@ -146,7 +146,7 @@ module BinData
             super(val)
           end
 
-          def _do_num_bytes(ignored)
+          def _do_num_bytes
             #{nbytes}
           end
 

data/lib/bindata/io.rb

@@ -1,8 +1,18 @@
+require 'stringio'
+
 module BinData
   # A wrapper around an IO object.  The wrapper provides a consistent
   # interface for BinData objects to use when accessing the IO.
   class IO
 
+    # Creates a StringIO around +str+.
+    def self.create_string_io(str = "")
+      if RUBY_VERSION >= "1.9"
+        str = str.dup.force_encoding(Encoding::BINARY)
+      end
+      StringIO.new(str)
+    end
+
     # Create a new IO wrapper around +io+.  +io+ must support #read if used
     # for reading, #write if used for writing, #pos if reading the current
     # stream position and #seek if setting the current stream position.  If
@@ -25,7 +35,7 @@ module BinData
 
       # wrap strings in a StringIO
       if io.respond_to?(:to_str)
-        io = StringIO.new(io)
+        io = BinData::IO.create_string_io(io.to_str)
       end
 
       @raw_io = io

data/lib/bindata/params.rb

@@ -6,6 +6,16 @@ module BinData
   # mandatory, optional, default or mutually exclusive.
   class AcceptedParameters
 
+    def self.invalid_parameter_names
+      unless defined? @invalid_names
+        all_names = LazyEvaluator.instance_methods(true) + Kernel.methods
+        all_names.collect! { |name| name.to_s }
+        allowed_names = ["type"]
+        @invalid_names = all_names - allowed_names
+      end
+      @invalid_names
+    end
+
     def initialize(ancestor_params = nil)
       @mandatory = ancestor_params ? ancestor_params.mandatory : []
       @optional  = ancestor_params ? ancestor_params.optional  : []
@@ -59,8 +69,7 @@ module BinData
     private
 
     def ensure_valid_names(names)
-      invalid_names = LazyEvaluator.instance_methods(true) +
-                        Kernel.methods - ["type"]
+      invalid_names = self.class.invalid_parameter_names
       names.each do |name|
         name = name.to_s
         if invalid_names.include?(name)

data/lib/bindata/primitive.rb

@@ -72,12 +72,13 @@ module BinData
         if [:little, :big].include?(endian)
           @endian = endian
         elsif endian != nil
-          raise ArgumentError, "unknown value for endian '#{endian}'", caller(1)
+          raise ArgumentError,
+                  "unknown value for endian '#{endian}' in #{self}", caller(1)
         end
         @endian
       end
 
-      def method_missing(symbol, *args)
+      def method_missing(symbol, *args) #:nodoc:
         name, params = args
 
         type = symbol
@@ -87,7 +88,7 @@ module BinData
         append_field(type, name, params)
       end
 
-      def sanitize_parameters!(params, sanitizer)
+      def sanitize_parameters!(params, sanitizer) #:nodoc:
         struct_params = {}
         struct_params[:fields] = fields
         struct_params[:endian] = endian unless endian.nil?
@@ -110,17 +111,17 @@ module BinData
         ensure_valid_name(name)
 
         fields.add_field(type, name, params)
-      rescue TypeError
-        raise TypeError, "unknown type '#{type}' for #{self}", caller(2)
+      rescue UnknownTypeError => err
+        raise TypeError, "unknown type '#{err.message}' for #{self}", caller(2)
       end
 
       def ensure_valid_name(name)
         if fields.field_names.include?(name)
           raise SyntaxError, "duplicate field '#{name}' in #{self}", caller(3)
         end
-        if self.instance_methods.include?(name)
+        if self.instance_methods.collect { |meth| meth.to_s }.include?(name)
           raise NameError.new("", name),
-                "field '#{name}' shadows an existing method", caller(3)
+                "field '#{name}' shadows an existing method in #{self}", caller(3)
         end
       end
     end
@@ -133,16 +134,16 @@ module BinData
       @struct = BinData::Struct.new(get_parameter(:struct_params), self)
     end
 
-    def method_missing(symbol, *args, &block)
+    def method_missing(symbol, *args, &block) #:nodoc:
       @struct.__send__(symbol, *args, &block)
     end
 
-    def debug_name_of(child)
+    def debug_name_of(child) #:nodoc:
       debug_name + "-internal-"
     end
 
-    def offset_of(child)
-      offset
+    def offset_of(child) #:nodoc:
+      @struct.offset_of(child)
     end
 
     #---------------

data/lib/bindata/record.rb

@@ -56,7 +56,8 @@ module BinData
         if [:little, :big].include?(endian)
           @endian = endian
         elsif endian != nil
-          raise ArgumentError, "unknown value for endian '#{endian}'", caller(1)
+          raise ArgumentError,
+                  "unknown value for endian '#{endian}' in #{self}", caller(1)
         end
         @endian
       end
@@ -67,7 +68,7 @@ module BinData
         @hide
       end
 
-      def method_missing(symbol, *args)
+      def method_missing(symbol, *args) #:nodoc:
         name, params = args
 
         type = symbol
@@ -77,7 +78,7 @@ module BinData
         append_field(type, name, params)
       end
 
-      def sanitize_parameters!(params, sanitizer)
+      def sanitize_parameters!(params, sanitizer) #:nodoc:
         params[:fields] = fields
         params[:endian] = endian unless endian.nil?
         params[:hide]   = hide   unless hide.empty?
@@ -100,21 +101,21 @@ module BinData
         ensure_valid_name(name)
 
         fields.add_field(type, name, params)
-      rescue TypeError
-        raise TypeError, "unknown type '#{type}' for #{self}", caller(2)
+      rescue UnknownTypeError => err
+        raise TypeError, "unknown type '#{err.message}' for #{self}", caller(2)
       end
 
       def ensure_valid_name(name)
         if fields.field_names.include?(name)
           raise SyntaxError, "duplicate field '#{name}' in #{self}", caller(3)
         end
-        if self.instance_methods.include?(name)
+        if self.instance_methods.collect { |meth| meth.to_s }.include?(name)
           raise NameError.new("", name),
-                "field '#{name}' shadows an existing method", caller(3)
+                "field '#{name}' shadows an existing method in #{self}", caller(3)
         end
         if self::RESERVED.include?(name)
           raise NameError.new("", name),
-                "field '#{name}' is a reserved name", caller(3)
+                "field '#{name}' is a reserved name in #{self}", caller(3)
         end
       end
     end

data/lib/bindata/sanitize.rb

@@ -2,6 +2,8 @@ require 'bindata/registry'
 
 module BinData
 
+  class UnknownTypeError < StandardError ; end
+
   # A BinData object accepts arbitrary parameters.  This class sanitizes
   # those parameters so they can be used by the BinData object.
   class SanitizedParameters
@@ -169,7 +171,7 @@ module BinData
     def lookup_class(type)
       registered_class = RegisteredClasses.lookup(type, @endian)
       if registered_class.nil?
-        raise TypeError, "unknown type '#{type}'"
+        raise UnknownTypeError, type.to_s
       end
       registered_class
     end

data/lib/bindata/string.rb

@@ -1,7 +1,7 @@
 require "bindata/base_primitive"
 
 module BinData
-  # A String is a sequence of bytes.  This is the same as strings in Ruby.
+  # A String is a sequence of bytes.  This is the same as strings in Ruby 1.8.
   # The issue of character encoding is ignored by this class.
   #
   #   require 'bindata'
@@ -56,7 +56,7 @@ module BinData
 
     class << self
 
-      def sanitize_parameters!(params, sanitizer)
+      def sanitize_parameters!(params, sanitizer) #:nodoc:
         warn_replacement_parameter(params, :initial_length, :read_length)
 
         if params.has_parameter?(:pad_char)
@@ -69,7 +69,7 @@ module BinData
       private
 
       def sanitized_pad_char(ch)
-        result = ch.respond_to?(:chr) ? ch.chr : ch.to_s
+        result = ch.is_a?(Integer) ? ch.chr : ch.to_s
         if result.length > 1
           raise ArgumentError, ":pad_char must not contain more than 1 char"
         end
@@ -80,6 +80,11 @@ module BinData
     #---------------
     private
 
+    def _assign(val)
+      val = val.dup.force_encoding(Encoding::BINARY) if RUBY_VERSION >= "1.9"
+      super(val)
+    end
+
     def _snapshot
       # override to ensure length and optionally trim padding
       result = super

data/lib/bindata/stringz.rb

@@ -34,6 +34,11 @@ module BinData
     #---------------
     private
 
+    def _assign(val)
+      val = val.dup.force_encoding(Encoding::BINARY) if RUBY_VERSION >= "1.9"
+      super(val)
+    end
+
     def _snapshot
       # override to always remove trailing zero bytes
       result = super
@@ -65,12 +70,12 @@ module BinData
     end
 
     def trim_and_zero_terminate(str)
-      str = truncate_at_first_zero_byte(str)
+      str = truncate_after_first_zero_byte(str)
       str = trim_to(str, eval_parameter(:max_length))
       append_zero_byte_if_needed(str)
     end
 
-    def truncate_at_first_zero_byte(str)
+    def truncate_after_first_zero_byte(str)
       str.sub(/([^\0]*\0).*/, '\1')
     end
 

data/lib/bindata/struct.rb

@@ -49,7 +49,7 @@ module BinData
     register(self.name, self)
 
     # These reserved words may not be used as field names
-    RESERVED = (::Hash.instance_methods + 
+    RESERVED = (::Hash.instance_methods.collect { |meth| meth.to_s } + 
                 %w{alias and begin break case class def defined do else elsif
                    end ensure false for if in module next nil not or redo
                    rescue retry return self super then true undef unless until
@@ -69,7 +69,7 @@ module BinData
 
     class << self
 
-      def sanitize_parameters!(params, sanitizer)
+      def sanitize_parameters!(params, sanitizer) #:nodoc:
         sanitize_endian(params, sanitizer)
         sanitize_fields(params, sanitizer)
         sanitize_hide(params, sanitizer)
@@ -116,7 +116,7 @@ module BinData
       end
 
       def ensure_field_names_are_valid(field_names)
-        instance_methods = self.instance_methods
+        instance_methods = self.instance_methods.collect { |meth| meth.to_s }
         reserved_names = RESERVED
 
         field_names.each do |name|
@@ -146,11 +146,11 @@ module BinData
       @field_objs  = []
     end
 
-    def clear
+    def clear #:nodoc:
       @field_objs.each { |f| f.clear unless f.nil? }
     end
 
-    def clear?
+    def clear? #:nodoc:
       @field_objs.inject(true) { |all_clear, f| all_clear and (f.nil? or f.clear?) }
     end
 
@@ -166,12 +166,12 @@ module BinData
       end
     end
 
-    def respond_to?(symbol, include_private = false)
+    def respond_to?(symbol, include_private = false) #:nodoc:
       super(symbol, include_private) ||
         field_names(true).include?(symbol.to_s.chomp("="))
     end
 
-    def method_missing(symbol, *args, &block)
+    def method_missing(symbol, *args, &block) #:nodoc:
       obj = find_obj_for_name(symbol)
       if obj
         invoke_field(obj, symbol, args)
@@ -180,17 +180,15 @@ module BinData
       end
     end
 
-    def debug_name_of(child)
+    def debug_name_of(child) #:nodoc:
       field_name = @field_names[find_index_of(child)]
       "#{debug_name}.#{field_name}"
     end
 
-    def offset_of(child)
+    def offset_of(child) #:nodoc:
       instantiate_all_objs
       sum = sum_num_bytes_below_index(find_index_of(child))
-      child_offset = child.do_num_bytes.is_a?(Integer) ? sum.ceil : sum.floor
-
-      offset + child_offset
+      child.do_num_bytes.is_a?(Integer) ? sum.ceil : sum.floor
     end
 
     #---------------
@@ -247,7 +245,7 @@ module BinData
       @field_objs.each { |f| f.do_write(io) if include_obj(f) }
     end
 
-    def _do_num_bytes(deprecated)
+    def _do_num_bytes
       instantiate_all_objs
       sum_num_bytes_for_all_fields.ceil
     end

data/lib/bindata/wrapper.rb

@@ -32,19 +32,20 @@ module BinData
         if [:little, :big].include?(endian)
           @endian = endian
         elsif endian != nil
-          raise ArgumentError, "unknown value for endian '#{endian}'", caller(1)
+          raise ArgumentError,
+                  "unknown value for endian '#{endian}' in #{self}", caller(1)
         end
         @endian
       end
 
-      def method_missing(symbol, *args)
+      def method_missing(symbol, *args) #:nodoc:
         type = symbol
         params = args.length == 0 ? {} : args[0]
 
         set_wrapped(type, params)
       end
 
-      def sanitize_parameters!(params, sanitizer)
+      def sanitize_parameters!(params, sanitizer) #:nodoc:
         raise "Nothing to wrap" unless defined? @wrapped
 
         wrapped_type, wrapped_params = @wrapped
@@ -81,27 +82,19 @@ module BinData
       @wrapped = prototype.instantiate(self)
     end
 
-    def clear
+    def clear #:nodoc:
       wrapped.clear
     end
 
-    def clear?
+    def clear? #:nodoc:
       wrapped.clear?
     end
 
-    def debug_name_of(child)
-      debug_name
-    end
-
-    def offset_of(child)
-      offset
-    end
-
-    def respond_to?(symbol, include_private = false)
+    def respond_to?(symbol, include_private = false) #:nodoc:
       super || wrapped.respond_to?(symbol, include_private)
     end
 
-    def method_missing(symbol, *args, &block)
+    def method_missing(symbol, *args, &block) #:nodoc:
       wrapped.__send__(symbol, *args, &block)
     end
 
@@ -124,8 +117,8 @@ module BinData
       wrapped.do_write(io)
     end
 
-    def _do_num_bytes(deprecated)
-      wrapped.do_num_bytes(deprecated)
+    def _do_num_bytes
+      wrapped.do_num_bytes
     end
 
     def _assign(val)

data/manual.haml

@@ -0,0 +1,301 @@
+!!!
+%html{ :xmlns => "http://www.w3.org/1999/xhtml" }
+  %head
+    %meta{ :content => "text/html; charset=iso-8859-1", "http-equiv" => "Content-Type" }
+    %title
+      BinData Reference Manual
+    :javascript
+      var TINY={};function T$(i){return document.getElementById(i)}function T$$(e,p){return p.getElementsByTagName(e)}TINY.accordion=function(){function slider(n){this.n=n;this.a=[]}slider.prototype.init=function(t,e,m,o,k){var a=T$(t),i=s=0,n=a.childNodes,l=n.length;this.s=k||0;this.m=m||0;for(i;i<l;i++){var v=n[i];if(v.nodeType!=3){this.a[s]={};this.a[s].h=h=T$$(e,v)[0];this.a[s].c=c=T$$('div',v)[0];h.onclick=new Function(this.n+'.pr(0,'+s+')');if(o==s){h.className=this.s;c.style.height='auto';c.d=1}else{c.style.height=0;c.d=-1}s++}}this.l=s};slider.prototype.pr=function(f,d){for(var i=0;i<this.l;i++){var h=this.a[i].h,c=this.a[i].c,k=c.style.height;k=k=='auto'?1:parseInt(k);clearInterval(c.t);if((k!=1&&c.d==-1)&&(f==1||i==d)){c.style.height='';c.m=c.offsetHeight;c.style.height=k+'px';c.d=1;h.className=this.s;su(c,1)}else if(k>0&&(f==-1||this.m||i==d)){c.d=-1;h.className='';su(c,-1)}}};function su(c){c.t=setInterval(function(){sl(c)},20)};function sl(c){var h=c.offsetHeight,d=c.d==1?c.m-h:h;c.style.height=h+(Math.ceil(d/5)*c.d)+'px';c.style.opacity=h/c.m;c.style.filter='alpha(opacity='+h*100/c.m+')';if((c.d==1&&h>=c.m)||(c.d!=1&&h==1)){if(c.d==1){c.style.height='auto'}clearInterval(c.t)}};return{slider:slider}}();
+
+      var menu1, menu2, menu3, menu4, menu5, menu6;
+      var menu7, menu8, menu9, menu10, menu11;
+
+      function init_accordion() {
+        menu1 = new TINY.accordion.slider("menu1"); menu1.init("menu1","a",1,0);
+        menu2 = new TINY.accordion.slider("menu2"); menu2.init("menu2","a",1,-1);
+        menu3 = new TINY.accordion.slider("menu3"); menu3.init("menu3","a",1,-1);
+        menu4 = new TINY.accordion.slider("menu4"); menu4.init("menu4","a",1,-1);
+        menu5 = new TINY.accordion.slider("menu5"); menu5.init("menu5","a",1,-1);
+        menu6 = new TINY.accordion.slider("menu6"); menu6.init("menu6","a",1,-1);
+        menu7 = new TINY.accordion.slider("menu7"); menu7.init("menu7","a",1,-1);
+        menu8 = new TINY.accordion.slider("menu8"); menu8.init("menu8","a",1,-1);
+        menu9 = new TINY.accordion.slider("menu9"); menu9.init("menu9","a",1,-1);
+        menu10 = new TINY.accordion.slider("menu10"); menu10.init("menu10","a",1,-1);
+        menu11 = new TINY.accordion.slider("menu11"); menu11.init("menu11","a",1,-1);
+      };
+      window.onload = init_accordion;
+
+    %style{:type => "text/css", :media => "screen"}
+      :plain
+        body {
+          margin:0; padding:0; border:0;
+          height:100%; max-height:100%;
+          overflow:hidden;
+          background-color:#FFF;
+        }
+
+        #left_frame {
+          position:absolute; overflow:hidden;
+          top:0; bottom:0; left:0;
+          width:240px; height:100%;
+        }
+
+        #main_frame {
+          position:fixed; overflow:auto;
+          top:0; right:0; bottom:0; left:240px;
+        }
+
+        * html body { /*IE6 hack*/
+          padding: 0 0 0 240px;
+        }
+        * html #main_frame { /*IE6 hack*/
+          height: 100%; width: 100%;
+        }
+
+        .menu_top_level {margin:5px;}
+        .menu_top_level ul {list-style:none; margin:0; padding:0;}
+        .menu_top_level li {margin-top:5px;}
+        .menu_top_level .acc-section {overflow:hidden;}
+        .menu_top_level .acc-content {width:100%; margin:0; padding:0; background:#FFF}
+
+        .menu_top_level li a {
+          display:block; cursor:pointer; text-decoration: none;
+          border:1px solid #9BC;
+          padding: 0;
+          font:bold 12px/2 Verdana, Arial, Helvetica;
+        }
+        .menu_top_level li a:link, .menu_top_level li a:visited { color: #131; background:#FFE;}
+        .menu_top_level li a:hover {background: #9C9; color:#FFE;}
+
+        .menu_top_level .level1 li a { padding-left: 15px; }
+        .menu_top_level .level2 li a { padding-left: 30px; }
+        .menu_top_level .level3 li a { padding-left: 45px; }
+
+        #main_content {
+          margin: 20px; padding-left: 3em;
+          width: 40em;
+          font-family: Georgia, Times;
+        }
+
+        #main_content h1 { margin-left: -1em;}
+        #main_content h2 { margin-left: -1em;}
+
+        #main_content pre {
+          margin-left: 2em; padding: 4px;
+          background-color: #EFF;
+          border: solid 1px #BDD;
+        }
+
+        #main_content .ruby .normal {}
+        #main_content .ruby .comment { color: #005; font-style: italic; }
+        #main_content .ruby .keyword { color: #A00; font-weight: bold; }
+        #main_content .ruby .method { color: #077; }
+        #main_content .ruby .class { color: #074; }
+        #main_content .ruby .module { color: #050; }
+        #main_content .ruby .punct { color: #447; font-weight: bold; }
+        #main_content .ruby .symbol { color: #099; }
+        #main_content .ruby .string { color: #944; background: #FFE; }
+        #main_content .ruby .char { color: #F07; }
+        #main_content .ruby .ident { color: #004; }
+        #main_content .ruby .constant { color: #07F; }
+        #main_content .ruby .regex { color: #B66; background: #FEF; }
+        #main_content .ruby .number { color: #F99; }
+        #main_content .ruby .attribute { color: #7BB; }
+        #main_content .ruby .global { color: #7FB; }
+        #main_content .ruby .expr { color: #227; }
+        #main_content .ruby .escape { color: #277; }
+
+  %body
+    #left_frame
+      .menu_top_level
+        %ul.level1#menu1
+          %li
+            %a{ :href => "#bindata" }
+              BinData
+            .acc-section
+              .acc-content
+                %ul.level2#menu2
+                  %li
+                    %a{ :href => "#what_is_it_for" }
+                      What is it for?
+                    .acc-section
+                      .acc-content
+                  %li
+                    %a{ :href => "#license" }
+                      License
+                    .acc-section
+                      .acc-content
+          %li
+            %a{ :href => "#overview" }
+              Overview
+            .acc-section
+              .acc-content
+          %li
+            %a{ :href => "#common_operations" }
+              Common Operations
+            .acc-section
+              .acc-content
+                %ul.level2#menu3
+                  %li
+                    %a{ :href => "#reading_and_writing" }
+                      Reading and writing
+                    .acc-section
+                      .acc-content
+                  %li
+                    %a{ :href => "#manipulating" }
+                      Manipulating
+                    .acc-section
+                      .acc-content
+                  %li
+                    %a{ :href => "#inspecting" }
+                      Inspecting
+                    .acc-section
+                      .acc-content
+          %li
+            %a{ :href => "#records" }
+              Records
+            .acc-section
+              .acc-content
+                %ul.level2#menu4
+                  %li
+                    %a{ :href => "#specifying_default_endian" }
+                      Specifying default endian
+                    .acc-section
+                      .acc-content
+                  %li
+                    %a{ :href => "#optional_fields" }
+                      Optional fields
+                    .acc-section
+                      .acc-content
+                  %li
+                    %a{ :href => "#handling_dependencies_between_fields" }
+                      Handling dependencies between fields
+                    .acc-section
+                      .acc-content
+          %li
+            %a{ :href => "#primitive_types" }
+              Primitive Types
+            .acc-section
+              .acc-content
+                %ul.level2#menu5
+                  %li
+                    %a{ :href => "#numerics" }
+                      Numerics
+                    .acc-section
+                      .acc-content
+                        %ul.level3#menu6
+                          %li
+                            %a{ :href => "#byte_based_integers" }
+                              Byte based integers
+                            .acc-section
+                              .acc-content
+                          %li
+                            %a{ :href => "#bit_based_integers" }
+                              Bit based integers
+                            .acc-section
+                              .acc-content
+                          %li
+                            %a{ :href => "#floating_point_numbers" }
+                              Floating point numbers
+                            .acc-section
+                              .acc-content
+                          %li
+                            %a{ :href => "#example" }
+                              Example
+                            .acc-section
+                              .acc-content
+                  %li
+                    %a{ :href => "#strings" }
+                      Strings
+                    .acc-section
+                      .acc-content
+                        %ul.level3#menu7
+                          %li
+                            %a{ :href => "#fixed_sized_strings" }
+                              Fixed Sized Strings
+                            .acc-section
+                              .acc-content
+                          %li
+                            %a{ :href => "#zero_terminated_strings" }
+                              Zero Terminated Strings
+                            .acc-section
+                              .acc-content
+                  %li
+                    %a{ :href => "#user_defined_primitive_types" }
+                      User Defined Primitive Types
+                    .acc-section
+                      .acc-content
+                        %ul.level3#menu8
+                          %li
+                            %a{ :href => "#advanced_user_defined_primitive_types" }
+                              Advanced User Defined Primitive Types
+                            .acc-section
+                              .acc-content
+          %li
+            %a{ :href => "#arrays" }
+              Arrays
+            .acc-section
+              .acc-content
+          %li
+            %a{ :href => "#choices" }
+              Choices
+            .acc-section
+              .acc-content
+          %li
+            %a{ :href => "#advanced_topics" }
+              Advanced Topics
+            .acc-section
+              .acc-content
+                %ul.level2#menu9
+                  %li
+                    %a{ :href => "#wrappers" }
+                      Wrappers
+                    .acc-section
+                      .acc-content
+                  %li
+                    %a{ :href => "#parameterizing_user_defined_types" }
+                      Parameterizing User Defined Types
+                    .acc-section
+                      .acc-content
+                        %ul.level3#menu10
+                          %li
+                            %a{ :href => "#mandatory_parameters" }
+                              Mandatory Parameters
+                            .acc-section
+                              .acc-content
+                          %li
+                            %a{ :href => "#default_parameters" }
+                              Default Parameters
+                            .acc-section
+                              .acc-content
+                  %li
+                    %a{ :href => "#debugging" }
+                      Debugging
+                    .acc-section
+                      .acc-content
+                        %ul.level3#menu11
+                          %li
+                            %a{ :href => "#tracing" }
+                              Tracing
+                            .acc-section
+                              .acc-content
+                          %li
+                            %a{ :href => "#rest" }
+                              Rest
+                            .acc-section
+                              .acc-content
+                          %li
+                            %a{ :href => "#hidden_fields" }
+                              Hidden fields
+                            .acc-section
+                              .acc-content
+          %li
+            %a{ :href => "#alternatives" }
+              Alternatives
+            .acc-section
+              .acc-content
+    #main_frame
+      #main_content
+        :maruku
+          #{File.read("README")}
+