home *** CD-ROM | disk | FTP | other *** search
AppleWorks Document | 1992-01-08 | 22.2 KB | 430 lines | [1A] AppleWorks Word Processing (0x0007) |
- O=====|====|====|====|====|====|====|====|====|====|====|====|====|====|====|===
- Real System Utilities (RSU) V1.40
- Copyright 1989 - 1990 by
- SALware
- 3604 S. 10th St. Ct.
- Blue Springs, MO 64015-6238
- Written in 1989 and 1990 by Steve Luzynski
- All rights reserved.
- Real System Utilities Documentation
- Page
- Table of Contents
- RSU:An overview .......................................... 3
- Instructions>
- Main Menu .......................................... 4>
- Select a Disk ...................................... 4>
- Select a Subdirectory .............................. 5>
- View Disk Tree ..................................... 5>
- Show Catalog ....................................... 5>
- Lock or Unlock Files ............................... 6>
- Delete Files ....................................... 6>
- Create a Subdirectory .............................. 6>
- Rename Files ....................................... 7>
- Copy Files ......................................... 7>
- Format a Disk ...................................... 7>
- Quit to ProDOS ..................................... 8>
- Upcoming Features ....................................... 9>
- Closing Comments ........................................ 9>
- Support Policy .......................................... 10>
- Catalog of Products ..................................... 10>
- RSU Release History ..................................... 11>
- Appendix A - Error Codes ................................ 12>
- Copyright Notice ........................................ 13
- RSU: An overview
- = Real System Utilities, or RSU, is a program that, in my >
- <humble opinion, should replace Apple's System Utilities for 5
- 3all your day-to-day file maintainence needs. It is <
- completely menu-driven and features my "5-key" interface.
- 8 The idea behind my "5-key" interface is: If at any 9
- 7time, there are more than 5 keys that have any sort of >
- <function within the program, things are too complicated. It 8
- 6is easy to get overwhelmed when learning to use a new ?
- =program, and I don't intend for that to happen with RSU. You ?
- =can operate the entire program with one hand on each side of =
- ;the keyboard, left hand for escape and the open-apple key, 8
- 6and your right hand for the arrow keys and return. Of >
- <course, I freely violated that rule when it would have made ?
- =things too complicated. Those two execeptions are the rename >
- <and create a subdirectory functions, where you have to type 3
- in a ProDOS pathname. But more about that later!
- : You don't really have to read this manual to operate <
- :the program; however, I do recommend you print it out and ?
- =keep it with you for quick reference the first few times you <
- :use the program. There is always help available to you at <
- :any time by pressing open apple - ?. Additionally, as you :
- 8will see when you boot the program, near the top of the >
- <screen, in a box ruled off by two lines,is a listing of all =
- ;the keys that operate in that function. But, since I wrote ?
- =the program and so know how it works, my directions at times =
- ;may be a little unclear. Besides, a lot of the program was ;
- 9written in the wee hours of the morning when I might not "
- have been thinking very clearly.
- Above all, have fun! That's what you bought your :
- computer for! (Whether you admit it to yourself or not!)
- Main Menu
- ; The main menu is where you will come to select all of =
- ;the various functions available to you. You can either use >
- <the up and down arrow keys, or the numbers/letters that are 7
- 5directly in front of the function's name to select a :
- 8function. When a function is selected, it will be high- 8
- 6lighted and in all capital letters. When you have the ;
- 9function you want selected, press return. It's just that
- easy!
- 8 A note about not only the main menu, but the whole <
- :program: At any time, you can press the escape key to get >
- <back to the main menu. You can also press open apple
- ? to :
- get help on the function you are in. (Open apple may be :
- called Command on your keyboard. They are the same key.)
- Select a Disk
- = This function should be the first thing you select when >
- <you start up RSU. In fact, nothing else will work until you
- 9 When you start this function, each one of your disk <
- :drives will spin for a moment. Don't worry if it's empty, <
- :RSU will find that out and go on to the next drive. Then, =
- ;you will see a list of the names of all the disks you have <
- :in your system. There will be a little folder in front of ;
- 9each disk's name. There will be an arrow pointing to the
- first one:
- ----> () RSU
- () HARD.DISK
- () GAMES
- ; Use the up and down arrow keys to move the arrow next >
- <to the disk you want to use. Press return when you have the ?
- =disk you want selected. The drive will spin, and you will go
- back to the main menu!
- Select a Subdirectory
- < This function works very much like Select a Disk. Your =
- ;drive will spin briefly and you will see a bunch of little ;
- 9folders with the names of any subdirectories that are on =
- ;your disks next to them. The arrow will be pointing at the <
- :top one. Use the up and down arrow keys to move the arrow :
- 8and press return to 'open' a folder. The folder will be >
- <opened, and you will see all the subdirectories inside that >
- <folder. Go back up the the third sentence in this paragraph
- and start over!
- At some point, you will see the message:
- = You are at the lowest point in this disk. Press TAB to 0
- back out a level or Escape for main menu.
- 8 This means you cannot go any deeper in the current ?
- =chain of directories. If you press TAB, the last name in the 9
- 7list will be pulled off and you can select a different
- directory if you want.
- < Note that the TAB key works any time in this function, =
- ;not just when the 'lowest point' has been reached. You can >
- <peel off all of the directory names but the first one. That ?
- =one is the name of the disk and you have to use the Select a
- Disk function to change that.
- View Disk Tree
- 3 This function just lists all the directories, <
- :subdirectories, and files on the current disk. It's great ;
- 9for those times when you just
- that a file is on a =
- ;disk but you can't remember where exactly. Tree starts its >
- <list from the current directory and works all the way down. :
- 8You can hit Control-S to stop the listing (just like in
- Applesoft).
- Show Catalog
- ; This function shows the names of all the files in the ;
- 9current directory in the same format as Basic. It pauses =
- ;every screenful for you to hit a key. At the end, it shows =
- ;the Blocks used, blocks free, total blocks, and percent of
- the disk used and free.
- Lock or Unlock Files
- 9 This function allows you to lock or unlock selected -
- files. First, a few words on locking files.
- ; When a file is locked, it cannot be renamed, deleted, =
- ;or written to unless it is first unlocked. This allows you =
- ;to protect important files from being carelessly erased or ;
- 9altered. You may realize the benefits of this early some ?
- =morning when, after hours of work, you mistype the name of a :
- 8file after a DELETE command and, instead of losing your :
- 8latest programming masterpiece, you get a "File Locked" '
- error, reminding you of your mistake.
- : When you start this function, you will see a list of =
- ;the first 14 files in the current directory. Use the arrow ?
- =keys to move the selection arrow, and press return to 'mark' >
- <a file. When you mark a file, a check mark will appear next =
- ;to it to show that it will be locked or unlocked. When you ?
- =have checked all the files you want to lock or unlock, press ?
- =space bar. A window will pop up to report on the progress of >
- <your locking/unlocking. When all the files you checked have ;
- 9been locked or unlocked, a screen with the next 14 files >
- <will appear and you can then go through the same process on %
- them, until all the files are done.
- Delete Files
- : This function allows you to permanently remove files :
- 8from your disk. It operates the same way as Lock/Unlock ;
- 9does. In fact, the program is the same for both sections <
- :except for the part that deletes files instead of locking
- them.
- Create a Subdirectory
- ; This function allows you to create a new subdirectory =
- ;on your disk. You will see a pair of lines on your screen. :
- 8Type in the name of the subdirectory you want to create =
- ;between the lines, and press return. The name must conform 3
- to standard ProDOS naming conventions, which are:
- 1) It must contain only letters (A-Z), numbers (0-9),$
- and the period charecter (.).2
- 2) It must be less than 16 characters long.6
- 3) It must not be used elsewhere in the current
- subdirectory.
- = When you press return, the subdirectory will be created ,
- and you will be returned to the main menu.
- Rename Files
- = This function allows you to change the name of any file =
- ;in the current subdirectory. Select files the same way you >
- <did in lock and delete. When you press space, a window will >
- <pop up for each file. It will list the current name and ask <
- :you to type in the new name. Type it in and press return. ?
- =The disk will spin, and the window will pop up again for the ?
- =next file. When all the files are done, you will be returned
- to the main menu.
- Copy Files
- ; This function allows you to copy files. First, before =
- ;you even select this function, you have to select a source =
- ;disk. Do this from the main menu using
- Select a Disk
- and <
- Select a Subdirectory
- . Now you're ready to select
- Copy ?
- =Files
- from the main menu. The source path will be listed on <
- :the screen so you can remember where you're copying files
- from. ?
- = Next, you have to select a destination disk. This works =
- ;the same way
- Select a Disk
- works. Then, you can select a <
- :directory within that disk if you want. If you don't just ;
- 9hit open apple - C. Otherwise, set a path as deep as you
- want and hit open apple - C.;
- 9 Next, the source directory will open up and you can <
- :select the files you want to copy, the same way you do in >
- <Lock and Delete. When you press space, a window will pop up ?
- =and show which file is currently being copied. If you try to ;
- 9copy a file that already exists on the destination disk, ?
- =another window will pop up and ask if it's okay to overwrite <
- :the old file. You can answer Yes or No. If you hit Y, the ?
- =old file will be over-written. Otherwise, it will be skipped >
- over and you can rename one of the files from the main menu.<
- : After all the files you marked have been copied, you $
- will be returned to the main menu.
- Format a Disk
- < This function formats any standard type disk. You must 8
- 6format a new disk before you can use it. You can also :
- 8re-format old disks that are no longer needed. When you 9
- 7select this function, a list of all the available disk <
- :drives will come up on the screen. Use the arrow keys and ?
- =return to pick a drive. After you press return, a dialog box ?
- =will come up asking you what to call the new disk. MAKE SURE =
- ;that before you press return at this question, the disk in ?
- =the drive you picked is not something important. There is NO
- WAY to un-format a disk!
- Format a Disk (continued)
- ; After you press return, the disk will spin for a few <
- :minutes. When it is finished, you will be returned to the >
- <main menu and the disk will be ready for use. PLEASE NOTE - <
- :Currently, the program will have trouble formatting disks <
- :that are mirrored to slot 2. This will only happen if you ?
- =have more than 2 drives on the slot 5 SmartPort. I'll try to ?
- =fix that problem in the next version, for now, however, just >
- <don't format disks in drives that show up in slot 2. (Use a
- different drive!)
- (Thanks to Shawn Quick for the formatter code!)
- Quit to ProDOS
- : This function quits into the current ProDOS selector ?
- =program. This will either be the Apple 'enter prefix of next ?
- =application' very unfriendly program, or another program you :
- 8have in your system, such as Squirt, Bird's Better Bye,
- ProSEL, Davex, etc.
- Upcoming Features
- Currently planned for addition to RSU is:
- 1) Nothing!
- 5 RSU is done! If you noticed the copy whole disk ?
- =function is missing, that's because there's no more room for 9
- 7it in memory. As it is, the
- Copy Files
- function only <
- :copies 9 blocks at a time because there isn't much memory <
- :left. Besides, there are plenty of very capable disk copy <
- :programs around. However, if there is a lot of demand for =
- ;it, I could disable your /RAM disk and use that extra 64K. .
- Let me know if you really want it thrown in.
- Closing Comments
- 8 Real System Utilities was written over a period of 6
- 4several months, using Merlin 8/16 by Glen Bredon. I 7
- 5recommend Merlin to anyone wanting to write assembly 8
- 6language programs of their own. RSU is under constant ;
- 9revision and refinement. But it can only be refined if I <
- :know what needs to be fixed. Don't ever hesitate to offer >
- <comments or criticisms on the program. Just remember not to >
- <just criticize. If you think something could be done better ?
- =or differently, tell me
- it should be done differently. >
- <I don't respond well to people just telling me something is 0
- stupid without telling me why they think that!
- 7 My thanks to: Dave Lyons (author of Davex, a high >
- <quality shareware program selector and utility program) for <
- :all his help at everything; Shawn Quick for the formatter =
- ;code; and everyone else who has contributed one little bit +
- of code or another that I can't think of.
- < Also, thanks to Roger Wagner (publisher of Merlin) for >
- <helping me out a couple of times with 'bugs' in Merlin that &
- turned out to be my own mistakes. :)
- Support Policy
- I can be reached at the following on-line addresses:
- SALware - America Online
- SLUZYNSKI - GEnie
- 72677,2140 - Compuserve
- Or, write me at:
- SALware
- 3604 S. 10th St. Ct."
- Blue Springs, MO 64015-6238
- 8Note that you will get the quickest response on America ?
- =Online. Sorry, but that's just the way it is. America Online
- is my primary support board.
- SALware Catalog of Products
- (As of February 1990:)
- Real System Utilities V1.40
- Graphics Toolkit V1.00
- 3 Graphics Toolkit is a collection of AppleSoft ?
- =compatible programs designed to help you create Hi-res games ;
- 9or other programs using hi-res graphics quickly and very >
- <easily. These programs were used to create Shooting Gallery ?
- =(described below). A copy of Shooting Gallery is included to =
- ;give you a head start on designing your own games, as well ?
- =as demonstrating the power of the Toolkit. Since some of the ?
- =included programs are not the exclusive property of SALware, >
- <Toolkit is available only directly from SALware for the low
- price of $15.
- Shooting Gallery
- ; Shooting Gallery is an AppleSoft Basic game available >
- <on most major networks and bulliten boards. It is freeware. >
- <It has proven to be a favorite on America Online, gathering >
- <over 650 downloads since December 1988. It doesn't have the =
- ;SALware name on it, but it is (of course) the same quality (
- as all of the author's other programs.
- SALware Catalog of Products (continued)
- DHRprint V1.00
- : DHRprint is a simple program for printing out double ;
- 9hires screen images on your ImageWriter II printer. This ?
- =version is freeware as the only working function is printing <
- :DHR images in one size in black & white. Color and varied ;
- 9sizes are planned for future addition. If you can't find <
- :DHRprint on your favorite bulliten board, contact SALware
- for a free copy.
- Make.Boot
- = This is a SALware mini utility. It is a short AppleSoft :
- 8Basic program that alters 5.25" disks to boot your 3.5" ?
- =drive automatically. It is most useful if you have a Disk ][ >
- <or compatible drive in slot 6 and a SmartPort controller in <
- :slot 5. Disks altered with Make.Boot only spin for 1 or 2 ?
- =seconds before they boot the SmartPort drive in slot 5. This 9
- 7one is freeware. It is available anywhere else SALware 7
- 5products can be found, or as a bonus program on your
- DHRprint or RSU disk.
- Sneak Preview!
- 8 SALware currently has a telecommunications program :
- 8under development, tentatively called MegaComm. It will 9
- 7support any Hayes compatible modem. Features include a =
- ;dialing directory, automatic downloads from Compuserve (R) >
- <using CIS Quick B+ protocol, ZModem downloads (supported on =
- ;GEnie and most MS-DOS bulliten boards), and a multitude of 7
- other features standard on most MS-DOS term programs.>
- < MegaComm is an attempt to bring some of the tremendous :
- 8power of MS-DOS communications programs to the Apple II
- world. 7
- 5 Please contact SALware if you have any ideas or -
- features you would like to see in MegaComm.
- RSU Release History
- 7 RSU has gone through several releases. Below is a 8
- listing of all the versions of RSU that were released.
- V1.00 - Preliminary version of RSU. Written in compiled:
- ZBasic. Did not achieve wide distribution due to
- bugs and slowness.
- V1.10B - First true release version. Dropped the view:
- pictures functions from V1.00 and added several7
- new features. Totally re-written in assembly&
- language. Released 6/14/89.
- V1.11 - Minor bug fixes to V1.10B. Fixed problem that5
- caused the Select disk function to crash if6
- Basic.System had not been run on the machine9
- prior to RSU. Also fixed percent display to add;
- up to 100 instead of 99. Written 6/15/89, but not8
- released. Sent out only to registered users as
- their serialed copy.
- V1.12 - Minor bug fixes to V1.11. Fixed percent display6
- again and set up a standard position for the9
- serial number. 6/15/89. Sent only to registered;
- users as their serialed copy. Note that V1.11 was(
- never actually sent to anyone.
- V1.20 - Added the disk formatter function to V1.12. Written=
- 6/27/89. Note that, once again, it was sent only to=
- registered users as their serialed copy and that no0
- one ever actually got a copy of V1.12.
- V1.30 - Added the copy files function. Written 8/13/89.
- V1.40 - Fixed a small bug in the copy files function.7
- Tentatively the final release of RSU. Written
- 2/13/90.
- Appendix A - Error Codes
- ; At different times while using the program, you could ?
- =recieve a ProDOS MLI error. Below is a table of the possible ?
- =error codes and what to do about the situation. If the error =
- ;you get is not in this table, please see if you can repeat =
- ;the error. If you can, write down how to create the error, ?
- =the error code, and the address the error message gives you. =
- ;Then send this information to me and I will see what I can
- do to fix it.
- Error Code
- Meaning
- $27 I/O Error - there was no disk in the drive or)
- it was not a ProDOS disk.7
- $2B Disk Write protected - remove the write
- protect tab.7
- $47 Duplicate File Name - the file name you9
- entered was already used. Use a different#
- name and try again.1
- $48 Disk Full - use a different disk.=
- $49 Directory Full - change to another directory.9
- $52 Not a ProDOS disk - insert a ProDOS disk.
- ; Any other codes should be reported to me to have them
- resolved.
- Copyright Notice
- = WARRANTY AND LIMITATION OF LIABILITY. SALware believes <
- :that Real System Utilities (hereafter referred to as RSU) ?
- =can be a useful tool for some people in some situations, but =
- ;not necessarily for you. The author uses RSU all the time =
- ;and is reasonably sure it won't do anything destructive to >
- <your data. But he DOES keep BACKUP COPIES of all important ;
- 9data, and so should you. SALware AND STEVEN A. LUZYNSKI =
- ;SHALL HAVE NO LIABILITY OR RESPONSIBILITY TO THE PURCHASER ?
- =OR ANY OTHER PERSON OR ENTITY WITH RESPECT TO ANY LIABILITY, <
- :LOSS OR DAMAGE CAUSED OR ALLEGED TO BE CAUSED DIRECTLY OR =
- ;INDIRECTLY BY RSU. THE EXCLUSION OF IMPLIED WARRANTIES IS =
- ;NOT PERMITTED BY SOME STATES. THE ABOVE EXCLUSION MAY NOT :
- 8APPLY TO YOU. THIS WARRANTY PROVIDES YOU WITH SPECIFIC =
- ;LEGAL RIGHTS. THERE MAY BE OTHER RIGHTS THAT YOU MAY HAVE !
- WHICH VARY FROM STATE TO STATE.
- ;The following are registered trademarks of Apple Computer, '
- Inc.: Apple, America Online, ProDOS.
- 9Any other copyrights and/or trademarks are held by their /
- -respective copyright/trademark holders. Said ;
- 9copyright/trademark holders are in no way connected with
- SALware.
- :Any mention of third party products is not an endorsement ?
- =(unless otherwise mentioned in context with said third party 9
- 7product's name), and constitutes only an informational ;
- 9reference to said third party and their product. SALware 7
- 5assumes no responsibility for the selection, use, or
- performance of these products.
- 7 APPLE COMPUTER, INC., MAKES NO WARRANTIES, EITHER ?
- =EXPRESS OR IMPLIED, REGARDING THE ENCLOSED COMPUTER SOFTWARE 6
- 4PACKAGE, ITS MERCHANTABILITY OR ITS FITNESS FOR ANY >
- <PARTICULAR PURPOSE. THE EXCLUSION OF IMPLIED WARRANTIES IS =
- ;NOT PERMITTED BY SOME STATES. THE ABOVE EXCLUSION MAY NOT :
- 8APPLY TO YOU. THIS WARRANTY PROVIDES YOU WITH SPECIFIC =
- ;LEGAL RIGHTS. THERE MAY BE OTHER RIGHTS THAT YOU MAY HAVE !
- WHICH VARY FROM STATE TO STATE.
-