FileUtil: add some comment to point out we are in the transition of moving stuff to LazFileUtils.

git-svn-id: trunk@41296 -

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+}