home *** CD-ROM | disk | FTP | other *** search
/ HomeWare 14 / HOMEWARE14.bin / utils2 / mymous12.arj / KNOBS.DOC < prev    next >
Text File  |  1994-02-10  |  9KB  |  221 lines
  1. *****************************************************************************
  2.  
  3.                                K  N  O  B  S
  4.  
  5. *****************************************************************************
  6.  
  7. by Andrew Forrest                                               Public Domain
  8.  
  9.  
  10. From Release 2 onwards, the Amiga Operating System has bits set aside inside
  11. its various structures to provide some (limited) control over its behaviour.
  12. There are a few programs which allow the user to twiddle these knobs, e.g. to
  13. switch on the AmigaDOS `asterisk-as-wildcard' feature, but why have lots of
  14. little programs cluttering up your "user-startup" sequence when one program
  15. can do it all?
  16.  
  17. This is a small program which allows you to twiddle these hidden knobs.
  18.  
  19.  
  20. HOW TO USE THIS PROGRAM
  21.  
  22.    "Knobs" is a small CLI command which you should probably stick in your
  23.    "C:" directory (on your Workbench disk or boot disk). The program should
  24.    come with its documentation (this file) and the source code, "Knobs.asm".
  25.  
  26.    "Knobs" can be run (only) from the CLI (Shell) and invoked with a
  27.    command of the form "Knobs <options>", where <options> represents one or
  28.    more of the command-line options listed below:
  29.  
  30.    ALERTTIMER/K/N
  31.  
  32.       Apparently one of the most requested enhancements by developers for
  33.       the Amiga Operating system was a means to control the time for which
  34.       `alerts' (see below) are displayed. For example, with an unattended
  35.       system controlling a nuclear power plant (as if) you probably want the
  36.       machine to reboot itself as soon as it crashes rather than wait forever
  37.       for a user to hit the mouse button.
  38.  
  39.       This option takes one argument, the time in frames (50ths or 60ths of
  40.       a second) for which an alert should be displayed before the machine
  41.       automatically reboots. If the number is 0, alerts are never displayed.
  42.       If it is -1, alerts are displayed until the user presses a mouse
  43.       button.
  44.  
  45.    BBLANK=BORDERBLANK/K
  46.  
  47.       Look at your workbench screen. Unless you have installed a pattern on
  48.       the workbench, the background colour probably extends to the edges of
  49.       the monitor. This looks a bit tacky. It also makes it hard to see where
  50.       the edges of the (Workbench) screen are.
  51.  
  52.       Help is at hand.
  53.  
  54.       Version 39 (Release 3) of the Amiga graphics.library contains a switch
  55.       which allows you to make the screen border black, rather than just the
  56.       same colour as the background (colour #0).
  57.  
  58.       Specify "BORDERBLANK ON" (or "BBLANK ON") to make your screen border
  59.       black. Specify "BORDERBLANK OFF" to make it the same as colour #0
  60.       again. Specify "BORDERBLANK CHANGE" to blank it if it's not blanked or
  61.       unblank it if it is. "BORDERBLANK <anything else>" has no effect.
  62.  
  63.    NOCLICK=NODISKCLICK/K
  64.  
  65.       Amiga disk drives click annoyingly when they do not contain a disk.
  66.       This option allows you to turn off the clicking. But first a word of
  67.       warning--if a drive makes funny noises after you have de-clicked it,
  68.       then the drive was not designed _not_ to click and continued use
  69.       of the anti-clicking thing could cause it damage (it could put the
  70.       read/write heads out of alignment).
  71.  
  72.       The noclick option should be followed by a string which specifies
  73.       which drives should be declicked. The first character of the string
  74.       controls the first drive ("DF0:"), the second controls "DF1:", the
  75.       third controls "DF2:" and so on The string may be as long or short as
  76.       you like. Each character should be one of:
  77.  
  78.             "1" - to stop the drive from clicking
  79.             "0" - to switch the clicking back on
  80.             "*" - to switch the clicking from on to off, or from off to on
  81.             "-" - to leave the drive as it is
  82.  
  83.       If there are more disk drives connected to your computer than there are
  84.       characters in the string, the extra drives will be left alone.
  85.  
  86.       So for example, to de-click drives "DF1:" and "DF2:", but leave "DF0:"
  87.       alone, give the argument
  88.  
  89.             NOCLICK="-11"
  90.  
  91.       To make "DF0:" click, but leave "DF1:" alone, you could write
  92.  
  93.             NODISKCLICK 0-
  94.  
  95.  
  96.    WILDSTAR=STAR/K
  97.  
  98.       The AmigaDOS shell commands often allow the user to specify several
  99.       files using wildcards and pattern-matching. A discussion of
  100.       pattern-matching is beyond the scope of this document, suffice to say
  101.       that normally AmigaDOS uses "#?" (hash-sign, question-mark) as its
  102.       wildcard, rather than "*" (asterisk) as used on many other operating
  103.       systems (most notably UNIX and MS-DOS).
  104.  
  105.       The WILDSTAR option instructs AmigaDOS to accept asterisks as
  106.       wildcards. Use "WILDSTAR ON" (or "STAR ON") to enable the feature,
  107.       "WILDSTAR OFF" to disable it or "WILDSTAR CHANGE" to toggle the feature
  108.       on or off, depending on its current state. "WILDSTAR <anythingelse>"
  109.       has no effect.
  110.  
  111.  
  112.    Any or all of these options may be included in the command-line when your
  113.    run "Knobs". So, for example, you might type "Knobs ALERTTIMER=-1
  114.    BBLANK=ON NOCLICK=1111" to run the program and invoke three of its
  115.    options.
  116.  
  117.    The effects of the program will not survive when you reboot the machine
  118.    (except for the ALERTTIMER option, which _does_ survive reboots). If you
  119.    want to run the program every time you reboot your Amiga, it makes sense
  120.    to add a line to your "user-startup" file (in the "S:" directory of your
  121.    Workbench or boot disk--see below for an explanation) to run the program.
  122.  
  123.  
  124. WHAT IS AN ALERT
  125.  
  126.    You mean you've never seen an alert?
  127.  
  128.    It used to be (before Release 2), that when an Amiga crashed, it would
  129.    put up a black screen with a message in red (with a red flashing
  130.    border) and a "guru meditation" number, to signify what went wrong.
  131.  
  132.    Putting "guru meditation" on the screen was obviously far too frivolous a
  133.    thing to do for a machine about to be targeted at serious, non-games-
  134.    playing markets, so Commodore changed the message to "Unrecoverable alert"
  135.    (or something), but the idea is much the same--you don't usually see an
  136.    unrecoverable alert unless your machine is about to crash (or has crashed
  137.    already).
  138.  
  139.    Another type of alert is the recoverable alert. Instead of an alarming
  140.    red, this alert is rendered in an optimistic shade of puce (I think). This
  141.    is usually a message that something has gone a bit wrong, but not to worry
  142.    about it too much.
  143.  
  144.  
  145. WHAT IS "USER-STARTUP"?
  146.  
  147.    The file "User-startup", which goes in the "S:" directory of your
  148.    Workbench disk, is nothing more than a list of commands, each of which is
  149.    executed when the Amiga is started up (switched on or rebooted).
  150.  
  151.    If the file does not exist, it can be created in any text editor or word
  152.    processing program. If it already exists, it can be edited in any text
  153.    editor or word-processing program.
  154.  
  155.    To run "Knobs" each time your machine reboots, insert a line of text at
  156.    the bottom of your "S:User-startup" file, of the form "Knobs <options>",
  157.    i.e. the same form in which the program is invoked from the CLI. Then just
  158.    save the file.
  159.  
  160.  
  161. PROGRAM REVISION HISTORY
  162.  
  163.    V 1.00 (February 1994)
  164.       The first version.
  165.  
  166.  
  167. PLANS FOR THIS PROGRAM
  168.  
  169.    I am happy with the form of the program as it is at the moment--a rather
  170.    minimal CLI command for flicking a few of the operating system's switches.
  171.  
  172.    If I learn of any other such switches in the Operating System, I'll try to
  173.    add them to the program. (So if you know of any, please contact me.)
  174.  
  175.    I _don't_ want to have this program patch the O.S. in any way. I'd
  176.    rather keep it small and clean and leave other programs to hack about with
  177.    the system. This program's `sister', "MyMouse" installs input handlers,
  178.    patches libraries and stuff. If I want to implement any system `hacks',
  179.    it'll be that program to which I add them.
  180.  
  181.    Anyhow, suggestions are welcome, so feel free to tell me if you have any
  182.    ideas.
  183.  
  184.  
  185. ABOUT THE AUTHOR...
  186.  
  187.    Andrew Forrest was born in 1974 and is still not dead---
  188.  
  189.    Sorry, wrong biography.
  190.  
  191.    Okay, basically I've been programming since birth (on a progression of
  192.    computers [ZX81, Spectrum, Amiga 500, Amiga 1200]). I used to do AMOS, but
  193.    I hope that I have closed the last page on _that_ chapter of my life (not
  194.    that AMOS does not have its merits, but it was rather unsuitable for what
  195.    I really wanted to do).
  196.  
  197.    I'm now on E and Assembler.
  198.  
  199.    I welcome correspondance--bug reports, suggestions, criticisms--on
  200.    anything I have written. I really prefer electronic mail (at least, during
  201.    term-time: October to Christmas, February to May), and I usually reply to
  202.    e-mail (unless I really get a lot).
  203.  
  204.    My e-mail address is
  205.  
  206.          aforrest@cs.strath.ac.uk
  207.  
  208.    and is likely to stay that way for at least another year.
  209.  
  210.    Conventional mail will reach me if sent to:
  211.  
  212.          Andrew Forrest
  213.          6 Stanley Avenue
  214.          Ardrossan
  215.          Ayrshire
  216.          KA22 8NT
  217.          (Scotland)
  218.  
  219.  
  220.  
  221.