
 ____________________________________________________________________________
|                                                                            |
|                               ACCESS!                                      |
|                               ~~~~~~~                                      |
|____________________________________________________________________________|

 Author:  Keith Young
Version:  .18
   Date:  8/22/87
 Status:  BETA
   Size:  68332     (damn, getting up there! :-)
 


Disclaimer!:
~~~~~~~~~~~~
        This Program is in BETA Testing, I assume NO responsibility for 
       any damage whatsoever, caused by the use of it. 
        
        Nuff Said, Now on to bussiness....


Access!: 
~~~~~~~
         A "16 Color Terminal Program" based on D.J.James's "Comm1.34".

         (NOTE: Although I list myself as "author", the "origianal" author
          of "Comm1.34" is D.J.James. This is a Modified Version of that 
          program.


Usage:
~~~~~~  
      from the cli promt:
   
        1> access! [-i] [-s] [phone.file]
       
      where optional "-i"         sets interlace
            optional "-s"         sets interlace AND "Split Screen" 
                                  (see "SPLIT" below under "FAST MENU")
            optional "phone.file" loads the phone file listed.
                                  (default is "comm.phone" and in "Comm1.34"
                                   format.) 

     Examples:                                 Sets:
 
       1> access!                 -> med-res,   full-screen,  comm.phone
       1> access! -i              -> interlace, full-screen,  comm.phone
       1> access! -s              -> interlace, split-screen, comm.phone           
       1> access! phone.file      -> med-res,   full-screen,  phone.file
       1> access! -i phone.file   -> interlace, full-screen,  phone.file 
       1> access! -s myphone.file -> interlace, split-screen, myphone.file
       1> accessories             -> loads some program called "accessories"?   

  (NOTE: also works with "Comm1.34" tpye icon from WBench)(I haven't drawn one 
         yet so rename one of your old ones if you prefer WBench)

History:
~~~~~~~~          

  Ver.18
  ~~~~~~
      Additions:
   
          1) New "Macro Window" added (see Macros: below)
         
          2) Fixed "CHAT" mode (now works on 512K machines, see below)
 
          3) Once again, minor code changes and "window dressing"


  Ver.17  
  ~~~~~~ 
      Additions:

         1) Second "Fast-Menu" (see Fast Menu: below)

         2) TRUE "Split-Screen" mode (see Fast Menu: below)

         3) Minor code optimizing and "window dressing" 

 

  Ver.16     (first "public" BETA release)
  ~~~~~~

        While learning "C" I decided to "Hack-up" someone else's
        (EXCELENT) program....
        This program is essentually "Comm 1.34e", with the changes listed 
        below.

         When I first started modifying it, I had it open up on a three 
        bit-plane screen, giving me 8 colors to play with (and support for
        8 color BBS's). I then proceeded to add custom gadgets and more color
        to the menus ect...ect... 

         Well, I wasn't happy with JUST 8 colors (I'm greedy! :-) so...
        I changed it to 4 bit-planes and 16 colors! (this seems to satisfy
        my needs for now :-).



