rdoc 3.5 → 3.5.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Potentially problematic release.
This version of rdoc might be problematic. Click here for more details.
- data.tar.gz.sig +0 -0
- data/History.txt +7 -0
- data/Rakefile +2 -1
- data/lib/rdoc.rb +1 -1
- data/lib/rdoc/class_module.rb +2 -2
- data/lib/rdoc/generator.rb +1 -1
- data/lib/rdoc/markup.rb +1 -1
- data/lib/rdoc/markup/heading.rb +1 -1
- data/lib/rdoc/markup/inline.rb +1 -1
- data/lib/rdoc/markup/parser.rb +1 -1
- data/lib/rdoc/markup/to_html.rb +1 -1
- data/lib/rdoc/markup/to_html_crossref.rb +3 -3
- data/lib/rdoc/markup/to_rdoc.rb +1 -1
- data/lib/rdoc/parser.rb +1 -1
- data/lib/rdoc/parser/c.rb +1 -1
- data/lib/rdoc/rdoc.rb +1 -1
- data/lib/rdoc/stats.rb +1 -1
- data/test/test_rdoc_options.rb +1 -1
- data/test/test_rdoc_parser_ruby.rb +2 -2
- data/test/test_rdoc_rdoc.rb +1 -1
- metadata +4 -3
- metadata.gz.sig +0 -0
    
        data.tar.gz.sig
    CHANGED
    
    | Binary file | 
    
        data/History.txt
    CHANGED
    
    | @@ -1,3 +1,10 @@ | |
| 1 | 
            +
            === 3.5.1
         | 
| 2 | 
            +
             | 
| 3 | 
            +
            * Bug fixes
         | 
| 4 | 
            +
              * Fixed some typos.  Pull request #13 by R.T. Lechow.
         | 
| 5 | 
            +
              * Ensure an RDoc::Stats is created in #parse_files.  Fixes documentation for
         | 
| 6 | 
            +
                railties which has no files.  Reported by Aaron Patterson
         | 
| 7 | 
            +
             | 
| 1 8 | 
             
            === 3.5 / 2010-01-29
         | 
| 2 9 |  | 
| 3 10 | 
             
            * Minor enhancements
         | 
    
        data/Rakefile
    CHANGED
    
    | @@ -15,8 +15,9 @@ Hoe.spec 'rdoc' do | |
| 15 15 | 
             
              developer 'Phil Hagelberg', 'technomancy@gmail.com'
         | 
| 16 16 | 
             
              developer 'Tony Strauss', 'tony.strauss@designingpatterns.com'
         | 
| 17 17 |  | 
| 18 | 
            -
              self.remote_rdoc_dir = ''
         | 
| 19 18 | 
             
              self.rsync_args = '-avz'
         | 
| 19 | 
            +
              rdoc_locations << 'drbrain@rubyforge.org:/var/www/gforge-projects/rdoc/'
         | 
| 20 | 
            +
             | 
| 20 21 | 
             
              self.testlib = :minitest
         | 
| 21 22 | 
             
              self.isolate_dir = 'tmp/isolate'
         | 
| 22 23 |  | 
    
        data/lib/rdoc.rb
    CHANGED
    
    
    
        data/lib/rdoc/class_module.rb
    CHANGED
    
    | @@ -151,7 +151,7 @@ class RDoc::ClassModule < RDoc::Context | |
| 151 151 | 
             
              end
         | 
| 152 152 |  | 
| 153 153 | 
             
              ##
         | 
| 154 | 
            -
              # Finds a class or module with +name+ in this namespace or its  | 
| 154 | 
            +
              # Finds a class or module with +name+ in this namespace or its descendants
         | 
| 155 155 |  | 
| 156 156 | 
             
              def find_class_named name
         | 
| 157 157 | 
             
                return self if full_name == name
         | 
| @@ -308,7 +308,7 @@ class RDoc::ClassModule < RDoc::Context | |
| 308 308 | 
             
              ##
         | 
