Gecko [ touzafair.com ]

Name	Size	Permission
context	[ DIR ]	drwxr-xr-x
generator	[ DIR ]	drwxr-xr-x
i18n	[ DIR ]	drwxr-xr-x
markdown	[ DIR ]	drwxr-xr-x
markup	[ DIR ]	drwxr-xr-x
parser	[ DIR ]	drwxr-xr-x
rd	[ DIR ]	drwxr-xr-x
ri	[ DIR ]	drwxr-xr-x
stats	[ DIR ]	drwxr-xr-x
alias.rb	2.12 KB	-rw-r--r--
anon_class.rb	172 B	-rw-r--r--
any_method.rb	8.18 KB	-rw-r--r--
attr.rb	3.76 KB	-rw-r--r--
class_module.rb	19.82 KB	-rw-r--r--
code_object.rb	9.26 KB	-rw-r--r--
code_objects.rb	151 B	-rw-r--r--
comment.rb	5.74 KB	-rw-r--r--
constant.rb	3.59 KB	-rw-r--r--
context.rb	30.27 KB	-rw-r--r--
cross_reference.rb	6.62 KB	-rw-r--r--
encoding.rb	3.75 KB	-rw-r--r--
erb_partial.rb	401 B	-rw-r--r--
erbio.rb	1.01 KB	-rw-r--r--
extend.rb	170 B	-rw-r--r--
generator.rb	1.79 KB	-rw-r--r--
ghost_method.rb	144 B	-rw-r--r--
i18n.rb	174 B	-rw-r--r--
include.rb	172 B	-rw-r--r--
known_classes.rb	2.62 KB	-rw-r--r--
markdown.rb	386.29 KB	-rw-r--r--
markup.rb	28.13 KB	-rw-r--r--
meta_method.rb	129 B	-rw-r--r--
method_attr.rb	9.03 KB	-rw-r--r--
mixin.rb	2.75 KB	-rw-r--r--
normal_class.rb	2.13 KB	-rw-r--r--
normal_module.rb	1.43 KB	-rw-r--r--
options.rb	33.29 KB	-rw-r--r--
parser.rb	7.07 KB	-rw-r--r--
rd.rb	3.57 KB	-rw-r--r--
rdoc.rb	13.29 KB	-rw-r--r--
require.rb	965 B	-rw-r--r--
ri.rb	345 B	-rw-r--r--
rubygems_hook.rb	5.2 KB	-rw-r--r--
servlet.rb	12.23 KB	-rw-r--r--
single_class.rb	408 B	-rw-r--r--
stats.rb	10.48 KB	-rw-r--r--
store.rb	22.67 KB	-rw-r--r--
task.rb	7.67 KB	-rw-r--r--
text.rb	7.63 KB	-rw-r--r--
token_stream.rb	3.16 KB	-rw-r--r--
tom_doc.rb	6.46 KB	-rw-r--r--
top_level.rb	5.54 KB	-rw-r--r--
version.rb	77 B	-rw-r--r--

Code Editor : cross_reference.rb

# frozen_string_literal: true
##
# 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-Za-z]\w*[!?=]?|%|===?|\[\]=?|<<|>>|\+@|-@|-|\+|\*)(?:$[\w.+*/=<>-]*$)?'

##
  # Regular expressions matching text that should potentially have
  # cross-reference links generated are passed to add_regexp_handling. 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 = /(?:^|[\s()])
                     (
                      (?:
                       # A::B::C.meth
                       #{CLASS_REGEXP_STR}(?:[.#]|::)#{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)

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

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

# 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<]
                      )

# labels for headings
                      (?:@[\w+%-]+(?:\.[\w|%-]+)?)?
                     )/x

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

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

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

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

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

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

# labels for headings
                      (?:@[\w+%-]+)?
                     )/x

##
  # Hash of references that have been looked-up to their replacements

attr_accessor :seen

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

def initialize context
    @context = context
    @store   = context.store

@seen = {}
  end

def resolve_method name
    ref = nil

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

if container then
      unless RDoc::TopLevel === container then
        if '.' == type then
          if 'new' == method then # AnyClassName.new will be class method
            ref = container.find_local_symbol method
            ref = container.find_ancestor_local_symbol method unless ref
          else
            ref = container.find_local_symbol "::#{method}"
            ref = container.find_ancestor_local_symbol "::#{method}" unless ref
            ref = container.find_local_symbol "##{method}" unless ref
            ref = container.find_ancestor_local_symbol "##{method}" unless ref
          end
        else
          ref = container.find_local_symbol method
          ref = container.find_ancestor_local_symbol method unless ref
        end
      end
    end

ref
  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

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

ref = resolve_method name unless ref

# Try a page name
    ref = @store.page name if not ref and name =~ /^[\w.]+$/

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

${this.title}

Code Editor : cross_reference.rb