DarkTerm V4.0 - By Alan Peters ------------------------------ (C) 1986 DarkStar Systems Software NOTE: This program is in the public domain, and may be given away, but may NOT be sold, nor may the main code be altered in any way. DarkTerm 4.0 is yet another enhancement of the previous version, 3.0. This new version is more compact, and offers some new features: - Xmodem Sum and Xmodem CRC protocols, with automatic padding removal, and CIS .IMG removal. - Multi-Page phone directory with multi-number sequence dialing. - New editor link file, for sequential text editing. - Modem Modules, files that contain all the basic modem communications routines, so that compatibility may be offered to the benefit of the user. - Accurate 1200/2400 baud rates, with a 200-600 baud range as well. - Increased buffer capacity (32k). This version was designed to go along with the DarkStar System 3 BBS programs, 2 very powerful, all ml BBS's that run in FULL color, or ASCII. If you want more info on these great programs, see the end of the docs. Loading The Program ------------------- V4.0 will load off any type of drive and off any device number, as long as the drive number is "0", not "1". Type LOAD"DARKTERM 4.0",device #,1 to load this program. After loading, the program will be set up according to DT4.SETUP file. If that file does not exist, or it does exist in it's original format, then the term will operate on the default settings that these docs are based on. The program has 2 modes of operation. The first status indicator at the bottom right will be either inversed, or normal. If it is inversed, you will be in command mode, where all commands that use the Commodore (C=) key will be functional, as will be the function keys. Otherwise, all commands and function keys are inoperative. Use SHIFT/RETURN to toggle between command mode, and normal mode. To do anything on the terminal, you will usually have to be in command mode. That same indicator will be either an A or a C indicating ASCII or COLOR terminal modes. SHIFT RUN/STOP will toggle between color and ASCII. Color mode is the same as it always was with previous DarkTerms, but it never hurts to refresh memories, so: C= 1-8 and CTRL 1-8 will change the cursor color. F1 and a color key (ie., F1, then CTRL-1) will set the border color. F3 and a color key will set the background color. F5 and a color key will set the foreground color. CTRL-I enables the UPPER-CASE/GRAPHICS character set at $E000 (57344). CTRL-H enables the UPPER & LOWER CASE character set at $E800 (59392). CTRL-G is the bell tone. Cursor Up, Down, Left, Right, Clear, Home, RVS On/Off all operate like the normal 64 screen editor. RETURN will remove all characters on that line after the point of return. INSERT will insert only on the current line; the same goes for delete. The ASCII mode may not appear to be ASCII when you are in half duplex, and you try typing. But it is, despite the fact that you can cursor around. NOTE: You can NOT send screen colors with F1/F3/F5 when you are in command mode, or you will send a function key string. Status Indicators ----------------- 00:00a 00:00:00 32768 01-01 A:B:H:I:U:W 1 2 3 4 5 6 7 8 9 0 1: Clock. Standard Am/Pm clock. 2: General purpose timer. This timer will be cleared whenever a carrier is detected from auto dial or auto answer. 3: Buffer Bytes Free. This is 32768 bytes when there is no phone directory in memory. This will count down to zero, and stop if it gets there. 4: Cursor row/column position. This is for the benefit of color mode, when one wishes to screen map when writing messages on the CBBS, or use hidden cursor movement. 5: ASCII/Color and Command Mode status. As explained above. 6: Buffer open/close. Use C= O to open and close the buffer. The buffer is open when the status flag is inversed. 7: Hide Screen Output. Use C= H to toggle. When inversed, all output to the screen is suppressed. However, if the buffer is open, data will still be sent to the buffer. This is useful for buffering data that you don't want visible on the screen. 8: Modem Input/Output Inhibit. Use C= I to toggle. When inversed, all input and output with the modem will be put on hold, while the carrier will remain in it's current state. 9: Upper Case Lock. Use C= U to toggle. All letters from A-Z will be in CAPS when this flag is inversed. 0: Word Wrap. If you are logged onto a system that runs at 80, 132, 160, or some other screen column format more than 40, then use C= W to enable wordwrap, and no words will be broken up on the right side of the screen. There are several other commands available, and each will be described in detail. When in a sub-menu of any command, use the RETURN key to get back to terminal mode, and if that doesn't work, use the STOP key to return. Auto Dial / Auto Answer (C= A) ------------------------------ Both auto dial and answer work according to the routines in the modem module file. See the notes at the end for how to create a modem module. Auto dialing here will only dial one number at a time, and will redial that number until a carrier is detected, or the STOP key is hit to abort dialing. A . string of 18 digits is acceptable for input. In the 1650 version, only numbers are dialed, and all other characters are skipped. Auto answer will answer at the current baud rate until a carrier is detected, or the STOP key is used abort. If you want multiple autodialing, use C= P and the phone directory. Buffer Options (C= B) --------------------- <A> Append Buffer To File. <C> Clear Buffer. <E> Edit Buffer (See Below). <L> Load File Into Buffer. <M> Merge (Add) File To Current Buffer Contents. <P> Print Buffer. (ASCII Or Normal). <R> Review Buffer (See Below). <S> Save Buffer. <T> Transmit Buffer. B:00000 - Buffer Byte Count. Transmitting buffer contents will operate according to the transmit delay factor set in modem options (see C= M). When you turn on transmit buffer, you will be returned to color/ascii terminal mode, and the buffer will begin to send. You will most likely need a delay factor when sending, or the data may be garbled when sending pre-written messages to a BBS. The CBBS-3 can usually accept text with an xmit delay of 50 or less. Once the buffer xmits, you can use any command mode keys, since the buffer transmit is running in the background. Use SPACE to pause buffer send, and STOP to abort. You may not send a buffer IF: you are sending a function key, or, you have the buffer already open to accept data. Editing a buffer operates in the same manner as writing a message with CBBS-3. You will be placed in the editor, and anything you type will be buffered. You may write color messages, using screen colors, etc., as described above, or anything else. When you are writing text, the message "Buffer Edit On..." will be displayed. To exit buffer edit, use the STOP key. If you want to delete the current character from the buffer, then use CTRL-D, NOT delete, as delete will be buffered. When you are in the editor, you may not be at the end of the text data that it contains. Ie., if you write some text, exit, then select edit again, you will be at position 0, where the text may be at position 1234, the end of the data. Thus, entering any data now will in effect overwrite anything currently at that position. Using CTRL-D Now will erase the byte at position 0, and shift the entire buffer after that, from 1-1234, one position down, until the entire buffer has been justified. I will not explain what happens; you will have to try it yourself. Also, CTRL-X may also exit like STOP, BUT this has the effect of TRUNCATING the remainder of the buffer data, from the current position onwards. When you are in review mode <R>, you will be able to read the buffe...
Amiga7878