textfiles/apple/DOCUMENTATION/cf22aenh.txt

525 lines
25 KiB
Plaintext
Raw Permalink Normal View History

2021-04-15 11:31:59 -07:00
===============================================================================
= Cat-Fur 2.2a Enhanced =
= =
= Written by: The Screamer =
= =
= Thanks to: The Vulture & Captain Sensible =
= Docs written by: The Messiah =
= =
= Apple Tree //..............305/556-6858 =
= The Midnight Sun...........509/783-1856 =
= Eastern Alliance...........201/327-5725 =
= =
= Released on December 9, 1986 =
===============================================================================
Introduction:
=============
After seeing the new transfer programs that were being developed for the
purpose of improving and replacing Cat-Fur 2.2a, I decided to rewrite Cat-Fur
in order to improve it and maintain compatibility. This new version of Cat-Fur
is 100% compatible with the existing Cat-Fur 2.2a, fixed by The Ubiquitous
Hacker. It also uses 64k Diversi-Dos 4.1C and this must be loaded in order to
use the new version. There is no memory available for any more additions to the
program. At the last count there were about 30 bytes of free memory. This file
will first give an overview of all the new modifications and then go into the
specifics into each of the modifications.
NOTE: This Cat-Fur fully supports the Enhanced //e as well as any other
Apple // computer with 64k. (Even the IIGS in SLOW speed).
::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
Overview:
=========
Terminal mods:
==============
Lightbar/Keyboard/Optional Joystick input
21000 Character buffer
Built in reconfigure menu
Auto-search feature added
Displays current baud rate [103/202]
Maintains online text page while in terminal mode
Unattended mods:
================
Counts number of calls in remote
Control-B/Control-F chat mode
Return to BBS
Online clock with timer
Online Transferring status
Auto-pause text file viewing
+/- or arrows to scan through volumes
Online 12800 character text editor
Chat call
Full DOS support for sysops
Search for file on hard drive
Find free space on hard drive
Loop Routine
Transfer mods:
==============
Counts number of sectors selected
Displays extended file descriptions
::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
Terminal mods:
==============
Lightbar menus:
===============
Lightbar menus can take input by:
---------------------------------
1) Typing the character between the brackets on the menu.
2) Using arrows (either left/right or up/down) to move
lightbar to your choice then pressing Return to choose
option.
3) Using joystick to scroll lightbar to choice then pressing
either joystick button to select option.
In Terminal Mode, not all of the lightbars are displayed
at once, and to get to the other options it is necessary
to scroll off of the top or bottom of the screen, and
the lightbars will scroll as well.
NOTE: The joystick method is optional and can be set in the
reconfigure menu. If you do not have a joystick,
do not worry as it automatically disables itself.
Dialing Options:
================
The dialing delays have been greatly shortened as well
as the wait delay, if you experience any problems as a
result, simply use the ":" as a pause. To "Auto-connect"
to a board, simply Number:A, and it will Auto-Search.
NOTE: To Auto-Search upon loading simply issue a
POKE 836,102 before running it.
Buffer Options:
===============
Specs on the buffer:
--------------------
The 21000 character buffer is located between $900 and $5BA0.
This translates to 84 sectors and the amount of free
characters is displayed in the upper right corner. The buffer
status light (on/off) is kept at the top of the screen. The
buffer can be toggled in one of two ways:
1) Going into the terminal section and toggling the buffer.
2) Toggling it while online by hitting control-B.
If you have an extended 80 column card, the buffer will be
copied into auxiliary memory when you enter the transfer
section and copied back to main memory when you exit the
transfer section.
If you do NOT have an extended 80 column card then you will be
prompted if you haven't saved the buffer yet.
When the buffer gets full you will be prompted in the upper
right corner.
Viewing the buffer:
-------------------
When you choose to view the buffer you will be asked which
slot you want it sent to. This serves three purposes:
1) Send the buffer to the printer slot to have it printed.
2) Send the buffer to your 80 column card to view it in 80
columns.
3) Hit return and view it in 40 columns.
While viewing the buffer you can hit any key to pause the
listing or hit either return or escape to abort the listing.
Saving the buffer:
------------------
To save the buffer simply select the option to save it on the
terminal menu. After saving the buffer, it will automatically
be cleared.
Reading a file into the buffer:
-------------------------------
To read the buffer simply select the option to read it on the
terminal menu. It will read in as much of the text file as
possible. It will also prompt you if there is already
something in the buffer. You can then either clear the buffer
first or append to the buffer.
Clearing the buffer:
--------------------
Simply select this option on the terminal menu where you will
then be prompted if you are sure you want to clear the buffer.
Transmitting the buffer:
------------------------
When you select to transmit the buffer you will be asked to
set the delay after each return. The default is 1 which should
be a sufficient delay. If it is not then simply set it to what
you feel will be. When you transmit the buffer Cat-Fur sends
the current buffer. While it is being sent you can hit any key
to pause or hit either return or escape to stop transmission.
Reconfigure menu:
=================
New reconfigure options:
------------------------
1) Disable sound completely.
2) Sound alarm upon connection.
3) Volume lockout if you selected that you had a hard drive.
4) Optional @ACC files if you feel they are unnecessary.
5) @ACTION file selection [SEE BELOW].
6) Copy buffer to auxiliary memory when entering transfer
section.
7) Amount of transfers allowed per call.
8) Return to BBS from remote.
9) Select amount of time the user has in remote, if you have a
Thunderclock.
Upon Saving the updated Cat-Fur to disk, it will save
under the name of CAT-FUR to the default slot, drive,
and volume. (A$6000,L$5DC2)
NOTE: The Lockout all other slots, and drives is a very useful
feature for users who have only one drive, or for hard drive
users. This feature does not allow the online user to change
the slot or drive in anyway, in this way the user will only
be allowed to access different volumes.
@ACTION file
------------
This file contains the users transferring status which is
stored on the default volume you selected in the reconfigure
menu. It opens and appends to the file. It writes in the
following format:
Uxxx or Dxxx [where "xxx" is the number of sectors of the
file]
Vxxx [where "xxx" is the volume of the file]
Filename of the file which was transferred
Uxxx or Dxxx [same as above]
Vxxx [same as above]
Filename [same as above]
etc...
This should be very useful for boards which keep track of user
transferring status and have to scan every volume to see
whether or not something was uploaded.
NOTE: This option is only active if CF 2.2a Enh. is being
run Remotely (from a board). The @ACTION file will be
written to the slot, drive, and volume of which CF 2.2a
Enh. was run from.
Maintaining text page:
----------------------
As in BME, Cat-Fur 2.2a Enhanced will copy the current text
page in a buffer when you hit control-Q to enter terminal mode
so that when you re-enter term you will be at the same
location that you were in before.
NOTE: When you are off-line (connected but in Terminal mode),
NO incoming characters are displayed or intercepted, so
make sure when you do enter Terminal mode (via ^Q) you should
be at the main menu of a board, or some other place where
it does not change between 103/202.
Exiting from Cat-Fur 2.2a Enhanced:
------------------------------------
Upon exiting from CF 2.2a Enh. (via ESCAPE or ^C or RESET),
DOS is restored as much as possible to as it was before.
To re-enter CF 2.2a Enh. after exiting press & from BASIC,
or ^Y from MONITOR.
:::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
Unattended mods:
================
Enhanced chat mode:
-------------------
Previously in the older versions of Cat-Fur, chat was entered
with a control-Q. With the new Enhanced chat mode, control-B
enters chat and control-F exits chat. There is no longer a
need for the receiving person to enter K)hat mode as there is
now an auto-echo feature which echoes every character to the
receiving end.
Return to BBS option:
---------------------
When a user selects "Return to BBS" from remote Cat-Fur will
then run "@FUR" but, to determine that they are returning to
the BBS a check must be added. PEEK (2046) will yield a 255 if
the user is returning to the BBS. Otherwise it will hold their
level as before. This is optional and can be selected from the
reconfigure menu, and is only active when being run remotely.
NOTE: See @FUR note at end of file.
Online Clock:
-------------
The Vulture's clock feature is now directly installed into
Cat-Fur. This feature is set in reconfigure and is optional.
NOTE: This option is only active if a Thunderclock is present
in any slot from 1-7, CF 2.2a Enh. will automatically find
the clock.
Online Transferring Status:
---------------------------
O)nline transferring status tells the user their current
upload/download ratios along with the total numbers of
transfers this call and transfers remaining (if not
unlimited). There is also a visible counter for the sysops
next to the incoming and outgoing character windows at the top
of the screen. This counts the number of files transferred,
not the total number of transfers.
Auto-pause:
-----------
This feature is used when viewing text files. It will
automatically pause when the screen is filled with characters,
not after every 18 returns. It will work when viewing ANY text
file whether 40, 80, or any other format. This feature is
useful when you wish to read text files online, but it is not
useful when you want to capture it in your buffer, therefore
it can be toggled on or off in remote via "A".
+/- or arrows to log volumes:
-----------------------------
You may now use your arrow keys (left/right or up/down) as
well as +/- keys to move up or down volumes on the hard drive.
NOTE: This option is only active if a hard drive is in use.
Online 12800 character message editor:
--------------------------------------
This is an online message editor. Although it is not a full
scale message editor, it is useful for "About files" as well
as messages to the sysop.
NOTE: All commands that are listed as "^A ^A:Abort.." mean
that Control-A must be pressed twice consecutively in order
to issue that command. It would also be helpful if you
ended every line with a RETURN, as many times it will
repeat your last line that you typed in, that is from
the last RETURN to the end of the message.
Chat Call:
----------
This feature is meant to call the sysops attention when the
online user needs assistance. It sounds a short tone three
times, after that no noise is made. Once selected it shows a
flashing "CHAT!" in the upper right corner. It can be
turned off by the user online as well as by chatting with the
user.
Full DOS support for Sysops:
----------------------------
Sysops can now log volumes or interpret DOS commands from
terminal mode as well as when in transfer mode.
Search for a File on Hard Drive:
--------------------------------
This feature will search the hard drive for a file which you
select by typing the first few letters. It will start the scan
from the lowest lockout volume up to the highest. The
volume(s) that the file was found on (if any) will be
displayed and it will put the user on the last found volume.
NOTE: This option is only active if a hard drive is in use.
Free Sector Scan:
-----------------
This feature will search the hard drive for a selected number
of sectors that the user online chooses. The user will then be
taken to the first volume found with enough room. If there is
no room anywhere on the hard drive the user will be prompted.
NOTE: This option is only active if a hard drive is in use.
Loop routine:
------------
If a key is not hit in unattended after approximately
two minutes, CF 2.2a Enh. will hang up. Two ^G BEEPS are sent
to the other side about 30 seconds before hanging up.
::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
Transfer mods:
==============
Counts number of selected sectors:
----------------------------------
This feature shows the total number of selected sectors
on the bottom right of the text window, after a CATALOG
is sent or received. It keeps an running count of the number
of sectors the transfer will be.
Extended filetypes:
-------------------
Filetypes are now shown as: TXT, INT, APL, BIN, SEQ, REL, AUX,
and LSA. The files sectors are also corrected, in other words
it will now show the correct number of sectors a file is, if
it exceeds the standard 256.
::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
Peeks, Pokes, & Calls:
======================
Pokes for Cat-Fur 2.2a Enhanced Remote:
---------------------------------------
All of the following pokes should be issues AFTER
CF 2.2a Enh. has been BLOADed into memory, and none
of the pokes should be less than 0 or greater than 255.
Set number of chat calls [default=3]: POKE 26097,number
Set starting slot, drive, and volume: POKE 26229,slot :
POKE 26221,drive : POKE 26237,volume
Upload only Cat-Fur 2.2a Enh.: POKE 36757,76 :
POKE 36758,125 : POKE 36759,139
Disable free sector print out in remote: POKE 44164,96
Set minutes allowed in remote: POKE 48423,minutes
Disable sound completely: POKE 48430,0
Set low/high volumes: POKE 48443,low : POKE 48444,high
Set number of transfers: POKE 48445,number
To start CF 2.2a Enh. after it has been BLOADed and
POKEd, issue a: CALL 24576
Peeks AFTER Cat-Fur 2.2a Enhanced has been run:
-----------------------------------------------
PEEK (898) = number of uploaded files
PEEK (899) = number of downloaded files
PEEK (900) = number of uploads total
PEEK (901) = number of downloads total
PEEK (2046) = 255, Returning to BBS
PEEK (2046) <> 255, not returning to BBS, lost carrier
@FUR and other notes:
---------------------
The hello text-file is still CAT.HELLO, and the file run
upon losing carrier, or Returning to the BBS is @FUR.
The only difference with @FUR is that now @FUR must
have a line 1. For example enter this:
1 REM NOW THERE'S A LINE 1!!
And @FUR will then work properly, without a line 1
@FUR will get an ?UNDEF'D STATEMENT ERROR.
MENU program Note:
------------------
Upon the bootup of the Cat-Fur 2.2a Enhanced disk,
the program MENU will BLOAD CF 2.2A ENH. ORIG and
do a checksum on it, if any discrepancies are found,
an appropriate message will be displayed.
NOTE: The checksum is for an unmodified copy, and
should not be done on a Reconfigured copy as the
checksum will be different.
::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
Diversi-Dos 64k Notes:
======================
Boot:
-----
This disk automatically boots into 64k Diversi-Dos without
the use of the DDMOVER file. If you want this DOS on another
disk simply copy the DOS from this disk to another and it
will also automatically boot into 64k DOS. To disable the
auto-boot into 64k DOS press ESCAPE while loading.
Ramdisks:
---------
Do not use the RAMDISK program on the Diversi-Dos disk,
or any other RAMDISK program as CF 2.2a Enh. does not work
with them.
Versions:
---------
This program only works with Diversi-Dos 64k 4.1-C, do
not worry if you do not have this version as it is on the
disk.
Hard Drive Users:
-----------------
In order to get into 64k Diversi-Dos from your hard drive
(this was tested on the Sider, but should work for most
hard drives), boot into DOS 3.3 then BRUN the PATCH file
that is included on this disk. You will now be in 48k
Diversi-Dos, now BRUN the DDMOVER which is also included
on this disk. You will now be in 64k Diversi-Dos. This also
works if you do not have a hard drive.
Lowercase files:
----------------
Diversi-Dos 64k does not support lowercase filenames,
and neither does Cat-Fur 2.2a Enhanced. Even though
lowercase files will be displayed in the Catalog after
it has been transferred, any attempt at Receiving a lowercase
file will yield a Transfer Aborted message.
Patches:
========
^I/Macros and "?" patches:
--------------------------
The ^I/Macros an the "?" wildcard in 64k Diversi-Dos may cause
problems with your board, so it is best to disable them with
the following patches:
Disable ^I/Macros and "?" wildcard: POKE 57006,32 :
POKE 57007,30 : POKE 57008,191 : POKE 63326,234 :
POKE 63327,234 : POKE 63328,234 : POKE 63329,234
Re-enable ^I/Macros and "?" wildcard: POKE 57006,76 :
POKE 57007,7 : POKE 57008,218 : POKE 63326,201 :
POKE 63327,191 : POKE 63328,240 : POKE 63329,11
Catalog pause:
--------------
Disable Catalog pause: POKE 60985,96
Re-enable Catalog pause: POKE 60985,32
NOTE: CF 2.2a Enh. automatically installs the patches, so it
is not necessary to enter these patches before running
Cat-Fur 2.2a Enhanced.
::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
Conclusion:
===========
This Cat-Fur took over a month to complete and is, as far
as we (the testers and the writers) know, it is bug-free. If
any problems arise, or you would just like to comment on the
program then please call Apple Tree // (305/556-6858) and
leave mail to The Screamer, account 3.
Thanks to:
==========
The Ubiquitous Hacker: For "fixing" Cat-Fur 2.2 in the first
place, and starting the trend of using Cat-Fur 2.2a
Enson Parker: For creating the first 64k Cat-Fur.
Mr. Slick: For making the anti-stack crashing routines
which are still in use now.
And to Radar, and all of the other testers. Without the help
of them this Cat-Fur wouldn't be out for another year.
Docs typed by The Messiah
with finishing touches by The Screamer
By the way, Merry Christmas!
::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::