# File lib/puppet/util/rdoc/parser.rb, line 117
117:   def scan_top_level(container)
118:     # use the module README as documentation for the module
119:     comment = ""
120:     readme = File.join(File.dirname(File.dirname(@input_file_name)), "README")
121:     comment = File.open(readme,"r") { |f| f.read } if FileTest.readable?(readme)
122:     look_for_directives_in(container, comment) unless comment.empty?
123: 
124:     # infer module name from directory
125:     name = split_module(@input_file_name)
126:     if name.nil?
127:       # skip .pp files that are not in manifests directories as we can't guarantee they're part
128:       # of a module or the global configuration.
129:       container.document_self = false
130:       return
131:     end
132: 
133:     Puppet.debug "rdoc: scanning for #{name}"
134: 
135:     container.module_name = name
136:     container.global=true if name == SITE
137: 
138:     @stats.num_modules += 1
139:     container, name  = get_class_or_module(container,name)
140:     mod = container.add_module(PuppetModule, name)
141:     mod.record_location(@top_level)
142:     mod.comment = comment
143: 
144:     if @input_file_name =~ /\.pp$/
145:       parse_elements(mod)
146:     elsif @input_file_name =~ /\.rb$/
147:       parse_plugins(mod)
148:     end
149:   end