ARUD CONVERTER V2.2

 CREDITS
	- Coding : Morten Amundsen
	- Idea   : Jan Erik Arud

 NOTE
	Arud Converter v2.2 requires AmigaOS V39+ and reqtools.library.


 ADDRESS
	Morten Amundsen
	Rute 20/14, Hjukebø
	3670 NOTODDEN
	NORWAY

	TEL: 35 95 74 57

 HISTORY
	In the fall of 1993, Jan Erik Arud of Notodden, Norway, asked
	me to make a program for him that could rename files.
	All of the files had the same "basename", and all of them had
	a number attached to it. He needed this program for renaming
	animations, and since there was a lot of files, doing this
	manually was a time consuming task.
	The first version was finished merly days after he asked me,
	but he was not completly satisfied with it, so I scraped it
	and did some adjustments.

	After releasing a few versions in 1993, I decided to make
	an update now (Oct. 1995). This time font-sensitive and
	a more fool-proof program.
	It is now also possible to force the program to look for
	files with a user pre-defined basename.

	As of version 2.2, the user can specify if the files are to
	be renamed, copied or copied to a specified directory.	

 USAGE
	First of all select a path by clicking the "Path"
	gadget, or typing it in manually.

	Let's say we have a drawer called "Animation". There are 10
	files in this drawer called:

	NOTE! If you have a drawer with lots of files with different
	      basenames, it it possible to pre-define the basename in
	      the "Base" gadget, and then set the "First/Force" gadget to
	      Force. If you select a path now, the program will only
	      look for files with this basename.

	Anim1
	Anim10
	Anim2
	Anim3
	Anim4
	Anim5
	Anim6
	Anim7
	Anim8
	Anim9

	After selecting the path the result could look like this:

	Basename:		Anim
	Places needed:		2
	Files:			10
	Range:			1-10

	- Basename
		This is the "name" part of the file, which is
		similar for all the files. (Anim)

	- Places needed
		This is how many places the biggest number requires.
		In our example it is 2, because 10 needs 2 places.
		If there were 1000 files it would require 4 places.
		As of V2.2, the field now also shows the max number
		of places used in the current number sequence.

	- Files
		Number of files in the directory. (10)

	- Range
		Smallest filenumber upto biggest filenumber

 GADGETS
	
	- Base
		This gadget let's you change the filename base of the
		files in the selected drawer.
		Example: "Arud"

	- First/Force
		In the "First" position, the program will use the first
		files of the right composition it can find in the chosen
		directory.
		In the "Force" position, it will only look for files with
		the chosen basename.
		PS! The program will refuse to go into "Force-mode" if
		    the Basename is empty.

	- Places
		Tells the program how many places (of numbers) to
		use in the numbers field.
		This number must be able to fill: StartValue+NoOfFiles
		Example: "5"

	- Start Value
		Any positive integer of which the numbers should start
		renaming from.
		Example: "500"

	- No Leading Zeros/Leading Zeros
		This cycle gadget lets you select if you want to
		remove unfilled places if "Places" is bigger
		than the required number of places needed to fill
		"Start Value" + "Files".

	- Same Order/Reverse Order
		By using this gadget you are able to reverse the order
		of renaming, so that the lowest numbered file now becomes
		the highest. (...and the highest, the lowest.)

	- Rename/Copy/Copy To
		This gadget gives the user the option of either renaming
		all the files or copy the files to their new names,
		leaving the old files be with their original names.
		In the "Copy To" position a file requester will pop
		up, so that you can choose a destination directory.

	- Convert
		Start the renaming process (error checking is done here).

	- Quit
		Exit the program.


 EXAMPLE
	If we use the numbers given in the examples in the GADGETS section
	it would turn out like this:

	- Leading Zeros ON

		Arud00500
		Arud00501
		Arud00502
		Arud00503
		Arud00504
		Arud00505
		Arud00506
		Arud00507
		Arud00508
		Arud00509

	- Leading OFF

		Arud500
		Arud501
		Arud502
		Arud503
		Arud504
		Arud505
		Arud506
		Arud507
		Arud508
		Arud509

	If the Rename/Copy gadget has been set to "Copy", there would
	be two set of files.

	- Leading ON

		Anim1
		Anim10
		Anim2
		Anim3
		Anim4
		Anim5
		Anim6
		Anim7
		Anim8
		Anim9
		Arud00500
		Arud00501
		Arud00502
		Arud00503
		Arud00504
		Arud00505
		Arud00506
		Arud00507
		Arud00508
		Arud00509

	- Leading OFF

		Anim1
		Anim10
		Anim2
		Anim3
		Anim4
		Anim5
		Anim6
		Anim7
		Anim8
		Anim9
		Arud500
		Arud501
		Arud502
		Arud503
		Arud504
		Arud505
		Arud506
		Arud507
		Arud508
		Arud509

 COPYRIGHTS
	- Arud Converter V2.2 is a postcard-ware program
	- reqtools.library is copyright (C) Nico François