Additions: 
~~~~~~~~~~ 
    1)   It now supports 16 Colors!
	 ~~~~~~~~~~~~~~~~~~~~~~~~~~
        Access! now opens up on a 4 bit-plane screen, giving
       a total of 16 colors (1 background and 15 foreground).

        Colors 0-7 can be used for Text foreground/background                               
       color combinations. (see "Color Menu" below).
      
        Colors 8-15 are used for various menu/gadget colors.

                    
    2)   "Color" menu item
          ~~~~~~~~~~~~~~~~
         a) "Reset Text Colors"-> Selecting this will reset both the foreground
            and background colors (colors 1,0 respectively).         
             This is usefull if you make a selection on a "Color" BBS in the
            middle of a color change and you get a "bad" color combination.
            (this ever happen to you? :-)
       
         b) "ForeGround Text Color" -> Here you can select the color for text
            in the "receive" window. This color will stay the same until...
            1:You select another color.
            2:A BBS (or other terminal) sends an ansi code that changes it.

           (NOTE: in split screen mode, the TOP (receive) window will use this
                  color,but the BOTTOM (transfer) window will be color #1.)
          
         c) "BackGround Text Color" -> Same as above but for the text 
             background color.
           
           (NOTE: see note above :-) 

         d) "Sample Text Colors" -> This option lets you test your 
            foreground/background color selections to see what works best...

           EXAMPLE: Select a foreground color, go to "Sample Text Colors",
                   select "Background Colors" and your selected foreground
                   color will be displayed on 8 different background colors.
                    Now try the opposite for background. (confused yet?)  

         e) "Modify Palette" -> Yep, you guessed it, this will bring up a 
            color palette for you to set the colors YOU like. (the colors 
            I like are already there). Sorry, NO SAVE/LOAD option yet.
           
             1a) "OKAY"-> Selecting this gadget tells the system that the
                 current/modified (or not modified) colors are the ones
                 you would like to use.
              
             1b) "RESET"-> This gadget brings back the original "system" 
                  colors (the ones I like :-). If you get things all messed
                  up, you can always get back to where you started.

             1c) "CANCEL"-> This gadget tells the system that you changed 
                 your mind and it will return you to the last colors that
                 were "OKAYed". 
               
                 EXAMPLE: If you have modified the colors (and hit OKAY) 
                          and then want the "default/system colors",
                         1. Open the Palette.
                         2. select "RESET"
                         3. select "OKAY" (if you select "CANCEL" instead,
                                           it will return to the last colors)
         IMPORTANT!     
         ~~~~~~~~~~
                ONLY AFTER selecting your colors and CLOSING the palette, open 
               up the file-requester and/or menus and check out the colors. 
                
                Many of the colors are dependent on each other for the 
               gadgets and menus to look "esthitically" pleasing.(in my 
               humble opinion anyway :-) But if you find a combination that 
               works well, write down the numbers for later use. 

             1d) "LOAD"-> N/A  (yet)    
     
             1e) "SAVE"-> N/A  (yet)

  (NOTE Ver.18: the "Color Palette" option is seeming more and more like a
               double-edged sword... It's nice to be able to CHANGE the colors
               but (as you might have already noticed) I keep using different 
               color schemes for different funtions! And so when you think
               you've got some colors you like... BAM!, they don't ALWAYS look
               good on some other menu/window/gadget/text ect... OH Well, such
               is life :-) (that's the REASON for the RESET button)


    3)   FAST MENU
         ~~~~~~~~~
 (NEW Ver.17: There are now 2 Fast menus!, the items on them may move around
              (even from one to the other) but both menus work the same so 
              I'll just list them and you should find them on one menu or
              the other (unless I delete it altogether :-)).

        You might (should) (will) notice a New "FAST MENU BAR" accross the 
       bottom of the screen. Most of these are self explanitory(sp) and are
       just short-cuts to the menu-items. There are a few that need further
       explanation....

       a) "QUIT"  ->  hmmmmmm.....
       b) "INFO"  ->  brings up the "Status Window" (same as <Help> key)
       c) "PRINT" ->  Starts Printer (if you have one hooked up :-)
       d) "CAPT"  ->  Starts Capture (with file name)
       e) "XUP"   ->    "    XModem (or WXModem) send
       f) "XDOWN" ->    "    XModem download
       g) "WXDOWN"->    "   WXModem download  
       h) "CHAT"  ->  Chat Mode (Split Screen mode on Comm1.34)
       i) "COLOR" ->  Brings up the Color Palette
       j) "NEWCLI"->  Starts a NewCli (flip back to WBench to find it)
       k) "MACROS"->  New (Ver.18) Opens "Macro Window" (see below)

       l) " ^ "   ->  (Up Arrow) This gadget will send the "FAST MENU" to the
                      top of the screen (and back again)(NOTE: if your cursor
                      is at the top of the screen when you send the menu bar
                      up there, it will "hide" the cursor. (if for some reason
                      you can't find the cursor, move the fast menu and it will
                      probably be there.) If you select "CHAT" AFTER the menu
                      is at the top, the cursor will move down for you.
               (NOTE Ver.17: this gadget works the same for both "FAST MENUS") 

             //  
       m) "\X/ "  -> (check mark) This gadget will bring the "Status Line"     
                     (which is at the bottom under the "Fast Menu") to the
                     top. If you want info about the last file you downloaded
                     or the last number you dialed, it will show up there.
                     (there is also an "invisable" gadget on the "Status Line" 
                      to let you flip back and fourth)
                      (NOTE: the status line does not move with the fast menu,  
                             it stays at the bottom.)

               (NOTE Ver.17: this gadget is now essentually a "back" gadget,) 
           

       n) "ASEND"  -> Starts ASCII "Send" mode (same as normal menu selection).     
       o) "HANGUP" -> Sends out "hang-up" string to modem. 
       p) "DIAL"   -> N/A (this version)
       q) "REDIAL" -> N/A (actually "dumb" redial for now, sends "A/" to modem
                           which will perform last command string sent to it
                           which might have been "hang-up" :-)
       r) "FONT"   -> N/A (this version)
       s) "SERIAL" -> N/A (this version)
       t) "ABOUT"  -> short text about "Access!"
       u) "CLOCK"  -> N/A (this version)(somebody got a small clock routine?)                     
       
       v) "SPLIT"  -> NEW Ver.17

                      I saved this one for last so I can explain it in a little
                      more detail(and 'cause I think it's the best thing I've 
                      done so far! :-).
                      
                       Selecting "SPLIT" (currently not a normal menu item)
                      will give you a TRUE split screen!, which means no more 
                      swapping back and forth to the WorkBench screen to see
                      how your "unarcing" is coming along (know of a good,
                      small "DirUtil"? like one that takes up half of a
                      screen... ? )( hint, hint ).
  
                       What it actually does is shrink the term down to normal, 
                      non-interlaced size (640*200) and moves the screen 
                      half-way down. Thus giving you a 23 line (interlaced)
                      terminal on the bottom of the screen w/out losing any of
                      the normal terminal display area ( of course you dont 
                      get as many lines as a "full/sized/interlace/display"
                      but you can swap back and forth as you like!)
                   
                       Seleting "SPLIT" again returns you to a Full/Sized/
                      Interlace screen again (it's a toggle switch).
                       
                      (NOTE: this option works very well when used with the 
                             "NEWCLI" option above or with a "half-screen
                              DirUtil" if there's one around or better yet,
                              with WBench set to interlace also.(although I
                              haven't taken the time to try it.))   

              (ANOTHER NOTE: this option can be selected at start-up by using
                             the "-s" (or "-S") as a command-line argument.
                             ( example: at the prompt, 1> Access! -s ) 

             (ONE MORE NOTE: this option is currently only supported in 
                             "interlace" mode. 
                            1> Access! -i (sets interlace on)
                            or
                            1> Access! -s (which also sets interlace on)

       (NOTE Ver.18: the cursor now moves down one if one of the "Fast-Menus"
                     is at the top when you select "SPLIT")(as it should!)


    4)   Macro Window 
         ~~~~~~~~~~~~
(New Ver.18)  Selecting this option (from the "Fast-Menu") now opens up a
             "Macro Window" that will let you see/edit/load/save all currently
             defined macro keys (F1-F10,<shift>F1-F10).

     usage:   When the window opens, you will see 10 funtion key definitions.
             Hit the "arrow" gadget to toggle between shifted/non-shifted keys.

              To edit one, simply point to it and "click". It will then move
             down to the editing line where you can make your changes. When
             your through, be sure to hit <return> before moving on or your
             changes will be lost! 

              The new definitions will be in effect until you either quit the
             program, change them again, load in new ones, or (heaven forbid)
             crash. Select "Save" to save them to disk for future use.

              BTW, if for some reason while you're editing you hit the
             "switch" gadget (arrow) and THEN hit <return> your changes will
             go onto the current page at the same location.(might be useful
             for "copying" from F1->S1 ect.. but not much else :-)
                
         a) "OKAY"  -> when your done editing/loading/saving ect.. this will
                       close the window.
 
         b) "SAVE"  -> brings up the "Input" window and saves macros to the
                       name you supply. (access! currently looks for 
                       "comm.keys" at startup, unless you specify otherwise
                       on the comand line or in the Icon from WBench.)
 
         c) "LOAD"  -> opposite of "SAVE" (above)

         d) "CANCEL"-> currently acts the same as "OKAY" above (selcting this
                       gadget COULD be used for "undoing" any current changes,
                       but this would take a little more "overhead" and I left
                       that option out for now...)

         e) " ^ "   -> (arrow) click on this to toggle between "shifted" and
                       "non-shifted" funtion key definitions.

    (NOTE: the menu options regarding "keymacros" still operate as they used 
           to, these option will be taken out of future versions to cut down
           program size.)     

      
