Gecko [ www.corporacionhdm.com.pe ]

Name	Size	Permission	Date
generator	[ DIR ]	drwxr-xr-x	2024-03-03 22:48
markup	[ DIR ]	drwxr-xr-x	2024-03-03 22:48
parser	[ DIR ]	drwxr-xr-x	2024-03-03 22:48
ri	[ DIR ]	drwxr-xr-x	2024-03-03 22:48
stats	[ DIR ]	drwxr-xr-x	2024-03-03 22:48
alias.rb	2.12 KB	-rw-r--r--	2010-12-20 03:22
anon_class.rb	171 B	-rw-r--r--	2011-02-02 00:32
any_method.rb	4.54 KB	-rw-r--r--	2011-06-16 04:59
attr.rb	2.88 KB	-rw-r--r--	2011-06-16 04:59
class_module.rb	14.49 KB	-rw-r--r--	2011-08-05 21:21
code_object.rb	6.56 KB	-rw-r--r--	2011-08-05 21:21
code_objects.rb	535 B	-rw-r--r--	2010-04-01 07:45
constant.rb	1.5 KB	-rw-r--r--	2010-12-20 03:22
context.rb	28.14 KB	-rw-r--r--	2011-08-05 21:21
cross_reference.rb	5.82 KB	-rw-r--r--	2011-08-05 21:21
encoding.rb	2.52 KB	-rw-r--r--	2012-02-14 07:55
erbio.rb	794 B	-rw-r--r--	2011-05-15 11:55
generator.rb	1.3 KB	-rw-r--r--	2011-02-02 00:32
ghost_method.rb	141 B	-rw-r--r--	2010-04-01 07:45
include.rb	2.11 KB	-rw-r--r--	2010-12-20 03:22
known_classes.rb	2.58 KB	-rw-r--r--	2011-06-29 21:17
markup.rb	20.96 KB	-rw-r--r--	2011-08-26 23:58
meta_method.rb	126 B	-rw-r--r--	2010-04-01 07:45
method_attr.rb	7.57 KB	-rw-r--r--	2011-05-15 11:55
normal_class.rb	1.58 KB	-rw-r--r--	2011-02-02 00:32
normal_module.rb	1.24 KB	-rw-r--r--	2011-02-02 00:32
options.rb	18.79 KB	-rw-r--r--	2011-05-14 00:39
parser.rb	5.39 KB	-rw-r--r--	2011-08-26 23:58
rdoc.rb	11.97 KB	-rw-r--r--	2011-06-16 04:59
require.rb	963 B	-rw-r--r--	2010-12-20 03:22
ri.rb	230 B	-rw-r--r--	2010-04-01 07:45
ruby_lex.rb	26.07 KB	-rw-r--r--	2011-08-24 00:02
ruby_token.rb	10.14 KB	-rw-r--r--	2010-12-20 03:22
rubygems_hook.rb	4.5 KB	-rw-r--r--	2011-06-16 04:59
single_class.rb	359 B	-rw-r--r--	2011-02-02 00:32
stats.rb	9.52 KB	-rw-r--r--	2011-05-14 00:39
task.rb	7.5 KB	-rw-r--r--	2011-05-14 00:39
text.rb	7.22 KB	-rw-r--r--	2011-08-05 21:21
token_stream.rb	1015 B	-rw-r--r--	2010-12-20 03:22
top_level.rb	10.1 KB	-rw-r--r--	2011-06-29 21:17

Rename

##
# RDoc::CrossReference is a reusable way to create cross references for names.

class RDoc::CrossReference

##
  # Regular expression to match class references
  #
  # 1. There can be a '\\' in front of text to suppress the cross-reference
  # 2. There can be a '::' in front of class names to reference from the
  #    top-level namespace.
  # 3. The method can be followed by parenthesis (not recommended)

CLASS_REGEXP_STR = '\\\\?((?:\:{2})?[A-Z]\w*(?:\:\:\w+)*)'

##
  # Regular expression to match method references.
  #
  # See CLASS_REGEXP_STR

METHOD_REGEXP_STR = '([a-z]\w*[!?=]?)(?:$[\w.+*/=<>-]*$)?'

##
  # Regular expressions matching text that should potentially have
  # cross-reference links generated are passed to add_special.  Note that
  # these expressions are meant to pick up text for which cross-references
  # have been suppressed, since the suppression characters are removed by the
  # code that is triggered.