| 309 309 | 
             
              # Name to use to generate the url:
         | 
| 310 310 | 
             
              # modules and classes that are aliases for another
         | 
| 311 | 
            -
              # module or  | 
| 311 | 
            +
              # module or class return the name of the latter.
         | 
| 312 312 |  | 
| 313 313 | 
             
              def name_for_path
         | 
| 314 314 | 
             
                is_alias_for ? is_alias_for.full_name : full_name
         | 
    
        data/lib/rdoc/generator.rb
    CHANGED
    
    | @@ -22,7 +22,7 @@ require 'rdoc' | |
| 22 22 | 
             
            # use RDoc::Options#option_parser to add command-line options to the +rdoc+
         | 
| 23 23 | 
             
            # tool.  See OptionParser for details on how to add options.
         | 
| 24 24 | 
             
            #
         | 
| 25 | 
            -
            # You can extend the RDoc::Options instance with additional  | 
| 25 | 
            +
            # You can extend the RDoc::Options instance with additional accessors for your
         | 
| 26 26 | 
             
            # generator.
         | 
| 27 27 | 
             
            #
         | 
| 28 28 | 
             
            # = Generator Instantiation
         | 
    
        data/lib/rdoc/markup.rb
    CHANGED
    
    | @@ -483,7 +483,7 @@ require 'rdoc' | |
| 483 483 | 
             
            # [+:include:+ _filename_]
         | 
| 484 484 | 
             
            #   Include the contents of the named file at this point. This directive
         | 
| 485 485 | 
             
            #   must appear alone on one line, possibly preceded by spaces. In this
         | 
| 486 | 
            -
            #   position, it can be  | 
| 486 | 
            +
            #   position, it can be escaped with a \ in front of the first colon.
         | 
| 487 487 | 
             
            #
         | 
| 488 488 | 
             
            #   The file will be searched for in the directories listed by the +--include+
         | 
| 489 489 | 
             
            #   option, or in the current directory by default.  The contents of the file
         | 
    
        data/lib/rdoc/markup/heading.rb
    CHANGED
    
    
    
        data/lib/rdoc/markup/inline.rb
    CHANGED
    
    
    
        data/lib/rdoc/markup/parser.rb
    CHANGED
    
    
    
        data/lib/rdoc/markup/to_html.rb
    CHANGED
    
    | @@ -130,7 +130,7 @@ class RDoc::Markup::ToHtml < RDoc::Markup::Formatter | |
| 130 130 | 
             
              end
         | 
| 131 131 |  | 
| 132 132 | 
             
              ##
         | 
| 133 | 
            -
              # Here's a  | 
| 133 | 
            +
              # Here's a hyperlink where the label is different to the URL
         | 
| 134 134 | 
             
              # <label>[url] or {long label}[url]
         | 
| 135 135 |  | 
| 136 136 | 
             
              def handle_special_TIDYLINK(special)
         | 
| @@ -34,10 +34,10 @@ class RDoc::Markup::ToHtmlCrossref < RDoc::Markup::ToHtml | |
| 34 34 | 
             
                                  # A::B::C.meth
         | 
| 35 35 | 
             
                                  #{CLASS_REGEXP_STR}(?:[.#]|::)#{METHOD_REGEXP_STR}
         | 
| 36 36 |  | 
| 37 | 
            -
                                  # Stand-alone method ( | 
| 37 | 
            +
                                  # Stand-alone method (preceded by a #)
         | 
| 38 38 | 
             
                                  | \\?\##{METHOD_REGEXP_STR}
         | 
| 39 39 |  | 
| 40 | 
            -
                                  # Stand-alone method ( | 
| 40 | 
            +
                                  # Stand-alone method (preceded by ::)
         | 
| 41 41 | 
             
                                  | ::#{METHOD_REGEXP_STR}
         | 
| 42 42 |  | 
| 43 43 | 
             
                                  # A::B::C
         | 
