home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Crawly Crypt Collection 1
/
crawlyvol1.bin
/
utility
/
disk
/
rename15
/
renameit.doc
< prev
next >
Wrap
Text File
|
1993-11-27
|
26KB
|
464 lines
-- What should have been in the LZH file -------------------------------------
¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
ReadThis.1st This file.
Rc2eNameItc0.PRG Thec2 prc0ogc2ram,c0 version 1.5. c2 c0 c2 c0 c2 c0
Rec2Nac0meIc2t.c0NIC NeoDc2eskc0/Tc2OSc0 2 Icons. c2 c0 c2 c0 c2 c0
c2 c0 c2 c0 c2 c0 c2 c0 c2 c0 c2 c0 c2 c0 c2 c0 c2 c0 c2 c0 c2 c0 c2 c0 c2 c0
The nac2mes arc0e ic2n c0upc2pec0r/c2loc0wc2er cc0ase ic2n c0thec2 LZc0Hc2, bc0uc2t c0wic2llc0 bc2e c0alc2l c0CAPc2S c0when c2yoc0u
unLZH c2thc0e c2fic0le.c2 c0 c2 c0 c2 c0 c2 c0 c2 c0 c2 c0 c2 c0 c2 c0 c2 c0 c2 c0 c2 c0
c2 c0 c2 c0 c2 c0 c2 c0 c2 c0 c2 c0 c2 c0 c2 c0 c2 c0 c2 c0 c2 c0 c2 c0 c2 c0 c2 c0
The ic2consc0 ic2nclc0udc2ed ac0rec2 forc0 boc2tc0h c2TLCc0 c2Soc0fc2twac0rc2e ac0nc2d dmc0j c2softc0wac2re pc0rogc2rac0ms. c2 Yc0ou
can use them with NeoDesk, or with the new desktop in TOS 2 if you have Icon
Juggler or the NewDesk Icon Editor CPX.
-- What this is --------------------------------------------------------------
¨¨¨¨¨¨¨¨¨¨¨¨
This is ReNameIt!, a program that renames files, folders, and volume labels,
using upper case, lower case, and extended characters. It works as a program,
accessory, TTP, or CLI program, on any ST, STe, or TT, with any hard drive, in
any resolution. It also takes advantage of special capabilities of NeoDesk and
TOS 2.
-- Shareware notice ----------------------------------------------------------
¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
This was a collective effort by Tom Hayslett of TLC Software and Damien M.
Jones of dmj software. Many (many!) hours went into the development and
testing of this program and it is intended as a replacement for the original
TLC File Namer and dmj's Label programs. (If you still use one of these, you
must be way out in the boonies somewhere.) If you don't wish to try any of our
other TLC or dmj software (see ad below), just send us $5 for this program and
we'll have a burger on you! You won't know what you're missing, though, as
there are some great bargains available. (Of course, we'll still enjoy the
burger. Hmmm... cheese, lettuce, mayo...) If you haven't registered a dmj
software or TLC Software program, you MUST register this program if you keep
using it!
TLC Software MSgt Tom Hayslett
210 Fairmont Drive
Hampton, VA 23666 804-766-3691
dmj software Damien M. Jones
Route 1, Box 168
Milford, TX 76670 817-582-7373
If you use ReNameIt! regularly (and you've already registered a dmj software or
TLC Software program) we'd still like to hear from you. We always listen to
suggestions, and we like to get a feel for which people use this program.
-- Disclaimer ----------------------------------------------------------------
¨¨¨¨¨¨¨¨¨¨
This program has been tested on a 1040 STf with TOS 1.4, a 1040 STfm with TOS
1.2, a 520 ST with TOS 1.0, a MEGA IV with TOS 2.06 and a MEGA STe IV with TOS
2.05. It has been used on 3.5 and 5.25 inch floppies as well as a hard disk
with a Supra Host Adapter, an ICD disk with an ICD Host Adapter and a Quantum
hard disk in a MEGA STe using Atari's Host Adapter. It has been tested with
hard disks formatted and partitioned with Supra, ICD, and Atari hard disk
software using both regular and BGM partitions, and it has been tested with big
cluster formats (only available on TOS 1.4 or higher). Tom and I use the
program frequently, so you can be sure we'd have fixed any serious problems
that might occur! In spite of all this testing, neither TLC Software nor dmj
software can be held responsible for any damage you may do to your system.
There should be no problems with any ST or TT using this software, but you
should NEVER try a new program (ours or anyone else's) on a hard disk that you
don't have a recent backup of or that has the only copy of one of your
programs. Copy a few files to a blank floppy and play with the names until
you're familiar with using the program.
-- Using the program ---------------------------------------------------------
¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
This is the easy part. The first thing is that ReNameIt! works in any ST
resolution, low, medium, or high; it should work fine in TT resolutions, but
neither of us has access to a TT, so there was no way for us to make sure.
(We're sure someone on one of the online services can verify that it works in
TT resolutions; all of the cheating is in the rename code, *not* the interface
code.) The program /even/ runs in Falcon resolutions--see note below!
There are six ways to run the program. We'll start with the easiest one, and
that's to just double-click on RENAMEIT.PRG. You'll see a small dialog appear
with some icons at the top, "Old Name" & "New Name" fields in the middle, and
"Select", "Change", and "Exit" on the bottom. You want to rename something
(we'll start with the program itself) so click on "Select". This is used to
select which file, folder, or disk you want to rename. For now, just select on
"RENAMEIT.PRG" and click "Okay". You'll see both the "Old Name" and "New Name"
fields change to contain "RENAMEIT.PRG", and the cursor will be at the end of
the "New Name" field. Press the ESC key to clear the field and type
"ReNameIt.PRG". That's the name we want for the program. Now click on
"Change". You'll see an hourglass for a few seconds and then it will change
back to the arrow. That's all! You've just changed the filename. ("Exit",
obviously, exits the program. Don't flub it by mistake because ReNameIt! won't
ask if you really want to exit.)
I suppose you're probably wondering now what those icons are at the top of the
dialog, huh? Well, the disk/folder/file icon brings up info about the program,
like version number, release date, serial number, and, of course, the
programmer ego trip. (We're pretty fond of the programmer ego trip.) It also
reminds you this is a Shareware program. The other icon, the question mark,
gives some brief help (and I do mean brief). The icon in the upper right
corner allows you to drag the dialog anywhere on the screen.
You can enter anything for the new filename. You can type in the regular
characters, as well as lowercase, directly; to enter a funky character, hold
down the ALT key and press a letter, number, or function key. If you know the
ASCII code for a character, hold down the ALT key and type the ASCII code on
the numeric keypad. Then let go of the ALT key. Or, if you don't want to go
searching all over your keyboard, just click the right mouse button. A larger
dialog will appear with all the funky characters the ST has. Just select one.
(Pressing the right mouse button again will abort.) Don't worry about what
characters are allowed... ReNameIt! will not allow you to enter anything that
won't work.
If you want to select a folder, just click on the folder inside the
fileselector and leave the "Filename" blank. To select a volume label, just
select the root directory and make sure the "Filename" is blank. ReNameIt
isn't that picky about renaming things--it'll rename anything, even hidden and
system files (although that's not a good idea!)
Okay, so running RENAMEIT.PRG is just one way to use ReNameIt. You can also
use it as an accessory... just rename the program so its extender is .ACC (i.e.
ReNameIt.ACC), copy it to wherever your accessories are and reboot the
computer. (It also works fine from MultiDesk Deluxe from CodeHead.) When you
select "ReNameIt! 1.5" from the Desk menu, the dialog will appear. From there
use it as above. (See below for some notes about accessory usage.)
You can also use ReNameIt! as a NeoDesk accessory. This works basically the
same as a regular accessory, except that you can place ReNameIt!'s icon on the
NeoDesk desktop and double-click it from there to open up the ReNameIt! dialog.
You can also drag a file to ReNameIt!'s icon and ReNameIt! will fill in the
"Old name" for you. You need NeoDesk 3 to take advantage of this, of course;
consult your NeoDesk manual on installing NeoDesk accessories to get the
details.
You can also run ReNameIt! by dropping a file onto the program icon; as when
used as a NeoDesk accessory, it will fill in the "Old name" for you. You will
need TOS 2 (or higher) or NeoDesk 3 to use this feature.
Then, for those die-hard TTP fans, you can rename the program to ReNameIt.TTP
and run it that way. At the parameter prompt from the Desktop, enter first the
full pathname of the file you want to rename, then a space, then the new name
(without the path) that you want to change it to. The first name isn't case
sensitive--ReNameIt! will find it whether it's in upper case or not. The
second name--the new name--IS case sensitive; type it in EXACTLY as you want it
to appear on the disk. Click "Okay" from the parameter dialog (or press
RETURN) and ReNameIt! will change the name. If the file is in the same
directory as ReNameIt.TTP, you don't have to type in the full path for the
first name. Here's a few examples:
oldname.ext NewName.EXT - renames a file from oldname.ext (or
OLDNAME.EXT), to NewName.EXT. NewName.EXT
is exactly as the new name will appear,
including the lower case letters.
C:\auto\ NewAuto - renames a folder called auto (or AUTO) on
drive C: to NewAuto. You MUST enter the
last backslash ('\') so the ReNameIt! knows
you intend to rename a folder.
C:\auto\oldname.ext New - names a file called oldname.ext in the
auto folder on drive C: to New.
The last way to use ReNameIt! is from a CLI (Command Line Interpreter). The
parameters are the same as for the .TTP method, but you need to specify the
program name or your CLI won't know which programs you're running (obviously).
Here's an example:
>renameit oldname.ext NewName.EXT
|
'-- CLI prompt
If you use ReNameIt! a lot, you'll probably find the keyboard shortcuts
helpful. Pressing ALT-S is the same as clicking the "Select" button; RETURN is
equivalent to "Change". "Undo" exits, ALT-I is info, and HELP is the brief
help.
-- What's the deal? ----------------------------------------------------------
¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
The ST has all the extended characters built into it, there just isn't an easy
way using GEM to include these symbols in filenames. There isn't ANY way using
GEM or TOS to use lower case letters in naming your disks, files, or folders
(that's where we had to lie, cheat, and steal from the OS to make it work).
There are some combinations the ST doesn't like and we have trapped the fatal
ones, the program won't let you use these characters (spaces, backslashes,
etc.).
There are a few more things you should know about, though. GEM and TOS do NOT
like programs with lower case file extenders (i.e. NewName.PRG is fine but GEM
chokes on NewName.Prg--it has no idea that it's supposed to be a program. It
is possible to edit your DESKTOP.INF or NEWDESK.INF to allow it to run program
with the different extenders, *IF* you know what you're doing!) Many other
programs are also picky about extenders in lowercase, so you're probably best
leaving the extenders in all CAPS. When you copy a file or folder containing
lower case letters in the name, GEM will thank you by changing all the letters
back to upper case (sad, but true; let me (dmj) know if you want that fixed).
Extended characters will be retained, though.
Some versions of ARC and LHarc don't like odd characters and lower case
characters in archive names, so test them with one or two files before renaming
a lot of files. (LHarc 2.01 preserves the case inside archive files, though,
as you may have noticed with this LZH!)
NeoDesk 3.02 handles lowercase in filenames as GEM does, but it doesn't treat
upper and lower case as equivalent when matching icons; this means that
READTHIS.1ST will match the READ*.* (question mark) icon, but ReadThis.1st will
not. It can also become confused if you try to copy over a file with a
lowercase name. NeoDesk 3.03 does NOT have this problem--just turn off the
"Check for bad filenames" option in the "More" dialog from the "Preferences"
dialog. Many thanks to Dan Wilga for adding this to NeoDesk!
If you Bob Luneski's Diamond Edge, you should make sure to enable the "Ignore
Illegal Names" in the "Medic" menu. This will stop Diamond Edge's Medic from
treating ReNameIt!-named files from being interpreted as errors. Many thanks
to Bob Luneski for this option!
If you plan to use a disk in a PC I recommend not using ReNameIt! on it.
MS-DOS can behave erratically when provided a weird filename. (Of course,
MS-DOS behaves erratically ANYWAY, right?)
-- Something about using as an accessory? ------------------------------------
¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
GFA BASIC has a few annoying bugs in its compiler. One of those has to do with
reserving memory for accessories. If you use ReNameIt! as an accessory through
something like MultiDesk Deluxe, you should have no problems; if you don't, be
warned that on early TOS machines ReNameIt! consumes an enormous chunk of
memory when run as an accessory (on the order of 200K). It doesn't really need
this space, but with some glitches in GFA BASIC's compiler, there are just four
things to do:
1. Use ReNameIt! as a program; nobody sane uses accessories anyway, right? ;-)
2. Buy MultiDesk Deluxe (an excellent program!) which will allow you to load
and unload ReNameIt!, as an accessory, as you need it.
3. Wait for GFA BASIC 4 to come out so I can recompile the program bug-free.
4. Register the program so I'll be motivated to recode the entire thing in
assembly, effectively bypassing GFA's memory glitches. (HINT, HINT!)
-- Something about using ReNameIt! on a Falcon? -----------------------------
¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
ReNameIt! /does/ work in Falcon resolutions--it looks rather nice in 640x480x16
mode. Having all that extra room on the screen makes an amazing difference.
Due to a "feature" in TOS 4, the Falcon is unable to locate any file with
lowercase letters in its name. Extended characters work just fine. I'm
putting together two work-arounds for this bug (yes, I consider it a bug)--the
first is a program called "SANITIZE", which will scan an entire disk (or
folder) and automatically "fix" its name to conform to MS-DOS standards. This
will make it easy to "sanitize" disks before moving them to the PC (or
Falcon).
The other work-around is to patch TOS 4 to allow it to locate the lowercase
filenames. This would just go in the AUTO folder. I cannot do this until I
get my Falcon (hopefully VERY soon) but I'm definitely going to do it because I
/like/ lowercase names.
Should you encounter a filename on the Falcon that the machine just doesn't
seem to be able to find (or delete) you CAN use ReNameIt! to restore the name
to "proper" form. This is MUCH easier than trying it with a sector editor.
Because ReNameIt! does not use TOS to find files, it does not suffer from the
TOS 4 filename bug.
-- TLC Software --------------------------------------------------------------
¨¨¨¨¨¨¨¨¨¨¨¨
A $20 contribution will get you the latest version of *all* TLC utilities
including:
TLC Book - A combination address book and date keeper. Version 3.0 now prints
phone books as well as address books, mailing labels, date books, and date
labels. It allows as many entries as your systems memory will hold and has
full hot key access. Also new is the ability to merge multiple address books
and you can even print addresses, dates, or labels to disk! Supports any
printer and works in ST & TT resolutions except low.
TLC Attributor - Allows renaming volume labels, files, changing files
attributes (read only, hidden, system, etc). Runs as a program or accessory in
all but low resolution. Allows setting the fast load bit as well as updating
the date/time stamp on files.
TLC Fixer - Allows changing ASCII or HEX strings in programs or data files.
Runs as an accessory or program in all resolutions except low. Will do
multiple searches, ask before changing, keep backups etc. Uses hot keys or
GEM.
TLC Icon Maker - Creates icons in .RSC files from DEGAS medium or high
resolution (.PI2, .PI3) pictures, for use with DRIs RCS2 or Kumas K-Resource.
The TLC Sound Machine - Allows playing and manipulating digitized sounds
created with DigiSound, SoundOff, MasterSound, ST Replay and more. You can
modify the sounds and save them to disk in several formats.
TLC Show - A quick and dirty Spectrum picture viewer for those times you don't
want to load a slide show program and set a series of buttons to display a
picture or two.
TLC RSRC - Creates GFA Basic 3.x compatible ASCII LST files from resources
created with DRIs RCS2 or Kumas K-Resource so you can merge it into your
program and include your resource file in your program. Prints full
instructions in the LST file.
All these programs for one low $20 price.
-- dmj software --------------------------------------------------------------
¨¨¨¨¨¨¨¨¨¨¨¨
View II (coming Real Soon Now) - View pictures, animations, text files,
digitized sound files, and ARC/LZH files, right from the Desktop or NeoDesk!
View any resolution picture in color or mono--fast conversions! Installed on a
hard drive, View II takes ABSOLUTELY NO RAM but is always ready to act. All
viewer programs written in 100% assembly for small size and fast execution.
Compatible with everything (we're still looking for something it won't work
with). Automatically installs itself OR lets you control the installation.
Installs on a hard drive or RAM disk (RAM disk uses 48K RAM or less). Works on
any ST, STe, TT, or Falcon. Commercial, price to be announced.
DMJ GIF - This excellent GIF converter allows you to convert high-quality GIF
images to high-quality Spectrum, DEGAS, or Tiny pictures. It allows you to
convert using either the ST or STe palette (that's right--STe Spectrum
pictures!), and has lots of other options. Shareware, just $15. (Color
monitor required.)
Spc-3375 - A Spectrum picture viewer with some nifty features. It's the only
Spectrum viewer that displays 3,375 of the STe's 4,096 colors on a regular
ST--with virtually NO FLICKER. Spc-3375 will view single pictures or a
slideshow; it will attempt to fix out-of-sync ST's; and it will even slow down
Mega STe's automatically to properly display Spectrum pix! Freeware. (Color
monitor required.)
Sound Lab - Sample editing software at its FASTEST! This program allows you to
edit digitized sound quickly and easily. Features include Play, Listen, Record
(from 4.9KHz to 30.7KHz), O-scope style monitor, Cut, Copy, Insert & Overlay
(from memory or from file), Volume, Fade (four different shapes!), Echo, and
Reverse, plus more. Handles lots of different sample formats, plenty of
options. Complete docs and online help. An early beta version appeared on ST
Format's cover disk--if the BETA VERSION is good enough for them, think what
the full release version must be! Runs in any TT color or ST (color or mono)
resolution. Shareware, just $20.
BoinkSave - A screen saver - it displays a bouncing, spinning ball if you don't
press a key or move the mouse for two minutes. A little more interesting than
a plain black screen--interesting enough to make the cover disks of both Atari
ST User and Atari ST Review. Freeware. (Color monitor required.)
MoireSave - Monochrome users deserve a screen saver too, so here's a good one.
This one draws Moire patterns on the screen after two minutes of inactivity.
MUCH more interesting that inverting the screen! Freeware. (Monochrome
monitor required.)
MHz - Allows Mega STe's to switch between 8MHz and 16MHz with a configurable
hot key. It's EVEN compatible with Spectrum. Freeware. (Color or mono, Mega
STe required.)
Spc Thumb - Create catalog images of your picture collection. Up to 25
pictures can be shrunk to fit in a single color or grey catalog image, with or
without names. Easy to use and BLISTERING QUICK! Shareware, just $10. (Color
monitor required.)
-- Revision History ----------------------------------------------------------
¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
Version 1.5, April 6, 1993:
o If you use ReNameIt! with TOS 1.2, the fileselector no longer comes up with
no search mask. We're not sure when this bug appeared, but it should be
fixed now.
o You can now rename something dragged and dropped onto ReNameIt!'s program
icon properly. A single program line had accidentally been left out (oops).
o We changed internally how the fileselector is called. This allows ReNameIt!
to work properly on the Falcon and also frees up 32K of RAM.
o The mouse pointer now changes to an hourglass, rather than a bee, while the
program is renaming something.
o There are no longer "mouse droppings". Before, they were always covered up;
now they don't appear at all.
Version 1.4, February 24, 1993:
o Tom reworked the dialog routines so that you can drag the dialogs anywhere
on the screen. Each dialog has its own position.
o When using ReNameIt! as an accessory, windows now redraw correctly.
o You can now use ReNameIt! as a NeoDesk accessory.
o You can now drag-and-drop files onto ReNameIt!.
o The dialogs have been slightly altered.
o After renaming something, you can rename it again without having to select
the Select button. This was supposed to be in v1.2, but was not implemented
correctly. It now works properly.
o The program is about 4K bigger. Most of this is the new flydial code.
Version 1.3, December 2, 1992:
o The program would crash if you tried to rename anything on a hard drive
formatted to more than 16M using TOS 1.4 or higher. This has been fixed.
o The program now uses 24K less memory. (These two fixes are related!)
Version 1.2, November 16, 1992:
o The main dialog has been slimmed down to almost nothing, and the icons
were changed. There are no longer separate icons for different resolutions;
this saves on program space.
o The info and help dialogs were added, which contain more info than was
available before.
o The program is now much more intelligent about what it will let you enter
in the "New name" field--it will no longer allow you to enter an illegal
filename in any way. (If you try REALLY HARD, you might outsmart the
program--lots of luck.)
o You can now enter special characters by holding down the ALT key and
pressing letters. If you know the ASCII code, you can hold down the ALT key
and type the ASCII code on the number keypad. (You could do this before if
you had TOS 2.05 or higher, but now it works for all TOS versions.)
o The program no longer asks you if you're SURE you want to change the name.
It just does. I figured it was more annoying to to have the alert appear
than to restore the name if you screwed up.
o After changing a name, the new name is copied to the old name, instead of
clearing both fields. This makes it easier to correct a typo (you won't
have to reselect the name).
o The mouse no longer disappears while a rename is taking place.
o You may have noticed a slight difference in the underline character I used
in this doc file. That's because I found out the one I was using confused
TOS 1.0. I *HATE* when that happens.
o Sorry to make the program bigger, but that's what happens when you make the
interface code more complicated.
Version 1.1, September 16, 1992:
o You can now properly select extended characters in ST and TT low
resolutions.
o If an error occurs while using the program as TTP or CLI program, the error
is displayed as a simple text message, rather than as an alert box. (Using
an alert box in a TTP is a real no-no.)
o The program icon is now highlighted when you select it. Tom also touched
up the icons so they look better.
o I rearranged the extended characters in the dialog so they appear in
ascending ASCII order. This should make it easier to find a particular
character.
o Tom adjusted the program's memory requirements so it works on his Mega STe
as an accessory.
o The program is now slightly smaller (even before packing).
Comments? Questions? We've got an open ear--er, mailbox. Just write!
-- Oh, the life of a programmer ----------------------------------------------
¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨¨
This time around Tom & I nailed down a few bugs. While we were at it we
replaced the GFA FILESELECT command (which uses 32K) with direct GEM calls
(which don't). Not only does this result in a lower memory requirement, but it
also means it works properly on the Falcon--not just in ST compatibility modes,
but also in genuine Falcon resolutions.
I (dmj) have just received the NeoDesk 3.03 update. I must say I'm impressed;
Dan Wilga states in his documentation that disabling "Check for bad filenames"
may slow down disk reading, but I can't tell the difference. I can whole-
heartedly recommend NeoDesk to anyone serious about using their ST; not only is
the program first-rate, but the product support is just as good!
ReNameIt! will be updated again as soon as I get my Falcon and can add the
Falcon patches. What with a few serious projects already heavily in
development, I feel a bit guilty spending time on ReNameIt!... but hey, it's
only taking me a few hours, so I can live with a /little/ guilt.
By the way, does anyone REALLY read this file all the way down here to the
end?