File: C:/Ruby27-x64/share/doc/ruby/html/RDoc/Options.html
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>class RDoc::Options - RDoc Documentation</title>
<script type="text/javascript">
var rdoc_rel_prefix = "../";
var index_rel_prefix = "../";
</script>
<script src="../js/navigation.js" defer></script>
<script src="../js/search.js" defer></script>
<script src="../js/search_index.js" defer></script>
<script src="../js/searcher.js" defer></script>
<script src="../js/darkfish.js" defer></script>
<link href="../css/fonts.css" rel="stylesheet">
<link href="../css/rdoc.css" rel="stylesheet">
<body id="top" role="document" class="class">
<nav role="navigation">
<div id="project-navigation">
<div id="home-section" role="region" title="Quick navigation" class="nav-section">
<h2>
<a href="../index.html" rel="home">Home</a>
</h2>
<div id="table-of-contents-navigation">
<a href="../table_of_contents.html#pages">Pages</a>
<a href="../table_of_contents.html#classes">Classes</a>
<a href="../table_of_contents.html#methods">Methods</a>
</div>
</div>
<div id="search-section" role="search" class="project-section initially-hidden">
<form action="#" method="get" accept-charset="utf-8">
<div id="search-field-wrapper">
<input id="search-field" role="combobox" aria-label="Search"
aria-autocomplete="list" aria-controls="search-results"
type="text" name="search" placeholder="Search" spellcheck="false"
title="Type to search, Up and Down to navigate, Enter to load">
</div>
<ul id="search-results" aria-label="Search Results"
aria-busy="false" aria-expanded="false"
aria-atomic="false" class="initially-hidden"></ul>
</form>
</div>
</div>
<div class="nav-section">
<h3>Table of Contents</h3>
<ul class="link-list" role="directory">
<li><a href="#class-RDoc::Options-label-Saved+Options">Saved Options</a>
<li><a href="#class-RDoc::Options-label-Custom+Options">Custom Options</a>
<li><a href="#class-RDoc::Options-label-Option+Validators">Option Validators</a>
</ul>
</div>
<div id="class-metadata">
<div id="parent-class-section" class="nav-section">
<h3>Parent</h3>
<p class="link"><a href="../Object.html">Object</a>
</div>
<!-- Method Quickref -->
<div id="method-list-section" class="nav-section">
<h3>Methods</h3>
<ul class="link-list" role="directory">
<li ><a href="#method-i-check_files">#check_files</a>
<li ><a href="#method-i-check_generator">#check_generator</a>
<li ><a href="#method-i-default_title-3D">#default_title=</a>
<li ><a href="#method-i-exclude">#exclude</a>
<li ><a href="#method-i-finish">#finish</a>
<li ><a href="#method-i-finish_page_dir">#finish_page_dir</a>
<li ><a href="#method-i-generator_descriptions">#generator_descriptions</a>
<li ><a href="#method-i-parse">#parse</a>
<li ><a href="#method-i-quiet">#quiet</a>
<li ><a href="#method-i-quiet-3D">#quiet=</a>
<li ><a href="#method-i-sanitize_path">#sanitize_path</a>
<li ><a href="#method-i-setup_generator">#setup_generator</a>
<li ><a href="#method-i-template_dir_for">#template_dir_for</a>
<li ><a href="#method-i-visibility-3D">#visibility=</a>
<li class="calls-super" ><a href="#method-i-warn">#warn</a>
<li ><a href="#method-i-write_options">#write_options</a>
</ul>
</div>
</div>
</nav>
<main role="main" aria-labelledby="class-RDoc::Options">
<h1 id="class-RDoc::Options" class="class">
class RDoc::Options
</h1>
<section class="description">
<p><a href="Options.html"><code>RDoc::Options</code></a> handles the parsing and storage of options</p>
<h2 id="class-RDoc::Options-label-Saved+Options">Saved <a href="Options.html"><code>Options</code></a><span><a href="#class-RDoc::Options-label-Saved+Options">¶</a> <a href="#top">↑</a></span></h2>
<p>You can save some options like the markup format in the <code>.rdoc_options</code> file in your gem. The easiest way to do this is:</p>
<pre>rdoc --markup tomdoc --write-options</pre>
<p>Which will automatically create the file and fill it with the options you specified.</p>
<p>The following options will not be saved since they interfere with the user's preferences or with the normal operation of RDoc:</p>
<ul><li>
<p><code>--coverage-report</code></p>
</li><li>
<p><code>--dry-run</code></p>
</li><li>
<p><code>--encoding</code></p>
</li><li>
<p><code>--force-update</code></p>
</li><li>
<p><code>--format</code></p>
</li><li>
<p><code>--pipe</code></p>
</li><li>
<p><code>--quiet</code></p>
</li><li>
<p><code>--template</code></p>
</li><li>
<p><code>--verbose</code></p>
</li></ul>
<h2 id="class-RDoc::Options-label-Custom+Options">Custom <a href="Options.html"><code>Options</code></a><span><a href="#class-RDoc::Options-label-Custom+Options">¶</a> <a href="#top">↑</a></span></h2>
<p>Generators can hook into <a href="Options.html"><code>RDoc::Options</code></a> to add generator-specific command line options.</p>
<p>When <code>--format</code> is encountered in ARGV, <a href="../RDoc.html"><code>RDoc</code></a> calls ::setup_options on the generator class to add extra options to the option parser. <a href="Options.html"><code>Options</code></a> for custom generators must occur after <code>--format</code>. <code>rdoc --help</code> will list options for all installed generators.</p>
<p>Example:</p>
<pre class="ruby"><span class="ruby-keyword">class</span> <span class="ruby-constant">RDoc</span><span class="ruby-operator">::</span><span class="ruby-constant">Generator</span><span class="ruby-operator">::</span><span class="ruby-constant">Spellcheck</span>
<span class="ruby-constant">RDoc</span><span class="ruby-operator">::</span><span class="ruby-constant">RDoc</span>.<span class="ruby-identifier">add_generator</span> <span class="ruby-keyword">self</span>
<span class="ruby-keyword">def</span> <span class="ruby-keyword">self</span>.<span class="ruby-identifier ruby-title">setup_options</span> <span class="ruby-identifier">rdoc_options</span>
<span class="ruby-identifier">op</span> = <span class="ruby-identifier">rdoc_options</span>.<span class="ruby-identifier">option_parser</span>
<span class="ruby-identifier">op</span>.<span class="ruby-identifier">on</span>(<span class="ruby-string">'--spell-dictionary DICTIONARY'</span>,
<span class="ruby-constant">RDoc</span><span class="ruby-operator">::</span><span class="ruby-constant">Options</span><span class="ruby-operator">::</span><span class="ruby-constant">Path</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">dictionary</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">rdoc_options</span>.<span class="ruby-identifier">spell_dictionary</span> = <span class="ruby-identifier">dictionary</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
</pre>
<p>Of course, <a href="Options.html"><code>RDoc::Options</code></a> does not respond to <code>spell_dictionary</code> by default so you will need to add it:</p>
<pre class="ruby"><span class="ruby-keyword">class</span> <span class="ruby-constant">RDoc</span><span class="ruby-operator">::</span><span class="ruby-constant">Options</span>
<span class="ruby-comment">##</span>
<span class="ruby-comment"># The spell dictionary used by the spell-checking plugin.</span>
<span class="ruby-identifier">attr_accessor</span> <span class="ruby-value">:spell_dictionary</span>
<span class="ruby-keyword">end</span>
</pre>
<h2 id="class-RDoc::Options-label-Option+Validators">Option Validators<span><a href="#class-RDoc::Options-label-Option+Validators">¶</a> <a href="#top">↑</a></span></h2>
<p><a href="../OptionParser.html"><code>OptionParser</code></a> validators will validate and cast user input values. In addition to the validators that ship with <a href="../OptionParser.html"><code>OptionParser</code></a> (<a href="../String.html"><code>String</code></a>, <a href="../Integer.html"><code>Integer</code></a>, <a href="../Float.html"><code>Float</code></a>, <a href="../TrueClass.html"><code>TrueClass</code></a>, <a href="../FalseClass.html"><code>FalseClass</code></a>, <a href="../Array.html"><code>Array</code></a>, <a href="../Regexp.html"><code>Regexp</code></a>, <a href="../Date.html"><code>Date</code></a>, <a href="../Time.html"><code>Time</code></a>, <a href="../URI.html"><code>URI</code></a>, etc.), <a href="Options.html"><code>RDoc::Options</code></a> adds <a href="Options.html#Path"><code>Path</code></a>, <a href="Options.html#PathArray"><code>PathArray</code></a> and <a href="Options.html#Template"><code>Template</code></a>.</p>
</section>
<section id="5Buntitled-5D" class="documentation-section">
<section class="constants-list">
<header>
<h3>Constants</h3>
</header>
<dl>
<dt id="DEPRECATED">DEPRECATED
<dd><p>The deprecated options.</p>
<dt id="Directory">Directory
<dd><p>Option validator for <a href="../OptionParser.html"><code>OptionParser</code></a> that matches a directory that exists on the filesystem.</p>
<dt id="Path">Path
<dd><p>Option validator for <a href="../OptionParser.html"><code>OptionParser</code></a> that matches a file or directory that exists on the filesystem.</p>
<dt id="PathArray">PathArray
<dd><p>Option validator for <a href="../OptionParser.html"><code>OptionParser</code></a> that matches a comma-separated list of files or directories that exist on the filesystem.</p>
<dt id="SPECIAL">SPECIAL
<dd><p><a href="../RDoc.html"><code>RDoc</code></a> options ignored (or handled specially) by –write-options</p>
<dt id="Template">Template
<dd><p>Option validator for <a href="../OptionParser.html"><code>OptionParser</code></a> that matches a template directory for an installed generator that lives in <code>"rdoc/generator/template/#{template_name}"</code></p>
</dl>
</section>
<section class="attribute-method-details" class="method-section">
<header>
<h3>Attributes</h3>
</header>
<div id="attribute-i-charset" class="method-detail">
<div class="method-heading attribute-method-heading">
<span class="method-name">charset</span><span
class="attribute-access-type">[RW]</span>
</div>
<div class="method-description">
<p>Character-set for HTML output. <a href="Options.html#attribute-i-encoding"><code>encoding</code></a> is preferred over <a href="Options.html#attribute-i-charset"><code>charset</code></a></p>
</div>
</div>
<div id="attribute-i-coverage_report" class="method-detail">
<div class="method-heading attribute-method-heading">
<span class="method-name">coverage_report</span><span
class="attribute-access-type">[RW]</span>
</div>
<div class="method-description">
<p>If true, only report on undocumented files</p>
</div>
</div>
<div id="attribute-i-dry_run" class="method-detail">
<div class="method-heading attribute-method-heading">
<span class="method-name">dry_run</span><span
class="attribute-access-type">[RW]</span>
</div>
<div class="method-description">
<p>If true, <a href="../RDoc.html"><code>RDoc</code></a> will not write any files.</p>
</div>
</div>
<div id="attribute-i-encoding" class="method-detail">
<div class="method-heading attribute-method-heading">
<span class="method-name">encoding</span><span
class="attribute-access-type">[RW]</span>
</div>
<div class="method-description">
<p>The output encoding. All input files will be transcoded to this encoding.</p>
<p>The default encoding is UTF-8. This is set via –encoding.</p>
</div>
</div>
<div id="attribute-i-exclude" class="method-detail">
<div class="method-heading attribute-method-heading">
<span class="method-name">exclude</span><span
class="attribute-access-type">[W]</span>
</div>
<div class="method-description">
<p>Files matching this pattern will be excluded</p>
</div>
</div>
<div id="attribute-i-files" class="method-detail">
<div class="method-heading attribute-method-heading">
<span class="method-name">files</span><span
class="attribute-access-type">[RW]</span>
</div>
<div class="method-description">
<p>The list of files to be processed</p>
</div>
</div>
<div id="attribute-i-force_output" class="method-detail">
<div class="method-heading attribute-method-heading">
<span class="method-name">force_output</span><span
class="attribute-access-type">[RW]</span>
</div>
<div class="method-description">
<p>Create the output even if the output directory does not look like an rdoc output directory</p>
</div>
</div>
<div id="attribute-i-force_update" class="method-detail">
<div class="method-heading attribute-method-heading">
<span class="method-name">force_update</span><span
class="attribute-access-type">[RW]</span>
</div>
<div class="method-description">
<p>Scan newer sources than the flag file if true.</p>
</div>
</div>
<div id="attribute-i-formatter" class="method-detail">
<div class="method-heading attribute-method-heading">
<span class="method-name">formatter</span><span
class="attribute-access-type">[RW]</span>
</div>
<div class="method-description">
<p>Formatter to mark up text with</p>
</div>
</div>
<div id="attribute-i-generator" class="method-detail">
<div class="method-heading attribute-method-heading">
<span class="method-name">generator</span><span
class="attribute-access-type">[RW]</span>
</div>
<div class="method-description">
<p>Description of the output generator (set with the <code>--format</code> option)</p>
</div>
</div>
<div id="attribute-i-generator_options" class="method-detail">
<div class="method-heading attribute-method-heading">
<span class="method-name">generator_options</span><span
class="attribute-access-type">[RW]</span>
</div>
<div class="method-description">
<p>Loaded generator options. Used to prevent –help from loading the same options multiple times.</p>
</div>
</div>
<div id="attribute-i-hyperlink_all" class="method-detail">
<div class="method-heading attribute-method-heading">
<span class="method-name">hyperlink_all</span><span
class="attribute-access-type">[RW]</span>
</div>
<div class="method-description">
<p>Old rdoc behavior: hyperlink all words that match a method name, even if not preceded by '#' or '::'</p>
</div>
</div>
<div id="attribute-i-line_numbers" class="method-detail">
<div class="method-heading attribute-method-heading">
<span class="method-name">line_numbers</span><span
class="attribute-access-type">[RW]</span>
</div>
<div class="method-description">
<p>Include line numbers in the source code</p>
</div>
</div>
<div id="attribute-i-locale" class="method-detail">
<div class="method-heading attribute-method-heading">
<span class="method-name">locale</span><span
class="attribute-access-type">[RW]</span>
</div>
<div class="method-description">
<p>The output locale.</p>
</div>
</div>
<div id="attribute-i-locale_dir" class="method-detail">
<div class="method-heading attribute-method-heading">
<span class="method-name">locale_dir</span><span
class="attribute-access-type">[RW]</span>
</div>
<div class="method-description">
<p>The directory where locale data live.</p>
</div>
</div>
<div id="attribute-i-main_page" class="method-detail">
<div class="method-heading attribute-method-heading">
<span class="method-name">main_page</span><span
class="attribute-access-type">[RW]</span>
</div>
<div class="method-description">
<p>Name of the file, class or module to display in the initial index page (if not specified the first file we encounter is used)</p>
</div>
</div>
<div id="attribute-i-markup" class="method-detail">
<div class="method-heading attribute-method-heading">
<span class="method-name">markup</span><span
class="attribute-access-type">[RW]</span>
</div>
<div class="method-description">
<p>The default markup format. The default is 'rdoc'. 'markdown', 'tomdoc' and 'rd' are also built-in.</p>
</div>
</div>
<div id="attribute-i-op_dir" class="method-detail">
<div class="method-heading attribute-method-heading">
<span class="method-name">op_dir</span><span
class="attribute-access-type">[RW]</span>
</div>
<div class="method-description">
<p>The name of the output directory</p>
</div>
</div>
<div id="attribute-i-option_parser" class="method-detail">
<div class="method-heading attribute-method-heading">
<span class="method-name">option_parser</span><span
class="attribute-access-type">[RW]</span>
</div>
<div class="method-description">
<p>The <a href="../OptionParser.html"><code>OptionParser</code></a> for this instance</p>
</div>
</div>
<div id="attribute-i-output_decoration" class="method-detail">
<div class="method-heading attribute-method-heading">
<span class="method-name">output_decoration</span><span
class="attribute-access-type">[RW]</span>
</div>
<div class="method-description">
<p>Output heading decorations?</p>
</div>
</div>
<div id="attribute-i-page_dir" class="method-detail">
<div class="method-heading attribute-method-heading">
<span class="method-name">page_dir</span><span
class="attribute-access-type">[RW]</span>
</div>
<div class="method-description">
<p><a href="Options.html#Directory"><code>Directory</code></a> where guides, FAQ, and other pages not associated with a class live. You may leave this unset if these are at the root of your project.</p>
</div>
</div>
<div id="attribute-i-pipe" class="method-detail">
<div class="method-heading attribute-method-heading">
<span class="method-name">pipe</span><span
class="attribute-access-type">[RW]</span>
</div>
<div class="method-description">
<p>Is <a href="../RDoc.html"><code>RDoc</code></a> in pipe mode?</p>
</div>
</div>
<div id="attribute-i-rdoc_include" class="method-detail">
<div class="method-heading attribute-method-heading">
<span class="method-name">rdoc_include</span><span
class="attribute-access-type">[RW]</span>
</div>
<div class="method-description">
<p><a href="../Array.html"><code>Array</code></a> of directories to search for files to satisfy an :include:</p>
</div>
</div>
<div id="attribute-i-root" class="method-detail">
<div class="method-heading attribute-method-heading">
<span class="method-name">root</span><span
class="attribute-access-type">[RW]</span>
</div>
<div class="method-description">
<p>Root of the source documentation will be generated for. <a href="../Set.html"><code>Set</code></a> this when building documentation outside the source directory. Defaults to the current directory.</p>
</div>
</div>
<div id="attribute-i-show_hash" class="method-detail">
<div class="method-heading attribute-method-heading">
<span class="method-name">show_hash</span><span
class="attribute-access-type">[RW]</span>
</div>
<div class="method-description">
<p>Include the '#' at the front of hyperlinked instance method names</p>
</div>
</div>
<div id="attribute-i-static_path" class="method-detail">
<div class="method-heading attribute-method-heading">
<span class="method-name">static_path</span><span
class="attribute-access-type">[RW]</span>
</div>
<div class="method-description">
<p><a href="Options.html#Directory"><code>Directory</code></a> to copy static files from</p>
</div>
</div>
<div id="attribute-i-tab_width" class="method-detail">
<div class="method-heading attribute-method-heading">
<span class="method-name">tab_width</span><span
class="attribute-access-type">[RW]</span>
</div>
<div class="method-description">
<p>The number of columns in a tab</p>
</div>
</div>
<div id="attribute-i-template" class="method-detail">
<div class="method-heading attribute-method-heading">
<span class="method-name">template</span><span
class="attribute-access-type">[RW]</span>
</div>
<div class="method-description">
<p><a href="Options.html#Template"><code>Template</code></a> to be used when generating output</p>
</div>
</div>
<div id="attribute-i-template_dir" class="method-detail">
<div class="method-heading attribute-method-heading">
<span class="method-name">template_dir</span><span
class="attribute-access-type">[RW]</span>
</div>
<div class="method-description">
<p><a href="Options.html#Directory"><code>Directory</code></a> the template lives in</p>
</div>
</div>
<div id="attribute-i-template_stylesheets" class="method-detail">
<div class="method-heading attribute-method-heading">
<span class="method-name">template_stylesheets</span><span
class="attribute-access-type">[RW]</span>
</div>
<div class="method-description">
<p>Additional template stylesheets</p>
</div>
</div>
<div id="attribute-i-title" class="method-detail">
<div class="method-heading attribute-method-heading">
<span class="method-name">title</span><span
class="attribute-access-type">[RW]</span>
</div>
<div class="method-description">
<p>Documentation title</p>
</div>
</div>
<div id="attribute-i-update_output_dir" class="method-detail">
<div class="method-heading attribute-method-heading">
<span class="method-name">update_output_dir</span><span
class="attribute-access-type">[RW]</span>
</div>
<div class="method-description">
<p>Should <a href="../RDoc.html"><code>RDoc</code></a> update the timestamps in the output dir?</p>
</div>
</div>
<div id="attribute-i-verbosity" class="method-detail">
<div class="method-heading attribute-method-heading">
<span class="method-name">verbosity</span><span
class="attribute-access-type">[RW]</span>
</div>
<div class="method-description">
<p>Verbosity, zero means quiet</p>
</div>
</div>
<div id="attribute-i-visibility" class="method-detail">
<div class="method-heading attribute-method-heading">
<span class="method-name">visibility</span><span
class="attribute-access-type">[R]</span>
</div>
<div class="method-description">
<p>Minimum visibility of a documented method. One of <code>:public</code>, <code>:protected</code>, <code>:private</code> or <code>:nodoc</code>.</p>
<p>The <code>:nodoc</code> visibility ignores all directives related to visibility. The other visibilities may be overridden on a per-method basis with the :doc: directive.</p>
</div>
</div>
<div id="attribute-i-webcvs" class="method-detail">
<div class="method-heading attribute-method-heading">
<span class="method-name">webcvs</span><span
class="attribute-access-type">[RW]</span>
</div>
<div class="method-description">
<p>URL of web cvs frontend</p>
</div>
</div>
</section>
<section id="public-instance-5Buntitled-5D-method-details" class="method-section">
<header>
<h3>Public Instance Methods</h3>
</header>
<div id="method-i-check_files" class="method-detail ">
<div class="method-heading">
<span class="method-name">check_files</span><span
class="method-args">()</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<p>Check that the files on the command line exist</p>
<div class="method-source-code" id="check_files-source">
<pre><span class="ruby-comment"># File lib/rdoc/options.rb, line 444</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">check_files</span>
<span class="ruby-ivar">@files</span>.<span class="ruby-identifier">delete_if</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">file</span><span class="ruby-operator">|</span>
<span class="ruby-keyword">if</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">exist?</span> <span class="ruby-identifier">file</span> <span class="ruby-keyword">then</span>
<span class="ruby-keyword">if</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">readable?</span> <span class="ruby-identifier">file</span> <span class="ruby-keyword">then</span>
<span class="ruby-keyword">false</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">warn</span> <span class="ruby-node">"file '#{file}' not readable"</span>
<span class="ruby-keyword">true</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">warn</span> <span class="ruby-node">"file '#{file}' not found"</span>
<span class="ruby-keyword">true</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-check_generator" class="method-detail ">
<div class="method-heading">
<span class="method-name">check_generator</span><span
class="method-args">()</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<p>Ensure only one generator is loaded</p>
<div class="method-source-code" id="check_generator-source">
<pre><span class="ruby-comment"># File lib/rdoc/options.rb, line 465</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">check_generator</span>
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@generator</span> <span class="ruby-keyword">then</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">OptionParser</span><span class="ruby-operator">::</span><span class="ruby-constant">InvalidOption</span>,
<span class="ruby-node">"generator already set to #{@generator_name}"</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-default_title-3D" class="method-detail ">
<div class="method-heading">
<span class="method-name">default_title=</span><span
class="method-args">(string)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<p><a href="../Set.html"><code>Set</code></a> the title, but only if not already set. Used to set the title from a source file, so that a title set from the command line will have the priority.</p>
<div class="method-source-code" id="default_title-3D-source">
<pre><span class="ruby-comment"># File lib/rdoc/options.rb, line 477</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">default_title=</span>(<span class="ruby-identifier">string</span>)
<span class="ruby-ivar">@title</span> <span class="ruby-operator">||=</span> <span class="ruby-identifier">string</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-exclude" class="method-detail ">
<div class="method-heading">
<span class="method-name">exclude</span><span
class="method-args">()</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<p>Create a regexp for <a href="Options.html#method-i-exclude"><code>exclude</code></a></p>
<div class="method-source-code" id="exclude-source">
<pre><span class="ruby-comment"># File lib/rdoc/options.rb, line 502</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">exclude</span>
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@exclude</span>.<span class="ruby-identifier">nil?</span> <span class="ruby-keyword">or</span> <span class="ruby-constant">Regexp</span> <span class="ruby-operator">===</span> <span class="ruby-ivar">@exclude</span> <span class="ruby-keyword">then</span>
<span class="ruby-comment"># done, #finish is being re-run</span>
<span class="ruby-ivar">@exclude</span>
<span class="ruby-keyword">elsif</span> <span class="ruby-ivar">@exclude</span>.<span class="ruby-identifier">empty?</span> <span class="ruby-keyword">then</span>
<span class="ruby-keyword">nil</span>
<span class="ruby-keyword">else</span>
<span class="ruby-constant">Regexp</span>.<span class="ruby-identifier">new</span>(<span class="ruby-ivar">@exclude</span>.<span class="ruby-identifier">join</span>(<span class="ruby-string">"|"</span>))
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-finish" class="method-detail ">
<div class="method-heading">
<span class="method-name">finish</span><span
class="method-args">()</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<p>Completes any unfinished option setup business such as filtering for existent files, creating a regexp for <a href="Options.html#method-i-exclude"><code>exclude</code></a> and setting a default <a href="Options.html#attribute-i-template"><code>template</code></a>.</p>
<div class="method-source-code" id="finish-source">
<pre><span class="ruby-comment"># File lib/rdoc/options.rb, line 518</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">finish</span>
<span class="ruby-ivar">@op_dir</span> <span class="ruby-operator">||=</span> <span class="ruby-string">'doc'</span>
<span class="ruby-ivar">@rdoc_include</span> <span class="ruby-operator"><<</span> <span class="ruby-string">"."</span> <span class="ruby-keyword">if</span> <span class="ruby-ivar">@rdoc_include</span>.<span class="ruby-identifier">empty?</span>
<span class="ruby-identifier">root</span> = <span class="ruby-ivar">@root</span>.<span class="ruby-identifier">to_s</span>
<span class="ruby-ivar">@rdoc_include</span> <span class="ruby-operator"><<</span> <span class="ruby-identifier">root</span> <span class="ruby-keyword">unless</span> <span class="ruby-ivar">@rdoc_include</span>.<span class="ruby-identifier">include?</span>(<span class="ruby-identifier">root</span>)
<span class="ruby-ivar">@exclude</span> = <span class="ruby-keyword">self</span>.<span class="ruby-identifier">exclude</span>
<span class="ruby-identifier">finish_page_dir</span>
<span class="ruby-identifier">check_files</span>
<span class="ruby-comment"># If no template was specified, use the default template for the output</span>
<span class="ruby-comment"># formatter</span>
<span class="ruby-keyword">unless</span> <span class="ruby-ivar">@template</span> <span class="ruby-keyword">then</span>
<span class="ruby-ivar">@template</span> = <span class="ruby-ivar">@generator_name</span>
<span class="ruby-ivar">@template_dir</span> = <span class="ruby-identifier">template_dir_for</span> <span class="ruby-ivar">@template</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@locale_name</span>
<span class="ruby-ivar">@locale</span> = <span class="ruby-constant">RDoc</span><span class="ruby-operator">::</span><span class="ruby-constant">I18n</span><span class="ruby-operator">::</span><span class="ruby-constant">Locale</span>[<span class="ruby-ivar">@locale_name</span>]
<span class="ruby-ivar">@locale</span>.<span class="ruby-identifier">load</span>(<span class="ruby-ivar">@locale_dir</span>)
<span class="ruby-keyword">else</span>
<span class="ruby-ivar">@locale</span> = <span class="ruby-keyword">nil</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">self</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-finish_page_dir" class="method-detail ">
<div class="method-heading">
<span class="method-name">finish_page_dir</span><span
class="method-args">()</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<p>Fixes the <a href="Options.html#attribute-i-page_dir"><code>page_dir</code></a> to be relative to the root_dir and adds the <a href="Options.html#attribute-i-page_dir"><code>page_dir</code></a> to the files list.</p>
<div class="method-source-code" id="finish_page_dir-source">
<pre><span class="ruby-comment"># File lib/rdoc/options.rb, line 553</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">finish_page_dir</span>
<span class="ruby-keyword">return</span> <span class="ruby-keyword">unless</span> <span class="ruby-ivar">@page_dir</span>
<span class="ruby-ivar">@files</span> <span class="ruby-operator"><<</span> <span class="ruby-ivar">@page_dir</span>.<span class="ruby-identifier">to_s</span>
<span class="ruby-identifier">page_dir</span> = <span class="ruby-keyword">nil</span>
<span class="ruby-keyword">begin</span>
<span class="ruby-identifier">page_dir</span> = <span class="ruby-ivar">@page_dir</span>.<span class="ruby-identifier">expand_path</span>.<span class="ruby-identifier">relative_path_from</span> <span class="ruby-ivar">@root</span>
<span class="ruby-keyword">rescue</span> <span class="ruby-constant">ArgumentError</span>
<span class="ruby-comment"># On Windows, sometimes crosses different drive letters.</span>
<span class="ruby-identifier">page_dir</span> = <span class="ruby-ivar">@page_dir</span>.<span class="ruby-identifier">expand_path</span>
<span class="ruby-keyword">end</span>
<span class="ruby-ivar">@page_dir</span> = <span class="ruby-identifier">page_dir</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-generator_descriptions" class="method-detail ">
<div class="method-heading">
<span class="method-name">generator_descriptions</span><span
class="method-args">()</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<p>Returns a properly-space list of generators and their descriptions.</p>
<div class="method-source-code" id="generator_descriptions-source">
<pre><span class="ruby-comment"># File lib/rdoc/options.rb, line 572</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">generator_descriptions</span>
<span class="ruby-identifier">lengths</span> = []
<span class="ruby-identifier">generators</span> = <span class="ruby-constant">RDoc</span><span class="ruby-operator">::</span><span class="ruby-constant">RDoc</span><span class="ruby-operator">::</span><span class="ruby-constant">GENERATORS</span>.<span class="ruby-identifier">map</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">name</span>, <span class="ruby-identifier">generator</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">lengths</span> <span class="ruby-operator"><<</span> <span class="ruby-identifier">name</span>.<span class="ruby-identifier">length</span>
<span class="ruby-identifier">description</span> = <span class="ruby-identifier">generator</span><span class="ruby-operator">::</span><span class="ruby-constant">DESCRIPTION</span> <span class="ruby-keyword">if</span>
<span class="ruby-identifier">generator</span>.<span class="ruby-identifier">const_defined?</span> <span class="ruby-value">:DESCRIPTION</span>
[<span class="ruby-identifier">name</span>, <span class="ruby-identifier">description</span>]
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">longest</span> = <span class="ruby-identifier">lengths</span>.<span class="ruby-identifier">max</span>
<span class="ruby-identifier">generators</span>.<span class="ruby-identifier">sort</span>.<span class="ruby-identifier">map</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">name</span>, <span class="ruby-identifier">description</span><span class="ruby-operator">|</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">description</span> <span class="ruby-keyword">then</span>
<span class="ruby-string">" %-*s - %s"</span> <span class="ruby-operator">%</span> [<span class="ruby-identifier">longest</span>, <span class="ruby-identifier">name</span>, <span class="ruby-identifier">description</span>]
<span class="ruby-keyword">else</span>
<span class="ruby-node">" #{name}"</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>.<span class="ruby-identifier">join</span> <span class="ruby-string">"\n"</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-parse" class="method-detail ">
<div class="method-heading">
<span class="method-name">parse</span><span
class="method-args">(argv)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<p>Parses command line options.</p>
<div class="method-source-code" id="parse-source">
<pre><span class="ruby-comment"># File lib/rdoc/options.rb, line 598</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">parse</span> <span class="ruby-identifier">argv</span>
<span class="ruby-identifier">ignore_invalid</span> = <span class="ruby-keyword">true</span>
<span class="ruby-identifier">argv</span>.<span class="ruby-identifier">insert</span>(<span class="ruby-value">0</span>, <span class="ruby-operator">*</span><span class="ruby-constant">ENV</span>[<span class="ruby-string">'RDOCOPT'</span>].<span class="ruby-identifier">split</span>) <span class="ruby-keyword">if</span> <span class="ruby-constant">ENV</span>[<span class="ruby-string">'RDOCOPT'</span>]
<span class="ruby-identifier">opts</span> = <span class="ruby-constant">OptionParser</span>.<span class="ruby-identifier">new</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">opt</span><span class="ruby-operator">|</span>
<span class="ruby-ivar">@option_parser</span> = <span class="ruby-identifier">opt</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">program_name</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">basename</span> <span class="ruby-identifier">$0</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">version</span> = <span class="ruby-constant">RDoc</span><span class="ruby-operator">::</span><span class="ruby-constant">VERSION</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">release</span> = <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">summary_indent</span> = <span class="ruby-string">' '</span> <span class="ruby-operator">*</span> <span class="ruby-value">4</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">banner</span> = <span class="ruby-identifier"><<-EOF</span>
<span class="ruby-value">Usage: #{opt.program_name} [options] [names...]
Files are parsed, and the information they contain collected, before any
output is produced. This allows cross references between all files to be
resolved. If a name is a directory, it is traversed. If no names are
specified, all Ruby files in the current directory (and subdirectories) are
processed.
How RDoc generates output depends on the output formatter being used, and on
the options you give.
Options can be specified via the RDOCOPT environment variable, which
functions similar to the RUBYOPT environment variable for ruby.
$ export RDOCOPT="--show-hash"
will make rdoc show hashes in method links by default. Command-line options
always will override those in RDOCOPT.
Available formatters:
#{generator_descriptions}
RDoc understands the following file formats:
</span><span class="ruby-identifier"> EOF</span>
<span class="ruby-identifier">parsers</span> = <span class="ruby-constant">Hash</span>.<span class="ruby-identifier">new</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">h</span>,<span class="ruby-identifier">parser</span><span class="ruby-operator">|</span> <span class="ruby-identifier">h</span>[<span class="ruby-identifier">parser</span>] = [] }
<span class="ruby-constant">RDoc</span><span class="ruby-operator">::</span><span class="ruby-constant">Parser</span>.<span class="ruby-identifier">parsers</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">regexp</span>, <span class="ruby-identifier">parser</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">parsers</span>[<span class="ruby-identifier">parser</span>.<span class="ruby-identifier">name</span>.<span class="ruby-identifier">sub</span>(<span class="ruby-string">'RDoc::Parser::'</span>, <span class="ruby-string">''</span>)] <span class="ruby-operator"><<</span> <span class="ruby-identifier">regexp</span>.<span class="ruby-identifier">source</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">parsers</span>.<span class="ruby-identifier">sort</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">parser</span>, <span class="ruby-identifier">regexp</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">banner</span> <span class="ruby-operator">+=</span> <span class="ruby-node">" - #{parser}: #{regexp.join ', '}\n"</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">banner</span> <span class="ruby-operator">+=</span> <span class="ruby-string">" - TomDoc: Only in ruby files\n"</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">banner</span> <span class="ruby-operator">+=</span> <span class="ruby-string">"\n The following options are deprecated:\n\n"</span>
<span class="ruby-identifier">name_length</span> = <span class="ruby-constant">DEPRECATED</span>.<span class="ruby-identifier">keys</span>.<span class="ruby-identifier">sort_by</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">k</span><span class="ruby-operator">|</span> <span class="ruby-identifier">k</span>.<span class="ruby-identifier">length</span> }.<span class="ruby-identifier">last</span>.<span class="ruby-identifier">length</span>
<span class="ruby-constant">DEPRECATED</span>.<span class="ruby-identifier">sort_by</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">k</span>,<span class="ruby-operator">|</span> <span class="ruby-identifier">k</span> }.<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">name</span>, <span class="ruby-identifier">reason</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">banner</span> <span class="ruby-operator">+=</span> <span class="ruby-string">" %*1$2$s %3$s\n"</span> <span class="ruby-operator">%</span> [<span class="ruby-operator">-</span><span class="ruby-identifier">name_length</span>, <span class="ruby-identifier">name</span>, <span class="ruby-identifier">reason</span>]
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">accept</span> <span class="ruby-constant">Template</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">template</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">template_dir</span> = <span class="ruby-identifier">template_dir_for</span> <span class="ruby-identifier">template</span>
<span class="ruby-keyword">unless</span> <span class="ruby-identifier">template_dir</span> <span class="ruby-keyword">then</span>
<span class="ruby-identifier">$stderr</span>.<span class="ruby-identifier">puts</span> <span class="ruby-node">"could not find template #{template}"</span>
<span class="ruby-keyword">nil</span>
<span class="ruby-keyword">else</span>
[<span class="ruby-identifier">template</span>, <span class="ruby-identifier">template_dir</span>]
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">accept</span> <span class="ruby-constant">Directory</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">directory</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">directory</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">expand_path</span> <span class="ruby-identifier">directory</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">OptionParser</span><span class="ruby-operator">::</span><span class="ruby-constant">InvalidArgument</span> <span class="ruby-keyword">unless</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">directory?</span> <span class="ruby-identifier">directory</span>
<span class="ruby-identifier">directory</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">accept</span> <span class="ruby-constant">Path</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">path</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">path</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">expand_path</span> <span class="ruby-identifier">path</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">OptionParser</span><span class="ruby-operator">::</span><span class="ruby-constant">InvalidArgument</span> <span class="ruby-keyword">unless</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">exist?</span> <span class="ruby-identifier">path</span>
<span class="ruby-identifier">path</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">accept</span> <span class="ruby-constant">PathArray</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">paths</span>,<span class="ruby-operator">|</span>
<span class="ruby-identifier">paths</span> = <span class="ruby-keyword">if</span> <span class="ruby-identifier">paths</span> <span class="ruby-keyword">then</span>
<span class="ruby-identifier">paths</span>.<span class="ruby-identifier">split</span>(<span class="ruby-string">','</span>).<span class="ruby-identifier">map</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">d</span><span class="ruby-operator">|</span> <span class="ruby-identifier">d</span> <span class="ruby-keyword">unless</span> <span class="ruby-identifier">d</span>.<span class="ruby-identifier">empty?</span> }
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">paths</span>.<span class="ruby-identifier">map</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">path</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">path</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">expand_path</span> <span class="ruby-identifier">path</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">OptionParser</span><span class="ruby-operator">::</span><span class="ruby-constant">InvalidArgument</span> <span class="ruby-keyword">unless</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">exist?</span> <span class="ruby-identifier">path</span>
<span class="ruby-identifier">path</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">separator</span> <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">separator</span> <span class="ruby-string">"Parsing options:"</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">separator</span> <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">on</span>(<span class="ruby-string">"--encoding=ENCODING"</span>, <span class="ruby-string">"-e"</span>, <span class="ruby-constant">Encoding</span>.<span class="ruby-identifier">list</span>.<span class="ruby-identifier">map</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">e</span><span class="ruby-operator">|</span> <span class="ruby-identifier">e</span>.<span class="ruby-identifier">name</span> },
<span class="ruby-string">"Specifies the output encoding. All files"</span>,
<span class="ruby-string">"read will be converted to this encoding."</span>,
<span class="ruby-string">"The default encoding is UTF-8."</span>,
<span class="ruby-string">"--encoding is preferred over --charset"</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
<span class="ruby-ivar">@encoding</span> = <span class="ruby-constant">Encoding</span>.<span class="ruby-identifier">find</span> <span class="ruby-identifier">value</span>
<span class="ruby-ivar">@charset</span> = <span class="ruby-ivar">@encoding</span>.<span class="ruby-identifier">name</span> <span class="ruby-comment"># may not be valid value</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">separator</span> <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">on</span>(<span class="ruby-string">"--locale=NAME"</span>,
<span class="ruby-string">"Specifies the output locale."</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
<span class="ruby-ivar">@locale_name</span> = <span class="ruby-identifier">value</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">on</span>(<span class="ruby-string">"--locale-data-dir=DIR"</span>,
<span class="ruby-string">"Specifies the directory where locale data live."</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
<span class="ruby-ivar">@locale_dir</span> = <span class="ruby-identifier">value</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">separator</span> <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">on</span>(<span class="ruby-string">"--all"</span>, <span class="ruby-string">"-a"</span>,
<span class="ruby-string">"Synonym for --visibility=private."</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
<span class="ruby-ivar">@visibility</span> = <span class="ruby-value">:private</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">separator</span> <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">on</span>(<span class="ruby-string">"--exclude=PATTERN"</span>, <span class="ruby-string">"-x"</span>, <span class="ruby-constant">Regexp</span>,
<span class="ruby-string">"Do not process files or directories"</span>,
<span class="ruby-string">"matching PATTERN."</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
<span class="ruby-ivar">@exclude</span> <span class="ruby-operator"><<</span> <span class="ruby-identifier">value</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">separator</span> <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">on</span>(<span class="ruby-string">"--extension=NEW=OLD"</span>, <span class="ruby-string">"-E"</span>,
<span class="ruby-string">"Treat files ending with .new as if they"</span>,
<span class="ruby-string">"ended with .old. Using '-E cgi=rb' will"</span>,
<span class="ruby-string">"cause xxx.cgi to be parsed as a Ruby file."</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">new</span>, <span class="ruby-identifier">old</span> = <span class="ruby-identifier">value</span>.<span class="ruby-identifier">split</span>(<span class="ruby-regexp">/=/</span>, <span class="ruby-value">2</span>)
<span class="ruby-keyword">unless</span> <span class="ruby-identifier">new</span> <span class="ruby-keyword">and</span> <span class="ruby-identifier">old</span> <span class="ruby-keyword">then</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">OptionParser</span><span class="ruby-operator">::</span><span class="ruby-constant">InvalidArgument</span>, <span class="ruby-string">"Invalid parameter to '-E'"</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">unless</span> <span class="ruby-constant">RDoc</span><span class="ruby-operator">::</span><span class="ruby-constant">Parser</span>.<span class="ruby-identifier">alias_extension</span> <span class="ruby-identifier">old</span>, <span class="ruby-identifier">new</span> <span class="ruby-keyword">then</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">OptionParser</span><span class="ruby-operator">::</span><span class="ruby-constant">InvalidArgument</span>, <span class="ruby-node">"Unknown extension .#{old} to -E"</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">separator</span> <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">on</span>(<span class="ruby-string">"--[no-]force-update"</span>, <span class="ruby-string">"-U"</span>,
<span class="ruby-string">"Forces rdoc to scan all sources even if"</span>,
<span class="ruby-string">"newer than the flag file."</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
<span class="ruby-ivar">@force_update</span> = <span class="ruby-identifier">value</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">separator</span> <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">on</span>(<span class="ruby-string">"--pipe"</span>, <span class="ruby-string">"-p"</span>,
<span class="ruby-string">"Convert RDoc on stdin to HTML"</span>) <span class="ruby-keyword">do</span>
<span class="ruby-ivar">@pipe</span> = <span class="ruby-keyword">true</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">separator</span> <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">on</span>(<span class="ruby-string">"--tab-width=WIDTH"</span>, <span class="ruby-string">"-w"</span>, <span class="ruby-constant">Integer</span>,
<span class="ruby-string">"Set the width of tab characters."</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">OptionParser</span><span class="ruby-operator">::</span><span class="ruby-constant">InvalidArgument</span>,
<span class="ruby-node">"#{value} is an invalid tab width"</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">value</span> <span class="ruby-operator"><=</span> <span class="ruby-value">0</span>
<span class="ruby-ivar">@tab_width</span> = <span class="ruby-identifier">value</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">separator</span> <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">on</span>(<span class="ruby-string">"--visibility=VISIBILITY"</span>, <span class="ruby-string">"-V"</span>, <span class="ruby-constant">RDoc</span><span class="ruby-operator">::</span><span class="ruby-constant">VISIBILITIES</span> <span class="ruby-operator">+</span> [<span class="ruby-value">:nodoc</span>],
<span class="ruby-string">"Minimum visibility to document a method."</span>,
<span class="ruby-string">"One of 'public', 'protected' (the default),"</span>,
<span class="ruby-string">"'private' or 'nodoc' (show everything)"</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
<span class="ruby-ivar">@visibility</span> = <span class="ruby-identifier">value</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">separator</span> <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">markup_formats</span> = <span class="ruby-constant">RDoc</span><span class="ruby-operator">::</span><span class="ruby-constant">Text</span><span class="ruby-operator">::</span><span class="ruby-constant">MARKUP_FORMAT</span>.<span class="ruby-identifier">keys</span>.<span class="ruby-identifier">sort</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">on</span>(<span class="ruby-string">"--markup=MARKUP"</span>, <span class="ruby-identifier">markup_formats</span>,
<span class="ruby-string">"The markup format for the named files."</span>,
<span class="ruby-string">"The default is rdoc. Valid values are:"</span>,
<span class="ruby-identifier">markup_formats</span>.<span class="ruby-identifier">join</span>(<span class="ruby-string">', '</span>)) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
<span class="ruby-ivar">@markup</span> = <span class="ruby-identifier">value</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">separator</span> <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">on</span>(<span class="ruby-string">"--root=ROOT"</span>, <span class="ruby-constant">Directory</span>,
<span class="ruby-string">"Root of the source tree documentation"</span>,
<span class="ruby-string">"will be generated for. Set this when"</span>,
<span class="ruby-string">"building documentation outside the"</span>,
<span class="ruby-string">"source directory. Default is the"</span>,
<span class="ruby-string">"current directory."</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">root</span><span class="ruby-operator">|</span>
<span class="ruby-ivar">@root</span> = <span class="ruby-constant">Pathname</span>(<span class="ruby-identifier">root</span>)
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">separator</span> <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">on</span>(<span class="ruby-string">"--page-dir=DIR"</span>, <span class="ruby-constant">Directory</span>,
<span class="ruby-string">"Directory where guides, your FAQ or"</span>,
<span class="ruby-string">"other pages not associated with a class"</span>,
<span class="ruby-string">"live. Set this when you don't store"</span>,
<span class="ruby-string">"such files at your project root."</span>,
<span class="ruby-string">"NOTE: Do not use the same file name in"</span>,
<span class="ruby-string">"the page dir and the root of your project"</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">page_dir</span><span class="ruby-operator">|</span>
<span class="ruby-ivar">@page_dir</span> = <span class="ruby-constant">Pathname</span>(<span class="ruby-identifier">page_dir</span>)
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">separator</span> <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">separator</span> <span class="ruby-string">"Common generator options:"</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">separator</span> <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">on</span>(<span class="ruby-string">"--force-output"</span>, <span class="ruby-string">"-O"</span>,
<span class="ruby-string">"Forces rdoc to write the output files,"</span>,
<span class="ruby-string">"even if the output directory exists"</span>,
<span class="ruby-string">"and does not seem to have been created"</span>,
<span class="ruby-string">"by rdoc."</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
<span class="ruby-ivar">@force_output</span> = <span class="ruby-identifier">value</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">separator</span> <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">generator_text</span> = <span class="ruby-ivar">@generators</span>.<span class="ruby-identifier">keys</span>.<span class="ruby-identifier">map</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">name</span><span class="ruby-operator">|</span> <span class="ruby-node">" #{name}"</span> }.<span class="ruby-identifier">sort</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">on</span>(<span class="ruby-string">"-f"</span>, <span class="ruby-string">"--fmt=FORMAT"</span>, <span class="ruby-string">"--format=FORMAT"</span>, <span class="ruby-ivar">@generators</span>.<span class="ruby-identifier">keys</span>,
<span class="ruby-string">"Set the output formatter. One of:"</span>, <span class="ruby-operator">*</span><span class="ruby-identifier">generator_text</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">check_generator</span>
<span class="ruby-ivar">@generator_name</span> = <span class="ruby-identifier">value</span>.<span class="ruby-identifier">downcase</span>
<span class="ruby-identifier">setup_generator</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">separator</span> <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">on</span>(<span class="ruby-string">"--include=DIRECTORIES"</span>, <span class="ruby-string">"-i"</span>, <span class="ruby-constant">PathArray</span>,
<span class="ruby-string">"Set (or add to) the list of directories to"</span>,
<span class="ruby-string">"be searched when satisfying :include:"</span>,
<span class="ruby-string">"requests. Can be used more than once."</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
<span class="ruby-ivar">@rdoc_include</span>.<span class="ruby-identifier">concat</span> <span class="ruby-identifier">value</span>.<span class="ruby-identifier">map</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">dir</span><span class="ruby-operator">|</span> <span class="ruby-identifier">dir</span>.<span class="ruby-identifier">strip</span> }
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">separator</span> <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">on</span>(<span class="ruby-string">"--[no-]coverage-report=[LEVEL]"</span>, <span class="ruby-string">"--[no-]dcov"</span>, <span class="ruby-string">"-C"</span>, <span class="ruby-constant">Integer</span>,
<span class="ruby-string">"Prints a report on undocumented items."</span>,
<span class="ruby-string">"Does not generate files."</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">value</span> = <span class="ruby-value">0</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">value</span>.<span class="ruby-identifier">nil?</span> <span class="ruby-comment"># Integer converts -C to nil</span>
<span class="ruby-ivar">@coverage_report</span> = <span class="ruby-identifier">value</span>
<span class="ruby-ivar">@force_update</span> = <span class="ruby-keyword">true</span> <span class="ruby-keyword">if</span> <span class="ruby-identifier">value</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">separator</span> <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">on</span>(<span class="ruby-string">"--output=DIR"</span>, <span class="ruby-string">"--op"</span>, <span class="ruby-string">"-o"</span>,
<span class="ruby-string">"Set the output directory."</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
<span class="ruby-ivar">@op_dir</span> = <span class="ruby-identifier">value</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">separator</span> <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">on</span>(<span class="ruby-string">"-d"</span>,
<span class="ruby-string">"Deprecated --diagram option."</span>,
<span class="ruby-string">"Prevents firing debug mode"</span>,
<span class="ruby-string">"with legacy invocation."</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">separator</span> <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">separator</span> <span class="ruby-string">'HTML generator options:'</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">separator</span> <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">on</span>(<span class="ruby-string">"--charset=CHARSET"</span>, <span class="ruby-string">"-c"</span>,
<span class="ruby-string">"Specifies the output HTML character-set."</span>,
<span class="ruby-string">"Use --encoding instead of --charset if"</span>,
<span class="ruby-string">"available."</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
<span class="ruby-ivar">@charset</span> = <span class="ruby-identifier">value</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">separator</span> <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">on</span>(<span class="ruby-string">"--hyperlink-all"</span>, <span class="ruby-string">"-A"</span>,
<span class="ruby-string">"Generate hyperlinks for all words that"</span>,
<span class="ruby-string">"correspond to known methods, even if they"</span>,
<span class="ruby-string">"do not start with '#' or '::' (legacy"</span>,
<span class="ruby-string">"behavior)."</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
<span class="ruby-ivar">@hyperlink_all</span> = <span class="ruby-identifier">value</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">separator</span> <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">on</span>(<span class="ruby-string">"--main=NAME"</span>, <span class="ruby-string">"-m"</span>,
<span class="ruby-string">"NAME will be the initial page displayed."</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
<span class="ruby-ivar">@main_page</span> = <span class="ruby-identifier">value</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">separator</span> <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">on</span>(<span class="ruby-string">"--[no-]line-numbers"</span>, <span class="ruby-string">"-N"</span>,
<span class="ruby-string">"Include line numbers in the source code."</span>,
<span class="ruby-string">"By default, only the number of the first"</span>,
<span class="ruby-string">"line is displayed, in a leading comment."</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
<span class="ruby-ivar">@line_numbers</span> = <span class="ruby-identifier">value</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">separator</span> <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">on</span>(<span class="ruby-string">"--show-hash"</span>, <span class="ruby-string">"-H"</span>,
<span class="ruby-string">"A name of the form #name in a comment is a"</span>,
<span class="ruby-string">"possible hyperlink to an instance method"</span>,
<span class="ruby-string">"name. When displayed, the '#' is removed"</span>,
<span class="ruby-string">"unless this option is specified."</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
<span class="ruby-ivar">@show_hash</span> = <span class="ruby-identifier">value</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">separator</span> <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">on</span>(<span class="ruby-string">"--template=NAME"</span>, <span class="ruby-string">"-T"</span>, <span class="ruby-constant">Template</span>,
<span class="ruby-string">"Set the template used when generating"</span>,
<span class="ruby-string">"output. The default depends on the"</span>,
<span class="ruby-string">"formatter used."</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span>(<span class="ruby-identifier">template</span>, <span class="ruby-identifier">template_dir</span>)<span class="ruby-operator">|</span>
<span class="ruby-ivar">@template</span> = <span class="ruby-identifier">template</span>
<span class="ruby-ivar">@template_dir</span> = <span class="ruby-identifier">template_dir</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">separator</span> <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">on</span>(<span class="ruby-string">"--template-stylesheets=FILES"</span>, <span class="ruby-constant">PathArray</span>,
<span class="ruby-string">"Set (or add to) the list of files to"</span>,
<span class="ruby-string">"include with the html template."</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
<span class="ruby-ivar">@template_stylesheets</span> <span class="ruby-operator"><<</span> <span class="ruby-identifier">value</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">separator</span> <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">on</span>(<span class="ruby-string">"--title=TITLE"</span>, <span class="ruby-string">"-t"</span>,
<span class="ruby-string">"Set TITLE as the title for HTML output."</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
<span class="ruby-ivar">@title</span> = <span class="ruby-identifier">value</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">separator</span> <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">on</span>(<span class="ruby-string">"--copy-files=PATH"</span>, <span class="ruby-constant">Path</span>,
<span class="ruby-string">"Specify a file or directory to copy static"</span>,
<span class="ruby-string">"files from."</span>,
<span class="ruby-string">"If a file is given it will be copied into"</span>,
<span class="ruby-string">"the output dir. If a directory is given the"</span>,
<span class="ruby-string">"entire directory will be copied."</span>,
<span class="ruby-string">"You can use this multiple times"</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
<span class="ruby-ivar">@static_path</span> <span class="ruby-operator"><<</span> <span class="ruby-identifier">value</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">separator</span> <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">on</span>(<span class="ruby-string">"--webcvs=URL"</span>, <span class="ruby-string">"-W"</span>,
<span class="ruby-string">"Specify a URL for linking to a web frontend"</span>,
<span class="ruby-string">"to CVS. If the URL contains a '\%s', the"</span>,
<span class="ruby-string">"name of the current file will be"</span>,
<span class="ruby-string">"substituted; if the URL doesn't contain a"</span>,
<span class="ruby-string">"'\%s', the filename will be appended to it."</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
<span class="ruby-ivar">@webcvs</span> = <span class="ruby-identifier">value</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">separator</span> <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">separator</span> <span class="ruby-string">"ri generator options:"</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">separator</span> <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">on</span>(<span class="ruby-string">"--ri"</span>, <span class="ruby-string">"-r"</span>,
<span class="ruby-string">"Generate output for use by `ri`. The files"</span>,
<span class="ruby-string">"are stored in the '.rdoc' directory under"</span>,
<span class="ruby-string">"your home directory unless overridden by a"</span>,
<span class="ruby-string">"subsequent --op parameter, so no special"</span>,
<span class="ruby-string">"privileges are needed."</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">check_generator</span>
<span class="ruby-ivar">@generator_name</span> = <span class="ruby-string">"ri"</span>
<span class="ruby-ivar">@op_dir</span> <span class="ruby-operator">||=</span> <span class="ruby-constant">RDoc</span><span class="ruby-operator">::</span><span class="ruby-constant">RI</span><span class="ruby-operator">::</span><span class="ruby-constant">Paths</span><span class="ruby-operator">::</span><span class="ruby-constant">HOMEDIR</span>
<span class="ruby-identifier">setup_generator</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">separator</span> <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">on</span>(<span class="ruby-string">"--ri-site"</span>, <span class="ruby-string">"-R"</span>,
<span class="ruby-string">"Generate output for use by `ri`. The files"</span>,
<span class="ruby-string">"are stored in a site-wide directory,"</span>,
<span class="ruby-string">"making them accessible to others, so"</span>,
<span class="ruby-string">"special privileges are needed."</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">check_generator</span>
<span class="ruby-ivar">@generator_name</span> = <span class="ruby-string">"ri"</span>
<span class="ruby-ivar">@op_dir</span> = <span class="ruby-constant">RDoc</span><span class="ruby-operator">::</span><span class="ruby-constant">RI</span><span class="ruby-operator">::</span><span class="ruby-constant">Paths</span>.<span class="ruby-identifier">site_dir</span>
<span class="ruby-identifier">setup_generator</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">separator</span> <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">separator</span> <span class="ruby-string">"Generic options:"</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">separator</span> <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">on</span>(<span class="ruby-string">"--write-options"</span>,
<span class="ruby-string">"Write .rdoc_options to the current"</span>,
<span class="ruby-string">"directory with the given options. Not all"</span>,
<span class="ruby-string">"options will be used. See RDoc::Options"</span>,
<span class="ruby-string">"for details."</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
<span class="ruby-ivar">@write_options</span> = <span class="ruby-keyword">true</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">separator</span> <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">on</span>(<span class="ruby-string">"--[no-]dry-run"</span>,
<span class="ruby-string">"Don't write any files"</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
<span class="ruby-ivar">@dry_run</span> = <span class="ruby-identifier">value</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">separator</span> <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">on</span>(<span class="ruby-string">"-D"</span>, <span class="ruby-string">"--[no-]debug"</span>,
<span class="ruby-string">"Displays lots on internal stuff."</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">$DEBUG_RDOC</span> = <span class="ruby-identifier">value</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">separator</span> <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">on</span>(<span class="ruby-string">"--[no-]ignore-invalid"</span>,
<span class="ruby-string">"Ignore invalid options and continue"</span>,
<span class="ruby-string">"(default true)."</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">ignore_invalid</span> = <span class="ruby-identifier">value</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">separator</span> <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">on</span>(<span class="ruby-string">"--quiet"</span>, <span class="ruby-string">"-q"</span>,
<span class="ruby-string">"Don't show progress as we parse."</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
<span class="ruby-ivar">@verbosity</span> = <span class="ruby-value">0</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">separator</span> <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">on</span>(<span class="ruby-string">"--verbose"</span>, <span class="ruby-string">"-V"</span>,
<span class="ruby-string">"Display extra progress as RDoc parses"</span>) <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">value</span><span class="ruby-operator">|</span>
<span class="ruby-ivar">@verbosity</span> = <span class="ruby-value">2</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">separator</span> <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">on</span>(<span class="ruby-string">"--version"</span>, <span class="ruby-string">"-v"</span>, <span class="ruby-string">"print the version"</span>) <span class="ruby-keyword">do</span>
<span class="ruby-identifier">puts</span> <span class="ruby-identifier">opt</span>.<span class="ruby-identifier">version</span>
<span class="ruby-identifier">exit</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">separator</span> <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">on</span>(<span class="ruby-string">"--help"</span>, <span class="ruby-string">"-h"</span>, <span class="ruby-string">"Display this help"</span>) <span class="ruby-keyword">do</span>
<span class="ruby-constant">RDoc</span><span class="ruby-operator">::</span><span class="ruby-constant">RDoc</span><span class="ruby-operator">::</span><span class="ruby-constant">GENERATORS</span>.<span class="ruby-identifier">each_key</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">generator</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">setup_generator</span> <span class="ruby-identifier">generator</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">puts</span> <span class="ruby-identifier">opt</span>.<span class="ruby-identifier">help</span>
<span class="ruby-identifier">exit</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">opt</span>.<span class="ruby-identifier">separator</span> <span class="ruby-keyword">nil</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">setup_generator</span> <span class="ruby-string">'darkfish'</span> <span class="ruby-keyword">if</span>
<span class="ruby-identifier">argv</span>.<span class="ruby-identifier">grep</span>(<span class="ruby-regexp">/\A(-f|--fmt|--format|-r|-R|--ri|--ri-site)\b/</span>).<span class="ruby-identifier">empty?</span>
<span class="ruby-identifier">deprecated</span> = []
<span class="ruby-identifier">invalid</span> = []
<span class="ruby-keyword">begin</span>
<span class="ruby-identifier">opts</span>.<span class="ruby-identifier">parse!</span> <span class="ruby-identifier">argv</span>
<span class="ruby-keyword">rescue</span> <span class="ruby-constant">OptionParser</span><span class="ruby-operator">::</span><span class="ruby-constant">ParseError</span> <span class="ruby-operator">=></span> <span class="ruby-identifier">e</span>
<span class="ruby-keyword">if</span> <span class="ruby-constant">DEPRECATED</span>[<span class="ruby-identifier">e</span>.<span class="ruby-identifier">args</span>.<span class="ruby-identifier">first</span>] <span class="ruby-keyword">then</span>
<span class="ruby-identifier">deprecated</span> <span class="ruby-operator"><<</span> <span class="ruby-identifier">e</span>.<span class="ruby-identifier">args</span>.<span class="ruby-identifier">first</span>
<span class="ruby-keyword">elsif</span> <span class="ruby-node">%w[--format --ri -r --ri-site -R]</span>.<span class="ruby-identifier">include?</span> <span class="ruby-identifier">e</span>.<span class="ruby-identifier">args</span>.<span class="ruby-identifier">first</span> <span class="ruby-keyword">then</span>
<span class="ruby-identifier">raise</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">invalid</span> <span class="ruby-operator"><<</span> <span class="ruby-identifier">e</span>.<span class="ruby-identifier">args</span>.<span class="ruby-identifier">join</span>(<span class="ruby-string">' '</span>)
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">retry</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">unless</span> <span class="ruby-ivar">@generator</span> <span class="ruby-keyword">then</span>
<span class="ruby-ivar">@generator</span> = <span class="ruby-constant">RDoc</span><span class="ruby-operator">::</span><span class="ruby-constant">Generator</span><span class="ruby-operator">::</span><span class="ruby-constant">Darkfish</span>
<span class="ruby-ivar">@generator_name</span> = <span class="ruby-string">'darkfish'</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@pipe</span> <span class="ruby-keyword">and</span> <span class="ruby-keyword">not</span> <span class="ruby-identifier">argv</span>.<span class="ruby-identifier">empty?</span> <span class="ruby-keyword">then</span>
<span class="ruby-ivar">@pipe</span> = <span class="ruby-keyword">false</span>
<span class="ruby-identifier">invalid</span> <span class="ruby-operator"><<</span> <span class="ruby-string">'-p (with files)'</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">unless</span> <span class="ruby-identifier">quiet</span> <span class="ruby-keyword">then</span>
<span class="ruby-identifier">deprecated</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">opt</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">$stderr</span>.<span class="ruby-identifier">puts</span> <span class="ruby-string">'option '</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">opt</span> <span class="ruby-operator">+</span> <span class="ruby-string">' is deprecated: '</span> <span class="ruby-operator">+</span> <span class="ruby-constant">DEPRECATED</span>[<span class="ruby-identifier">opt</span>]
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">unless</span> <span class="ruby-identifier">invalid</span>.<span class="ruby-identifier">empty?</span> <span class="ruby-keyword">then</span>
<span class="ruby-identifier">invalid</span> = <span class="ruby-node">"invalid options: #{invalid.join ', '}"</span>
<span class="ruby-keyword">if</span> <span class="ruby-identifier">ignore_invalid</span> <span class="ruby-keyword">then</span>
<span class="ruby-keyword">unless</span> <span class="ruby-identifier">quiet</span> <span class="ruby-keyword">then</span>
<span class="ruby-identifier">$stderr</span>.<span class="ruby-identifier">puts</span> <span class="ruby-identifier">invalid</span>
<span class="ruby-identifier">$stderr</span>.<span class="ruby-identifier">puts</span> <span class="ruby-string">'(invalid options are ignored)'</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">else</span>
<span class="ruby-keyword">unless</span> <span class="ruby-identifier">quiet</span> <span class="ruby-keyword">then</span>
<span class="ruby-identifier">$stderr</span>.<span class="ruby-identifier">puts</span> <span class="ruby-identifier">opts</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">$stderr</span>.<span class="ruby-identifier">puts</span> <span class="ruby-identifier">invalid</span>
<span class="ruby-identifier">exit</span> <span class="ruby-value">1</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span>
<span class="ruby-ivar">@files</span> = <span class="ruby-identifier">argv</span>.<span class="ruby-identifier">dup</span>
<span class="ruby-identifier">finish</span>
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@write_options</span> <span class="ruby-keyword">then</span>
<span class="ruby-identifier">write_options</span>
<span class="ruby-identifier">exit</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">self</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-quiet" class="method-detail ">
<div class="method-heading">
<span class="method-name">quiet</span><span
class="method-args">()</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<p>Don't display progress as we process the files</p>
<div class="method-source-code" id="quiet-source">
<pre><span class="ruby-comment"># File lib/rdoc/options.rb, line 1143</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">quiet</span>
<span class="ruby-ivar">@verbosity</span>.<span class="ruby-identifier">zero?</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-quiet-3D" class="method-detail ">
<div class="method-heading">
<span class="method-name">quiet=</span><span
class="method-args">(bool)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<p><a href="../Set.html"><code>Set</code></a> quietness to <code>bool</code></p>
<div class="method-source-code" id="quiet-3D-source">
<pre><span class="ruby-comment"># File lib/rdoc/options.rb, line 1150</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">quiet=</span> <span class="ruby-identifier">bool</span>
<span class="ruby-ivar">@verbosity</span> = <span class="ruby-identifier">bool</span> <span class="ruby-operator">?</span> <span class="ruby-value">0</span> <span class="ruby-operator">:</span> <span class="ruby-value">1</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-sanitize_path" class="method-detail ">
<div class="method-heading">
<span class="method-name">sanitize_path</span><span
class="method-args">(path)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<p>Removes directories from <code>path</code> that are outside the current directory</p>
<div class="method-source-code" id="sanitize_path-source">
<pre><span class="ruby-comment"># File lib/rdoc/options.rb, line 1157</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">sanitize_path</span> <span class="ruby-identifier">path</span>
<span class="ruby-identifier">require</span> <span class="ruby-string">'pathname'</span>
<span class="ruby-identifier">dot</span> = <span class="ruby-constant">Pathname</span>.<span class="ruby-identifier">new</span>(<span class="ruby-string">'.'</span>).<span class="ruby-identifier">expand_path</span>
<span class="ruby-identifier">path</span>.<span class="ruby-identifier">reject</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">item</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">path</span> = <span class="ruby-constant">Pathname</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">item</span>).<span class="ruby-identifier">expand_path</span>
<span class="ruby-identifier">is_reject</span> = <span class="ruby-keyword">nil</span>
<span class="ruby-identifier">relative</span> = <span class="ruby-keyword">nil</span>
<span class="ruby-keyword">begin</span>
<span class="ruby-identifier">relative</span> = <span class="ruby-identifier">path</span>.<span class="ruby-identifier">relative_path_from</span>(<span class="ruby-identifier">dot</span>).<span class="ruby-identifier">to_s</span>
<span class="ruby-keyword">rescue</span> <span class="ruby-constant">ArgumentError</span>
<span class="ruby-comment"># On Windows, sometimes crosses different drive letters.</span>
<span class="ruby-identifier">is_reject</span> = <span class="ruby-keyword">true</span>
<span class="ruby-keyword">else</span>
<span class="ruby-identifier">is_reject</span> = <span class="ruby-identifier">relative</span>.<span class="ruby-identifier">start_with?</span> <span class="ruby-string">'..'</span>
<span class="ruby-keyword">end</span>
<span class="ruby-identifier">is_reject</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-setup_generator" class="method-detail ">
<div class="method-heading">
<span class="method-name">setup_generator</span><span
class="method-args">(generator_name = @generator_name)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<p><a href="../Set.html"><code>Set</code></a> up an output generator for the named <code>generator_name</code>.</p>
<p>If the found generator responds to :setup_options it will be called with the options instance. This allows generators to add custom options or set default options.</p>
<div class="method-source-code" id="setup_generator-source">
<pre><span class="ruby-comment"># File lib/rdoc/options.rb, line 1184</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">setup_generator</span> <span class="ruby-identifier">generator_name</span> = <span class="ruby-ivar">@generator_name</span>
<span class="ruby-ivar">@generator</span> = <span class="ruby-ivar">@generators</span>[<span class="ruby-identifier">generator_name</span>]
<span class="ruby-keyword">unless</span> <span class="ruby-ivar">@generator</span> <span class="ruby-keyword">then</span>
<span class="ruby-identifier">raise</span> <span class="ruby-constant">OptionParser</span><span class="ruby-operator">::</span><span class="ruby-constant">InvalidArgument</span>,
<span class="ruby-node">"Invalid output formatter #{generator_name}"</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">return</span> <span class="ruby-keyword">if</span> <span class="ruby-ivar">@generator_options</span>.<span class="ruby-identifier">include?</span> <span class="ruby-ivar">@generator</span>
<span class="ruby-ivar">@generator_name</span> = <span class="ruby-identifier">generator_name</span>
<span class="ruby-ivar">@generator_options</span> <span class="ruby-operator"><<</span> <span class="ruby-ivar">@generator</span>
<span class="ruby-keyword">if</span> <span class="ruby-ivar">@generator</span>.<span class="ruby-identifier">respond_to?</span> <span class="ruby-value">:setup_options</span> <span class="ruby-keyword">then</span>
<span class="ruby-ivar">@option_parser</span> <span class="ruby-operator">||=</span> <span class="ruby-constant">OptionParser</span>.<span class="ruby-identifier">new</span>
<span class="ruby-ivar">@generator</span>.<span class="ruby-identifier">setup_options</span> <span class="ruby-keyword">self</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-template_dir_for" class="method-detail ">
<div class="method-heading">
<span class="method-name">template_dir_for</span><span
class="method-args">(template)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<p>Finds the template dir for <code>template</code></p>
<div class="method-source-code" id="template_dir_for-source">
<pre><span class="ruby-comment"># File lib/rdoc/options.rb, line 1206</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">template_dir_for</span> <span class="ruby-identifier">template</span>
<span class="ruby-identifier">template_path</span> = <span class="ruby-constant">File</span>.<span class="ruby-identifier">join</span> <span class="ruby-string">'rdoc'</span>, <span class="ruby-string">'generator'</span>, <span class="ruby-string">'template'</span>, <span class="ruby-identifier">template</span>
<span class="ruby-identifier">$LOAD_PATH</span>.<span class="ruby-identifier">map</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">path</span><span class="ruby-operator">|</span>
<span class="ruby-constant">File</span>.<span class="ruby-identifier">join</span> <span class="ruby-constant">File</span>.<span class="ruby-identifier">expand_path</span>(<span class="ruby-identifier">path</span>), <span class="ruby-identifier">template_path</span>
<span class="ruby-keyword">end</span>.<span class="ruby-identifier">find</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">dir</span><span class="ruby-operator">|</span>
<span class="ruby-constant">File</span>.<span class="ruby-identifier">directory?</span> <span class="ruby-identifier">dir</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-visibility-3D" class="method-detail ">
<div class="method-heading">
<span class="method-name">visibility=</span><span
class="method-args">(visibility)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<p>Sets the minimum visibility of a documented method.</p>
<p>Accepts <code>:public</code>, <code>:protected</code>, <code>:private</code>, <code>:nodoc</code>, or <code>:all</code>.</p>
<p>When <code>:all</code> is passed, visibility is set to <code>:private</code>, similarly to RDOCOPT=“–all”, see <a href="Options.html#attribute-i-visibility"><code>visibility</code></a> for more information.</p>
<div class="method-source-code" id="visibility-3D-source">
<pre><span class="ruby-comment"># File lib/rdoc/options.rb, line 1223</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">visibility=</span> <span class="ruby-identifier">visibility</span>
<span class="ruby-keyword">case</span> <span class="ruby-identifier">visibility</span>
<span class="ruby-keyword">when</span> <span class="ruby-value">:all</span>
<span class="ruby-ivar">@visibility</span> = <span class="ruby-value">:private</span>
<span class="ruby-keyword">else</span>
<span class="ruby-ivar">@visibility</span> = <span class="ruby-identifier">visibility</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-warn" class="method-detail ">
<div class="method-heading">
<span class="method-name">warn</span><span
class="method-args">(message)</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<p>Displays a warning using <a href="../Kernel.html#method-i-warn"><code>Kernel#warn</code></a> if we're being verbose</p>
<div class="method-calls-super">
Calls superclass method
<a href="../Kernel.html#method-i-warn"><code>Kernel#warn</code></a>
</div>
<div class="method-source-code" id="warn-source">
<pre><span class="ruby-comment"># File lib/rdoc/options.rb, line 1235</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">warn</span> <span class="ruby-identifier">message</span>
<span class="ruby-keyword">super</span> <span class="ruby-identifier">message</span> <span class="ruby-keyword">if</span> <span class="ruby-ivar">@verbosity</span> <span class="ruby-operator">></span> <span class="ruby-value">1</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
<div id="method-i-write_options" class="method-detail ">
<div class="method-heading">
<span class="method-name">write_options</span><span
class="method-args">()</span>
<span class="method-click-advice">click to toggle source</span>
</div>
<div class="method-description">
<p>Writes the YAML file .rdoc_options to the current directory containing the parsed options.</p>
<div class="method-source-code" id="write_options-source">
<pre><span class="ruby-comment"># File lib/rdoc/options.rb, line 1243</span>
<span class="ruby-keyword">def</span> <span class="ruby-identifier ruby-title">write_options</span>
<span class="ruby-constant">RDoc</span>.<span class="ruby-identifier">load_yaml</span>
<span class="ruby-constant">File</span>.<span class="ruby-identifier">open</span> <span class="ruby-string">'.rdoc_options'</span>, <span class="ruby-string">'w'</span> <span class="ruby-keyword">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">io</span><span class="ruby-operator">|</span>
<span class="ruby-identifier">io</span>.<span class="ruby-identifier">set_encoding</span> <span class="ruby-constant">Encoding</span><span class="ruby-operator">::</span><span class="ruby-constant">UTF_8</span>
<span class="ruby-constant">YAML</span>.<span class="ruby-identifier">dump</span> <span class="ruby-keyword">self</span>, <span class="ruby-identifier">io</span>
<span class="ruby-keyword">end</span>
<span class="ruby-keyword">end</span></pre>
</div>
</div>
</div>
</section>
</section>
</main>
<footer id="validator-badges" role="contentinfo">
<p><a href="https://validator.w3.org/check/referer">Validate</a>
<p>Generated by <a href="https://ruby.github.io/rdoc/">RDoc</a> 6.2.1.1.
<p>Based on <a href="http://deveiate.org/projects/Darkfish-RDoc/">Darkfish</a> by <a href="http://deveiate.org">Michael Granger</a>.
</footer>