merb-core 0.9.13 → 1.0

data/lib/merb-core/controller/mixins/render.rb

@@ -20,7 +20,7 @@ module Merb::RenderMixin
     # ==== Returns
     # Hash:: An options hash
     #
-    # @api public
+    # :api: public
     def default_render_options
       self._default_render_options ||= {}
     end
@@ -30,7 +30,7 @@ module Merb::RenderMixin
     # ==== Parameters
     # opts<Hash>:: An options hash
     #
-    # @api public
+    # :api: public
     def render_options(opts)
       self._default_render_options = opts
     end
@@ -47,7 +47,7 @@ module Merb::RenderMixin
     # ==== Returns
     # Hash:: The default render options.
     #
-    # @api public
+    # :api: public
     def layout(layout)
       self.default_render_options.update(:layout => (layout || false))
     end
@@ -57,7 +57,7 @@ module Merb::RenderMixin
     # ==== Returns
     # ~to_s:: The layout that was previously set.
     #
-    # @api public
+    # :api: public
     def default_layout
       self.default_render_options.delete(:layout)
     end
@@ -96,7 +96,7 @@ module Merb::RenderMixin
   # If you pass a Hash as the first parameter, it will be moved to opts and
   # "thing" will be the current action
   #
-  # @api public
+  # :api: public
   def render(thing = nil, opts = {})
     # render :format => :xml means render nil, :format => :xml
     opts, thing = thing, nil if thing.is_a?(Hash)
@@ -201,7 +201,7 @@ module Merb::RenderMixin
   # The transformed object will not be used in a layout unless a :layout is
   # explicitly passed in the opts.
   #
-  # @api public
+  # :api: public
   def display(object, thing = nil, opts = {})
     template_opt = thing.is_a?(Hash) ? thing.delete(:template) : opts.delete(:template)
 
@@ -283,7 +283,7 @@ module Merb::RenderMixin
   # In this case, "one" will be available in the partial through the local
   # variable named +number+.
   #
-  # @api public
+  # :api: public
   def partial(template, opts={})
 
     # partial :foo becomes "#{controller_name}/_foo"
@@ -340,7 +340,7 @@ module Merb::RenderMixin
   # ==== Returns
   # Hash:: The options hash that was passed in.
   #
-  # @api private
+  # :api: private
   def _handle_options!(opts)
     self.status = opts.delete(:status).to_i if opts[:status]
     headers["Location"] = opts.delete(:location) if opts[:location]
@@ -365,7 +365,7 @@ module Merb::RenderMixin
   #   one in to this method), and not found. No error will be raised if no
   #   layout was specified, and the default layouts were not found.
   #
-  # @api private
+  # :api: private
   def _get_layout(layout = nil)
     return false if layout == false
     
@@ -406,7 +406,7 @@ module Merb::RenderMixin
   # Array[Symbol, String]::
   #   A pair consisting of the template method and location.
   #
-  # @api private
+  # :api: private
   def _template_for(context, content_type, controller=nil, template=nil, locals=[])
     template_method, template_location = nil, nil
 
@@ -442,7 +442,7 @@ module Merb::RenderMixin
   # ==== Returns
   # String:: The method, if it exists. Otherwise return nil.
   #
-  # @api private
+  # :api: private
   def _template_method_for(template_location, locals)
     meth = Merb::Template.template_for(template_location, [], locals)
     meth && self.respond_to?(meth) ? meth : nil
@@ -456,7 +456,7 @@ module Merb::RenderMixin
   # ==== Parameters
   # obj<Object>:: The key in the thrown_content hash. Defaults to :for_layout.
   #
-  # @api public
+  # :api: public
   def catch_content(obj = :for_layout)
     @_caught_content[obj] || ''
   end
@@ -466,7 +466,7 @@ module Merb::RenderMixin
   # ==== Parameters
   # obj<Object>:: The key in the thrown_content hash. Defaults to :for_layout.
   #
