home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / MM1 / UTIL / stg_mm1.lzh / pop.doc < prev    next >
Text File  |  1991-08-18  |  6KB  |  141 lines
  1.  
  2.     POP - OSK/MM1/KD Windows Version - Beta Release 91/08/18 - V5.5
  3.  
  4.  
  5.     (c) 1991 by StG Computers inc.
  6.  
  7.     This program is SHAREWARE.
  8.     If you find it useful, a donation of $10 towards will help to
  9.     encourage future enhancements.  A donation of $20 or more will
  10.     get you a copy of the latest version in the mail when we add
  11.     new features!  Address at end of file...
  12.  
  13. Output from -? option:
  14.  
  15. Pop {-opt} {program} - create new window
  16.      -l = don't label the window
  17.      -s = don't switch to window
  18.      -c = replace current window
  19.      -w = wait on program to die
  20.      -f=# = set foreground color
  21.      -b=# = set background color
  22.      -o=# = set border color
  23.      -0 = 80x26 640x208 16 Color [default]
  24.      -1 = 80x26 640x416 16 Color Interlaced
  25.      -2 = 80x52 640x416 16 Color Interlaced
  26.      -3 = 40x26 320x208 256 Color
  27.      -4 = 40x26 320x416 256 Color Interlaced
  28.      -5 = 40x52 320x416 256 Color Interlaced
  29.      -6 = 90x30 720x240 16 Color Overscan
  30.      -7 = 90x60 720x480 16 Color Interlaced/Overscan
  31.  
  32. POP V5.5 (c) 1991 by StG Computers inc.
  33. Written by Chris Swinefurth (The Bug) and StG
  34.  
  35. This program is SHAREWARE!  If you like it, please send $10 to:
  36.     StG Computers inc., P.O. Box 24285, Speedway IN 46224
  37.  
  38.  
  39. Pop is a handy little program that allows you to create a new window
  40. from the command line at any time.  You can specify a program for it to
  41. start running on that window, or it will default to the Shell.  Although
  42. pop will normally create a new window, you may change your current
  43. window by using the -c option.  Pop will also put the window name on the
  44. top line unless you specify the -l option.  The program that is started
  45. will run by itself unless you add the -w option that causes it to wait
  46. on the program to finish.  The foreground, background, and border colors
  47. can also be specified on the command line.  The default foreground and
  48. background colors depend on the window type, and the default border
  49. colors is taken from the window number to 'color code' each open window.
  50. And of course, any type of window (as currently defined) can be started,
  51. making it easy to start a program that requires a particular type of window.
  52.  
  53. NOTE: On the MM1 the color scheme is white on blue for all window
  54.       types, and the 'overscan' types do not display a border.
  55.  
  56. Pop also will automatically add a termcap entry with correct settings for
  57. the window size.  It also sets the environment variable TERM for you to
  58. use the correct entry.  However, if you 'pop' the current window (-c),
  59. it can't affect an existing shell so it tells you what to enter to set
  60. the TERM correctly.  So far I have only run into one program (ME) that
  61. doesn't work with this correctly, but it is due to a bug in that program.
  62. Use umacs instead.  Also, pop sets the tmode 'pag' setting to reflect the
  63. proper number of lines for your window, in case you have pause on.
  64.  
  65. The -s option on pop will keep it from selecting the new window.  This
  66. allows you to put 'pop -s' in the startup (or .login) file to create
  67. a new window, but leave you on /term.  Also, the SHELL environment
  68. variable is used to determine the default program to start.  This way
  69. if you want to use another shell, or put an option in like -e (print
  70. error messages), pop will take care of that each time you start a new
  71. window.
  72.  
  73. Apologies for the quick'n'dirty doc file folks, this is a quick hack.
  74. There is also a CoCo version of this same utility, which has the
  75. capability of pop'ing a VDG window.  No more xmode'ing a window to
  76. start your favorite game.  Just pop -v it.
  77.  
  78. NOTES:  If you are using the sysgo module that I modified and uploaded
  79.         to CIS (it comes with the MM1), you can put the command 'pop -c'
  80.         in a file called '/dd/.login' and it will automatically be
  81.         executed (just before your first shell).  To prevent pop from
  82.         complaining about the TERM variable not being set correctly,
  83.         set it just before the 'pop -c' entry in /dd/.login.  For
  84.         example, your .login might read:
  85.  
  86.         setenv TERM Win80x25
  87.         pop -c
  88.  
  89.         The PORT environment variable is now set to the new window if 
  90.         it was not already set to something.
  91.  
  92.         Users wishing to modify the 'Win' termcap entry may do so, but
  93.         do not change the first title line or any of the lines/columns
  94.         entries.  The lines following the Win title line may be changed
  95.         carefully to allow for different features or customization.  I
  96.         may re-write the termcap entries, but in that case a different
  97.         name will be used and a whole new set created leaving the old
  98.         one to copy from.
  99.  
  100. Known Bugs:
  101.  - The border color is not supported by early versions of KD windows
  102.    (this causes all borders to be black - DWset call is being fixed)
  103.  - Modules that are not 68k exectable code (such as Basic modules) must
  104.    be run by prefixing the command with 'shell'
  105.  - Termcap entry created uses ANSI rather than COCO sequences, this is
  106.    due to cursor up (code 9) not working yet.  When fixed, an all-COCO
  107.    entry would run faster.  Current ANSI termcap entry also contains
  108.    unimplimented (although standard) codes such as inverse (ESC[7m) and
  109.    underline.  If these get implemented (hey Kev!) they will work...
  110.  
  111.  * Version History:
  112.  * V0.? - Original version in C by StG (probably late '87)
  113.  * V1.0 - First assembly version by StG (source ate by disk) for StGNet
  114.  * V2.0 - Disassembled by Bug and hacked for more options
  115.  *        (not released due to bugs in VDG support)
  116.  * V3.0 - Rewrote by Bug and added -c option
  117.  *        (modeled after my type utility in the RBW)
  118.  * V4.0 - Rewrite by Bug in C with VDG support fixed (help from StG)
  119.  * V5.0 - trashed and recoded by StG for OSK support, new var naming style
  120.  * V5.1 - included patches for awkward SELECT in KDwin and tmode pag setting
  121.  * V5.2 - added auto termcap features from edit
  122.  * V5.3 - fixed window flip problem (caused by DWSET bug) and added -s opt
  123.  * V5.4 - use SHELL variable for default program and options
  124.  * V5.5 - created setenv() to fix environ mod'ing problems, added set to PORT
  125.  *
  126.  * Future enhancements:
  127.  *
  128.  * -v = vertical split screen (put []'s on ends of label)
  129.  * -h = horizontal split screen
  130.  * -d = auto SRCDBG mode (pop 2 windows)
  131.  *  $ = separation character for multiple commands (for split, etc)
  132.  * -f = select a font file(?)
  133.  * -i = interactive mode (mousey)
  134.  
  135.  
  136. StG Computers inc.
  137. P.O. Box 24285
  138. Speedway IN  46224
  139. (317) 241-6401
  140.  
  141.