FPDoc - further descriptions of functions in FileUtils.xml

git-svn-id: trunk@15209 -
This commit is contained in:
kirkpatc 2008-05-22 17:12:16 +00:00
parent 49291a20cd
commit a04e14d982

View File

@ -407,7 +407,9 @@
<element name="CompareFileExt.CaseSensitive"> <element name="CompareFileExt.CaseSensitive">
<short> <short>
<var>CaseSensitive</var> - if True, case of <var>CaseSensitive</var> - if True, case of
<var>Ext</var> must match case in <var>Ext</var> must match case in
<var>FileName</var> <var>FileName</var>
</short> </short>
</element> </element>
@ -504,41 +506,66 @@
</element> </element>
<!-- function Visibility: default --> <!-- function Visibility: default -->
<element name="CreateAbsoluteSearchPath"> <element name="CreateAbsoluteSearchPath">
<short/> <short>
<descr/> <var>CreateAbsoluteSearchPath</var> - concatenates
<errors/> <var>BaseDirectory </var>and
<seealso/> <var>SearchPath</var> to form an absolute path to search for files</short>
<descr>
<p>
<var>CreateAbsoluteSearchPath</var> - concatenates
<var>BaseDirectory </var>and
<var>SearchPath</var> to form an absolute path to search for files</p>
<p>Adds appropriate path delimiters to the BaseDirectory string, then adds the search path, checking that each directory in the path is in fact an absolutely specified directory, then returns the fully formed absolute search path.</p>
</descr>
<errors>If
<var>BaseDirectory</var> is empty, functions exits and returns with
<var>Result</var> equal to
<var>SearchPath</var>; if
<var>SearchPath</var> is empty, function exits with empty
<var>Result</var>
</errors>
</element> </element>
<!-- function result Visibility: default --> <!-- function result Visibility: default -->
<element name="CreateAbsoluteSearchPath.Result"> <element name="CreateAbsoluteSearchPath.Result">
<short/> <short>The absolute path formed by concatenating <var>BaseDirectory</var> and <var>SearchPath</var>
</short>
</element> </element>
<!-- argument Visibility: default --> <!-- argument Visibility: default -->
<element name="CreateAbsoluteSearchPath.SearchPath"> <element name="CreateAbsoluteSearchPath.SearchPath">
<short/> <short>The search path (a relative path)</short>
</element> </element>
<!-- argument Visibility: default --> <!-- argument Visibility: default -->
<element name="CreateAbsoluteSearchPath.BaseDirectory"> <element name="CreateAbsoluteSearchPath.BaseDirectory">
<short/> <short>The base directory from which to form the absolute path</short>
</element> </element>
<!-- function Visibility: default --> <!-- function Visibility: default -->
<element name="CreateRelativePath"> <element name="CreateRelativePath">
<short/> <short>
<descr/> <var>CreateRelativePath</var> - given an absolute path and a
<errors/> <var>BaseDirectory,</var> create a search path relative to the current directory</short>
<seealso/> <descr>
<p>
<var>CreateRelativePath</var> - given an absolute path and a
<var>BaseDirectory,</var> create a search path relative to the current directory</p>
<p>The returned string includes the correct number of dots and double dots to signify relativity to the current directory (eg ../../or ..\..\ etc)</p>
</descr>
<errors>If <var>BaseDirectory</var> is empty, functions exits and returns with <var>Result</var> equal to <var>Filename</var>; if <var>Filename</var> is empty, function exits with empty <var>Result</var>
</errors>
</element> </element>
<!-- function result Visibility: default --> <!-- function result Visibility: default -->
<element name="CreateRelativePath.Result"> <element name="CreateRelativePath.Result">
<short/> <short>The file name expressed as path relative to the current directory</short>
</element> </element>
<!-- argument Visibility: default --> <!-- argument Visibility: default -->
<element name="CreateRelativePath.Filename"> <element name="CreateRelativePath.Filename">
<short/> <short>The absolute <var>FileName</var> for which a relative path is to be created</short>
</element> </element>
<!-- argument Visibility: default --> <!-- argument Visibility: default -->
<element name="CreateRelativePath.BaseDirectory"> <element name="CreateRelativePath.BaseDirectory">
<short/> <short>
<var>BaseDirectory </var>of the absolute search path</short>
</element> </element>
<!-- function Visibility: default --> <!-- function Visibility: default -->
<element name="FileIsInPath"> <element name="FileIsInPath">