-  # @api public
+  # :api: public
   def thrown_content?(obj = :for_layout)
     @_caught_content.key?(obj)
   end
@@ -488,7 +488,7 @@ module Merb::RenderMixin
   #   throw_content(:foo, "Foo")
   #   catch_content(:foo) #=> "Foo"
   #
-  # @api public
+  # :api: public
   def throw_content(obj, string = nil, &block)
     unless string || block_given?
       raise ArgumentError, "You must pass a block or a string into throw_content"
@@ -508,7 +508,7 @@ module Merb::RenderMixin
   # @raise [ArgumentError]
   #   Neither string nor block given
   #
-  # @api public
+  # :api: public
   def append_content(obj, string = nil, &block)
     unless string || block_given?
       raise ArgumentError, "You must pass a block or a string into append_content"
@@ -524,7 +524,7 @@ module Merb::RenderMixin
   # ==== Parameters
   # obj<Object>:: The key in the thrown_content hash. Defaults to :for_layout.
   #
-  # @api public
+  # :api: public
   def clear_content(obj = :for_layout)
     @_caught_content.delete(obj) unless @_caught_content[obj].nil?
   end

data/lib/merb-core/controller/mixins/responder.rb

@@ -105,7 +105,7 @@ module Merb
     # ==== Parameters
     # base<Module>:: The module that ResponderMixin was mixed into
     #
-    # @api private
+    # :api: private
     def self.included(base)
       base.extend(ClassMethods)
       base.class_eval do
@@ -133,7 +133,7 @@ module Merb
       # ==== Examples
       #   provides :html, :xml
       #
-      # @api public
+      # :api: public
       def provides(*formats)
         self.class_provided_formats |= formats
       end
@@ -147,7 +147,7 @@ module Merb
       # ==== Returns
       # Array[Symbol]:: List of formats passed in.      
       #
-      # @api public
+      # :api: public
       def only_provides(*formats)
         clear_provides
         provides(*formats)
@@ -163,7 +163,7 @@ module Merb
       # Array[Symbol]::
       #   List of formats that remain after removing the ones not to provide.
       #
-      # @api public
+      # :api: public
       def does_not_provide(*formats)
         self.class_provided_formats -= formats
       end
@@ -173,7 +173,7 @@ module Merb
       # ==== Returns
       # Array:: An empty Array.
       #
-      # @api public
+      # :api: public
       def clear_provides
         self.class_provided_formats.clear
       end
@@ -183,7 +183,7 @@ module Merb
       # ==== Returns
       # Array[Symbol]:: [:html].
       #
-      # @api public
+      # :api: public
       def reset_provides
         only_provides(:html)
       end
@@ -195,7 +195,7 @@ module Merb
     #   controller. It starts with what has been set in the controller (or
     #   :html by default) but can be modifed on a per-action basis.      
     #
-    # @api private
+    # :api: private
     def _provided_formats
       @_provided_formats ||= class_provided_formats.dup
     end
@@ -215,7 +215,7 @@ module Merb
     # ==== Returns
     # Array[Symbol]:: List of formats passed in.
     #
-    # @api public
+    # :api: public
     def provides(*formats)
       if @_content_type
         raise ContentTypeAlreadySet, "Cannot modify provided_formats because content_type has already been set"
@@ -234,7 +234,7 @@ module Merb
     # ==== Returns
     # Array[Symbol]:: List of formats passed in.
     #
-    # @api public
+    # :api: public
     def only_provides(*formats)
       @_provided_formats = []
       provides(*formats)
@@ -252,7 +252,7 @@ module Merb
     # Array[Symbol]::
     #   List of formats that remain after removing the ones not to provide.
     #
-    # @api public
+    # :api: public
     def does_not_provide(*formats)
       @_provided_formats -= formats.flatten
     end
@@ -264,7 +264,7 @@ module Merb
     # 4. Look for one that is provided, in order of request
     # 5. Raise 406 if none found
     #
-    # @api private
+    # :api: private
     def _perform_content_negotiation
       if (fmt = params[:format]) && !fmt.empty?
         accepts = [fmt.to_sym]
