| 0 | 1 <html> | 
|  | 2 <head> | 
|  | 3 <title>MayaChemTools:Code:FileUtil.pm</title> | 
|  | 4 <meta http-equiv="content-type" content="text/html;charset=utf-8"> | 
|  | 5 <link rel="stylesheet" type="text/css" href="../../../css/MayaChemToolsCode.css"> | 
|  | 6 </head> | 
|  | 7 <body leftmargin="20" rightmargin="20" topmargin="10" bottommargin="10"> | 
|  | 8 <br/> | 
|  | 9 <center> | 
|  | 10 <a href="http://www.mayachemtools.org" title="MayaChemTools Home"><img src="../../../images/MayaChemToolsLogo.gif" border="0" alt="MayaChemTools"></a> | 
|  | 11 </center> | 
|  | 12 <br/> | 
|  | 13 <pre> | 
|  | 14 <a name="package-FileUtil-"></a>   1 <span class="k">package </span><span class="i">FileUtil</span><span class="sc">;</span> | 
|  | 15    2 <span class="c">#</span> | 
|  | 16    3 <span class="c"># $RCSfile: FileUtil.pm,v $</span> | 
|  | 17    4 <span class="c"># $Date: 2015/02/28 20:47:17 $</span> | 
|  | 18    5 <span class="c"># $Revision: 1.40 $</span> | 
|  | 19    6 <span class="c">#</span> | 
|  | 20    7 <span class="c"># Author: Manish Sud <msud@san.rr.com></span> | 
|  | 21    8 <span class="c">#</span> | 
|  | 22    9 <span class="c"># Copyright (C) 2015 Manish Sud. All rights reserved.</span> | 
|  | 23   10 <span class="c">#</span> | 
|  | 24   11 <span class="c"># This file is part of MayaChemTools.</span> | 
|  | 25   12 <span class="c">#</span> | 
|  | 26   13 <span class="c"># MayaChemTools is free software; you can redistribute it and/or modify it under</span> | 
|  | 27   14 <span class="c"># the terms of the GNU Lesser General Public License as published by the Free</span> | 
|  | 28   15 <span class="c"># Software Foundation; either version 3 of the License, or (at your option) any</span> | 
|  | 29   16 <span class="c"># later version.</span> | 
|  | 30   17 <span class="c">#</span> | 
|  | 31   18 <span class="c"># MayaChemTools is distributed in the hope that it will be useful, but without</span> | 
|  | 32   19 <span class="c"># any warranty; without even the implied warranty of merchantability of fitness</span> | 
|  | 33   20 <span class="c"># for a particular purpose.  See the GNU Lesser General Public License for more</span> | 
|  | 34   21 <span class="c"># details.</span> | 
|  | 35   22 <span class="c">#</span> | 
|  | 36   23 <span class="c"># You should have received a copy of the GNU Lesser General Public License</span> | 
|  | 37   24 <span class="c"># along with MayaChemTools; if not, see <http://www.gnu.org/licenses/> or</span> | 
|  | 38   25 <span class="c"># write to the Free Software Foundation Inc., 59 Temple Place, Suite 330,</span> | 
|  | 39   26 <span class="c"># Boston, MA, 02111-1307, USA.</span> | 
|  | 40   27 <span class="c">#</span> | 
|  | 41   28 | 
|  | 42   29 <span class="k">use</span> <span class="w">strict</span><span class="sc">;</span> | 
|  | 43   30 <span class="k">use</span> <span class="w">Exporter</span><span class="sc">;</span> | 
|  | 44   31 <span class="k">use</span> <span class="w">Carp</span><span class="sc">;</span> | 
|  | 45   32 <span class="k">use</span> <span class="w">File::stat</span><span class="sc">;</span> | 
|  | 46   33 <span class="k">use</span> <span class="w">Time::localtime</span> <span class="s">(</span><span class="s">)</span><span class="sc">;</span> | 
|  | 47   34 <span class="k">use</span> <span class="w">TextUtil</span> <span class="s">(</span><span class="s">)</span><span class="sc">;</span> | 
|  | 48   35 | 
|  | 49   36 <span class="k">use</span> <span class="w">vars</span> <span class="q">qw(@ISA @EXPORT @EXPORT_OK %EXPORT_TAGS)</span><span class="sc">;</span> | 
|  | 50   37 | 
|  | 51   38 <span class="i">@ISA</span> = <span class="q">qw(Exporter)</span><span class="sc">;</span> | 
|  | 52   39 <span class="i">@EXPORT</span> = <span class="q">qw(CheckFileType ConvertCygwinPath ExpandFileNames FileModificationTimeAndDate FormattedFileModificationTimeAndDate FileSize FormatFileSize GetMayaChemToolsLibDirName GetUsageFromPod ParseFileName)</span><span class="sc">;</span> | 
|  | 53   40 <span class="i">@EXPORT_OK</span> = <span class="q">qw()</span><span class="sc">;</span> | 
|  | 54   41 <span class="i">%EXPORT_TAGS</span> = <span class="s">(</span><span class="w">all</span>  <span class="cm">=></span> <span class="s">[</span><span class="i">@EXPORT</span><span class="cm">,</span> <span class="i">@EXPORT_OK</span><span class="s">]</span><span class="s">)</span><span class="sc">;</span> | 
|  | 55   42 | 
|  | 56   43 <span class="c"># Setup package variables...</span> | 
|  | 57   44 <span class="k">my</span><span class="s">(</span><span class="i">$MayaChemToolsLibDir</span><span class="s">)</span><span class="sc">;</span> | 
|  | 58   45 | 
|  | 59   46 <span class="c"># Check to see path contains cygdrive and convert it into windows path...</span> | 
|  | 60 <a name="ConvertCygwinPath-"></a>  47 <span class="k">sub </span><span class="m">ConvertCygwinPath</span> <span class="s">{</span> | 
|  | 61   48   <span class="k">my</span><span class="s">(</span><span class="i">$Path</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span> | 
|  | 62   49   <span class="k">my</span><span class="s">(</span><span class="i">$NewPath</span><span class="cm">,</span> <span class="i">$OSName</span><span class="s">)</span><span class="sc">;</span> | 
|  | 63   50 | 
|  | 64   51   <span class="i">$NewPath</span> = <span class="i">$Path</span><span class="sc">;</span> <span class="i">$OSName</span> = <span class="i">$^O</span><span class="sc">;</span> | 
|  | 65   52   <span class="k">if</span> <span class="s">(</span><span class="i">$OSName</span> =~ <span class="q">/cygwin/i</span> && <span class="i">$Path</span> =~ <span class="q">/cygdrive/i</span> <span class="s">)</span> <span class="s">{</span> | 
|  | 66   53     <span class="k">my</span><span class="s">(</span><span class="i">@PathParts</span><span class="s">)</span> = <span class="k">split</span> <span class="q">"\/"</span><span class="cm">,</span> <span class="i">$Path</span><span class="sc">;</span> | 
|  | 67   54     <span class="k">my</span><span class="s">(</span><span class="i">$Drive</span><span class="s">)</span> = <span class="i">$PathParts</span>[<span class="n">2</span>]<span class="sc">;</span> | 
|  | 68   55     <span class="k">shift</span> <span class="i">@PathParts</span><span class="sc">;</span> <span class="k">shift</span> <span class="i">@PathParts</span><span class="sc">;</span> <span class="k">shift</span> <span class="i">@PathParts</span><span class="sc">;</span> | 
|  | 69   56     <span class="i">$NewPath</span> = <span class="k">join</span> <span class="q">"\/"</span><span class="cm">,</span> <span class="i">@PathParts</span><span class="sc">;</span> | 
|  | 70   57     <span class="i">$NewPath</span> = <span class="i">$Drive</span>. <span class="q">":\/"</span> . <span class="i">$NewPath</span><span class="sc">;</span> | 
|  | 71   58   <span class="s">}</span> | 
|  | 72   59   <span class="k">return</span> <span class="i">$NewPath</span><span class="sc">;</span> | 
|  | 73   60 <span class="s">}</span> | 
|  | 74   61 | 
|  | 75   62 <span class="c"># Based on the file name extension, figure out its type.</span> | 
|  | 76 <a name="CheckFileType-"></a>  63 <span class="k">sub </span><span class="m">CheckFileType</span> <span class="s">{</span> | 
|  | 77   64   <span class="k">my</span><span class="s">(</span><span class="i">$FileName</span><span class="cm">,</span> <span class="i">$FileExts</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span> | 
|  | 78   65   <span class="k">my</span><span class="s">(</span><span class="i">$Status</span><span class="cm">,</span> <span class="i">@FileExtsList</span><span class="cm">,</span> <span class="i">$Index</span><span class="cm">,</span> <span class="i">$Ext</span><span class="s">)</span><span class="sc">;</span> | 
|  | 79   66 | 
|  | 80   67   <span class="i">$Status</span> = <span class="n">0</span><span class="sc">;</span> | 
|  | 81   68   <span class="i">@FileExtsList</span> = <span class="k">split</span> <span class="q">" "</span><span class="cm">,</span> <span class="i">$FileExts</span><span class="sc">;</span> | 
|  | 82   69   <span class="k">for</span> <span class="i">$Index</span> <span class="s">(</span><span class="n">0</span> .. <span class="i">$#FileExtsList</span><span class="s">)</span> <span class="s">{</span> | 
|  | 83   70     <span class="i">$Ext</span> = <span class="i">$FileExtsList</span>[<span class="i">$Index</span>]<span class="sc">;</span> | 
|  | 84   71     <span class="k">if</span> <span class="s">(</span><span class="i">$FileName</span> =~ <span class="q">/(\.$Ext)$/i</span><span class="s">)</span> <span class="s">{</span> | 
|  | 85   72       <span class="i">$Status</span> = <span class="n">1</span><span class="sc">;</span> | 
|  | 86   73     <span class="s">}</span> | 
|  | 87   74   <span class="s">}</span> | 
|  | 88   75   <span class="k">return</span> <span class="s">(</span><span class="i">$Status</span><span class="s">)</span><span class="sc">;</span> | 
|  | 89   76 <span class="s">}</span> | 
|  | 90   77 | 
|  | 91   78 <span class="c"># Expand file names using specified directory and/or file names along with any</span> | 
|  | 92   79 <span class="c"># file extensions containing one or more wild cards. And return the expanded</span> | 
|  | 93   80 <span class="c"># list.</span> | 
|  | 94   81 <span class="c">#</span> | 
|  | 95   82 <span class="c"># IncludeDirName controls whether directory prefixes are included in expanded</span> | 
|  | 96   83 <span class="c"># file names. Default is to always append directory name before expanded file</span> | 
|  | 97   84 <span class="c"># name.</span> | 
|  | 98   85 <span class="c">#</span> | 
|  | 99   86 <span class="c"># Notes:</span> | 
|  | 100   87 <span class="c">#   . Multiple file extensions are delimited by spaces.</span> | 
|  | 101   88 <span class="c">#   . Wild card, *, is supported in directory and file names along with file</span> | 
|  | 102   89 <span class="c">#     extensions.</span> | 
|  | 103   90 <span class="c">#   . For a specified directory name in the files list, all the files in the</span> | 
|  | 104   91 <span class="c">#     directory are retrieved using Perl opendir function and files filtered using file</span> | 
|  | 105   92 <span class="c">#     extensions. The file names "." and ".." returned by opendir are ignored.</span> | 
|  | 106   93 <span class="c">#   . For file names containing wild cards with and without any explicit file</span> | 
|  | 107   94 <span class="c">#     extension specification in the file name, all the files in the directory are retrieved</span> | 
|  | 108   95 <span class="c">#     using Perl opendir function and files filtered using file name along with any</span> | 
|  | 109   96 <span class="c">#     file extension. The file names "." and ".." returned by opendir are ignored.</span> | 
|  | 110   97 <span class="c">#</span> | 
|  | 111 <a name="ExpandFileNames-"></a>  98 <span class="k">sub </span><span class="m">ExpandFileNames</span> <span class="s">{</span> | 
|  | 112   99   <span class="k">my</span><span class="s">(</span><span class="i">$Files</span><span class="cm">,</span> <span class="i">$FileExts</span><span class="cm">,</span> <span class="i">$IncludeDirName</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span> | 
|  | 113  100   <span class="k">my</span><span class="s">(</span><span class="i">$FileName</span><span class="cm">,</span> <span class="i">$Index</span><span class="cm">,</span> <span class="i">$Delimiter</span><span class="cm">,</span> <span class="i">$FileExtsPattern</span><span class="cm">,</span> <span class="i">@FilesList</span><span class="cm">,</span> <span class="i">@DirFileNames</span><span class="s">)</span><span class="sc">;</span> | 
|  | 114  101 | 
|  | 115  102   <span class="c"># Check whether to include directory name in expanded file names...</span> | 
|  | 116  103   <span class="i">$IncludeDirName</span> = <span class="k">defined</span> <span class="i">$IncludeDirName</span> ? <span class="i">$IncludeDirName</span> <span class="co">:</span> <span class="n">1</span><span class="sc">;</span> | 
|  | 117  104 | 
|  | 118  105   <span class="c"># Setup file externsions...</span> | 
|  | 119  106   <span class="i">$FileExtsPattern</span> = <span class="q">""</span><span class="sc">;</span> | 
|  | 120  107   <span class="k">if</span> <span class="s">(</span><span class="i">$FileExts</span><span class="s">)</span> <span class="s">{</span> | 
|  | 121  108     <span class="i">$FileExtsPattern</span> = <span class="k">join</span> <span class="q">"|"</span><span class="cm">,</span> <span class="k">split</span> <span class="q">" "</span><span class="cm">,</span> <span class="i">$FileExts</span><span class="sc">;</span> | 
|  | 122  109     <span class="k">if</span> <span class="s">(</span><span class="i">$FileExtsPattern</span> =~ <span class="q">/\*/</span><span class="s">)</span> <span class="s">{</span> | 
|  | 123  110       <span class="c"># Replace * by .*? for greedy match...</span> | 
|  | 124  111       <span class="i">$FileExtsPattern</span> =~ <span class="q">s/\*/\.\*\?/g</span><span class="sc">;</span> | 
|  | 125  112     <span class="s">}</span> | 
|  | 126  113   <span class="s">}</span> | 
|  | 127  114 | 
|  | 128  115   <span class="i">@FilesList</span> = <span class="s">(</span><span class="s">)</span><span class="sc">;</span> | 
|  | 129  116 | 
|  | 130  117   <span class="j">FILEINDEX:</span> <span class="k">for</span> <span class="s">(</span><span class="i">$Index</span> = <span class="n">0</span><span class="sc">;</span> <span class="i">$Index</span> < <span class="i">@$Files</span><span class="sc">;</span> <span class="i">$Index</span>++<span class="s">)</span> <span class="s">{</span> | 
|  | 131  118     <span class="i">$FileName</span> = <span class="i">@$Files</span>[<span class="i">$Index</span>]<span class="sc">;</span> | 
|  | 132  119     <span class="i">$Delimiter</span> = <span class="q">"\/"</span><span class="sc">;</span> | 
|  | 133  120     <span class="k">if</span> <span class="s">(</span><span class="i">$FileName</span> =~ <span class="q">/\\/</span> <span class="s">)</span> <span class="s">{</span> | 
|  | 134  121       <span class="i">$Delimiter</span> = <span class="q">"\\"</span><span class="sc">;</span> | 
|  | 135  122     <span class="s">}</span> | 
|  | 136  123 | 
|  | 137  124     <span class="k">if</span> <span class="s">(</span><span class="k">-d</span> <span class="i">$FileName</span><span class="s">)</span> <span class="s">{</span> | 
|  | 138  125       <span class="k">my</span><span class="s">(</span><span class="i">$DirName</span><span class="cm">,</span> <span class="i">$DirNamePrefix</span><span class="s">)</span><span class="sc">;</span> | 
|  | 139  126 | 
|  | 140  127       <span class="i">$DirName</span> = <span class="i">$FileName</span><span class="sc">;</span> | 
|  | 141  128       <span class="i">$DirNamePrefix</span> = <span class="i">$IncludeDirName</span> ? <span class="q">"$DirName$Delimiter"</span> <span class="co">:</span> <span class="q">""</span><span class="sc">;</span> | 
|  | 142  129 | 
|  | 143  130       <span class="c"># glob doesn't appear to work during command line invocation from Windows.</span> | 
|  | 144  131       <span class="c"># So, use opendir to make it work...</span> | 
|  | 145  132       <span class="c">#</span> | 
|  | 146  133       <span class="c"># push @FilesList,  map {glob("$DirName/*.$_")} split " ", $FileExts;</span> | 
|  | 147  134       <span class="c">#</span> | 
|  | 148  135       <span class="i">@DirFileNames</span> = <span class="s">(</span><span class="s">)</span><span class="sc">;</span> | 
|  | 149  136       <span class="k">if</span> <span class="s">(</span>!<span class="k">opendir</span> <span class="w">DIRNAME</span><span class="cm">,</span> <span class="i">$DirName</span><span class="s">)</span> <span class="s">{</span> | 
|  | 150  137         <span class="w">carp</span> <span class="q">"Warning: Ignoring directory $DirName: Couldn't open it: $! ..."</span><span class="sc">;</span> | 
|  | 151  138         <span class="k">next</span> <span class="j">FILEINDEX</span><span class="sc">;</span> | 
|  | 152  139       <span class="s">}</span> | 
|  | 153  140 | 
|  | 154  141       <span class="c"># Collect file names without '.' and '..' as readdir function places them on the list...</span> | 
|  | 155  142       <span class="c">#</span> | 
|  | 156  143       <span class="i">@DirFileNames</span> = <span class="k">map</span> <span class="s">{</span> <span class="q">"$DirNamePrefix$_"</span>  <span class="s">}</span> <span class="k">grep</span> <span class="s">{</span> !<span class="q">/^(\.|\.\.)$/</span> <span class="s">}</span> <span class="k">readdir</span> <span class="w">DIRNAME</span><span class="sc">;</span> | 
|  | 157  144       <span class="k">closedir</span> <span class="w">DIRNAME</span><span class="sc">;</span> | 
|  | 158  145 | 
|  | 159  146       <span class="c"># Collect files with any specified file extensions...</span> | 
|  | 160  147       <span class="k">if</span> <span class="s">(</span><span class="i">$FileExtsPattern</span><span class="s">)</span> <span class="s">{</span> | 
|  | 161  148         <span class="i">@DirFileNames</span> = <span class="k">grep</span> <span class="s">{</span> <span class="q">/\.$FileExtsPattern$/</span> <span class="s">}</span> <span class="i">@DirFileNames</span><span class="sc">;</span> | 
|  | 162  149       <span class="s">}</span> | 
|  | 163  150 | 
|  | 164  151       <span class="k">push</span> <span class="i">@FilesList</span><span class="cm">,</span> <span class="i">@DirFileNames</span><span class="sc">;</span> | 
|  | 165  152     <span class="s">}</span> | 
|  | 166  153     <span class="k">elsif</span> <span class="s">(</span><span class="i">$FileName</span> =~ <span class="q">/\*/</span><span class="s">)</span> <span class="s">{</span> | 
|  | 167  154       <span class="k">my</span><span class="s">(</span><span class="i">$FileDir</span><span class="cm">,</span> <span class="i">$Name</span><span class="cm">,</span> <span class="i">$FileExt</span><span class="cm">,</span> <span class="i">$DirNamePrefix</span><span class="s">)</span><span class="sc">;</span> | 
|  | 168  155 | 
|  | 169  156       <span class="c"># Filenames are not expanded during command line invocation from Windows...</span> | 
|  | 170  157       <span class="s">(</span><span class="i">$FileDir</span><span class="cm">,</span> <span class="i">$Name</span><span class="cm">,</span> <span class="i">$FileExt</span><span class="s">)</span> = <span class="i">ParseFileName</span><span class="s">(</span><span class="i">$FileName</span><span class="s">)</span><span class="sc">;</span> | 
|  | 171  158 | 
|  | 172  159       <span class="i">$DirNamePrefix</span> = <span class="i">$IncludeDirName</span> ? <span class="q">"$FileDir$Delimiter"</span> <span class="co">:</span> <span class="q">""</span><span class="sc">;</span> | 
|  | 173  160 | 
|  | 174  161       <span class="i">@DirFileNames</span> = <span class="s">(</span><span class="s">)</span><span class="sc">;</span> | 
|  | 175  162       <span class="k">if</span> <span class="s">(</span>!<span class="k">opendir</span> <span class="w">FILEDIR</span><span class="cm">,</span> <span class="i">$FileDir</span><span class="s">)</span> <span class="s">{</span> | 
|  | 176  163         <span class="w">carp</span> <span class="q">"Warning: Ignoring files $FileName: Couldn't open directory $FileDir: $! ..."</span><span class="sc">;</span> | 
|  | 177  164         <span class="k">next</span> <span class="j">FILEINDEX</span><span class="sc">;</span> | 
|  | 178  165       <span class="s">}</span> | 
|  | 179  166 | 
|  | 180  167       <span class="c"># Collect file names without '.' and '..' as readdir function places them on the list...</span> | 
|  | 181  168       <span class="c">#</span> | 
|  | 182  169       <span class="i">@DirFileNames</span> = <span class="k">map</span> <span class="s">{</span> <span class="q">"$DirNamePrefix$_"</span>  <span class="s">}</span> <span class="k">grep</span> <span class="s">{</span> !<span class="q">/^(\.|\.\.)$/</span> <span class="s">}</span> <span class="k">readdir</span> <span class="w">FILEDIR</span><span class="sc">;</span> | 
|  | 183  170       <span class="k">closedir</span> <span class="w">FILEDIR</span><span class="sc">;</span> | 
|  | 184  171 | 
|  | 185  172       <span class="k">if</span> <span class="s">(</span><span class="k">length</span><span class="s">(</span><span class="i">$Name</span><span class="s">)</span> > <span class="n">1</span><span class="s">)</span> <span class="s">{</span> | 
|  | 186  173         <span class="c"># Replace * by .*? for greedy match...</span> | 
|  | 187  174         <span class="i">$Name</span> =~ <span class="q">s/\*/\.\*\?/g</span><span class="sc">;</span> | 
|  | 188  175         <span class="i">@DirFileNames</span> =  <span class="k">grep</span> <span class="s">{</span> <span class="q">/$Name/</span> <span class="s">}</span> <span class="i">@DirFileNames</span><span class="sc">;</span> | 
|  | 189  176       <span class="s">}</span> | 
|  | 190  177 | 
|  | 191  178       <span class="k">if</span> <span class="s">(</span><span class="i">$FileExt</span><span class="s">)</span> <span class="s">{</span> | 
|  | 192  179         <span class="i">$FileExt</span> =~ <span class="q">s/\*/\.\*\?/g</span><span class="sc">;</span> | 
|  | 193  180         <span class="i">@DirFileNames</span> =  <span class="k">grep</span> <span class="s">{</span> <span class="q">/\.$FileExt$/</span> <span class="s">}</span> <span class="i">@DirFileNames</span><span class="sc">;</span> | 
|  | 194  181       <span class="s">}</span> | 
|  | 195  182       <span class="k">elsif</span> <span class="s">(</span><span class="i">$FileExtsPattern</span><span class="s">)</span> <span class="s">{</span> | 
|  | 196  183         <span class="i">@DirFileNames</span> = <span class="k">grep</span> <span class="s">{</span> <span class="q">/\.$FileExtsPattern$/</span> <span class="s">}</span> <span class="i">@DirFileNames</span><span class="sc">;</span> | 
|  | 197  184       <span class="s">}</span> | 
|  | 198  185 | 
|  | 199  186       <span class="k">push</span> <span class="i">@FilesList</span><span class="cm">,</span> <span class="i">@DirFileNames</span><span class="sc">;</span> | 
|  | 200  187     <span class="s">}</span> | 
|  | 201  188     <span class="k">else</span> <span class="s">{</span> | 
|  | 202  189       <span class="k">push</span> <span class="i">@FilesList</span><span class="cm">,</span> <span class="i">$FileName</span><span class="sc">;</span> | 
|  | 203  190     <span class="s">}</span> | 
|  | 204  191   <span class="s">}</span> | 
|  | 205  192   <span class="k">return</span> <span class="i">@FilesList</span><span class="sc">;</span> | 
|  | 206  193 <span class="s">}</span> | 
|  | 207  194 | 
|  | 208  195 <span class="c"># Formatted file modification time...</span> | 
|  | 209 <a name="FormattedFileModificationTimeAndDate-"></a> 196 <span class="k">sub </span><span class="m">FormattedFileModificationTimeAndDate</span> <span class="s">{</span> | 
|  | 210  197   <span class="k">my</span><span class="s">(</span><span class="i">$FileName</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span> | 
|  | 211  198   <span class="k">my</span><span class="s">(</span><span class="i">$TimeString</span><span class="cm">,</span> <span class="i">$DateString</span><span class="s">)</span> = <span class="s">(</span><span class="q">''</span><span class="s">)</span> x <span class="n">2</span><span class="sc">;</span> | 
|  | 212  199 | 
|  | 213  200   <span class="k">if</span> <span class="s">(</span>! <span class="k">-e</span> <span class="i">$FileName</span><span class="s">)</span> <span class="s">{</span> | 
|  | 214  201     <span class="k">return</span> <span class="s">(</span><span class="i">$TimeString</span><span class="cm">,</span> <span class="i">$DateString</span><span class="s">)</span><span class="sc">;</span> | 
|  | 215  202   <span class="s">}</span> | 
|  | 216  203   <span class="k">my</span><span class="s">(</span><span class="i">$Hours</span><span class="cm">,</span> <span class="i">$Mins</span><span class="cm">,</span> <span class="i">$Secs</span><span class="cm">,</span> <span class="i">$DayName</span><span class="cm">,</span> <span class="i">$MonthName</span><span class="cm">,</span> <span class="i">$Month</span><span class="cm">,</span> <span class="i">$Year</span><span class="s">)</span> = <span class="i">FileModificationTimeAndDate</span><span class="s">(</span><span class="i">$FileName</span><span class="s">)</span><span class="sc">;</span> | 
|  | 217  204 | 
|  | 218  205   <span class="c"># Setup time suffix...</span> | 
|  | 219  206   <span class="k">my</span><span class="s">(</span><span class="i">$TimeSuffix</span><span class="s">)</span> = <span class="q">''</span><span class="sc">;</span> | 
|  | 220  207   <span class="k">if</span> <span class="s">(</span><span class="i">$Hours</span> < <span class="n">12</span><span class="s">)</span> <span class="s">{</span> | 
|  | 221  208     <span class="i">$TimeSuffix</span> = <span class="q">'AM'</span><span class="sc">;</span> | 
|  | 222  209   <span class="s">}</span> | 
|  | 223  210   <span class="k">elsif</span> <span class="s">(</span><span class="i">$Hours</span> > <span class="n">12</span><span class="s">)</span> <span class="s">{</span> | 
|  | 224  211     <span class="i">$TimeSuffix</span> = <span class="q">'PM'</span><span class="sc">;</span> | 
|  | 225  212     <span class="i">$Hours</span> = <span class="i">$Hours</span> - <span class="n">12</span><span class="sc">;</span> | 
|  | 226  213   <span class="s">}</span> | 
|  | 227  214   <span class="k">elsif</span> <span class="s">(</span><span class="i">$Hours</span> == <span class="n">12</span> && <span class="s">(</span><span class="i">$Mins</span> > <span class="n">0</span> || <span class="i">$Secs</span> > <span class="n">0</span><span class="s">)</span><span class="s">)</span> <span class="s">{</span> | 
|  | 228  215     <span class="i">$TimeSuffix</span> = <span class="q">'PM'</span><span class="sc">;</span> | 
|  | 229  216   <span class="s">}</span> | 
|  | 230  217   <span class="k">elsif</span> <span class="s">(</span><span class="i">$Hours</span> == <span class="n">12</span> && <span class="i">$Mins</span> == <span class="n">0</span> && <span class="i">$Secs</span> == <span class="n">0</span><span class="s">)</span> <span class="s">{</span> | 
|  | 231  218     <span class="i">$TimeSuffix</span> = <span class="q">'Noon'</span><span class="sc">;</span> | 
|  | 232  219   <span class="s">}</span> | 
|  | 233  220 | 
|  | 234  221   <span class="i">$Month</span> = <span class="i">TextUtil::AddNumberSuffix</span><span class="s">(</span><span class="i">$Month</span><span class="s">)</span><span class="sc">;</span> | 
|  | 235  222 | 
|  | 236  223   <span class="i">$TimeString</span> = <span class="q">"${DayName} ${Hours}:${Mins}:${Secs} ${TimeSuffix}"</span><span class="sc">;</span> | 
|  | 237  224   <span class="i">$DateString</span> = <span class="q">"${MonthName} ${Month}, ${Year}"</span><span class="sc">;</span> | 
|  | 238  225 | 
|  | 239  226   <span class="k">return</span> <span class="s">(</span><span class="i">$TimeString</span><span class="cm">,</span> <span class="i">$DateString</span><span class="s">)</span><span class="sc">;</span> | 
|  | 240  227 <span class="s">}</span> | 
|  | 241  228 | 
|  | 242  229 <span class="c"># File modifcation time and date...</span> | 
|  | 243 <a name="FileModificationTimeAndDate-"></a> 230 <span class="k">sub </span><span class="m">FileModificationTimeAndDate</span> <span class="s">{</span> | 
|  | 244  231   <span class="k">my</span><span class="s">(</span><span class="i">$FileName</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span> | 
|  | 245  232   <span class="k">my</span><span class="s">(</span><span class="i">$Hours</span><span class="cm">,</span> <span class="i">$Mins</span><span class="cm">,</span> <span class="i">$Secs</span><span class="cm">,</span> <span class="i">$DayName</span><span class="cm">,</span> <span class="i">$MonthName</span><span class="cm">,</span> <span class="i">$Month</span><span class="cm">,</span> <span class="i">$Year</span><span class="s">)</span> = <span class="s">(</span><span class="q">''</span><span class="s">)</span> x <span class="n">7</span><span class="sc">;</span> | 
|  | 246  233 | 
|  | 247  234   <span class="k">if</span> <span class="s">(</span>! <span class="k">-e</span> <span class="i">$FileName</span><span class="s">)</span> <span class="s">{</span> | 
|  | 248  235     <span class="k">return</span> <span class="s">(</span><span class="i">$Hours</span><span class="cm">,</span> <span class="i">$Mins</span><span class="cm">,</span> <span class="i">$Secs</span><span class="cm">,</span> <span class="i">$DayName</span><span class="cm">,</span> <span class="i">$MonthName</span><span class="cm">,</span> <span class="i">$Month</span><span class="cm">,</span> <span class="i">$Year</span><span class="s">)</span><span class="sc">;</span> | 
|  | 249  236   <span class="s">}</span> | 
|  | 250  237 | 
|  | 251  238   <span class="k">my</span><span class="s">(</span><span class="i">$CTimeString</span><span class="cm">,</span> <span class="i">$FileStatRef</span><span class="cm">,</span> <span class="i">$TimeStamp</span><span class="s">)</span><span class="sc">;</span> | 
|  | 252  239   <span class="i">$FileStatRef</span> = <span class="k">stat</span><span class="s">(</span><span class="i">$FileName</span><span class="s">)</span><span class="sc">;</span> | 
|  | 253  240 | 
|  | 254  241   <span class="i">$CTimeString</span> = <span class="i">Time::localtime::ctime</span><span class="s">(</span><span class="i">$FileStatRef</span><span class="i">->mtime</span><span class="s">)</span><span class="sc">;</span> | 
|  | 255  242 | 
|  | 256  243   <span class="c"># ctime returns: Thu Aug 3 10:13:53 2006</span> | 
|  | 257  244   <span class="s">(</span><span class="i">$DayName</span><span class="cm">,</span> <span class="i">$MonthName</span><span class="cm">,</span> <span class="i">$Month</span><span class="cm">,</span> <span class="i">$TimeStamp</span><span class="cm">,</span> <span class="i">$Year</span><span class="s">)</span> = <span class="k">split</span> <span class="q">/[ ]+/</span><span class="cm">,</span> <span class="i">$CTimeString</span><span class="sc">;</span> | 
|  | 258  245   <span class="s">(</span><span class="i">$Hours</span><span class="cm">,</span> <span class="i">$Mins</span><span class="cm">,</span> <span class="i">$Secs</span><span class="s">)</span> = <span class="k">split</span> <span class="q">/\:/</span><span class="cm">,</span> <span class="i">$TimeStamp</span><span class="sc">;</span> | 
|  | 259  246 | 
|  | 260  247   <span class="k">return</span> <span class="s">(</span><span class="i">$Hours</span><span class="cm">,</span> <span class="i">$Mins</span><span class="cm">,</span> <span class="i">$Secs</span><span class="cm">,</span> <span class="i">$DayName</span><span class="cm">,</span> <span class="i">$MonthName</span><span class="cm">,</span> <span class="i">$Month</span><span class="cm">,</span> <span class="i">$Year</span><span class="s">)</span><span class="sc">;</span> | 
|  | 261  248 <span class="s">}</span> | 
|  | 262  249 | 
|  | 263  250 <span class="c"># Format file size...</span> | 
|  | 264 <a name="FormatFileSize-"></a> 251 <span class="k">sub </span><span class="m">FormatFileSize</span> <span class="s">{</span> | 
|  | 265  252   <span class="k">my</span><span class="s">(</span><span class="i">$Precision</span><span class="cm">,</span> <span class="i">$Size</span><span class="s">)</span><span class="sc">;</span> | 
|  | 266  253 | 
|  | 267  254   <span class="i">$Precision</span> = <span class="n">1</span><span class="sc">;</span> | 
|  | 268  255   <span class="k">if</span> <span class="s">(</span><span class="i">@_</span> == <span class="n">2</span><span class="s">)</span> <span class="s">{</span> | 
|  | 269  256     <span class="s">(</span><span class="i">$Size</span><span class="cm">,</span> <span class="i">$Precision</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span> | 
|  | 270  257   <span class="s">}</span> | 
|  | 271  258   <span class="k">else</span> <span class="s">{</span> | 
|  | 272  259     <span class="s">(</span><span class="i">$Size</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span> | 
|  | 273  260   <span class="s">}</span> | 
|  | 274  261   <span class="k">my</span><span class="s">(</span><span class="i">$SizeDenominator</span><span class="cm">,</span> <span class="i">$SizeSuffix</span><span class="s">)</span><span class="sc">;</span> | 
|  | 275  262   <span class="j">FORMAT:</span> <span class="s">{</span> | 
|  | 276  263       <span class="k">if</span> <span class="s">(</span><span class="i">$Size</span> < <span class="n">1024</span><span class="s">)</span> <span class="s">{</span> <span class="i">$SizeDenominator</span> = <span class="n">1</span><span class="sc">;</span> <span class="i">$SizeSuffix</span> = <span class="q">'bytes'</span><span class="sc">;</span> <span class="k">last</span> <span class="j">FORMAT</span><span class="sc">;</span><span class="s">}</span> | 
|  | 277  264       <span class="k">if</span> <span class="s">(</span><span class="i">$Size</span> < <span class="s">(</span><span class="n">1024</span>*<span class="n">1024</span><span class="s">)</span><span class="s">)</span> <span class="s">{</span> <span class="i">$SizeDenominator</span> = <span class="n">1024</span><span class="sc">;</span> <span class="i">$SizeSuffix</span> = <span class="q">'KB'</span><span class="sc">;</span> <span class="k">last</span> <span class="j">FORMAT</span><span class="sc">;</span><span class="s">}</span> | 
|  | 278  265       <span class="k">if</span> <span class="s">(</span><span class="i">$Size</span> < <span class="s">(</span><span class="n">1024</span>*<span class="n">1024</span>*<span class="n">1024</span><span class="s">)</span><span class="s">)</span> <span class="s">{</span> <span class="i">$SizeDenominator</span> = <span class="n">1024</span>*<span class="n">1024</span><span class="sc">;</span> <span class="i">$SizeSuffix</span> = <span class="q">'MB'</span><span class="sc">;</span> <span class="k">last</span> <span class="j">FORMAT</span><span class="sc">;</span><span class="s">}</span> | 
|  | 279  266       <span class="k">if</span> <span class="s">(</span><span class="i">$Size</span> < <span class="s">(</span><span class="n">1024</span>*<span class="n">1024</span>*<span class="n">1024</span>*<span class="n">1024</span><span class="s">)</span><span class="s">)</span> <span class="s">{</span> <span class="i">$SizeDenominator</span> = <span class="n">1024</span>*<span class="n">1024</span>*<span class="n">1024</span><span class="sc">;</span> <span class="i">$SizeSuffix</span> = <span class="q">'GB'</span><span class="sc">;</span> <span class="k">last</span> <span class="j">FORMAT</span><span class="sc">;</span><span class="s">}</span> | 
|  | 280  267       <span class="i">$SizeDenominator</span> = <span class="n">1</span><span class="sc">;</span> <span class="i">$SizeSuffix</span> = <span class="q">'bytes'</span><span class="sc">;</span> | 
|  | 281  268     <span class="s">}</span> | 
|  | 282  269   <span class="i">$Size</span> /= <span class="i">$SizeDenominator</span><span class="sc">;</span> | 
|  | 283  270   <span class="i">$Size</span> = <span class="k">sprintf</span><span class="s">(</span><span class="q">"%.${Precision}f"</span><span class="cm">,</span> <span class="i">$Size</span><span class="s">)</span> + <span class="n">0</span><span class="sc">;</span> | 
|  | 284  271   <span class="i">$Size</span> = <span class="q">"$Size $SizeSuffix"</span><span class="sc">;</span> | 
|  | 285  272 | 
|  | 286  273   <span class="k">return</span> <span class="i">$Size</span><span class="sc">;</span> | 
|  | 287  274 <span class="s">}</span> | 
|  | 288  275 | 
|  | 289  276 <span class="c"># Get file size in bytes...</span> | 
|  | 290 <a name="FileSize-"></a> 277 <span class="k">sub </span><span class="m">FileSize</span> <span class="s">{</span> | 
|  | 291  278   <span class="k">my</span><span class="s">(</span><span class="i">$File</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span> | 
|  | 292  279 | 
|  | 293  280   <span class="k">if</span> <span class="s">(</span>! <span class="k">-e</span> <span class="i">$File</span><span class="s">)</span> <span class="s">{</span> | 
|  | 294  281     <span class="k">return</span> <span class="k">undef</span><span class="sc">;</span> | 
|  | 295  282   <span class="s">}</span> | 
|  | 296  283   <span class="k">return</span> <span class="s">(</span><span class="k">-s</span> <span class="i">$File</span><span class="s">)</span> | 
|  | 297  284 <span class="s">}</span> | 
|  | 298  285 | 
|  | 299  286 <span class="c"># Get MayaChemTool's lib directory name using @INC to extract</span> | 
|  | 300  287 <span class="c"># <MAYACHEMTOOLS>/lib directory location: first entry in @INC path should contain</span> | 
|  | 301  288 <span class="c"># MayaChemTools modules location</span> | 
|  | 302  289 <span class="c">#</span> | 
|  | 303 <a name="GetMayaChemToolsLibDirName-"></a> 290 <span class="k">sub </span><span class="m">GetMayaChemToolsLibDirName</span> <span class="s">{</span> | 
|  | 304  291 | 
|  | 305  292   <span class="k">if</span> <span class="s">(</span><span class="k">defined</span> <span class="i">$MayaChemToolsLibDir</span><span class="s">)</span> <span class="s">{</span> | 
|  | 306  293     <span class="k">return</span> <span class="i">$MayaChemToolsLibDir</span><span class="sc">;</span> | 
|  | 307  294   <span class="s">}</span> | 
|  | 308  295 | 
|  | 309  296   <span class="i">$MayaChemToolsLibDir</span> = <span class="q">""</span><span class="sc">;</span> | 
|  | 310  297   <span class="k">if</span> <span class="s">(</span><span class="i">$INC</span>[<span class="n">0</span>] =~ <span class="q">/MayaChemTools/i</span><span class="s">)</span> <span class="s">{</span> | 
|  | 311  298     <span class="i">$MayaChemToolsLibDir</span> = <span class="i">$INC</span>[<span class="n">0</span>]<span class="sc">;</span> | 
|  | 312  299   <span class="s">}</span> | 
|  | 313  300   <span class="k">else</span> <span class="s">{</span> | 
|  | 314  301     <span class="c"># Go through rest of the entries...</span> | 
|  | 315  302     <span class="k">my</span><span class="s">(</span><span class="i">$Index</span><span class="s">)</span><span class="sc">;</span> | 
|  | 316  303     <span class="j">INDEX:</span> <span class="k">for</span> <span class="i">$Index</span> <span class="s">(</span><span class="n">1</span> .. <span class="i">$#INC</span><span class="s">)</span> <span class="s">{</span> | 
|  | 317  304       <span class="k">if</span> <span class="s">(</span><span class="i">$INC</span>[<span class="i">$Index</span>] =~ <span class="q">/MayaChemTools/i</span><span class="s">)</span> <span class="s">{</span> | 
|  | 318  305         <span class="i">$MayaChemToolsLibDir</span> = <span class="i">$INC</span>[<span class="i">$Index</span>]<span class="sc">;</span> | 
|  | 319  306         <span class="k">last</span> <span class="j">INDEX</span><span class="sc">;</span> | 
|  | 320  307       <span class="s">}</span> | 
|  | 321  308     <span class="s">}</span> | 
|  | 322  309     <span class="k">if</span> <span class="s">(</span>!<span class="i">$MayaChemToolsLibDir</span><span class="s">)</span> <span class="s">{</span> | 
|  | 323  310       <span class="w">carp</span> <span class="q">"Warning: MayaChemTools lib directory location doesn't appear to exist in library search path specified by \@INC ..."</span><span class="sc">;</span> | 
|  | 324  311     <span class="s">}</span> | 
|  | 325  312   <span class="s">}</span> | 
|  | 326  313   <span class="k">return</span> <span class="i">$MayaChemToolsLibDir</span><span class="sc">;</span> | 
|  | 327  314 <span class="s">}</span> | 
|  | 328  315 | 
|  | 329  316 <span class="c"># Get Usage from Pod...</span> | 
|  | 330 <a name="GetUsageFromPod-"></a> 317 <span class="k">sub </span><span class="m">GetUsageFromPod</span> <span class="s">{</span> | 
|  | 331  318   <span class="k">my</span><span class="s">(</span><span class="i">$Usage</span><span class="cm">,</span> <span class="i">$ScriptPath</span><span class="s">)</span><span class="sc">;</span> | 
|  | 332  319 | 
|  | 333  320   <span class="s">(</span><span class="i">$ScriptPath</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span> | 
|  | 334  321   <span class="i">$Usage</span> = <span class="q">"Script usage not available: pod2text or pod2text.bat doesn't exist in your Perl installation and direct invocation of Pod::Text also failed\n"</span><span class="sc">;</span> | 
|  | 335  322 | 
|  | 336  323   <span class="c"># Get pod documentation: try pod2text first followed by perdoc.bat in case it fails to</span> | 
|  | 337  324   <span class="c"># to handle ActiveState Perl...</span> | 
|  | 338  325   <span class="k">my</span><span class="s">(</span><span class="i">$PodStatus</span><span class="s">)</span><span class="sc">;</span> | 
|  | 339  326   <span class="i">$PodStatus</span> = <span class="s">(</span><span class="k">open</span> <span class="w">CMD</span><span class="cm">,</span> <span class="q">"pod2text $ScriptPath|"</span><span class="s">)</span> ? <span class="n">1</span> <span class="co">:</span> <span class="s">(</span><span class="s">(</span><span class="k">open</span> <span class="w">CMD</span><span class="cm">,</span> <span class="q">"pod2text.bat $ScriptPath|"</span><span class="s">)</span> ? <span class="n">1</span> <span class="co">:</span> <span class="n">0</span><span class="s">)</span><span class="sc">;</span> | 
|  | 340  327   <span class="k">if</span> <span class="s">(</span>!<span class="i">$PodStatus</span><span class="s">)</span> <span class="s">{</span> | 
|  | 341  328     <span class="c"># Try direct invocation of Pod::Text before giving up...</span> | 
|  | 342  329     <span class="k">my</span><span class="s">(</span><span class="i">$PodTextCmd</span><span class="s">)</span><span class="sc">;</span> | 
|  | 343  330     <span class="i">$PodTextCmd</span> = <span class="q">"perl -e \'use Pod::Text (); \$TextFormatter = Pod::Text->new(); \$TextFormatter->parse_from_file(\"$ScriptPath\");\'"</span><span class="sc">;</span> | 
|  | 344  331     <span class="i">$PodStatus</span> = <span class="s">(</span><span class="k">open</span> <span class="w">CMD</span><span class="cm">,</span> <span class="q">"$PodTextCmd|"</span><span class="s">)</span> ? <span class="n">1</span> <span class="co">:</span> <span class="n">0</span><span class="sc">;</span> | 
|  | 345  332     <span class="k">if</span> <span class="s">(</span>!<span class="i">$PodStatus</span><span class="s">)</span> <span class="s">{</span> | 
|  | 346  333       <span class="k">return</span> <span class="i">$Usage</span><span class="sc">;</span> | 
|  | 347  334     <span class="s">}</span> | 
|  | 348  335   <span class="s">}</span> | 
|  | 349  336   <span class="k">my</span><span class="s">(</span><span class="i">$ProcessingSection</span><span class="cm">,</span> <span class="i">$InParametersSection</span><span class="cm">,</span> <span class="i">$InOptionsSection</span><span class="cm">,</span> <span class="i">@LineWords</span><span class="s">)</span><span class="sc">;</span> | 
|  | 350  337   <span class="i">$ProcessingSection</span> = <span class="n">0</span><span class="sc">;</span> <span class="i">$InParametersSection</span> = <span class="n">0</span><span class="sc">;</span> <span class="i">$InOptionsSection</span> = <span class="n">0</span><span class="sc">;</span> | 
|  | 351  338   <span class="j">PODLINE:</span> <span class="k">while</span> <span class="s">(</span><span class="q"><CMD></span><span class="s">)</span> <span class="s">{</span> | 
|  | 352  339     <span class="k">if</span> <span class="s">(</span><span class="q">/^SYNOPSIS/</span><span class="s">)</span> <span class="s">{</span> | 
|  | 353  340       <span class="i">$_</span> = <span class="q"><CMD></span><span class="sc">;</span> <span class="k">chomp</span><span class="sc">;</span> <span class="q">s/^ +//g</span><span class="sc">;</span> | 
|  | 354  341       <span class="s">(</span><span class="i">@LineWords</span><span class="s">)</span> = <span class="k">split</span> <span class="q">/ /</span><span class="sc">;</span> | 
|  | 355  342       <span class="i">$Usage</span> = <span class="q">qq(Usage: $LineWords[0] [-options]... )</span><span class="sc">;</span> | 
|  | 356  343       <span class="k">shift</span> <span class="i">@LineWords</span><span class="sc">;</span> | 
|  | 357  344       <span class="i">$Usage</span> .= <span class="k">join</span><span class="s">(</span><span class="q">" "</span><span class="cm">,</span> <span class="i">@LineWords</span><span class="s">)</span> . <span class="q">"\n"</span><span class="sc">;</span> | 
|  | 358  345     <span class="s">}</span> | 
|  | 359  346     <span class="k">elsif</span> <span class="s">(</span><span class="q">/^(DESCRIPTION|PARAMETERS|OPTIONS|EXAMPLES|AUTHOR|SEE ALSO|COPYRIGHT)/i</span><span class="s">)</span> <span class="s">{</span> | 
|  | 360  347       <span class="c"># Various sections...</span> | 
|  | 361  348       <span class="k">chomp</span><span class="sc">;</span> | 
|  | 362  349       <span class="i">$Usage</span> .= <span class="k">ucfirst</span><span class="s">(</span><span class="k">lc</span><span class="s">(</span><span class="i">$_</span><span class="s">)</span><span class="s">)</span> . <span class="q">":\n"</span><span class="sc">;</span> | 
|  | 363  350       <span class="i">$ProcessingSection</span> = <span class="n">1</span><span class="sc">;</span> | 
|  | 364  351       <span class="i">$InOptionsSection</span> = <span class="q">/^OPTIONS/</span> ? <span class="n">1</span> <span class="co">:</span> <span class="n">0</span><span class="sc">;</span> | 
|  | 365  352       <span class="i">$InParametersSection</span> = <span class="q">/^PARAMETERS/</span> ? <span class="n">1</span> <span class="co">:</span> <span class="n">0</span><span class="sc">;</span> | 
|  | 366  353     <span class="s">}</span> | 
|  | 367  354     <span class="k">elsif</span> <span class="s">(</span><span class="i">$InParametersSection</span>|<span class="i">$InOptionsSection</span><span class="s">)</span> <span class="s">{</span> | 
|  | 368  355       <span class="k">if</span> <span class="s">(</span><span class="q">/^[ ]+\-/</span> || <span class="q">/^[ ]{4,4}/</span><span class="s">)</span> <span class="s">{</span> | 
|  | 369  356         <span class="c"># Start of option line: any number of spaces followed by - sign.</span> | 
|  | 370  357         <span class="c"># Put back in <> which pod2text replaced to **</span> | 
|  | 371  358         <span class="k">my</span><span class="s">(</span><span class="i">$OptionLine</span><span class="s">)</span> = <span class="q">qq($_)</span><span class="sc">;</span> | 
|  | 372  359            <span class="j">OPTIONLINE:</span> <span class="k">while</span> <span class="s">(</span><span class="q"><CMD></span><span class="s">)</span> <span class="s">{</span> | 
|  | 373  360           <span class="k">if</span> <span class="s">(</span><span class="q">/^(    )/</span><span class="s">)</span> <span class="s">{</span> | 
|  | 374  361             <span class="i">$OptionLine</span> .= <span class="q">qq($_)</span><span class="sc">;</span> | 
|  | 375  362           <span class="s">}</span> | 
|  | 376  363           <span class="k">else</span> <span class="s">{</span> | 
|  | 377  364             <span class="i">$OptionLine</span> =~ <span class="q">s/\*(([a-zA-Z0-9])|(\[)|(\#)|(\"))/"\<" . substr($&, -1, 1)/e</span><span class="sc">;</span> | 
|  | 378  365             <span class="i">$OptionLine</span> =~ <span class="q">s/(([a-zA-Z0-9])|(\])|(\#)|(\"))\*/substr($&, 0, 1) . "\>"/e</span><span class="sc">;</span> | 
|  | 379  366             <span class="i">$Usage</span> .= <span class="q">qq($OptionLine$_)</span><span class="sc">;</span> | 
|  | 380  367             <span class="k">last</span> <span class="j">OPTIONLINE</span><span class="sc">;</span> | 
|  | 381  368           <span class="s">}</span> | 
|  | 382  369         <span class="s">}</span> | 
|  | 383  370       <span class="s">}</span> | 
|  | 384  371     <span class="s">}</span> | 
|  | 385  372     <span class="k">else</span> <span class="s">{</span> | 
|  | 386  373       <span class="k">if</span> <span class="s">(</span><span class="i">$ProcessingSection</span><span class="s">)</span> <span class="s">{</span> <span class="i">$Usage</span> .= <span class="q">qq($_)</span><span class="sc">;</span> <span class="s">}</span> | 
|  | 387  374     <span class="s">}</span> | 
|  | 388  375   <span class="s">}</span> | 
|  | 389  376   <span class="k">close</span> <span class="w">CMD</span><span class="sc">;</span> | 
|  | 390  377 | 
|  | 391  378   <span class="c"># Take out **which pod2text puts in for <></span> | 
|  | 392  379   <span class="i">$Usage</span> =~ <span class="q">s/\*(([a-zA-Z0-9;#-])|(\")|(\()|(\[)|(\.))/substr($&, -1, 1)/eg</span><span class="sc">;</span> | 
|  | 393  380   <span class="i">$Usage</span> =~ <span class="q">s/(([a-zA-Z0-9;#-])|(\")|(\))|(\])|(\.))\*/substr($&, 0, 1)/eg</span><span class="sc">;</span> | 
|  | 394  381 | 
|  | 395  382   <span class="k">return</span> <span class="i">$Usage</span><span class="sc">;</span> | 
|  | 396  383 <span class="s">}</span> | 
|  | 397  384 | 
|  | 398  385 <span class="c"># Split full file name into directory path, file name, and the extension.</span> | 
|  | 399 <a name="ParseFileName-"></a> 386 <span class="k">sub </span><span class="m">ParseFileName</span> <span class="s">{</span> | 
|  | 400  387   <span class="k">my</span><span class="s">(</span><span class="i">$FullName</span><span class="s">)</span> = <span class="i">@_</span><span class="sc">;</span> | 
|  | 401  388   <span class="k">my</span><span class="s">(</span><span class="i">$FileDir</span><span class="cm">,</span> <span class="i">$FileName</span><span class="cm">,</span> <span class="i">$FileExt</span><span class="cm">,</span> <span class="i">@FullFileNameParts</span><span class="cm">,</span> <span class="i">@FileNameParts</span><span class="cm">,</span> <span class="i">$Delimiter</span><span class="s">)</span><span class="sc">;</span> | 
|  | 402  389 | 
|  | 403  390   <span class="i">$Delimiter</span> = <span class="q">"\/"</span><span class="sc">;</span> | 
|  | 404  391   <span class="k">if</span> <span class="s">(</span><span class="i">$FullName</span> =~ <span class="q">/\\/</span> <span class="s">)</span> <span class="s">{</span> | 
|  | 405  392     <span class="i">$Delimiter</span> = <span class="q">"\\"</span><span class="sc">;</span> | 
|  | 406  393     <span class="i">$FullName</span> =~ <span class="q">s/\\/\//g</span><span class="sc">;</span> | 
|  | 407  394   <span class="s">}</span> | 
|  | 408  395   <span class="i">$FileDir</span> = <span class="q">""</span><span class="sc">;</span> <span class="i">$FileName</span> = <span class="q">""</span><span class="sc">;</span> <span class="i">$FileExt</span> = <span class="q">""</span><span class="sc">;</span> | 
|  | 409  396   <span class="i">@FullFileNameParts</span> = <span class="s">(</span><span class="s">)</span><span class="sc">;</span> <span class="i">@FileNameParts</span> = <span class="s">(</span><span class="s">)</span><span class="sc">;</span> | 
|  | 410  397 | 
|  | 411  398   <span class="i">@FullFileNameParts</span> = <span class="k">split</span> <span class="q">"\/"</span><span class="cm">,</span> <span class="i">$FullName</span><span class="sc">;</span> | 
|  | 412  399   <span class="i">@FileNameParts</span> = <span class="k">split</span> <span class="q">/\./</span><span class="cm">,</span> <span class="i">$FullFileNameParts</span>[<span class="i">$#FullFileNameParts</span>]<span class="sc">;</span> | 
|  | 413  400 | 
|  | 414  401   <span class="c"># Setup file dir...</span> | 
|  | 415  402   <span class="k">if</span> <span class="s">(</span><span class="i">@FullFileNameParts</span> == <span class="n">1</span><span class="s">)</span> <span class="s">{</span> | 
|  | 416  403     <span class="i">$FileDir</span> = <span class="q">"\."</span><span class="sc">;</span> | 
|  | 417  404   <span class="s">}</span> | 
|  | 418  405   <span class="k">else</span> <span class="s">{</span> | 
|  | 419  406     <span class="k">pop</span> <span class="i">@FullFileNameParts</span><span class="sc">;</span> | 
|  | 420  407     <span class="i">$FileDir</span> = <span class="k">join</span> <span class="i">$Delimiter</span><span class="cm">,</span> <span class="i">@FullFileNameParts</span><span class="sc">;</span> | 
|  | 421  408   <span class="s">}</span> | 
|  | 422  409 | 
|  | 423  410   <span class="c"># Setup file name and ext...</span> | 
|  | 424  411   <span class="k">if</span> <span class="s">(</span><span class="i">@FileNameParts</span> == <span class="n">1</span><span class="s">)</span> <span class="s">{</span> | 
|  | 425  412     <span class="i">$FileName</span> = <span class="i">$FileNameParts</span>[<span class="n">0</span>]<span class="sc">;</span> | 
|  | 426  413     <span class="i">$FileExt</span> = <span class="q">""</span><span class="sc">;</span> | 
|  | 427  414   <span class="s">}</span> | 
|  | 428  415   <span class="k">elsif</span> <span class="s">(</span><span class="i">@FileNameParts</span> == <span class="n">2</span><span class="s">)</span> <span class="s">{</span> | 
|  | 429  416     <span class="i">$FileName</span> = <span class="i">$FileNameParts</span>[<span class="n">0</span>]<span class="sc">;</span> | 
|  | 430  417     <span class="i">$FileExt</span> = <span class="i">$FileNameParts</span>[<span class="n">1</span>]<span class="sc">;</span> | 
|  | 431  418   <span class="s">}</span> | 
|  | 432  419   <span class="k">elsif</span> <span class="s">(</span><span class="i">@FileNameParts</span> > <span class="n">2</span><span class="s">)</span> <span class="s">{</span> | 
|  | 433  420     <span class="c"># Use the last entry as file extension and the rest for file name...</span> | 
|  | 434  421     <span class="i">$FileExt</span> = <span class="i">$FileNameParts</span>[<span class="i">$#FileNameParts</span>]<span class="sc">;</span> | 
|  | 435  422     <span class="k">pop</span> <span class="i">@FileNameParts</span><span class="sc">;</span> | 
|  | 436  423     <span class="i">$FileName</span> = <span class="k">join</span> <span class="q">'.'</span><span class="cm">,</span> <span class="i">@FileNameParts</span><span class="sc">;</span> | 
|  | 437  424   <span class="s">}</span> | 
|  | 438  425   <span class="k">return</span> <span class="s">(</span><span class="i">$FileDir</span><span class="cm">,</span> <span class="i">$FileName</span><span class="cm">,</span> <span class="i">$FileExt</span><span class="s">)</span><span class="sc">;</span> | 
|  | 439  426 <span class="s">}</span> | 
|  | 440  427 | 
|  | 441 <a name="EOF-"></a></pre> | 
|  | 442 <p> </p> | 
|  | 443 <br /> | 
|  | 444 <center> | 
|  | 445 <img src="../../../images/h2o2.png"> | 
|  | 446 </center> | 
|  | 447 </body> | 
|  | 448 </html> |