RubyGems - facets - Versions diffs - 2.5.2 → 2.6.0 - Mend

facets 2.5.2 → 2.6.0

Files changed (677) hide show

data/doc/rdoc/more/classes/FileList.html DELETED

@@ -1,955 +0,0 @@
-<?xml version="1.0" encoding="iso-8859-1"?>
-<!DOCTYPE html
-     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html>
-  <head>
-    <title>Class: FileList</title>
-    <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
-    <link rel="stylesheet" href=".././rdoc-style.css" type="text/css" media="screen" />
-    <script language="JavaScript" type="text/javascript">
-    // <![CDATA[
-        function toggleSource( id )
-        {
-          var elem
-          var link
-          if( document.getElementById )
-          {
-            elem = document.getElementById( id )
-            link = document.getElementById( "l_" + id )
-          }
-          else if ( document.all )
-          {
-            elem = eval( "document.all." + id )
-            link = eval( "document.all.l_" + id )
-          }
-          else
-            return false;
-          if( elem.style.display == "block" )
-          {
-            elem.style.display = "none"
-            link.innerHTML = "+"
-          }
-          else
-          {
-            elem.style.display = "block"
-            link.innerHTML = "-"
-          }
-        }
-        function openCode( url )
-        {
-          window.open( url, "SOURCE_CODE", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=480,width=750" ).focus();
-        }
-      // ]]>
-    </script>
-  </head>
-  <body>
-  <table width="100%" border='0' cellpadding='0' cellspacing='0' class='banner'><tr>
-  <td class="file-title"><span class="file-title-prefix">Class</span><br />FileList</td>
-  <td align="right">
-    <table cellspacing="0" cellpadding="2">
-      <tr valign="top">
-        <td>In:</td>
-        <td>
-<a href="../files/lib/more/facets/filelist_rb.html">lib/more/facets/filelist.rb</a>
-        </td>
-      </tr>
-    <tr>
-      <td>Parent:</td>
-      <td>
-Object
-     </td>
-   </tr>
-         </table>
-        </td>
-        </tr>
-      </table>
- <!-- banner header -->
-  <div id="bodyContent">
-      <div id="content">
-  <div class="description"><h1><a href="FileList.html">FileList</a></h1>
-<p>
-A <a href="FileList.html">FileList</a> is essentially an array with helper
-methods to make file manipulation easier.
-</p>
-<p>
-FileLists are lazy. When given a list of glob patterns for possible files
-to be included in the file list, instead of searching the file structures
-to find the files, a <a href="FileList.html">FileList</a> holds the pattern
-for latter use.
-</p>
-<p>
-This allows us to define a number of <a href="FileList.html">FileList</a>
-to match any number of files, but only search out the actual files when
-then <a href="FileList.html">FileList</a> itself is actually used. The key
-is that the first time an element of the <a
-href="FileList.html">FileList</a>/Array is requested, the pending patterns
-are resolved into a real list of file names.
-</p>
-<pre>
-  fl = FileList.new
-  fl.include('./**/*')
-  fl.exclude('./*~')
-</pre>
-</div>
-  <div class="sectiontitle">Methods</div>
-  <span style="padding-right: 5px;"><a href="#M000078">*</a></span>
-  <span style="padding-right: 5px;"><a href="#M000075">==</a></span>
-  <span style="padding-right: 5px;"><a href="#M000092">[]</a></span>
-  <span style="padding-right: 5px;"><a href="#M000072">add</a></span>
-  <span style="padding-right: 5px;"><a href="#M000080">calculate_exclude_regexp</a></span>
-  <span style="padding-right: 5px;"><a href="#M000074">clear_exclude</a></span>
-  <span style="padding-right: 5px;"><a href="#M000094">clear_ignore_patterns</a></span>
-  <span style="padding-right: 5px;"><a href="#M000068">clone</a></span>
-  <span style="padding-right: 5px;"><a href="#M000069">dup</a></span>
-  <span style="padding-right: 5px;"><a href="#M000088">egrep</a></span>
-  <span style="padding-right: 5px;"><a href="#M000073">exclude</a></span>
-  <span style="padding-right: 5px;"><a href="#M000090">exclude?</a></span>
-  <span style="padding-right: 5px;"><a href="#M000087">ext</a></span>
-  <span style="padding-right: 5px;"><a href="#M000084">gsub</a></span>
-  <span style="padding-right: 5px;"><a href="#M000086">gsub!</a></span>
-  <span style="padding-right: 5px;"><a href="#M000091">import</a></span>
-  <span style="padding-right: 5px;"><a href="#M000071">include</a></span>
-  <span style="padding-right: 5px;"><a href="#M000070">new</a></span>
-  <span style="padding-right: 5px;"><a href="#M000079">resolve</a></span>
-  <span style="padding-right: 5px;"><a href="#M000081">resolve_add</a></span>
-  <span style="padding-right: 5px;"><a href="#M000082">resolve_exclude</a></span>
-  <span style="padding-right: 5px;"><a href="#M000093">select_default_ignore_patterns</a></span>
-  <span style="padding-right: 5px;"><a href="#M000083">sub</a></span>
-  <span style="padding-right: 5px;"><a href="#M000085">sub!</a></span>
-  <span style="padding-right: 5px;"><a href="#M000076">to_a</a></span>
-  <span style="padding-right: 5px;"><a href="#M000077">to_ary</a></span>
-  <span style="padding-right: 5px;"><a href="#M000089">to_s</a></span>
-  <div class="sectiontitle">Constants</div>
-  <table border='0' cellpadding='5'>
-  <tr valign='top'>
-    <td class="attr-name">ARRAY_METHODS</td>
-    <td>=</td>
-    <td class="attr-value">Array.instance_methods - Object.instance_methods</td>
-  </tr>
-  <tr valign='top'>
-    <td>&nbsp;</td>
-    <td colspan="2" class="attr-desc">
-List of array methods (that are not in <tt>Object</tt>) that need to be
-delegated.
-</td>
-  </tr>
-  <tr valign='top'>
-    <td class="attr-name">MUST_DEFINE</td>
-    <td>=</td>
-    <td class="attr-value">%w[to_a inspect]</td>
-  </tr>
-  <tr valign='top'>
-    <td>&nbsp;</td>
-    <td colspan="2" class="attr-desc">
-List of additional methods that must be delegated.
-</td>
-  </tr>
-  <tr valign='top'>
-    <td class="attr-name">MUST_NOT_DEFINE</td>
-    <td>=</td>
-    <td class="attr-value">%w[to_a to_ary partition *]</td>
-  </tr>
-  <tr valign='top'>
-    <td>&nbsp;</td>
-    <td colspan="2" class="attr-desc">
-List of methods that should not be delegated here (we define special
-versions of them explicitly below).
-</td>
-  </tr>
-  <tr valign='top'>
-    <td class="attr-name">SPECIAL_RETURN</td>
-    <td>=</td>
-    <td class="attr-value">%w[     map collect sort sort_by select find_all reject grep     compact flatten uniq values_at     + - &amp; |   ]</td>
-  </tr>
-  <tr valign='top'>
-    <td>&nbsp;</td>
-    <td colspan="2" class="attr-desc">
-List of delegated methods that return <a
-href="FileList.html#M000070">new</a> array values which need wrapping.
-</td>
-  </tr>
-  <tr valign='top'>
-    <td class="attr-name">DELEGATING_METHODS</td>
-    <td>=</td>
-    <td class="attr-value">(ARRAY_METHODS + MUST_DEFINE - MUST_NOT_DEFINE).sort.uniq</td>
-  </tr>
-  <tr valign='top'>
-    <td class="attr-name">DEFAULT_IGNORE_PATTERNS</td>
-    <td>=</td>
-    <td class="attr-value">[     /(^|[\/\\])CVS([\/\\]|$)/,     /(^|[\/\\])\.svn([\/\\]|$)/,     /(^|[\/\\])_darcs([\/\\]|$)/,     /\.bak$/,     /~$/,     /(^|[\/\\])core$/</td>
-  </tr>
-  </table>
-<div class="sectiontitle">Public Class methods</div>
-<div class="method">
-  <div class="title">
-    <a name="M000092"></a><b>[]</b>(*args)
-  </div>
-  <div class="description">
-  <p>
-Create a <a href="FileList.html#M000070">new</a> file list including the
-files listed. Similar to:
-</p>
-<pre>
-  FileList.new(*args)
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000092_source')" id="l_M000092_source">+</a> ]</p>
-  <div id="M000092_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/filelist.rb, line 439</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-operator">[]</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>)
-      <span class="ruby-identifier">new</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>)
-    <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000094"></a><b>clear_ignore_patterns</b>()
-  </div>
-  <div class="description">
-  <p>
-Clear the ignore patterns.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000094_source')" id="l_M000094_source">+</a> ]</p>
-  <div id="M000094_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/filelist.rb, line 460</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">clear_ignore_patterns</span>
-      <span class="ruby-ivar">@exclude_patterns</span> = [ <span class="ruby-regexp re">/^$/</span> ]
-    <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000070"></a><b>new</b>(*patterns) {|self if block_given?| ...}
-  </div>
-  <div class="description">
-  <p>
-Create a file list from the globbable patterns given. If you wish to
-perform multiple includes or excludes at object build time, use the
-&quot;yield self&quot; pattern.
-</p>
-<p>
-Example:
-</p>
-<pre>
-  file_list = FileList.new['lib/**/*.rb', 'test/test*.rb']
-  pkg_files = FileList.new['lib/**/*'] do |fl|
-    fl.exclude(/\bCVS\b/)
-  end
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000070_source')" id="l_M000070_source">+</a> ]</p>
-  <div id="M000070_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/filelist.rb, line 169</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">patterns</span>)
-    <span class="ruby-ivar">@pending_add</span> = []
-    <span class="ruby-ivar">@pending</span> = <span class="ruby-keyword kw">false</span>
-    <span class="ruby-ivar">@exclude_patterns</span> = <span class="ruby-constant">DEFAULT_IGNORE_PATTERNS</span>.<span class="ruby-identifier">dup</span>
-    <span class="ruby-ivar">@exclude_re</span> = <span class="ruby-keyword kw">nil</span>
-    <span class="ruby-ivar">@items</span> = []
-    <span class="ruby-identifier">patterns</span>.<span class="ruby-identifier">each</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">pattern</span><span class="ruby-operator">|</span> <span class="ruby-identifier">include</span>(<span class="ruby-identifier">pattern</span>) }
-    <span class="ruby-keyword kw">yield</span> <span class="ruby-keyword kw">self</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">block_given?</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000093"></a><b>select_default_ignore_patterns</b>()
-  </div>
-  <div class="description">
-  <p>
-Set the ignore patterns back to the default value. The default patterns
-will ignore files
-</p>
-<ul>
-<li>containing &quot;CVS&quot; in the file path
-</li>
-<li>containing &quot;.svn&quot; in the file path
-</li>
-<li>containing &quot;_darcs&quot; in the file path
-</li>
-<li>ending with &quot;.bak&quot;
-</li>
-<li>ending with &quot;~&quot;
-</li>
-<li>named &quot;core&quot;
-</li>
-</ul>
-<p>
-Note that file names beginning with &quot;.&quot; are automatically ignored
-by Ruby&#8216;s glob patterns and are not specifically listed in the ignore
-patterns.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000093_source')" id="l_M000093_source">+</a> ]</p>
-  <div id="M000093_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/filelist.rb, line 455</span>
-    <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">select_default_ignore_patterns</span>
-      <span class="ruby-ivar">@exclude_patterns</span> = <span class="ruby-constant">DEFAULT_IGNORE_PATTERNS</span>.<span class="ruby-identifier">dup</span>
-    <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="sectiontitle">Public Instance methods</div>
-<div class="method">
-  <div class="title">
-    <a name="M000078"></a><b>*</b>(other)
-  </div>
-  <div class="description">
-  <p>
-Redefine * to return either a string or a <a
-href="FileList.html#M000070">new</a> file list.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000078_source')" id="l_M000078_source">+</a> ]</p>
-  <div id="M000078_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/filelist.rb, line 252</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-operator">*</span>(<span class="ruby-identifier">other</span>)
-    <span class="ruby-identifier">result</span> = <span class="ruby-ivar">@items</span> <span class="ruby-operator">*</span> <span class="ruby-identifier">other</span>
-    <span class="ruby-keyword kw">case</span> <span class="ruby-identifier">result</span>
-    <span class="ruby-keyword kw">when</span> <span class="ruby-constant">Array</span>
-      <span class="ruby-constant">FileList</span>.<span class="ruby-identifier">new</span>.<span class="ruby-identifier">import</span>(<span class="ruby-identifier">result</span>)
-    <span class="ruby-keyword kw">else</span>
-      <span class="ruby-identifier">result</span>
-    <span class="ruby-keyword kw">end</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000075"></a><b>==</b>(array)
-  </div>
-  <div class="description">
-  <p>
-Define equality.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000075_source')" id="l_M000075_source">+</a> ]</p>
-  <div id="M000075_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/filelist.rb, line 235</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-operator">==</span>(<span class="ruby-identifier">array</span>)
-    <span class="ruby-identifier">to_ary</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">array</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000072"></a><b>add</b>(*filenames)
-  </div>
-  <div class="description">
-  <p>
-Alias for <a href="FileList.html#M000071">include</a>
-</p>
-  </div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000080"></a><b>calculate_exclude_regexp</b>()
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000080_source')" id="l_M000080_source">+</a> ]</p>
-  <div id="M000080_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/filelist.rb, line 273</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">calculate_exclude_regexp</span>
-    <span class="ruby-identifier">ignores</span> = []
-    <span class="ruby-ivar">@exclude_patterns</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">pat</span><span class="ruby-operator">|</span>
-      <span class="ruby-keyword kw">case</span> <span class="ruby-identifier">pat</span>
-      <span class="ruby-keyword kw">when</span> <span class="ruby-constant">Regexp</span>
-        <span class="ruby-identifier">ignores</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">pat</span>
-      <span class="ruby-keyword kw">when</span> <span class="ruby-regexp re">/[*.]/</span>
-        <span class="ruby-constant">Dir</span>[<span class="ruby-identifier">pat</span>].<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">p</span><span class="ruby-operator">|</span> <span class="ruby-identifier">ignores</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">p</span> <span class="ruby-keyword kw">end</span>
-      <span class="ruby-keyword kw">else</span>
-        <span class="ruby-identifier">ignores</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-constant">Regexp</span>.<span class="ruby-identifier">quote</span>(<span class="ruby-identifier">pat</span>)
-      <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">ignores</span>.<span class="ruby-identifier">empty?</span>
-      <span class="ruby-ivar">@exclude_re</span> = <span class="ruby-regexp re">/^$/</span>
-    <span class="ruby-keyword kw">else</span>
-      <span class="ruby-identifier">re_str</span> = <span class="ruby-identifier">ignores</span>.<span class="ruby-identifier">collect</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">p</span><span class="ruby-operator">|</span> <span class="ruby-value str">&quot;(&quot;</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">p</span>.<span class="ruby-identifier">to_s</span> <span class="ruby-operator">+</span> <span class="ruby-value str">&quot;)&quot;</span> }.<span class="ruby-identifier">join</span>(<span class="ruby-value str">&quot;|&quot;</span>)
-      <span class="ruby-ivar">@exclude_re</span> = <span class="ruby-constant">Regexp</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">re_str</span>)
-    <span class="ruby-keyword kw">end</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000074"></a><b>clear_exclude</b>()
-  </div>
-  <div class="description">
-  <p>
-Clear all the <a href="FileList.html#M000073">exclude</a> patterns so that
-we <a href="FileList.html#M000073">exclude</a> nothing.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000074_source')" id="l_M000074_source">+</a> ]</p>
-  <div id="M000074_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/filelist.rb, line 229</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">clear_exclude</span>
-    <span class="ruby-ivar">@exclude_patterns</span> = []
-    <span class="ruby-identifier">calculate_exclude_regexp</span> <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span> <span class="ruby-ivar">@pending</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000068"></a><b>clone</b>()
-  </div>
-  <div class="description">
-  <p>
-<a href="FileList.html#M000071">include</a> <a
-href="Cloneable.html">Cloneable</a>
-</p>
-  </div>
-<div class="aka">
-  This method is also aliased as
-  <a href="FileList.html#M000069">dup</a>
-</div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000068_source')" id="l_M000068_source">+</a> ]</p>
-  <div id="M000068_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/filelist.rb, line 85</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">clone</span>
-    <span class="ruby-identifier">sibling</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">class</span>.<span class="ruby-identifier">new</span>
-    <span class="ruby-identifier">instance_variables</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">ivar</span><span class="ruby-operator">|</span>
-      <span class="ruby-identifier">value</span> = <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">instance_variable_get</span>(<span class="ruby-identifier">ivar</span>)
-      <span class="ruby-identifier">sibling</span>.<span class="ruby-identifier">instance_variable_set</span>(<span class="ruby-identifier">ivar</span>, <span class="ruby-identifier">value</span>.<span class="ruby-identifier">rake_dup</span>)
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-identifier">sibling</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000069"></a><b>dup</b>()
-  </div>
-  <div class="description">
-  <p>
-Alias for <a href="FileList.html#M000068">clone</a>
-</p>
-  </div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000088"></a><b>egrep</b>(pattern) {|fn, count, line| ...}
-  </div>
-  <div class="description">
-  <p>
-Grep each of the files in the filelist using the given pattern. If a block
-is given, call the block on each matching line, passing the file name, line
-number, and the matching line of text. If no block is given, a standard
-emac style file:linenumber:line message will be printed to standard out.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000088_source')" id="l_M000088_source">+</a> ]</p>
-  <div id="M000088_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/filelist.rb, line 369</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">egrep</span>(<span class="ruby-identifier">pattern</span>)
-    <span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">fn</span><span class="ruby-operator">|</span>
-      <span class="ruby-identifier">open</span>(<span class="ruby-identifier">fn</span>) <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">inf</span><span class="ruby-operator">|</span>
-        <span class="ruby-identifier">count</span> = <span class="ruby-value">0</span>
-        <span class="ruby-identifier">inf</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">line</span><span class="ruby-operator">|</span>
-          <span class="ruby-identifier">count</span> <span class="ruby-operator">+=</span> <span class="ruby-value">1</span>
-          <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">pattern</span>.<span class="ruby-identifier">match</span>(<span class="ruby-identifier">line</span>)
-            <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">block_given?</span>
-              <span class="ruby-keyword kw">yield</span> <span class="ruby-identifier">fn</span>, <span class="ruby-identifier">count</span>, <span class="ruby-identifier">line</span>
-            <span class="ruby-keyword kw">else</span>
-              <span class="ruby-identifier">puts</span> <span class="ruby-node">&quot;#{fn}:#{count}:#{line}&quot;</span>
-            <span class="ruby-keyword kw">end</span>
-          <span class="ruby-keyword kw">end</span>
-        <span class="ruby-keyword kw">end</span>
-      <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">end</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000073"></a><b>exclude</b>(*patterns)
-  </div>
-  <div class="description">
-  <p>
-Register a list of file name patterns that should be excluded from the
-list. Patterns may be regular expressions, glob patterns or regular
-strings.
-</p>
-<p>
-Note that glob patterns are expanded against the file system. If a file is
-explicitly added to a file list, but does not exist in the file system,
-then an glob pattern in the <a href="FileList.html#M000073">exclude</a>
-list will not <a href="FileList.html#M000073">exclude</a> the file.
-</p>
-<p>
-Examples:
-</p>
-<pre>
-  FileList['a.c', 'b.c'].exclude(&quot;a.c&quot;) =&gt; ['b.c']
-  FileList['a.c', 'b.c'].exclude(/^a/)  =&gt; ['b.c']
-</pre>
-<p>
-If &quot;a.c&quot; is a file, then &#8230;
-</p>
-<pre>
-  FileList['a.c', 'b.c'].exclude(&quot;a.*&quot;) =&gt; ['b.c']
-</pre>
-<p>
-If &quot;a.c&quot; is not a file, then &#8230;
-</p>
-<pre>
-  FileList['a.c', 'b.c'].exclude(&quot;a.*&quot;) =&gt; ['a.c', 'b.c']
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000073_source')" id="l_M000073_source">+</a> ]</p>
-  <div id="M000073_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/filelist.rb, line 219</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">exclude</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">patterns</span>)
-    <span class="ruby-identifier">patterns</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">pat</span><span class="ruby-operator">|</span> <span class="ruby-ivar">@exclude_patterns</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">pat</span> <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span> <span class="ruby-ivar">@pending</span>
-      <span class="ruby-identifier">calculate_exclude_regexp</span>
-      <span class="ruby-identifier">reject!</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">fn</span><span class="ruby-operator">|</span> <span class="ruby-identifier">fn</span> <span class="ruby-operator">=~</span> <span class="ruby-ivar">@exclude_re</span> }
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">self</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000090"></a><b>exclude?</b>(fn)
-  </div>
-  <div class="description">
-  <p>
-Should the given file name be excluded?
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000090_source')" id="l_M000090_source">+</a> ]</p>
-  <div id="M000090_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/filelist.rb, line 415</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">exclude?</span>(<span class="ruby-identifier">fn</span>)
-    <span class="ruby-identifier">calculate_exclude_regexp</span> <span class="ruby-keyword kw">unless</span> <span class="ruby-ivar">@exclude_re</span>
-    <span class="ruby-identifier">fn</span> <span class="ruby-operator">=~</span> <span class="ruby-ivar">@exclude_re</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000087"></a><b>ext</b>(newext='')
-  </div>
-  <div class="description">
-  <p>
-Return a <a href="FileList.html#M000070">new</a> array with
-<tt>String#ext</tt> method applied to each member of the array.
-</p>
-<p>
-This method is a shortcut for:
-</p>
-<pre>
-   array.collect { |item| item.ext(newext) }
-</pre>
-<p>
-<tt><a href="FileList.html#M000087">ext</a></tt> is a user added method for
-the Array class.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000087_source')" id="l_M000087_source">+</a> ]</p>
-  <div id="M000087_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/filelist.rb, line 360</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">ext</span>(<span class="ruby-identifier">newext</span>=<span class="ruby-value str">''</span>)
-    <span class="ruby-identifier">collect</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">fn</span><span class="ruby-operator">|</span> <span class="ruby-identifier">fn</span>.<span class="ruby-identifier">ext</span>(<span class="ruby-identifier">newext</span>) }
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000084"></a><b>gsub</b>(pat, rep)
-  </div>
-  <div class="description">
-  <p>
-Return a <a href="FileList.html#M000070">new</a> <a
-href="FileList.html">FileList</a> with the results of running <tt><a
-href="FileList.html#M000084">gsub</a></tt> against each element of the
-original list.
-</p>
-<p>
-Example:
-</p>
-<pre>
-  FileList['lib/test/file', 'x/y'].gsub(/\//, &quot;\\&quot;)
-     =&gt; ['lib\\test\\file', 'x\\y']
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000084_source')" id="l_M000084_source">+</a> ]</p>
-  <div id="M000084_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/filelist.rb, line 336</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">gsub</span>(<span class="ruby-identifier">pat</span>, <span class="ruby-identifier">rep</span>)
-    <span class="ruby-identifier">inject</span>(<span class="ruby-constant">FileList</span>.<span class="ruby-identifier">new</span>) { <span class="ruby-operator">|</span><span class="ruby-identifier">res</span>, <span class="ruby-identifier">fn</span><span class="ruby-operator">|</span> <span class="ruby-identifier">res</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">fn</span>.<span class="ruby-identifier">gsub</span>(<span class="ruby-identifier">pat</span>,<span class="ruby-identifier">rep</span>) }
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000086"></a><b>gsub!</b>(pat, rep)
-  </div>
-  <div class="description">
-  <p>
-Same as <tt><a href="FileList.html#M000084">gsub</a></tt> except that the
-original file list is modified.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000086_source')" id="l_M000086_source">+</a> ]</p>
-  <div id="M000086_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/filelist.rb, line 347</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">gsub!</span>(<span class="ruby-identifier">pat</span>, <span class="ruby-identifier">rep</span>)
-    <span class="ruby-identifier">each_with_index</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">fn</span>, <span class="ruby-identifier">i</span><span class="ruby-operator">|</span> <span class="ruby-keyword kw">self</span>[<span class="ruby-identifier">i</span>] = <span class="ruby-identifier">fn</span>.<span class="ruby-identifier">gsub</span>(<span class="ruby-identifier">pat</span>,<span class="ruby-identifier">rep</span>) }
-    <span class="ruby-keyword kw">self</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000091"></a><b>import</b>(array)
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000091_source')" id="l_M000091_source">+</a> ]</p>
-  <div id="M000091_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/filelist.rb, line 430</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">import</span>(<span class="ruby-identifier">array</span>)
-    <span class="ruby-ivar">@items</span> = <span class="ruby-identifier">array</span>
-    <span class="ruby-keyword kw">self</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000071"></a><b>include</b>(*filenames)
-  </div>
-  <div class="description">
-  <p>
-Add file names defined by glob patterns to the file list. If an array is
-given, <a href="FileList.html#M000072">add</a> each element of the array.
-</p>
-<p>
-Example:
-</p>
-<pre>
-  file_list.include(&quot;*.java&quot;, &quot;*.cfg&quot;)
-  file_list.include %w( math.c lib.h *.o )
-</pre>
-  </div>
-<div class="aka">
-  This method is also aliased as
-  <a href="FileList.html#M000072">add</a>
-</div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000071_source')" id="l_M000071_source">+</a> ]</p>
-  <div id="M000071_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/filelist.rb, line 186</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">include</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">filenames</span>)
-    <span class="ruby-comment cmt"># TODO: check for pending</span>
-    <span class="ruby-identifier">filenames</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">fn</span><span class="ruby-operator">|</span>
-      <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">fn</span>.<span class="ruby-identifier">respond_to?</span> <span class="ruby-identifier">:to_ary</span>
-        <span class="ruby-identifier">include</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">fn</span>.<span class="ruby-identifier">to_ary</span>)
-      <span class="ruby-keyword kw">else</span>
-        <span class="ruby-ivar">@pending_add</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">fn</span>
-      <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-ivar">@pending</span> = <span class="ruby-keyword kw">true</span>
-    <span class="ruby-keyword kw">self</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000079"></a><b>resolve</b>()
-  </div>
-  <div class="description">
-  <p>
-Resolve all the pending adds now.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000079_source')" id="l_M000079_source">+</a> ]</p>
-  <div id="M000079_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/filelist.rb, line 263</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">resolve</span>
-    <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@pending</span>
-      <span class="ruby-ivar">@pending</span> = <span class="ruby-keyword kw">false</span>
-      <span class="ruby-ivar">@pending_add</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">fn</span><span class="ruby-operator">|</span> <span class="ruby-identifier">resolve_add</span>(<span class="ruby-identifier">fn</span>) <span class="ruby-keyword kw">end</span>
-      <span class="ruby-ivar">@pending_add</span> = []
-      <span class="ruby-identifier">resolve_exclude</span>
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">self</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000081"></a><b>resolve_add</b>(fn)
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000081_source')" id="l_M000081_source">+</a> ]</p>
-  <div id="M000081_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/filelist.rb, line 293</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">resolve_add</span>(<span class="ruby-identifier">fn</span>)
-    <span class="ruby-keyword kw">case</span> <span class="ruby-identifier">fn</span>
-    <span class="ruby-keyword kw">when</span> <span class="ruby-constant">Array</span>
-      <span class="ruby-identifier">fn</span>.<span class="ruby-identifier">each</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">f</span><span class="ruby-operator">|</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">resolve_add</span>(<span class="ruby-identifier">f</span>) }
-    <span class="ruby-keyword kw">when</span> <span class="ruby-regexp re">%r{[*?]}</span>
-      <span class="ruby-identifier">add_matching</span>(<span class="ruby-identifier">fn</span>)
-    <span class="ruby-keyword kw">else</span>
-      <span class="ruby-keyword kw">self</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">fn</span>
-    <span class="ruby-keyword kw">end</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000082"></a><b>resolve_exclude</b>()
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000082_source')" id="l_M000082_source">+</a> ]</p>
-  <div id="M000082_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/filelist.rb, line 304</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">resolve_exclude</span>
-    <span class="ruby-ivar">@exclude_patterns</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">pat</span><span class="ruby-operator">|</span>
-      <span class="ruby-keyword kw">case</span> <span class="ruby-identifier">pat</span>
-      <span class="ruby-keyword kw">when</span> <span class="ruby-constant">Regexp</span>
-        <span class="ruby-identifier">reject!</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">fn</span><span class="ruby-operator">|</span> <span class="ruby-identifier">fn</span> <span class="ruby-operator">=~</span> <span class="ruby-identifier">pat</span> }
-      <span class="ruby-keyword kw">when</span> <span class="ruby-regexp re">/[*.]/</span>
-        <span class="ruby-identifier">reject_list</span> = <span class="ruby-constant">Dir</span>[<span class="ruby-identifier">pat</span>]
-        <span class="ruby-identifier">reject!</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">fn</span><span class="ruby-operator">|</span> <span class="ruby-identifier">reject_list</span>.<span class="ruby-identifier">include?</span>(<span class="ruby-identifier">fn</span>) }
-      <span class="ruby-keyword kw">else</span>
-        <span class="ruby-identifier">reject!</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">fn</span><span class="ruby-operator">|</span> <span class="ruby-identifier">fn</span> <span class="ruby-operator">==</span> <span class="ruby-identifier">pat</span> }
-      <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">end</span>
-    <span class="ruby-keyword kw">self</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000083"></a><b>sub</b>(pat, rep)
-  </div>
-  <div class="description">
-  <p>
-Return a <a href="FileList.html#M000070">new</a> <a
-href="FileList.html">FileList</a> with the results of running <tt><a
-href="FileList.html#M000083">sub</a></tt> against each element of the
-oringal list.
-</p>
-<p>
-Example:
-</p>
-<pre>
-  FileList['a.c', 'b.c'].sub(/\.c$/, '.o')  =&gt; ['a.o', 'b.o']
-</pre>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000083_source')" id="l_M000083_source">+</a> ]</p>
-  <div id="M000083_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/filelist.rb, line 325</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">sub</span>(<span class="ruby-identifier">pat</span>, <span class="ruby-identifier">rep</span>)
-    <span class="ruby-identifier">inject</span>(<span class="ruby-constant">FileList</span>.<span class="ruby-identifier">new</span>) { <span class="ruby-operator">|</span><span class="ruby-identifier">res</span>, <span class="ruby-identifier">fn</span><span class="ruby-operator">|</span> <span class="ruby-identifier">res</span> <span class="ruby-operator">&lt;&lt;</span> <span class="ruby-identifier">fn</span>.<span class="ruby-identifier">sub</span>(<span class="ruby-identifier">pat</span>,<span class="ruby-identifier">rep</span>) }
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000085"></a><b>sub!</b>(pat, rep)
-  </div>
-  <div class="description">
-  <p>
-Same as <tt><a href="FileList.html#M000083">sub</a></tt> except that the
-oringal file list is modified.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000085_source')" id="l_M000085_source">+</a> ]</p>
-  <div id="M000085_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/filelist.rb, line 341</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">sub!</span>(<span class="ruby-identifier">pat</span>, <span class="ruby-identifier">rep</span>)
-    <span class="ruby-identifier">each_with_index</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">fn</span>, <span class="ruby-identifier">i</span><span class="ruby-operator">|</span> <span class="ruby-keyword kw">self</span>[<span class="ruby-identifier">i</span>] = <span class="ruby-identifier">fn</span>.<span class="ruby-identifier">sub</span>(<span class="ruby-identifier">pat</span>,<span class="ruby-identifier">rep</span>) }
-    <span class="ruby-keyword kw">self</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000076"></a><b>to_a</b>()
-  </div>
-  <div class="description">
-  <p>
-Return the internal array object.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000076_source')" id="l_M000076_source">+</a> ]</p>
-  <div id="M000076_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/filelist.rb, line 240</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_a</span>
-    <span class="ruby-identifier">resolve</span>
-    <span class="ruby-ivar">@items</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000077"></a><b>to_ary</b>()
-  </div>
-  <div class="description">
-  <p>
-Return the internal array object.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000077_source')" id="l_M000077_source">+</a> ]</p>
-  <div id="M000077_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/filelist.rb, line 246</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_ary</span>
-    <span class="ruby-identifier">resolve</span>
-    <span class="ruby-ivar">@items</span>
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-<div class="method">
-  <div class="title">
-    <a name="M000089"></a><b>to_s</b>()
-  </div>
-  <div class="description">
-  <p>
-Convert a <a href="FileList.html">FileList</a> to a string by joining all
-elements with a space.
-</p>
-  </div>
-<div class="sourcecode">
-  <p class="source-link">[ <a href="javascript:toggleSource('M000089_source')" id="l_M000089_source">+</a> ]</p>
-  <div id="M000089_source" class="dyn-source">
-<pre>
-<span class="ruby-comment cmt"># File lib/more/facets/filelist.rb, line 401</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_s</span>
-    <span class="ruby-identifier">resolve</span> <span class="ruby-keyword kw">if</span> <span class="ruby-ivar">@pending</span>
-    <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">join</span>(<span class="ruby-value str">' '</span>)
-  <span class="ruby-keyword kw">end</span>
-</pre>
-  </div>
-</div>
-</div>
-</div>
-  </div>
-    </body>
-</html>