@@ -312,7 +312,7 @@ module Merb
     # ==== Returns
     # Symbol:: The content-type that will be used for this controller.
     #
-    # @api public
+    # :api: public
     def content_type(fmt = nil)
       self.content_type = (fmt || _perform_content_negotiation) unless @_content_type
       @_content_type
@@ -331,7 +331,7 @@ module Merb
     # ==== Returns
     # Symbol:: The content-type that was passed in.
     #
-    # @api plugin
+    # :api: plugin
     def content_type=(type)
       unless Merb.available_mime_types.has_key?(type)
         raise Merb::ControllerExceptions::NotAcceptable.new("Unknown content_type for response: #{type}") 
@@ -384,7 +384,7 @@ module Merb
     #   The index used for sorting accept types. A lower value indicates higher
     #   priority.
     # 
-    # @api private
+    # :api: private
     def initialize(entry,index)
       @index = index
       
@@ -407,7 +407,7 @@ module Merb
     #   -1, 0 or 1, depending on whether entry has a lower, equal or higher
     #   priority than the accept type being compared.
     #
-    # @api private
+    # :api: private
     def <=>(entry)
       if entry.quality == quality
         @index <=> entry.index
@@ -425,27 +425,27 @@ module Merb
     #   True if the accept types are equal, i.e. if the synonyms for this
     #   accept type includes the entry media range.
     #
-    # @api private
+    # :api: private
     def eql?(entry)
       synonyms.include?(entry.media_range)
     end
 
     # An alias for eql?.
     #
-    # @api private
+    # :api: private
     def ==(entry); eql?(entry); end
 
     # ==== Returns
     # Fixnum:: A hash based on the super range.
     #
-    # @api private
+    # :api: private
     def hash; super_range.hash; end
 
     # ==== Returns
     # Array[String]::
     #   All Accept header values, such as "text/html", that match this type.
     #
-    # @api private
+    # :api: private
     def synonyms
       return @syns if @syns
       if _mime = mime
@@ -455,7 +455,7 @@ module Merb
       end
     end
     
-    # @api private
+    # :api: private
     def mime
       @mime ||= Merb.available_mime_types[Merb::ResponderMixin::MIMES[@media_range]]
     end
@@ -465,7 +465,7 @@ module Merb
     #   The primary media range for this accept type, i.e. either the first
     #   synonym or, if none exist, the media range.
     #
-    # @api private
+    # :api: private
     def super_range
       synonyms.first || @media_range
     end
@@ -473,7 +473,7 @@ module Merb
     # ==== Returns
     # Symbol: The type as a symbol, e.g. :html.
     #
-    # @api private
+    # :api: private
     def to_sym
       Merb.available_mime_types.select{|k,v| 
         v[:accepts] == synonyms || v[:accepts][0] == synonyms[0]}.flatten.first
@@ -482,7 +482,7 @@ module Merb
     # ==== Returns
     # String:: The accept type as a string, i.e. the media range.
     #
-    # @api private
+    # :api: private
     def to_s
       @media_range
     end

data/lib/merb-core/controller/template.rb

@@ -26,7 +26,7 @@ module Merb::Template
     # character replaced based on the non-alphanumeric character
     # to avoid edge-case collisions.
     #
-    # @api private
+    # :api: private
     def template_name(path)
       path = File.expand_path(path)      
       path.gsub(/[^\.a-zA-Z0-9]/, "__").gsub(/\./, "_")
@@ -48,7 +48,7 @@ module Merb::Template
     # ==== Returns
     # IO#path:: An IO object that responds to path (File or VirtualFile).
     #
-    # @api plugin
+    # :api: plugin
     # @overridable
     def load_template_io(path)
       File.open(path, "r")
@@ -64,7 +64,7 @@ module Merb::Template
     # ==== Returns
     # <String>:: name of the method that inlines the template.
     #
