@database MTM
@master MTM.guide
@$VER: 1.0
@font thin711.font 11
@width 76

@node "Main" "Move To Mirror 2.0"
@next "COPYRIGHTS"
@prev "AUTHOR"
 ===========================================================================

                    M O V E   T O   M I R R O R   2 . 0


                         by Kenneth "Kenny" Nilsen

                   Copyright (C) 1997 by Digital Surface

===========================================================================



     @{"  Copyright                      " link "COPYRIGHTS" 0}          Important notes


     @{"  Introduction                   " link "INTRO" 0}          What this program do


     @{"  Requirements and installation  " link "REQINSTALL" 0}          Nice stuff


     @{"  Usage                          " link "USAGE" 0}          How to use this program


     @{"  Author                         " link "AUTHOR" 0}          Address and notes



===========================================================================
@endnode

@node "COPYRIGHTS" "Copyrights"
@next "INTRO"
@prev "Main"
===========================================================================
                                 COPYRIGHT
===========================================================================


This program is FREEWARE. That means you can distribute this archive freely
as long there is no fee taken other than a nominal fee for media usage.

It is not legal to reverse engineer this program, neither to distribute the
files seperatly without prior written permission from author.


===========================================================================
@endnode

@node "INTRO" "Introduction"
@next "REQINSTALL"
@prev "COPYRIGHTS"
===========================================================================
                                INTRODUCTION
===========================================================================


This little program will organize your local AmiNet mirror on your HD. Most
times after downloading files from AmiNet all the files are in the same
directory. This is very messy if there are lots of files.

This program scans the messy directory, creates subdirs in the destination
dir you want the mirror based on the Type field in the readme file. It can
even do pattern matching of the files and use the short field of the
readme file as a filenote (see @{"usage" link "USAGE" 0} for more information).

It then copies the files optionally with the readme file to the new
location. For example:

In your download dir you have the following files:

Download:

   A1200FDfix.lha 
   A1200FDfix.readme 
   DBackup232_MUI.lha 
   DBackup232_MUI.readme 
   Galaxy_2.lha 
   Galaxy_2.readme 
   Kick1000.lha 
   Kick1000.readme 
   PllbC2pV1.lha 
   PllbC2pV1.readme 


After running MoveToMirror you could have this as result:

Download:Aminet/
hard/
   hack/
A1200FDfix.lha        : Make new A1200 compatible to old ones
A1200FDfix.readme
Kick1000.lha          : A1000 with 2.0 EPROM/ROM !
Kick1000.readme

dev/
   asm/
PllbC2pV1.lha         : Pllb-Chunky to Planar Sources PllbC2pV1.readme

pix/
   anim/
Galaxy_2.lha          : Red and Blue 3D Galaxy animation 2
Galaxy_2.readme


As you can see the download directory will be much more organized this way
and you can have an exact copy of the Aminet.

Check out the many options with this program. If you want one that doesn't
exist drop @{"me" link "AUTHOR" 0} a note!

===========================================================================
@endnode

@node "REQINSTALL" "Requirements and installation"
@next "USAGE"
@prev "INTRO"
===========================================================================
                       REQUIREMENTS AND INSTALLATION
===========================================================================

Requires:     kickstart 2.0. Any MC68K will do.
Recommented:  harddisk


Installation:

Copy MoveToMirror to C: or any other place you want. You can rename the
file to MTM or something else if you want to of course.

Copy the guide file if needed.


===========================================================================
@endnode

@node "USAGE" "Usage"
@next "AUTHOR"
@prev "REQINSTALL"
===========================================================================
                                   USAGE
===========================================================================


In this chapter we will go through all the options. First a short overview:


 USAGE:  MTM <srcdir> <destdir> [options]

         -a = overwrite existing files
         -c = clone file attributes
         -d = delete original (move)
         -n = don't use 'short:' as filecomment
         -p = use pattern matching
         -r = don't copy *.readme files
         -v = verbose


NOTE: You will need the readme files of an archive/file to use this
      program!


srcdir
------

Source  directory  is  where  you  have  all  the files you downloaded from
Aminet.


destdir
-------

Destination  directory  is  the directory where you want to have the Aminet
dir  three built.  For example:  download:aminet/ this will be the root for
the three like for example:  download:aminet/hard/hack/ will be the dir for
files  belonging here based on the Type:  field in the readme file.  If the
type  field  doesn't  exist  MoveToMirror  can't handle the file.   You can
manually insert the type field or move it yourself.


-a
--

When  this  option  is used MTM will not ask you if you want to overwrite a
file  if  the file already exists in the destination dir three.


-c
--

When  this  option  is  used  MTM  will clone the date, protection bits and
filecomment  of  the  original  file  in your source directory.  NOTE:  the
original  file  comment  will  only  be  copied  if  the option -n is used.
Otherwise  the Short:  field of the readme file will be used as filecomment
and the orignal commnent is copied to the readme file instead.


-d
--

When  this  option is used the original file(s) will be deleted if they are
succesfully  copied  to  destination dir three.  NOTE:  if option -r (don't
copy readme files) is used the original readme files will not be deleted.


-n
--

Use  this  option  if  you  don't want the Short:  field of the readme file
cloned.   Use  the -c (clone) option to copy the filecomment of the file(s)
in  source  directory.   When  -n option is not used the original (if -c is
used) filecomment will be copied to the readme file.


-p
--

This  option  will allow pattern macthing of the files in source directory.
Normal usage when this option isn't used, is just the dirname of the sourec
dir.   When  -p is set you must suply an additional pattern to srcdir.  For
example:  "MoveToMirror Download:*.jpg Download:Aminet/" will only copy the
files ending with *.jpg.  Using *.readme will have no effect.


-r
--

When  this  option  is  used  the readme files in the sourcedir will not be
copied  to  destination  dir three.  If option -d (delete original) is also
used the readme files will not be deleted from source dir.


-v
--

When  this  option  is on you are in verbose mode.  That means you will get
output  on  every  important  action  in  the  console done by the program.
Useful  for "debugging" if you find files that doesn't copy correctly or if
you  will  send  a bug report to @{"author" link "AUTHOR" 0}.  All major errors will be reported
independent on this option


Do you need more options ? @{"Contact author" link "AUTHOR" 0}

===========================================================================
@endnode

@node "AUTHOR" "Author"
@next "Main"
@prev "USAGE"
===========================================================================
                                  AUTHOR
===========================================================================

MoveToMirror (MTM) is made by:

Kenneth "Kenny" Nilsen

Email: kenny@bgnett.no
  URL: http://www.bgnett.no/~kenny/


Contact me for comments, suggestions, bugreports and wishes.

Keep  the Amiga alive!  Help Amiga program authors keep on developing.  You
can do that simply by sending a short email with regards or comments.


===========================================================================
@endnode