| @@ -51,7 +51,7 @@ class RDoc::Markup::ToHtmlCrossref < RDoc::Markup::ToHtml | |
| 51 51 | 
             
                                  # In order that words like "can't" not
         | 
| 52 52 | 
             
                                  # be flagged as potential cross-references, only
         | 
| 53 53 | 
             
                                  # flag potential class cross-references if the character
         | 
| 54 | 
            -
                                  # after the cross- | 
| 54 | 
            +
                                  # after the cross-reference is a space, sentence
         | 
| 55 55 | 
             
                                  # punctuation, tag start character, or attribute
         | 
| 56 56 | 
             
                                  # marker.
         | 
| 57 57 | 
             
                                  | #{CLASS_REGEXP_STR}(?=[\s\)\.\?\!\,\;<\000]|\z)
         | 
    
        data/lib/rdoc/markup/to_rdoc.rb
    CHANGED
    
    | @@ -217,7 +217,7 @@ class RDoc::Markup::ToRdoc < RDoc::Markup::Formatter | |
| 217 217 | 
             
              end
         | 
| 218 218 |  | 
| 219 219 | 
             
              ##
         | 
| 220 | 
            -
              # Removes  | 
| 220 | 
            +
              # Removes preceding \\ from the suppressed crossref +special+
         | 
| 221 221 |  | 
| 222 222 | 
             
              def handle_special_SUPPRESSED_CROSSREF special
         | 
| 223 223 | 
             
                text = special.text
         | 
    
        data/lib/rdoc/parser.rb
    CHANGED
    
    | @@ -45,7 +45,7 @@ class RDoc::Parser | |
| 45 45 | 
             
              class << self
         | 
| 46 46 |  | 
| 47 47 | 
             
                ##
         | 
| 48 | 
            -
                # A Hash that maps file  | 
| 48 | 
            +
                # A Hash that maps file extensions regular expressions to parsers that
         | 
| 49 49 | 
             
                # will consume them.
         | 
| 50 50 | 
             
                #
         | 
| 51 51 | 
             
                # Use parse_files_matching to register a parser's file extensions.
         | 
    
        data/lib/rdoc/parser/c.rb
    CHANGED
    
    | @@ -71,7 +71,7 @@ require 'rdoc/known_classes' | |
| 71 71 | 
             
            #   Documentation for the named attribute.
         | 
| 72 72 | 
             
            #
         | 
| 73 73 | 
             
            # [call-seq:  <i>text up to an empty line</i>]
         | 
| 74 | 
            -
            #   Because C source doesn't give  | 
| 74 | 
            +
            #   Because C source doesn't give descriptive names to Ruby-level parameters,
         | 
| 75 75 | 
             
            #   you need to document the calling sequence explicitly
         | 
| 76 76 | 
             
            #
         | 
| 77 77 | 
             
            # In addition, RDoc assumes by default that the C method implementing a
         | 
    
        data/lib/rdoc/rdoc.rb
    CHANGED
    
    | @@ -354,12 +354,12 @@ The internal error was: | |
| 354 354 |  | 
| 355 355 | 
             
              def parse_files files
         | 
| 356 356 | 
             
                file_list = gather_files files
         | 
| 357 | 
            +
                @stats = RDoc::Stats.new file_list.size, @options.verbosity
         | 
| 357 358 |  | 
| 358 359 | 
             
                return [] if file_list.empty?
         | 
| 359 360 |  | 
| 360 361 | 
             
                file_info = []
         | 
| 361 362 |  | 
| 362 | 
            -
                @stats = RDoc::Stats.new file_list.size, @options.verbosity
         | 
| 363 363 | 
             
                @stats.begin_adding
         | 
| 364 364 |  | 
| 365 365 | 
             
                file_info = file_list.map do |filename|
         | 
    
        data/lib/rdoc/stats.rb
    CHANGED
    
    | @@ -411,7 +411,7 @@ class RDoc::Stats | |
