emacs/nxhtml/nxhtml/html-upl/README

   1 # README file for ftpsync.pl
   2
   3
   4 Contents:
   5 =========
   6
   7 - Overview
   8 - Why use ftpsync.pl instead of mirror, sitecopy, ...?
   9 - Requirements/Restrictions
  10 - Bug reports, Contact
  11 - License
  12 - Updates
  13
  14
  15 Overview:
  16 ---------
  17
  18 ftpsync.pl synchronizes a local directory tree and a remote FTP directory tree.
  19
  20 It was initally written to automize web publishing, but might be useful for
  21 some other purposes, like mirroring not-too-large public sites, data
  22 replication, and more.
  23
  24 Call "ftpsync.pl -h" to get a short parameter explanation.
  25
  26
  27 Why use ftpsync.pl instead of mirror, sitecopy, ...?
  28 ----------------------------------------------------
  29
  30 Yes, there are similar projects, so some comments on them:
  31
  32 Compared to mirror, ftpsync.pl is capable of PUTing, not only GETing stuff
  33 (Don't blame me if mirror is able to PUT, I could'nt find a way).
  34
  35 Compared to sitecopy, ftpsync.pl has no problems, if the remote site has been
  36 changed since its last run by other tools and activites. Unless network
  37 problems or bugs occur, ftpsync.pl does a reliable synchronization.
  38
  39 Compared to both, ftpsync.pl is very lightweight ;-))
  40
  41
  42 Requirements / Restrictions:
  43 ----------------------------
  44
  45 - Perl 5.6+
  46   ftpsync.pl was initially developed on  Perl 5.6.0-81 on SuSE Linux 7.2,
  47   older Perl 5.x version might work. Test reports welcome at ftpsync@ibcl.at!
  48
  49 - File::Find, IO::Handle
  50   IMHO parts of the basic perl package.
  51
  52 - Net::FTP
  53   Part of the perl-libnet package.
  54
  55 - UNIX like operating systems on local system
  56   Porting to DOS based systems should be easily done by changing the
  57   directory separator.
  58
  59 - Perhaps, the script does not work with all FTP servers
  60   It is beeing tested only against UNIX based FTP servers.
  61
  62
  63 Bug-Reports, Contact:
  64 ---------------------
  65
  66 Besides ftpsync.sourceforge.net, ftpsync@ibcl.at is a good target for comments
  67 of any kind.
  68
  69
  70 License:
  71 --------
  72
  73 FTPSync.pl is GNU/GPL software and eMail ware.
  74
  75
  76 FTPSync.pl as GNU/GPL software:
  77 -------------------------------
  78
  79 FTPSync.pl (ftpsync.pl) is free software; you can redistribute it and/or modify
  80 it under the terms of the GNU General Public License as published by
  81 the Free Software Foundation; either version 2 of the License, or
  82 at your option) any later version.
  83
  84 This program is distributed in the hope that it will be useful,
  85 but WITHOUT ANY WARRANTY; without even the implied warranty of
  86 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  87 GNU General Public License for more details.
  88
  89 You should have received a copy of the GNU General Public License
  90 along with this program; if not, write to the Free Software
  91 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  92
  93 See attached file COPYING.
  94
  95
  96 FTPSync.pl as eMail ware:
  97 -------------------------
  98
  99 FTPSync.pl is also eMail-Ware, which means that the initial author
 100 (Christoph Lechleitner) would like to get an eMail (to ftpsync@ibcl.at),
 101 - if anyone uses the script on production level,
 102 - if anyone distributes or advertises it in any way,
 103 - if anyone starts to (try to) improve it.
 104
 105
 106 Updates
 107 -------
 108
 109 The software and updates should be available from
 110 http://ftpsync.sourceforge.net/
 111 http://www.ibcl.at/ossw/FTPSync