@database 002e4b08-11
@master Ram Disk:DiskFull.guide
@$VER: 1.1
@author "Francesco Gambino"
@(c) "(C)1996 Francesco Gambino"
@remark Created by Francesco Gambino
@node "Main" "DiskFull v1.1 - Program documentation"
DiskFull v1.1
Written by Francesco Gambino
@{"Distribution" link "Distribution" 0} Distribution Conditions
@{"Disclaimer" link "Disclaimer" 0} Disclaimer
@{"System�Req." link "System Req." 0} System Requirements
@{"Description" link "Description" 0} What's DiskFull?
@{"History" link "History" 0} DiskFull History
@{"Installation" link "Installation" 0} How to install DiskFull
@{"Important Note" link "Important Note" 0} Important Note
@{"Options" link "Options" 0} Menu and buttons description
@{"ToolTypes" link "ToolTypes" 0} About the ToolTypes
@{"Technical Info" link "Technical Information" 0} Program limitations
@{"Example" link "Example" 0} An example of DiskFull usage
@{"Future" link "Future" 0} About future versions
@{"Bug Reports" link "Bug Reports" 0} Contact me for bugs
@{"Other Programs" link "Other Programs" 0} List of other progs of mine
@{"Registration" link "Registration" 0} How to register
@{"Good�Bye" link "Good Bye" 0} Some greetings
DiskFull v1.1 (MAILWARE version)
Program by Francesco Gambino (e-mail: MC6144@mclink.it)
All Rights Reserved!
@endnode
@node "Distribution" "Distribution"
Distribution Conditions
=======================
This program is copyright (c) 1996 by Francesco Gambino.
This unregistered version may be freely distributed under the condition
that no profit MUST be gained from its distribution, nor from any other
program distributed in the same package.
All files of this package have to be distributed together and none of
them may be changed in any way except for archiving or crunching.
@endnode
@node "Disclaimer" "Disclaimer"
Disclaimer
==========
This package is provided "as is" without any warranty.
The author assumes no responsibility or liability whatsoever
for any damage or dataloss caused by using this package.
@endnode
@node "History" "History"
History
=======
V1.0 March 1996 First local release
V1.1 March 1996 First Aminet release:
- Fixed copyfile bug
Now COPY and MOVE options copy files
to disks with their comment field!
- Fixed a problem about Disks-list refresh
@endnode
@node "System Req." "System Req."
System Requirements
===================
You need : o A standard Amiga WorkBench system :)
o Kickstart 3.0 or above
(not tested on 2.04)
o Reqtools.library v38 (or better)
o ThinPaz fonts 8 in your system FONTS: directory
o Organiser fonts 8 in your system FONTS: directory
Note: The Installation script copies automatically the needed fonts
in your system.
@endnode
@node "Description" "Description"
Description
===========
DiskFull is a simple utility that transfers selected files from your HD
(or other device) to your disks (device DF0 or DF1). This program
attempts to use total disks capacity. I think that it's the best and easy
method to fill your disks. Remember that you have to create a files-list
first (choose files with a standard reqtools files-requester using
the "Select File(s)" button).
@endnode
@node "Important Note" "Important Note"
Important Note!
===============
DiskFull do not work correctly if you lose the "DiskFull.info" icon with
standard TOOLTYPES! To make it work again you have to install correctly
default ToolTypes in your DiskFull icon (see @{"ToolTypes" link "ToolTypes" 0}).
@endnode
@node "Installation" "Installation"
Installation
============
To Install DiskFull on your HD simply double-click on "Install" icon.
The installation procedure uses the standard "C:Installer" program of
Commodore Amiga.
@endnode
@node "Options" "Options"
DiskFull Options
================
DiskFull opens a standard window (to the centre) on your WB Screen.
Descriptions of avaible buttons:
o ABOUT - About the version of DiskFull
o SELECT FILES - Selects files to put on files-list
WARNING: This option clears the previous file list!
o ADD FILES - Adds files to the current files-list
(Only if file list is just loaded)
o CLEAR LIST - Clears current files-list
o METHODS - Selects the algorithm to use between NORMAL or BEST
o CALCULATING - Starts the calculating operation
o STATISTICS - Shows the Statistics window
(more statistics are available only after calculating)
Note: The "Average Kb per Disk" will be calculated
without the values of last disk in the disks-list
because often the last disks can't be full
for files deficiency.
o SAVE OPTIONS - Sets the save option between COPY or MOVE
(With the MOVE option selected original files will be
deleted after the copy to disks on SAVE TO DISK)
o SAVE TO DISK - Starts saving operation
(*** Works only in the registered version of DiskFull ***)
o DEVICE - Selects device between DF0 or DF1
o CAPACITY - Sets capacity of a single disk (eg. 878 Kb for FFS disks)
o DEFAUL DISK NAME - Sets the default name for disks
(followed by the disk number, see START ID also)
o DISK OPTION - Selects the operation that DiskFull have to do about the
format disks (or not) operations:
"Auto Fast Format" - makes a fast format
"Auto Format" - makes a standard format
"Rename Only" - updates only the disk's names
(use this option only if you
have pre-formatted and
empty disks!)
"None" - Does nothing
o START ID - Selects the start id number to use when rename or
autoformat disks (you can show variations in disks-list)
o FREE - setup the free space of the list's first disk
(usefull when you have to continue a disk-fitting
operation from a disk not completely free)
******** PROJECT Menu' ********
o About - Same as ABOUT button
o Save Defaults - Saves the program settings as TOOLTYPE into the
program icon (Note: To change the default directory
of the reqtools file-requester you have to modify
directly the path of DIR tooltype (see @{"ToolTypes" link "ToolTypes" 0}).
o Quit - Quit DiskFull
******** SPECIALS Menu' ********
o FastFileSystem - If actived use the FFS, OFS if not
(important in "Calculating" and auto-format options)
o Sort Disks - If actived the output disks-list will be sorted
by disk Kb contents.
WARNING: Do not modify this flag setting when you have
just started a saving operation or you think to resume
a saving operation because you risk to save the same
disk twice! Modification of this flag makes a
realtime disks-list refresh and the diskname list
remains unchanged!.
o Show Files - If actived disks-list will show file contents for
any disk.
@endnode
@node "ToolTypes" "ToolTypes"
ToolTypes
=========
DIR=<dirname> - <dirname> is the default directory name
for the reqtools file requester
(default DIR=SYS:)
SAVEOPT=<MOVE or COPY> - Sets the default save option
(default SAVEOPT=COPY)
DEFCAP=<num> - Sets the default disk capacity by <num> (in Kb)
(default DEFCAP=878)
DISKNAME=<diskname> - Sets the default disks names for "autoformat" and
"rename" DISK OPTIONS (default DISKNAME=Disk.)
STARTID=<num> - Sets start number <num> of the rename and format
disks options (default STARTID=1)
FREEKB=<num> - Sets the free kb on last disks used from DiskFull
(delault FREEKB=0)
FILESYS=<FFS or OFS> - Sets the default file system for the "autoformat"
and "Calculating" option (default FILESYS=FFS)
DISKOPT=<0 to 3> - Sets the "Disk Option" (see @{"Options" link "Options" 0})
0 = Auto Fast Format, 1 = Auto Format,
2 = Rename Only, 3 = None
(default DISKOPT=0)
SORTD=<ON or OFF> - Enables or disables sorting of disks-list
(default SORTD=ON)
SHOWFILES=<ON or OFF> - Enables or disables the "show files" function
(default SHOWFILES=OFF)
See @{"Important Note" link "Important Note" 0} for more information!
@endnode
@node "Registration" "Registration"
Registration
============
If you want to register DISKFULL please send your fullname and address
to:
Francesco Gambino, e-mail: MC6144@mclink.it
and I'll send to you your personal serial number as soon as possible!
When you'll receive serial number use "KeyMaker" program (present in
this archive) to create the registration keyfile.
Remember that registered version is ONLY your personal copy! You cannot
copy freely the registered version or send your personal keyfile to
anyone! Respect the laws, please!
Note: The registered users will be updated from a future version of
DiskFull freely!
@endnode
@node "Technical Information" "Technical Information"
Technical Information
=====================
DiskFull supports at least 2500 files per files-list.
If you have to operate longer than this value consider to use the
MOVE option (see @{"Options" link "Options" 0}) then make a new files-list
for all remaining files (the MOVE option delete original files
after the copy to disk!).
Note: Into the UNREGISTERED version of DiskFull you cannot use the
"Save Disk(s)" option (see @{"Registration" link "Registration" 0}).
@endnode
@node "Future" "Future"
Future
======
I think that a future version of DiskFull will have a built-in cataloger
program that will manage automatically files deletion and updating of new
programs' versions into the catalogue with the function to fill disks
(development of this new program depending on number of registered users
of DiskFull because i think that it takes an hard work).
Another possibility is adding other devices (as PC0, DS0, etc...)
but I need to know how these devices work.
New complex algorithm for the "Calculating" purpose (but I think these
are very good!) :)
Adding an option in menu project that append Disks-list to a ASCII file
(to make a simple ASCII catalogue of disks contents with file's comment).
@endnode
@node "Bug Reports" "Bug Reports"
Bug Reports
===========
Please reports bugs to my internet address (MC6144@mclink.it) only after
you have read all program documentation.
This program was tested on A1200 68020 (KS 3.0) with MBX1200 (68882 25Mhz),
HD 80Mb and 4 Mb of FASTRAM.
Please, specify (in your bug-report) your system equipement.
@endnode
@node "Other Programs" "Other Programs"
Other Programs
==============
List of other programs of mine:
- MPeg Audio GUI v1.1 (MpegA_GUI11.lha is SHAREWARE)
It's a GUI for the mpega mp2 (mpeg audio) file player
- AutoRename v1.0 (AutoRen_v10.lha is PD)
A simple utility to rename all files of a directory
- SpAn v1.5 (SpAn_v15.lha is PD)
A pseudo spectrum analyzer of input audio signals (you need an
audio digitizer) that works in background.
All these files are avaible on Aminet.
@endnode
@node "Example" "Example"
A simple example of DiskFull usage
==================================
I use DiskFull often to move files from my "DH1:Aminet" directory (full
of selected Aminet files) to my standard 880 Kb disks. So these are the
operations that I have to do using DiskFull:
1) Launch DiskFull icon from Workbench (double-click DiskFull icon?) :)
2) Push "Select Files" button and select all files of DH1:Aminet with
"ALL" option of the reqtools filerequester (remember that you have
to select the directory "DH1:Aminet" first!)
3) Now the files-list contains all the selected files (names and sizes)
4) Click to the "Calculating" button. After a few seconds (depending
what kind of Method you had select and number of files in the list)
you can see, after two progress indicator windows (Checking and
Calculating), the results in the disks-list.
5) Now you are ready to start the saving option by clicking "Save Disk(s)"
button! Other requester will guide you through saving operation (it's
possible to skip a copy to a disk too).
6) After you have finished the saving operations a window shows "All Done",
so, now, you can quit DiskFull ad re-use it when you want! :-)
@endnode
@node "Good Bye" "Good Bye"
Good Bye
========
I need you enjoy for DiskFull!
Thanks to Sauro, Zeus, Alexander, Daphne, Gino Latino, Necron, Rimmer Dall,
Mr.Black, Bruce Lee, Nightbreed, Asphix, Roby, Parnassius,
Revenger, Captain96, Panzer, Scorpio, Lazarus, Beby Boy, Alex,
Doggy, Stefano (Antani BBS), Moon, Dened, Rayced, Firewolf,
Fizban and all my "humane" friends! ;)
__
/ /
/ /
"Only AMIGA make it possible!" __ / /
"Amiga...back for the future!" \ \ / /
\ \/ /
\/\/
Francesco Gambino (ITALY)
@endnode