CROSSREF_REGEXP = /(
                      # A::B::C.meth
                      #{CLASS_REGEXP_STR}(?:[.#]|::)#{METHOD_REGEXP_STR}

# Stand-alone method (preceded by a #)
                      | \\?\##{METHOD_REGEXP_STR}

# Stand-alone method (preceded by ::)
                      | ::#{METHOD_REGEXP_STR}

# A::B::C
                      # The stuff after CLASS_REGEXP_STR is a
                      # nasty hack.  CLASS_REGEXP_STR unfortunately matches
                      # words like dog and cat (these are legal "class"
                      # names in Fortran 95).  When a word is flagged as a
                      # potential cross-reference, limitations in the markup
                      # engine suppress other processing, such as typesetting.
                      # This is particularly noticeable for contractions.
                      # In order that words like "can't" not
                      # be flagged as potential cross-references, only
                      # flag potential class cross-references if the character
                      # after the cross-reference is a space, sentence
                      # punctuation, tag start character, or attribute
                      # marker.
                      | #{CLASS_REGEXP_STR}(?=[\s\)\.\?\!\,\;<\000]|\z)

# Things that look like filenames
                      # The key thing is that there must be at least
                      # one special character (period, slash, or
                      # underscore).
                      | (?:\.\.\/)*[-\/\w]+[_\/\.][-\w\/\.]+

# Things that have markup suppressed
                      # Don't process things like '\<' in \<tt>, though.
                      # TODO: including < is a hack, not very satisfying.
                      | \\[^\s<]
                      )/x

##
  # Version of CROSSREF_REGEXP used when <tt>--hyperlink-all</tt> is specified.

ALL_CROSSREF_REGEXP = /(
                      # A::B::C.meth
                      #{CLASS_REGEXP_STR}(?:[.#]|::)#{METHOD_REGEXP_STR}

# Stand-alone method
                      | \\?#{METHOD_REGEXP_STR}

# A::B::C
                      | #{CLASS_REGEXP_STR}(?=[\s\)\.\?\!\,\;<\000]|\z)

# Things that look like filenames
                      | (?:\.\.\/)*[-\/\w]+[_\/\.][-\w\/\.]+

# Things that have markup suppressed
                      | \\[^\s<]
                      )/x

attr_accessor :seen

##
  # Allows cross-references to be created based on the given +context+
  # (RDoc::Context).

def initialize context
    @context = context

@seen = {}
  end

##
  # Returns a reference to +name+.
  #
  # If the reference is found and +name+ is not documented +text+ will be
  # returned.  If +name+ is escaped +name+ is returned.  If +name+ is not
  # found +text+ is returned.

def resolve name, text
    return @seen[name] if @seen.include? name

# Find class, module, or method in class or module.
    #
    # Do not, however, use an if/elsif/else chain to do so.  Instead, test
    # each possible pattern until one matches.  The reason for this is that a
    # string like "YAML.txt" could be the txt() class method of class YAML (in
    # which case it would match the first pattern, which splits the string
    # into container and method components and looks up both) or a filename
    # (in which case it would match the last pattern, which just checks
    # whether the string as a whole is a known symbol).

if /#{CLASS_REGEXP_STR}([.#]|::)#{METHOD_REGEXP_STR}/o =~ name then
      type = $2
      type = '' if type == '.'  # will find either #method or ::method
      method = "#{type}#{$3}"
      container = @context.find_symbol_module($1)
    elsif /^([.#]|::)#{METHOD_REGEXP_STR}/o =~ name then
      type = $1
      type = '' if type == '.'
      method = "#{type}#{$2}"
      container = @context
    else
      container = nil
    end

if container then
      ref = container.find_local_symbol method

unless ref || RDoc::TopLevel === container then
        ref = container.find_ancestor_local_symbol method
      end
    end

ref = case name
          when /^\\(#{CLASS_REGEXP_STR})$/o then
            ref = @context.find_symbol $1
          else
            ref = @context.find_symbol name
          end unless ref

ref = nil if RDoc::Alias === ref # external alias: can't link to it

out = if name == '\\' then
            name
          elsif name =~ /^\\/ then
            # we remove the \ only in front of what we know:
            # other backslashes are treated later, only outside of <tt>
            ref ? $' : name
          elsif ref then
            if ref.display? then
              ref
            else
              text
            end
          else
            text
          end

@seen[name] = out

out
  end

end