home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / mac / util / comm / multi.sit / docs.text next >
Encoding:
Text File  |  1990-05-03  |  6.1 KB  |  137 lines
  1. psuedo-documentation whipped up so people arent completely baffled by the program.
  2.  
  3. Multi-station-320 0.92b
  4. 5/3/90
  5. by Christopher Lloyd
  6. Copyright 1990, Christopher Lloyd
  7. Portions Copyright 1989, THINK Technology
  8.  
  9.  
  10. This program is not to be distributed in an altered form.  The 
  11. program is not in the public domain. You may not sell or make 
  12. money off of it it any way shape or form, or I will hunt you down 
  13. and do nasty things to you.
  14.  
  15. I am in no way libel for any damage, harm or any sort of headaches  
  16. generated from this program.  
  17.  
  18. All code is my creation except for the Mac toolbox interface and the 
  19. function key palette window definition, which is part of the THINK C 
  20. package.
  21.  
  22. If feel compelled to send me money, go ahead!
  23.  
  24. Ok, on with the info.
  25.  
  26. First order of business.  This is a 7 & 8 bit terminal emulator, so you 
  27. must be careful if you are using 7 bit communications, The Vax 
  28. systems I have used with this assume that if you are a vt320 you are 
  29. on a 8 bit line, be sure to inform the operating system that you are 
  30. running in 7-bit mode. on a Vax system: set term/noeight
  31.  
  32. What is this? This is a vt320 emulator with multi-session capabilities 
  33. and resizeable terminal windows.
  34.  
  35. The vt320 terminal emulation is near completion.  There a few rare 
  36. device control strings that I have left to do, the soft character sets 
  37. and the status line code isn╒t done.  I have tried to finish all the 
  38. important sequences. I have tested it out with various editors and 
  39. full screen utilities and it works fine.
  40.  
  41. Escape/Control/Device Control sequences are parsed up to the final 
  42. character without error. This means that undocumented sequences, 
  43. alien or any sequence that has not been totally garbled will be 
  44. parsed without error.  This pretty much guarantees the program will 
  45. work with any full screen application made for a vt series text 
  46. terminal, up to the 320. Unless there is undocumented sequences 
  47. which do not follow the correct format (but I doubt it).  Error 
  48. recovery for sequences is probably better than the vt320, it will 
  49. distinguish similar sequences through minimum uniqueness and as 
  50. long as the sequence is decipherable and does not contain extraneous 
  51. characters it will recognize it. In other words, it tries to perform any 
  52. sequence that comes in.
  53.  
  54. As for vt320 character & line attributes it does ALL of them: double 
  55. width, double height lines, bold, underline, blink and reverse or any 
  56. combination.  And the cursor is correctly represented on double wide 
  57. or double height lines.
  58.  
  59. All the vt320 character sets are present, the two graphics sets, ASCII, 
  60. ISO Latin, the Multinational set and the display control set.
  61.  
  62. Programmable function keys work.
  63.  
  64. Currently the multi-session capabilities are limited by the serial 
  65. ports.  I will hopefully be getting my hands on multi-session 
  66. protocols very soon for various environments.
  67.  
  68. The terminal window is sizeable to 200x100, if anyone thinks this 
  69. should be bigger, please tell me.  This means if you have a nice big 
  70. screen you could set your display to 80x100 lines and do a set/term 
  71. page=100 on a Vax and would be able to use all the editors and such 
  72. at 100 lines.
  73.  
  74. Scrollback is currently fixed at 70,000 bytes, this will be 
  75. customizable in byte increments from 500 bytes, as soon as I do the 
  76. interface for it.  If the 70,000 bytes can not be allocated for a session, 
  77. the session will not have scrollback.
  78.  
  79. The top part of the split screen only shows the scrollback.  The 
  80. bottom shows the active terminal window and the scrollback.
  81.  
  82. The character generation routines are hand coded 68020 
  83. and 68000 assembler that produce all the character attributes except 
  84. blink, which is done separately.  Currently the font is fixed at 9 point 
  85. vt320, I might add other sizes in time.  The difference in the 68020 
  86. routines is that they use 68020 specific instructions that boost 
  87. performance on 68020 machines.
  88.  
  89. There are 6 levels of scrolling. The first three are degrees of 
  90. smoothness. the fourth one is a standard jump scroll and the last two 
  91. are custom ones specific to this program.
  92.  
  93. The custom scrolling routines look like normal jump scroll until more 
  94. than one line of information is read from the serial port at any given 
  95. time.  The first one ╥Super Jump╙ will scroll the screen one line at a 
  96. time but not update the characters in the scrolled up part until it is 
  97. done receiving a packet.  The second one ╥Mega Blast╙ is very similar 
  98. to the behavior of the terminal windows on a Vaxstation, the screen 
  99. is scrolled up to a whole screen at a time, this produces a jumpy 
  100. effect, but is perfect for high speed lines or if the user was delaying 
  101. the emulator.  I would recommend turning these scrolling features 
  102. off in a terminal window that does have scrollback, as the screen 
  103. might flash before your eyes.
  104.  
  105. Pretty much all the dialog features work, if it doesn't respond, it 
  106. doesn't work, and a couple little check 
  107. boxes here and there.  Break (command-enter=short & command-
  108. shift enter=long) really doesn't work too well, have to look into this.
  109.  
  110. Keep in mind that this is made for multi-sessions, the serial port 
  111. configuration dialog DOES NOT decide which port your terminal is 
  112. hooked to. The comm dialog decides this.
  113.  
  114. This is a emulator.  There is no file transfer, no macros, no scripting 
  115. or other niceties.  These will be added as soon as the emulation is 
  116. near perfect and bugs have been worked out.  I have already started 
  117. design on some of these features and hope to have the beginnings of 
  118. them in future releases.
  119.  
  120. Low memory: ugh. you could probably crash this program if you sat 
  121. and crammed memory, then went and caused an alert or large region 
  122. to be allocated.  I will be fixing this very soon, but for now, if it 
  123. doesn't work its ╘cause it needs memory. I have tried to make as 
  124. much of the programs resources unpurgeable so the segment loader 
  125. and resource manager don't crap out with system errors. Just don't 
  126. push it.
  127.  
  128. I'm sure I haven't covered everything as this was whipped up and I 
  129. would like to spend more time developing the program than writing 
  130. pretty docs.
  131.  
  132. Please direct all bug reports to me, especially emulation bugs.
  133.  
  134. Any comments, suggestions, hate mail or job offers send to the address in the about box.:
  135.  
  136.  
  137.