Other:
~~~~~~
    1) Now checks for ".ZOO / .zoo" extension and for disabling auto-chop.    
    
    2) Routine added to "Confirm()" downloaded file, displayed in "Status-Line"
      (size may be off by a byte or so but if it shows "0" bytes, then you 
       know you didn't get the file :-) 
    
    3) File-Requester now supports up to six devices.(currently DF0:,DF1:,DF2:
      DH0:,RAM:,VD0: but future versions will "Dynamically" set up for devices
      you actually have mounted) (I'm still learning :-)  

    4) Various graphic/gadget enhancements. (let me know what you think) 


(Ver.18)
 ~~~~~~
    5) Older versions (even the original "Comm1.34") had problams with eating
       too much memory when going into "CHAT" mode (split-screen on Comm1.34).
       Thus, if you only had 512K, chances were that you could not use this
       feature. I've re-writen that routine and it should now be possible to
       use this option (even in interlace) with a 512K machine. If you STILL
       have problems with this option (or other windows not opening) try 
       shrinking down any windows you have open in the background (yes, even
       "empty" CLI windows eat up mem.) 


Deletions:
~~~~~~~~~~
    Yes, I'm guilty.... I took out the "Veiw Window" and the "Debug Functions"
  I never used them and I'm trying to keep the file size down. 

 
