home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_disks / 200-299 / ff267.lzh / Mackie / README < prev    next >
Text File  |  1989-10-31  |  10KB  |  241 lines
  1. Mackie 1.3 release
  2.  
  3. - Automatic generation of different patterns
  4. - `patterns' keyword removed
  5. - Spline bug removed
  6.  
  7. Mackie 1.2 release
  8.  
  9. - Selection of five screen blanking modes
  10. - New `patterns' keyword to select blanking mode
  11. - Changes screen blanking patterns every five minutes
  12.  
  13. Mackie 1.13 release
  14.  
  15. - Faster, machine language splines
  16. - Changes from splines->boxes->lines
  17.  
  18. Mackie 1.12 release
  19.  
  20. - Adds splines (compile with -DSPLINES)
  21. - Time of `0' disables screen blanking
  22.  
  23. Mackie 1.11 release
  24.  
  25. This release fixes a few bugs in the 1.1 alpha release.
  26.  
  27. - Function keys work now.
  28. - Any spawned commands have a priority of 0, not 20.
  29. - The -f option works.
  30. - The .mackierc file is closed after it is read.
  31. - Some minor space improvements.
  32.  
  33. Mackie 1.1 (beta release for 1.2) is now available.  This revision has
  34. significantly greater functionality than the original Mackie, and I am
  35. releasing it in hopes of getting comments and improvements.
  36.  
  37. To get the program, anonymous ftp it from labrea.stanford.edu (in ~pub)
  38. or send me mail; I'll send it to you by Email or physical mail (at least
  39. to the first 20 people who ask).  You'll get both source and executable;
  40. comments on the source is greatly appreciated.
  41.  
  42. Those of you who have used Lisp machines or TI Explorers will recognize
  43. how this works.  I've added a `System' key to the Amiga, by taking over
  44. the help key.  If I want to edit a file, I simply hit `Help' then `E'.
  45. If an editor already has a window open, it will be popped to front;
  46. otherwise, an editor will be spawned.  Similarly, `Help' `V' will give
  47. me a VT100 window, whether one exists or not.  If I want a new editor,
  48. regardless of ones that current exist, `Help' CTRL-E will give me one.
  49.  
  50. Let's plunge right in, by examining my current startup file.
  51.  
  52. *
  53. *   Typical .mackierc file; set the default pop
  54. *   command:
  55. *
  56. command "newwsh con:10/10/640/200/MackieCLI"
  57. ;
  58. ;   and the timeout:
  59. ;
  60. timeout 200
  61. ;
  62. ;
  63. ;
  64. patterns 023
  65. #
  66. #   Now define some system keys
  67. #
  68. space cli "" "newwsh"
  69. t cli "tex*" "newwsh con:20/20/640/100/texwsh cmd tex"
  70. p intuition "preview*" "preview"
  71. e intuition "mg*" "mg"
  72. v intuition "vt100*" "run vt100"
  73. d intuition "dfc*" "dfc"
  74.  
  75. w intuition ""
  76.  
  77. So, all the POPCLI stuff is still in there.  I'll address the system keys
  78. one by one.
  79.  
  80. The patterns line selects what patterns to display.  `0' is the original
  81. mackie lines patterns; `1' is a single Bezier spline; `2' is the standard
  82. qix; `3' is a four-line qix; `4' is sets of three splines in a closed curve,
  83. and `R' is pick one randomly.  It rotates patterns on a 5-minute basis.
  84.  
  85. The line that starts with `space' means that whenever `Help' `Space' is
  86. pressed, the next CLI window that matches the empty string is brought
  87. to the front.  The only CLI windows with a null command are the ones
  88. not executing a command, so this gives me a CLI ready for a command.
  89.  
  90. The line that starts with `t' means that `Help' `t' will look for a CLI
  91. executing a command starting with the three characters `tex', and pop it
  92. to front.  If one doesn't exist, one is started.  Note that all string
  93. comparisons here are case insensitive, and that `*' means match all the
  94. rest of the characters.
  95.  
  96. The syntax for the startup file is each line is an empty line, a comment,
  97. a parameter line, or a system key definition.  Comment lines start with
  98. semicolons, hashes, or splats.  Parameter lines start with `command',
  99. `timeout', `blank', or `lines'.  Timeout must be folled by a number,
  100. and command must be followed by a string.  Separators are tabs, spaces,
  101. equal signs, commas, or hyphens.
  102.  
  103. System key definitions start with the key being defined.  Allowable
  104. keys are A-Z or 0-9 (as themselves), F1 through F10 for the function
  105. keys, or Space for the space key.  The keyword `Shift' can precede the
  106. key.  After the key, an optional `CLI' or `Intuition' keyword can be
  107. placed.  These will be described later.
  108.  
  109. After the optional keyword, one or two strings should be found.  The
  110. first string is the command to match; the second string (if given) is
  111. the command to execute if no matches are found.  This command should
  112. return relatively quickly; if the program doesn't detach, then you want
  113. to precede the command with a `run' or `newcli' so it does.
  114.  
  115. Strings are bracketed by double quotes; a backslash-double quote means
  116. a literal double quote.
  117.  
  118. Any key that doesn't have a definition in the startup file gets a default
  119. definition; for the letter keys A-Z, the default definition is
  120.  
  121. X "X*"
  122.  
  123. for example, which means match any window starting with `X', be it a CLI
  124. or an Intuition window.  The number keys match only the CLI with that
  125. particular number.  The space key by default matches any window (so it just
  126. cycles all of the windows), and the function keys match nothing.
  127.  
  128. Windows are not matched by their title; the title is often blank or used
  129. for error messages and the like.  Instead, windows are matched by the
  130. name of the task associated with the window for Intuition windows, or the
  131. command being executed by the CLI in the case of CLI windows.  Thus, the
  132. program doesn't work very well with programs that use strange task names.
  133. For instance, Manx db uses the name `Aztec_db', so you'd have to match
  134. that, rather than the intuitive `db'.
  135.  
  136. There are three classes of programs.  There are those programs that run
  137. from the workbench or detach themselves from a CLI; these programs have
  138. only an Intuition window associated with them.  An example of this class
  139. is Manx `db'.  There are those programs that interact only through the CLI
  140. windows; an example of these is `tex'.  And finally, there are programs
  141. that run from a CLI but do their interaction through an Intuition window;
  142. an example of this is `vt100'.
  143.  
  144. Only the third class offers any ambiguity; the question is whether to
  145. active the CLI window or the Intuition window.  But the type of window is
  146. usually specified for the other kinds anyway, to help limit the search.
  147.  
  148. If you give a search string such as `!xyzzy!' that isn't likely to be
  149. matched, then the command string is always executed, so you can bind
  150. arbitrary commands to a system key.
  151.  
  152. Oh, yes; one important thing.  Hitting `help' twice passes a help key
  153. on through the input stream, so you haven't lost your help key.
  154.  
  155. The code will only compile with Manx.
  156.  
  157. Usage is simply:
  158.  
  159.    run mackie [-q] [-l] [-b] [-f filename] [command] [time]
  160.  
  161. Note that it doesn't automatically detach itself, so the `RUN' is
  162. necessary.  The first time you run it, it loads itself into RAM.
  163. Subsequent invocations need not be `run', as they notice the running
  164. portion of the program and simply send new parameters to it.
  165.  
  166. The options mean:
  167.  
  168.    -q             Quit.  Remove the resident portion from memory.
  169.    -l             Lines.  Draw lines instead of a blank screen.  (Default)
  170.    -b             Blank.  Draw a blank screen instead of fancy lines.
  171.    -f filename    Startup file (default is s:.mackierc).
  172.  
  173. A time is an argument that starts with a digit; this time is in seconds.
  174. After that much inactivity, the screen blanking starts.
  175.  
  176. A command is an argument that starts with neither digits nor a hyphen.
  177. This is the command executed whenever left-amiga ESC is pressed.
  178.  
  179. Thus, the command
  180.  
  181.    run mackie "newcli con:10/10/640/200/MackieCLI"
  182.  
  183. starts mackie up, and sets the command to be executed to a NewCLI with a
  184. specified size.  Later, if you want to see the screen blanking feature
  185. quickly, just type
  186.  
  187.    mackie 1
  188.  
  189. and in a second, the screen will go blank.  If the lines are driving you
  190. wild, you might type
  191.  
  192.    mackie -b
  193.  
  194. to turn them off.  Finally, you need every byte of memory, so you want to
  195. remove mackie.  Simply type
  196.  
  197.    mackie -q
  198.  
  199. That's all there is to it.
  200.  
  201. Enjoy this program!  Send bug reports to Tomas Rokicki, Box 2081,
  202. Stanford, CA  94309.
  203.  
  204. Based on:
  205.  
  206. /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
  207. /* |_o_o|\\ Copyright (c) 1986 The Software Distillery.  All Rights Reserved */
  208. /* |. o.| || This program may not be distributed without the permission of   */
  209. /* | .  | || the authors.                                                    */
  210. /* | o  | ||    Dave Baker     Ed Burnette  Jay Denebeim John Mainwaring     */
  211. /* |  . |//     Gordon Keener  Jack Rouse   John Toebes  Doug Walker         */
  212. /* ======                    BBS:(919)-471-6436                              */ 
  213. /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
  214.  
  215. POPCLI III by John Toebes © 1987 The Software Distillery.  All Rights Reserved
  216.  235 Trillingham Ln, Cary, NC 27511
  217.  
  218. Contributions to continue development of this and other fine products for the
  219. Amiga should be sent to the Software Distillery at the above address.
  220.  
  221. Other Products produced by the Software Distillery are:
  222.    BLINK    - the Turbo-charged Alink replacement
  223.    HACK     - The Amiga port of the famous UNIX game
  224.    LARN     - Another famous UNIX game
  225.    MEMWATCH - Protects your machine from random trashes
  226.    MAKE     - A software development tool one shouldn't be without
  227.    KERMIT   - The World renown file transfer protocol brought to the Amiga
  228.    ICONEXEC, SETALTERNATE, SETWINDOW - Icon manipulation tools
  229.    TSIZE    - A short utility for determining directory sizes.
  230. All of these are available on our BBS.
  231.  
  232. Permission is hereby granted to distribute this program provided both this
  233. documentation accompanies the executable and that no charge is made for its
  234. distribution.
  235.  
  236. POPCLI (pronounced POP-SEE-EL-EYE) is designed to solve two problems at once.
  237. First it provides a simple way of starting another CLI at any time without
  238. having to load workbench or exit whatever program you may be using.  Second
  239. it has a builtin screen saver mode that automatically turns off the Amiga
  240. display when there has been no input for a given period of time.
  241.