100: def self.process_args argv
101: options = default_options
102:
103: opts = OptionParser.new do |opt|
104: opt.accept File do |file,|
105: File.readable?(file) and not File.directory?(file) and file
106: end
107:
108: opt.program_name = File.basename $0
109: opt.version = RDoc::VERSION
110: opt.release = nil
111: opt.summary_indent = ' ' * 4
112:
113: opt.banner = Usage: #{opt.program_name} [options] [names...]Where name can be: Class | Class::method | Class#method | Class.method | methodAll class names may be abbreviated to their minimum unambiguous form. If a nameis ambiguous, all valid options will be listed.The form '.' method matches either class or instance methods, while #methodmatches only instance and ::method matches only class methods.For example: #{opt.program_name} Fil #{opt.program_name} File #{opt.program_name} File.new #{opt.program_name} zipNote that shell quoting may be required for method names containingpunctuation: #{opt.program_name} 'Array.[]' #{opt.program_name} compact\\!To see the default directories ri will search, run: #{opt.program_name} --list-doc-dirsSpecifying the --system, --site, --home, --gems or --doc-dir options willlimit ri to searching only the specified directories.Options may also be set in the 'RI' environment variable.
114:
115: opt.separator nil
116: opt.separator "Options:"
117:
118: opt.separator nil
119:
120: formatters = RDoc::Markup.constants.grep(/^To[A-Z][a-z]+$/).sort
121: formatters = formatters.sort.map do |formatter|
122: formatter.to_s.sub('To', '').downcase
123: end
124:
125: opt.on("--format=NAME", "-f",
126: "Uses the selected formatter. The default",
127: "formatter is bs for paged output and ansi",
128: "otherwise. Valid formatters are:",
129: formatters.join(' '), formatters) do |value|
130: options[:formatter] = RDoc::Markup.const_get "To#{value.capitalize}"
131: end
132:
133: opt.separator nil
134:
135: opt.on("--no-pager", "-T",
136: "Send output directly to stdout,",
137: "rather than to a pager.") do
138: options[:use_stdout] = true
139: end
140:
141: opt.separator nil
142:
143: opt.on("--width=WIDTH", "-w", OptionParser::DecimalInteger,
144: "Set the width of the output.") do |value|
145: options[:width] = value
146: end
147:
148: opt.separator nil
149:
150: opt.on("--interactive", "-i",
151: "In interactive mode you can repeatedly",
152: "look up methods with autocomplete.") do
153: options[:interactive] = true
154: end
155:
156: opt.separator nil
157:
158: opt.on("--[no-]profile",
159: "Run with the ruby profiler") do |value|
160: options[:profile] = value
161: end
162:
163: opt.separator nil
164: opt.separator "Data source options:"
165: opt.separator nil
166:
167: opt.on("--list-doc-dirs",
168: "List the directories from which ri will",
169: "source documentation on stdout and exit.") do
170: options[:list_doc_dirs] = true
171: end
172:
173: opt.separator nil
174:
175: opt.on("--doc-dir=DIRNAME", "-d", Array,
176: "List of directories from which to source",
177: "documentation in addition to the standard",
178: "directories. May be repeated.") do |value|
179: value.each do |dir|
180: unless File.directory? dir then
181: raise OptionParser::InvalidArgument, "#{dir} is not a directory"
182: end
183:
184: options[:extra_doc_dirs] << File.expand_path(dir)
185: end
186: end
187:
188: opt.separator nil
189:
190: opt.on("--no-standard-docs",
191: "Do not include documentation from",
192: "the Ruby standard library, site_lib,",
193: "installed gems, or ~/.rdoc.",
194: "Use with --doc-dir") do
195: options[:use_system] = false
196: options[:use_site] = false
197: options[:use_gems] = false
198: options[:use_home] = false
199: end
200:
201: opt.separator nil
202:
203: opt.on("--[no-]system",
204: "Include documentation from Ruby's standard",
205: "library. Defaults to true.") do |value|
206: options[:use_system] = value
207: end
208:
209: opt.separator nil
210:
211: opt.on("--[no-]site",
212: "Include documentation from libraries",
213: "installed in site_lib.",
214: "Defaults to true.") do |value|
215: options[:use_site] = value
216: end
217:
218: opt.separator nil
219:
220: opt.on("--[no-]gems",
221: "Include documentation from RubyGems.",
222: "Defaults to true.") do |value|
223: options[:use_gems] = value
224: end
225:
226: opt.separator nil
227:
228: opt.on("--[no-]home",
229: "Include documentation stored in ~/.rdoc.",
230: "Defaults to true.") do |value|
231: options[:use_home] = value
232: end
233:
234: opt.separator nil
235: opt.separator "Debug options:"
236: opt.separator nil
237:
238: opt.on("--dump=CACHE", File,
239: "Dumps data from an ri cache or data file") do |value|
240: options[:dump_path] = value
241: end
242: end
243:
244: argv = ENV['RI'].to_s.split.concat argv
245:
246: opts.parse! argv
247:
248: options[:names] = argv
249:
250: options[:use_stdout] ||= !$stdout.tty?
251: options[:use_stdout] ||= options[:interactive]
252: options[:width] ||= 72
253:
254: options
255:
256: rescue OptionParser::InvalidArgument, OptionParser::InvalidOption => e
257: puts opts
258: puts
259: puts e
260: exit 1
261: end
![[+]](../../images/find.png "show/hide quicksearch")