Known Bugs:
~~~~~~~~~~~
     I don't know of any "REAL" bugs, but the error checking is not what it
    should be.
  
     For example you CAN open every window/requester at the same time...
    This is NOT good and SHOULD be AVOIDED! (or you might see a number to 
    meditate over :-)(although if you close them back down in the right order,
    it should be OK, as long as you don't fiddle with a bunch of gadgets while
    they're open)

 (Ver.18)
  ~~~~~~
      still haven't added any more error checking....that's kinda' like doing
     the dishes after eating a good meal... (I'll get around to it...)
     

That's It For Now:
~~~~~~~~~~~~~~~~~~

  Besides these changes, it's good ole 100% "Comm 1.34" under the hood, so
 refer to your "Comm134e.docs" for info on the other features of this fine 
 term.

  Like I Said to start with, I'm working on this as an exorcise in "C".
 I was/am inspired by what David Salas has done (is doing) with "AMICTB" 
 terminal program.(FANTASTIC, Dave. Keep up the good work! and THANKS for 
 answering some DUMB questions:-)

  This is not meant to COPY what anyone else is doing, it's
 just what I'D like to see in a term. (of course I'd LIKE to see a lot more,
 but I'm still working on it).

 Please send all BUG REPORTS, KUDO'S, HELP, SUGGESTIONS, INSULTS (grin) to...

 AMIC:   Keith Young
GENIE:   K. Young

( or anywhere else you see my name listed )
 
Snail Mail:   K. Young 
            RT. 2  BOX 13G
            MONETA, VA.
                   24121


___________I CODE TO BE FRUSTRATED, DON'T WE ALL? AND ISN'T IT FUN?___________
