diff --git a/docs/xml/lazutils/lazfileutils.xml b/docs/xml/lazutils/lazfileutils.xml index ed9b2d391e..a540452fda 100644 --- a/docs/xml/lazutils/lazfileutils.xml +++ b/docs/xml/lazutils/lazfileutils.xml @@ -1029,26 +1029,49 @@ Windows-specific file system quirks handled in the routine include:
Resolved to C:\
\\..
Resolved to \\
+
c:/path/to/dir
+
+Resolved to C:\path\to\dir using the PathDelimiter for the platform. +

For UNIX-like environments, the resolved path may be invalid if it references the parent directory and the initial directory in the path is a symbolic link.

-When AFilename ends with a relative path ('/.' or '/..'), an additional path -delimiter is added to the return value. +When AFilename ends with a relative path ('/.' or '/..'), the path is resolved +to the directory represented by the relative value. The current directory for +'/.' or the parent directory for '/..'.

If a relative path reference cannot be resolved for the local file system, the original path information is retained.

-Macros found in the AFilename are retained if the relative path references a -parent directory. For example: +Some common examples include: +

+
+
foo/bar/..
+
Resolved to foo
+
foo//..//
+
Resolved to .
+
foo/bar/./../baz
+
Resolved to foo/baz
+
/a/b/../..
+
Resolved to /
+
.//.//.
+
Resolved to .
+
+

+Macros found in the AFilename are retained in the resolved file name. For example:

'($LazarusDir)/../path/that/may/be/invalid/for/macro/filename.ext' +

+If AFilename ends with a path trailing path delimiter or a relative path +reference, the return value will end with a trailing path delimiter. +