| 411 411 | 
             
              end
         | 
| 412 412 |  | 
| 413 413 | 
             
              ##
         | 
| 414 | 
            -
              # Determines which  | 
| 414 | 
            +
              # Determines which parameters in +method+ were not documented.  Returns a
         | 
| 415 415 | 
             
              # total parameter count and an Array of undocumented methods.
         | 
| 416 416 |  | 
| 417 417 | 
             
              def undoc_params method
         | 
    
        data/test/test_rdoc_options.rb
    CHANGED
    
    | @@ -17,7 +17,7 @@ class TestRDocOptions < MiniTest::Unit::TestCase | |
| 17 17 | 
             
              end
         | 
| 18 18 |  | 
| 19 19 | 
             
              def test_check_files
         | 
| 20 | 
            -
                skip "assumes UNIX  | 
| 20 | 
            +
                skip "assumes UNIX permission model" if /mswin|mingw/ =~ RUBY_PLATFORM
         | 
| 21 21 | 
             
                out, err = capture_io do
         | 
| 22 22 | 
             
                  Dir.mktmpdir do |dir|
         | 
| 23 23 | 
             
                    Dir.chdir dir do
         | 
| @@ -1144,7 +1144,7 @@ EOF | |
| 1144 1144 |  | 
| 1145 1145 | 
             
                content = <<-CONTENT
         | 
| 1146 1146 | 
             
            inline(:my_method) do |*args|
         | 
| 1147 | 
            -
              "this method  | 
| 1147 | 
            +
              "this method causes z to disappear"
         | 
| 1148 1148 | 
             
            end
         | 
| 1149 1149 | 
             
                CONTENT
         | 
| 1150 1150 |  | 
| @@ -1986,7 +1986,7 @@ class C | |
| 1986 1986 | 
             
              #  my method
         | 
| 1987 1987 |  | 
| 1988 1988 | 
             
              inline(:my_method) do |*args|
         | 
| 1989 | 
            -
                "this method used to cause z to  | 
| 1989 | 
            +
                "this method used to cause z to disappear"
         | 
| 1990 1990 | 
             
              end
         | 
| 1991 1991 |  | 
| 1992 1992 | 
             
              def z
         | 
    
        data/test/test_rdoc_rdoc.rb
    CHANGED
    
    
    
        metadata
    CHANGED
    
    | @@ -1,12 +1,13 @@ | |
| 1 1 | 
             
            --- !ruby/object:Gem::Specification 
         | 
| 2 2 | 
             
            name: rdoc
         | 
| 3 3 | 
             
            version: !ruby/object:Gem::Version 
         | 
| 4 | 
            -
              hash:  | 
| 4 | 
            +
              hash: 17
         | 
| 5 5 | 
             
              prerelease: 
         | 
| 6 6 | 
             
              segments: 
         | 
| 7 7 | 
             
              - 3
         | 
| 8 8 | 
             
              - 5
         | 
| 9 | 
            -
               | 
| 9 | 
            +
              - 1
         | 
| 10 | 
            +
              version: 3.5.1
         | 
| 10 11 | 
             
            platform: ruby
         | 
| 11 12 | 
             
            authors: 
         | 
| 12 13 | 
             
            - Eric Hodel
         | 
| @@ -38,7 +39,7 @@ cert_chain: | |
| 38 39 | 
             
              x52qPcexcYZR7w==
         | 
| 39 40 | 
             
              -----END CERTIFICATE-----
         | 
| 40 41 |  | 
| 41 | 
            -
            date: 2011-01- | 
| 42 | 
            +
            date: 2011-01-30 00:00:00 -08:00
         | 
| 42 43 | 
             
            default_executable: 
         | 
| 43 44 | 
             
            dependencies: 
         | 
| 44 45 | 
             
            - !ruby/object:Gem::Dependency 
         | 
    
        metadata.gz.sig
    CHANGED
    
    | Binary file |