Changeset 6031

Show
Ignore:
Timestamp:
11/09/06 17:59:58
Author:
jan
Message:

improved documentation

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved
  • trunk/lib/jerbil.rb

    r6029 r6031  
    88require 'jerbil/jibx_task' 
    99require 'jerbil/hibernate_task' 
    10 require 'jerbil/hibernate_task2' 
  • trunk/lib/jerbil/apt_task.rb

    r6029 r6031  
    5050    end 
    5151     
     52    # this is needed by java - the factory gets stored internally 
     53    # in a map, so it needs to return a hash code. 
    5254    def hashCode # :nodoc: 
    5355      123456 
     
    7981     
    8082    # A convenience method to serialize a list of found annotations  
    81     # to +filename+ using yaml
     83    # to file +filename+ (yaml format)
    8284    def annotated_classes_to_yaml(annotation, filename) 
    8385      find_annotation annotation do |classes| 
     
    107109    end 
    108110     
     111    # Calls all registered handlers. 
    109112    def post_compile 
    110113      super unless nocompile 
     
    115118    end 
    116119     
    117     def get_processor_factory 
     120    def get_processor_factory # :nodoc: 
    118121       Rjb::bind(self, 'com.sun.mirror.apt.AnnotationProcessorFactory') 
    119122    end 
  • trunk/lib/jerbil/hibernate_task.rb

    r6030 r6031  
    102102     end 
    103103      
    104      # Wrapper class around _org.hibernate.tool.hbm2ddl.SchemaExport_. 
     104     # Wrapper class around  
     105     # {org.hibernate.tool.hbm2ddl.SchemaExport.}[http://www.hibernate.org/hib_docs/v3/api/org/hibernate/tool/hbm2ddl/SchemaExport.html] 
    105106     class SchemaExporter 
    106107       def initialize(classes, outputfile, dialect, package=nil) 
  • trunk/lib/jerbil/java_helper.rb

    r6029 r6031  
    122122  end 
    123123   
    124   # Tasks including this module can specifiy additional 
    125   # Java style arguments (like -verbose, -gc). 
     124  # Tasks including this module can easily specify additional 
     125  # Java-style arguments (like -verbose, -gc). 
    126126  #  
    127127  # == Example 
    128128  # 
    129129  #     Jerbil::MyExtraArgumentTakingTask.new do |t| 
    130   #       t.foo = 'baz
     130  #       t.source = '1.5
    131131  #       t.options :wibble, :wobble 
    132132  #     end 
    133133  # 
    134   # results in a command line of the form "-foo baz -wibble -wobble".   
     134  # results in a command line of the form "-source 1.5 -wibble -wobble".   
    135135  module ExtraArgumentTaking       
    136136      def self.append_features(base) 
     
    256256  # A MultiJavaFileList is a container object for holding several JavaFileList 
    257257  # objects. This is useful for multidirectory builds. 
     258  # 
     259  # == Example 
     260  #   SOURCE_DIR = "src" 
     261  #   MODULES    = [ "a", "b" ] 
     262  #   JAVA_BUILD_DIR = "classes" 
     263  #   JAVA_FILES = MultiJavaFileList.new(MODULES, JAVA_BUILD_DIR, SOURCE_DIR) 
     264  # 
     265  # This will look for source files in +a/src+ and +b/src+, compiling into +classes+. 
    258266  class MultiJavaFileList 
    259267   
  • trunk/lib/jerbil/java_task.rb

    r6029 r6031  
    99  #     Jerbil::JavaTask.new(:run, "jerbil.sample.Main") do |t| 
    1010  #       t.classpath = CLASSPATH 
    11   #       t.parameters = [ "-foo", "baz" ]        
    12   #       t.sys_property "jerbil.foo", "baz" 
     11  #       t.parameters = [ "--quiet" ]        
     12  #       t.max_mem = 64 
    1313  #       t.fork = true 
    1414  #       t.depends_on :compile 
  • trunk/lib/jerbil/javac_task.rb

    r6029 r6031  
    44 
    55module Jerbil 
     6  # Compiles Java source files.  
     7  # The location of the source files and the destionation directory is encapsulated 
     8  # in a JavaFileList. 
     9  # 
    610  # == Example 
    711  # 
  • trunk/lib/jerbil/testng_task.rb

    r6029 r6031  
    1616    #   end 
    1717    # 
     18    # The test classes can be specified by passing a Jerbil::JavaFileList to  
     19    # +tests+, or by setting the location of xml test suites using +suites+. 
    1820    class TestNGTask < Rake::TaskLib 
    1921      include JavaHelper 
     
    175177        # +classnames+:: a list of test class names. 
    176178        # +suitename+:: name of the suite. 
    177         # +onetest++: whether all tests should be rolled into one. 
    178         # +excluded++: classes excluded from the test. 
     179        # +onetest+:: whether all tests should be rolled into one. 
     180        # +excluded+:: classes excluded from the test. 
    179181        def create_suite_xml(filename, classnames, suitename="default", onetest=false, excluded = []) 
    180182