################################################################################
  Kodowanie Windows-1250, koniec wiersza CR+LF, test: Za gl ja
  Files - Obsuga plikw i systemu plikw
  Copyleft (C) 2007 Adam Sawicki
  Licencja: GNU LGPL
  Kontakt: mailto:sawickiap@poczta.onet.pl , http://regedit.gamedev.pl/
################################################################################


Wstp
================================================================================

To modu do obsugi plikw i systemu plikw. Zawiera:

- FileStream - klasa strumienia do zapisywania i odczytywania treci pliku
- DirLister - klasa do listowania zawartoci katalogu
- Funkcje do operacji na systemie plikw, w tym:
  > Zapisywanie i odczytywanie caych plikw
  > Sprawdzanie, czy plik albo katalog istnieje
  > Odczytywanie i zapisywanie daty modyfikacji, utworzenia i ostatniego dostpu
  > Tworzenie, usuwanie, zmiana nazwy i przenoszenie plikw i katalogw


Uwagi
================================================================================

- Wiele funkcji posiada wariant z Must-. Wwczas funkcja zwracajca bool w
przypadku bdu zwraca false, a funkcja Must- w przypadku bdu rzuca wyjtek.

- Blokowanie:
W obecnej implementacji:
> Windows - jeli Lock=true, przy trybie do zapisu plik jest blokowany przed
  zapisem i odczytem, przy trybie tylko do odczytu plik jest blokowany tylko
  przed zapisem.
> Linux - jeli Lock=true, plik jest blokowany cakowicie (funkcja flock).


Czego nie ma
================================================================================

- Nie ma funkcji do listowania dyskw w Windows, bo one s charakterystyczne
tylko dla jednego systemu, wic mona z powodzeniem uywa wprost funkcji
WinAPI, jak GetLogicalDrives, GetDriveType i innych z listy "Volume Management
Functions".

- Nie ma kopiowania ani przenoszenia katalogw wraz z ca zawartoci, bo API
systemowe te tego nie maj (WinAPI ma tylko MoveFile[Ex] potrafice przenosi
katalogi wycznie w ramach jednej partycji). Trzebaby to pisa we wasnym
zakresie. Poza tym nie jest a tak potrzebne no i bez asynchronicznoci oraz
paska postpu nie ma zbyt wielkiego sensu.

