diff --git a/components/lazutils/fileutil.pas b/components/lazutils/fileutil.pas index d866a3358e..0af5a58219 100644 --- a/components/lazutils/fileutil.pas +++ b/components/lazutils/fileutil.pas @@ -18,6 +18,34 @@ * * ***************************************************************************** } + +{ **************************************************************************** +BB: 2013-05-19 + +Note to developers: + +This unit should contain functions and procedures to +maintain compatibility with Delphi's FileUtil unit. + +File routines that specifically deal with UTF8 filenames should go into +the LazFileUtils unit. +ATM we have too much duplicate code in FileUtil, LazFileUtils and LazUtf8 + +ToDo: + - copy all Utf8 file routines to LazFileUtils and + in FileUtil inline them to LazFileutils counterparts + (The windows implementation of current FileUtil functions + deals better with unicode characters outside current codepage, + then the old implementations in LazFileUtils that only call Utf8ToSys and vice versa) + (This part is in progres...) + - At a later stage, we might declare the FileUtil versions ot these routines as deprecated + and remove them at some point in time + - Any other functions/procedures that are needed in LazFileUtils too, should be moved + to LazFileUtils, and in Fileutil inlined to use LazileUtils counterparts + +PLEASE DO NOT ADD MORE UTF8 RELATED (FILE) ROUTINES TO THIS UNIT ! + +***************************************************************************** } unit FileUtil; {$mode objfpc}{$H+}