home *** CD-ROM | disk | FTP | other *** search
/ MACD 5 / MACD5.iso / workbench / boot / czesc_1 / climax / climax.readme < prev    next >
Encoding:
Text File  |  1991-01-10  |  10.2 KB  |  179 lines
  1.  
  2.                                  CLIMAX        (release three)
  3.  
  4. For those who have used CLImax in its first released version, here is a quick
  5. summary of how this version differs from that one:
  6.     - You don't need to Run it any more.  Just type "climax".
  7.     - It no longer closes the window when there is still a file handle open
  8.       on it.  I was wrong to say that this was a ConMan problem.  Or rather,
  9.       it was only a problem with obsolete versions of ConMan.
  10.     - Because of this, it now requires ConMan v1.3 or newer.
  11.     - Also, it never closes the screen while any windows are open on it.
  12.     - Memory consumption is about 10K less.
  13.     - There is now a CD= tooltype for setting initial CD from Workbench.
  14.     - There is a FROM option to specify the startup script.
  15.     - There's an option E that makes it try to use the Topaz 11 font.
  16.     - If the Workbench screen is larger than the minimum size CLImax needs,
  17.       it will use that size.
  18.     - It now reports error messages in a Workbench window if it has no
  19.       standard output.  You have to press return in this window to remove it.
  20.  
  21. Have you ever wished your CLI window had 25 lines of 80 characters, just like
  22. a good old fashioned non-windowing computer?  The answer is here: CLImax by
  23. Paul Kienitz.  It creates a custom screen with a borderless backdrop CLI
  24. window.  The CLI will be a Shell if you have the Shell-Seg resident.  It has
  25. a couple of requirements that you must meet for it to work:
  26.  
  27. In order to use CLImax, YOU MUST BE USING CONMAN VERSION 1.3 OR NEWER. 
  28. (ConMan 1.3 is on Fish disk 165.)  If you use ConMan 1.1 (or any other old
  29. version), the screen will never close.  You'll have to swat it with ScreenX
  30. or something.  If you do not use ConMan, it will be unable to open a CON:
  31. handler for the window.  **** If anyone has any ideas for how to open vanilla
  32. CON: or NEWCON: with a pre-existing window, let me know!
  33.  
  34. Furthermore, the Run program, and probably the Execute program, must be
  35. available in C: or made resident.  Run must be on disk if you are using a
  36. version of AmigaDOS earlier than 1.3.2 -- that's the first version in which
  37. the Execute() function knows to look for Run in the resident list.  If you
  38. don't use the 1.3.2 version of SetPatch, get it.  It makes anything that uses
  39. Execute(), including CLImax, a lot faster and more efficient, when Run is
  40. resident.  Make Run resident even if you don't make anything else resident. 
  41. It's something that should have been in ROM anyway.
  42.  
  43. To end CLImax, just EndCLI as usual; the screen will be closed when there are
  44. no windows left on it.  If there is still a window from some other program
  45. there after the console closes, it will check once per second to see when it
  46. leaves, and close when it's gone.  The console will stay open if some
  47. background process started with a Run command still has a dublicate file
  48. handle on it, just like regular NewCLI.
  49.  
  50. Command-line/ToolType options:  You can specify a startup script file, you
  51. can specify the initial current directory when run from workbench, and there
  52. are four one-letter option flags.  From CLI, put the letter(s) after the
  53. word CLImax; from Workbench, you can use the Info menu option to modify the
  54. ToolType OPTION= which is followed by any or all of these four letters.  The
  55. letters can be either case with anything in between.  The word OPTION must be
  56. uppercase with no space before the equal sign.
  57.  
  58. If you say "OPTION=I" or "CLImax I" you get an interlaced screen with fifty
  59. lines of text.  You might want to use the topaz 11 font (see below), to give
  60. you 36 lines with better readability.  Of course, European users get 32 lines
  61. without interlace anyway, or 46 in interlace with topaz 11.
  62.  
  63. The second option, "OPTION=G", causes the colors to change to black text on
  64. a greenish background, a good combination for interlaced text without a
  65. flicker fixer.  Ordinarily it uses the same colors as the Workbench screen. 
  66. Maybe someday I'll add RGB options, but for now if you want different colors
  67. you'll have to either use a program like Palette or Erik Nygren's
  68. SetColorReg, or recompile CLImax with new values.
  69.  
  70. The third option is "V" (for Vanilla; I want to save "C" to mean "color"). 
  71. It is basically a holdover from the days when the FROM option wasn't in yet. 
  72. V makes it not try to use S:Shell-Startup as the default startup script, and
  73. just try S:CLI-Startup.  Normally it uses s:CLI-Startup if it finds that
  74. s:Shell-Startup does not exist.  This has nothing to do with whether it is
  75. really a Shell or not.  It will always try to execute S:Shell-Startup if V is
  76. not specified and you don't explicitly name a startup script, even if the
  77. Shell-Seg is not resident.  If there are alias commands in that script, it
  78. won't work, and you'll need to use V or FROM.  If you don't ever use the
  79. Shell-Seg or NewShell, S:Shell-Startup can be written just for CLImax. 
  80.  
  81. The fourth option is "E" (for Eleven).  It makes CLImax use the Topaz 11
  82. font, which was designed for interlaced screens, instead of the default font.
  83. It uses the default anyway if it can't find topaz 11.  Typically you would
  84. use this option with the I and maybe G options, like "climax eig".
  85.  
  86. To specify a startup script for Workbench use, add the tooltype FROM=
  87. followed by the name of the file to execute.  From CLI, follow the word
  88. climax and any option letters with the word FROM (lowercase is okay) and the
  89. filename.  DO NOT put option letters AFTER the word "from".  In either case,
  90. you can make it use no startup script at all by putting nothing after the
  91. word FROM.  If the file does not exist, an error message will appear in the
  92. new CLI window.
  93.  
  94. The complete syntax of the CLI command is:
  95.  
  96.     CLIMAX  { V | I | G | E }  [ FROM [ scriptfile ] ]
  97.  
  98. typical example, interlaced:    1> climax ei from s:max-startup
  99.  
  100. There is also a tooltype "CD=", which should be followed by the name of a
  101. directory.  When started from Workbench, it will attempt to CD to that given
  102. directory, and will set the SetName (the name of the current directory that
  103. shows when you include %S in the prompt, with the Shell-Seg) to be a copy of
  104. the string you put there.  It used to always CD to the current definition of
  105. SYS: when run from Workbench, now you need to use the tooltype.  The icon
  106. I've provided has "CD=SYS:" in it.
  107.  
  108. CLImax will give a usage summary instead of running if you type "climax ?" or
  109. "climax h".
  110.  
  111. In the upper right corner of the screen you'll see (parts of) the two screen
  112. depth gadgets.  The screen is overscanned vertically, and so (though you
  113. can't see it) there is a piece of screen title bar above the top of the
  114. window, which you can use to slide the screen vertically, or to click the
  115. depth gadgets.  With an interlaced screen the whole title bar is there in
  116. addition to the 400 line window; with a non-interlaced screen the title bar
  117. and depth gadgets are only partially uncovered (just four lines).  I know it
  118. sounds unaesthetic, but it's not really so bad.  Because of the overscan, it
  119. helps to use Preferences settings in which the workbench screen is moved
  120. slightly upwards of center.  If the workbench is already overscanned, CLImax
  121. will not be any larger than the workbench screen is.  (I recently set my own
  122. workbench size to 664 by 212, which gives climax a 26 x 83 character screen
  123. instead of 25 x 80.  In fact this allows 25 x 80 chars in a regular bordered
  124. con window.)
  125.  
  126. If you leave out the CD= tooltype, or name a nonexistent directory after CD=,
  127. a CLImax started from Workbench will have no current directory.  The
  128. "SetName" in the prompt will be "SYS:", but the effective CD will be the
  129. drive you booted from (df0: or rad: often), NOT the current definition of
  130. SYS:.  Note that many standard commands like Dir and Copy don't like to have
  131. a null current directory.  They attempt to read the boot drive for no reason,
  132. and can fail if there's no disk in it, even if everything they're operating
  133. on is explicitly elsewhere.  Like, the command "c:dir ram:"  will fail if
  134. there's no disk in the boot drive.  This is a bug.  So if you ever create new
  135. CLI's that tell you "SYS:" when you ask what the current directory is, like
  136. by using PopCLI or DMouse, you should make use of my hack FixCLI, which will
  137. give a new CLI a path and a current directory if it has none already.
  138.  
  139. It is possible to set CD= to a file instead of a directory.  Some programs
  140. will bomb when run from such a CLI.  So avoid doing this.
  141.  
  142. Some of the programs you run will create windows and stuff on the Workbench
  143. screen, and will seem to be doing nothing if you just look at the CLImax
  144. screen.  One program that is very useful with CLImax for switching screens is
  145. wKeys by Davide Cervone, available on Fish disk 128.  Or you might prefer
  146. Matt Dillon's DMouse or a similar mouse enhancer.  Personally, I use a
  147. modified DMouse with wKeys-like screen flipping features, and a couple of
  148. other improvements.  If anybody wants a copy of this DMouse (called DRat) I
  149. can give you one, but I'm not mass-distributing it because Matt Dillon
  150. doesn't like it.  Anyway, it lacks a couple of features of Matt's latest
  151. version, which is no longer public domain.
  152.  
  153. It's possible that if you have CLImax and LoadWB both in your startup-
  154. sequence (I do) that you might end up facing an inactive CLImax window which
  155. ignores your typing because the workbench backdrop activated the moment the
  156. initial CLI window vanished.  Try readjusting positions of these things in
  157. startup-sequence; especially try putting CLImax at the very end.
  158.  
  159. Future plans/hopes:  1) Eliminate dependency on ConMan.  Anybody who thinks
  160. they might know a way to put a CON: handler on an existing window without
  161. ConMan, please tell me about it.  2) Option for RGB colors.  3) Make it
  162. "pure".  4) Productivity mode screen option.  5) Sense whether it's a shell
  163. or not, maybe.  5) Option to set screen depth.
  164.  
  165. CLImax is in the public domain.  Feedback is appreciated.  If you want to,
  166. and this hack is useful to you, you can send me something nice in return. 
  167. (My personal policy is (when I can) to treat all software, from PD to copy-
  168. protected, as if it were shareware.)
  169.  
  170.                                         Paul Kienitz
  171. no email address, but try               6430 San Pablo ave.
  172. these northern California BBSes:        Oakland, CA, 94608
  173.   Winners Circle 415-845-4812           USA
  174.   Triple-A 415-222-9416
  175.   The Mission 415-967-2021
  176.   FAUG 415-595-2479
  177. (the first two are in the east bay, the last two are in
  178. silicon valley - you'll get slower response with those)
  179.