#
# $Id: README,v 0.70 2005/08/09 15:47:00 dankogai Exp $
#

NAME
       MacOSX::File - A collection of modules to manipulate files
       on MacOS X

TIGER
       As of Mac OS X v10.4 (Tiger), most of these operations with
       resource fork are supported by the ordinary (cp|mv|rsync).
       If you are looking for psync, you may as well consider using
       rsync -E instead.

DESCRIPTION
       MacOSX::File is a collection of modules that allows you to
       do what binaries in  /Developer/Tools allows you to do
       directly via perl.  You can implement your own CpMac,
       MvMac, GetFileInfo and SetFile without calling these bina-
       ries.

Subroutines defined in MacOSX::File itself
       Others are defined in other submodules.  see SUBMODULES
       below.

       EXPORT

       by default: unlink(), strerr()

       on request: $OSErr, $CopyErr

       unlink(@files)
           Just like CORE::unlink, deletes a list of files.
           Returns the number of files successfully deleted.  In
           addition to that, MacOSX::File::unlink also attempts
           to delete '._' files, files used in UFS volume to
           store Finder attributes and Resouce fork.

             $cnt = unlink 'a', 'b', 'c'; # deletes 'a', 'b', 'c'
                                          # and     '._a', '._b', '._c'
                                          # and returns 3 if all of them are
                                          # unlinked

       strerr()
           Return string representation of File Manager errors if
           any.  See MacOSX::File::Constants for details.

SUBMODULES
         MacOSX::File::Catalog    - Gets/Sets FSCatalogInfo Attributes
         MacOSX::File::Copy       - copy/move with HFS(+) attributes
         MacOSX::File::Info       - Gets/Sets File Attributes (Subset of ::Catal
og)
         MacOSX::File::Spec       - Gets FSSpec Structure

SCRIPTS
         pcpmac     - CpMac reimplemented
         pmvmac     - MvMac reimplemented
         pgetfinfo  - GetFileInfo reimplemented
         psetfinfo  - SetFile reimplemented
         psync      - update copy utility, very reason I wrote this module

INSTALLATION
       To install this module, first make sure Developer kit is
       installed.  Then type the following:

          perl Makefile.PL
          make
          make test
          make install

DEPENDENCIES
       This module requires MacOS X.  Develper kit is needed to
       "make install".

COPYRIGHT AND LICENCE
       Copyright 2002-2003 Dan Kogai <dankogai@dan.co.jp>

       This library is free software; you can redistribute it
       and/or modify it under the same terms as Perl itself.