-    # @api private
+    # :api: private
     def template_for(path, template_stack = [], locals=[])
       path = File.expand_path(path)
       
@@ -85,7 +85,7 @@ module Merb::Template
     # ==== Returns
     # Boolean:: Whether or not the template for the provided path needs to be recompiled
     #
-    # @api private
+    # :api: private
     def needs_compilation?(path, locals)
       return true if Merb::Config[:reload_templates] || !METHOD_LIST[path]
       
@@ -99,7 +99,7 @@ module Merb::Template
     # ==== Returns
     #   Array:: Extension strings.
     #
-    # @api plugin
+    # :api: plugin
     def template_extensions
       EXTENSIONS.keys
     end
@@ -124,7 +124,7 @@ module Merb::Template
     # Even though this method supports inlining into any module, the method
     # must be available to instances of AbstractController that will use it.
     #
-    # @api private
+    # :api: private
     def inline_template(io, locals=[], mod = Merb::InlineTemplates)
       full_file_path = File.expand_path(io.path)
       engine_neutral_path = full_file_path.gsub(/\.[^\.]*$/, "")
@@ -145,7 +145,7 @@ module Merb::Template
     # ==== Returns
     # Class:: The engine.
     #
-    # @api private
+    # :api: private
     def engine_for(path)
       path = File.expand_path(path)      
       EXTENSIONS[path.match(/\.([^\.]*)$/)[1]]
@@ -169,7 +169,7 @@ module Merb::Template
     # ==== Example
     #   Merb::Template.register_extensions(Merb::Template::Erubis, ["erb"])
     #
-    # @api plugin
+    # :api: plugin
     def register_extensions(engine, extensions) 
       raise ArgumentError, "The class you are registering does not have a compile_template method" unless
         engine.respond_to?(:compile_template)
@@ -189,7 +189,7 @@ module Merb::Template
     # locals<Array[Symbol]>:: A list of locals to assign from the args passed into the compiled template.
     # mod<Module>:: The module that the compiled method will be placed into.
     #
-    # @api private
+    # :api: private
     def self.compile_template(io, name, locals, mod)
       template = ::Erubis::BlockAwareEruby.new(io.read)
       _old_verbose, $VERBOSE = $VERBOSE, nil
@@ -220,7 +220,7 @@ module Merb::Template
       #     <p>Some Foo content!</p> 
       #   <% end %>
       #
-      # @private
+      # :api: private
       def capture_erb(*args, &block)
         _old_buf, @_erb_buf = @_erb_buf, ""
         block.call(*args)
@@ -229,7 +229,7 @@ module Merb::Template
         ret
       end
 
-      # @private
+      # :api: private
       def concat_erb(string, binding)
         @_erb_buf << string
       end
@@ -243,36 +243,36 @@ end
 
 module Erubis
   module BlockAwareEnhancer
-    # @api private
+    # :api: private
     def add_preamble(src)
       src << "_old_buf, @_erb_buf = @_erb_buf, ''; "
       src << "@_engine = 'erb'; "
     end
 
-    # @api private
+    # :api: private
     def add_postamble(src)
       src << "\n" unless src[-1] == ?\n      
       src << "_ret = @_erb_buf; @_erb_buf = _old_buf; _ret.to_s;\n"
     end
 
-    # @api private
+    # :api: private
     def add_text(src, text)
       src << " @_erb_buf.concat('" << escape_text(text) << "'); "
     end
 
-    # @api private
+    # :api: private
     def add_expr_escaped(src, code)
       src << ' @_erb_buf.concat(' << escaped_expr(code) << ');'
     end
     
-    # @api private
+    # :api: private
     def add_stmt2(src, code, tailch)
       src << code
       src << " ).to_s; " if tailch == "="
       src << ';' unless code[-1] == ?\n
     end
     
-    # @api private
+    # :api: private
     def add_expr_literal(src, code)
       if code =~ /(do|\{)(\s*\|[^|]*\|)?\s*\Z/
         src << ' @_erb_buf.concat( ' << code << "; "