home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d9xx / d952 / machv.lha / MachV / Update50.doc < prev    next >
Text File  |  1993-12-31  |  27KB  |  788 lines
  1.                           NOTE! NOTE! NOTE!
  2.  
  3. Users of MachIV should note these changes:
  4.  
  5. 1. Unless specified on the command line or in the Tool Types, MachV will 
  6.    try to read an ENVARC:MachV/MachV.prefs preference file. If that is not
  7.    found, it will try ENVARC:MachIV/MachIV.prefs.
  8.  
  9. 2. Note the functions that have been renamed below. You will have to
  10.    rename these in your macros.
  11.  
  12. 3. Also note the functions that have been removed and delete these from
  13.    your macros.
  14.  
  15. 4  You will need to change all win_activate"" functions to win_activate"M".
  16.  
  17. 5. If you are upgrading from MachIV, all changes are listed here. These
  18.    changes have also been made to the MachV.guide file.
  19.  
  20. 6. AllTitles and AllTasks have been removed from the disk. They have been
  21.    replaced by "Select Title" in SetMachV. See SetMachV #14 below.
  22. =========================================================================
  23.                     MachV and SetMachV - Version 5.0
  24.  
  25. MachV now has (and requires) the library mach.library. With this library
  26. and the included header files, programmers can now access many of MachV's
  27. features and settings. SetMachV itself uses just this library to
  28. completely control MachV. See programmers docs for more details.
  29.  
  30. =========================================================================
  31. Functions Removed
  32. -----------------
  33.  
  34. Several macro functions have been removed. If you have any of these in
  35. your configuration, you should delete them.
  36.  
  37. All Graphics functions - MachV is not pretending to be a graphics
  38.                          utility. With the increased number of graphic 
  39.                          modes available, it is better to use a separate
  40.                          utility program.
  41.  
  42. Msc_Patch_Newlook      - This is replaced by the program ScreenDebut
  43.                          included on the disk.
  44.  
  45. Set_Key                - This was used mainly to set the middle mouse
  46.                          button to the shift key. Do this in the
  47.                          'Miscellaneous Features' window.
  48.  
  49. Set_SetMachV_Path      - The path and name for SetMachV is now a
  50.                          command line or icon ToolType option.
  51.  
  52. Set_Month_Names and    - These are available through the appropriate     
  53. Set_Day_Names            language catalogs or machv.txt file.
  54. =========================================================================
  55. Functions Renamed
  56. -----------------
  57.  
  58. The following functions have been renamed:
  59.  
  60.         Before                  Now
  61.         ------                  ---
  62.         Clk_Meter_Reset         Clk_Reset_Meter
  63.         Scr_Kill                Scr_Kill_Screen
  64.         Scr_Select              Scr_Select_Screen
  65.         Win_Change              Win_Change_Window
  66.         Win_Kill                Win_Kill_Window
  67.         Win_Layer               Win_Layer_Windows
  68.         Win_Move                Win_Move_Window
  69.         Win_Select              Win_Select_Window
  70.         Win_Size                Win_Size_Window
  71.  
  72. Since the prefixes are not needed, this makes some functions clearer and
  73. unambiguous. e.g. 'Win_Kill' and 'Scr_Kill' are ambiguous as just 'Kill'.
  74. Kill_Window and Kill_Screen is clearer.
  75.  
  76. Note that not all ambiguities have been removed. The following must 
  77. include their prefixes:
  78.  
  79.         Clk_To_Front
  80.         Win_To_Front
  81.         Scr_To_Front
  82.         Win_Back_To_Front
  83.         Scr_Back_To_Front
  84.         Win_Front_To_Back
  85.         Scr_Front_To_Back
  86.         
  87. See below for On_Off functions that have been renamed.
  88.  
  89. =========================================================================
  90. Function Changes
  91. ----------------
  92.  
  93. All window functions operate on the window as selected in this manner:
  94.  
  95.     Top window -
  96.  
  97.         win_function                    For compatibility with 4.2
  98.         win_function"T"
  99.         win_function"T,arg2,arg3,..."
  100.  
  101.     Active window -
  102.  
  103.         win_function""                  For compatibility with 4.2
  104.         win_function"A"
  105.         win_function"A,arg2,arg3,..."
  106.         win_function",arg2,arg3,..."    For compatibility with 4.2
  107.  
  108.     Under mouse window -
  109.  
  110.         win_function"M"
  111.         win_function"M,arg2,arg3,..."
  112.  
  113.     Titled window -
  114.  
  115.         win_function"title"
  116.         win_function"title,arg2,arg3,..."
  117.  
  118. While window functions select the window the same way as in previous
  119. versions (except win_activate), you should use 'T', 'A' and 'M' for top,
  120. active and (under) mouse. There is only the remote possiblity of a
  121. conflict if you must specify a window whose title is one of these single
  122. characters. In these cases you could use:
  123.  
  124.         win_function"(A)"
  125.         win_function"(M)"
  126.         win_function"(T)"
  127.  
  128. Note: You will need to change any win_activate"" functions to 
  129.       win_activate"M"
  130.  
  131.       If there is no window under the mouse, the top window will become
  132.       active.
  133.  
  134. On Off Functions
  135. ----------------
  136.  
  137. All on/off functions have been changed to be a little less tedious to type
  138. and to be clearer. The argument can now be 'On' or 'Off' as well as '1' or
  139. '0'. 'Tog' will toggle the feature as will no argument.
  140.  
  141.         Before                      Now
  142.         ------                      ---
  143.         Clk_On_Off"1"               Clk_Clock"On"
  144.         Mac_On_Off"0"               Mac_Macros"Off"
  145.         Mou_Sun_On_Off""            Mac_SunMouse"Tog"
  146.         Mou_To_Menu_On_Off"1"       Mou_To_Menu"On"
  147.         Mou_FreezeVert_On_Off"0"    Mou_FreezeVert"Off" 
  148.         Mou_FreezeHorz_On_Off       Mou_FreezeHorz"Tog" 
  149.         Msc_HoldQuals_On_Off"1"     Msc_HoldQuals"On"   
  150.         Msc_Speak_On_Off"0"         Msc_Speak"Off"  
  151.         Msc_Keys_On_Off""           Msc_FreezeKeys"Tog"
  152.         Msc_Debug_On_Off"1"         Msc_Debug"On"   
  153.  
  154. Because no argument is the same as 'Tog', and because prefixes are not
  155. always required, and because keywords are case insensitive, 
  156. 'Clk_Clock"Tog"' is equivalent to 'clock'.
  157.  
  158. Macro Names
  159. -----------
  160.  
  161. The following functions previously accepted only a macro name. They now
  162. can accept wildcards.
  163.  
  164.     Mac_Execute_Named"name"
  165.     Mac_Delete"name"
  166.     Msc_Set_Flags"xx,name"
  167.  
  168. Example:
  169.  
  170.         Mac_Execute_Named"test#?" beep"5"
  171.  
  172. This will queue up all macros that have a name beginning with 'test'. When
  173. the queued macros have executed, this macro will continue at the 'beep"5"'.
  174. This has the potential to be quite dangerous - USE WITH CAUTION! 
  175.  
  176. Msc_Set_Flags has been changed slightly. Previously it actually toggled 
  177. the desired flag. Now it sets it unless a third argument of '0' is 
  178. supplied. Example:
  179.  
  180.         Msc_Set_Flags"40,#?,0"
  181.  
  182.     This clears the 'Disabled' flag in all macros.
  183.  
  184.         Msc_Set_Flags"80,#?"
  185.  
  186.     This sets the 'Write Protected' flag in all macros.
  187.  
  188. Msc_Beep
  189. --------
  190.  
  191. Beep and Key Click each have a volume setting in 'Miscellaneous Features'.
  192. The Beep volume can be over-ridden by a second argument to Msc_Beep.
  193.  
  194.         Msc_Beep"1,64"          one beep, full volume.
  195.         Msc_Beep"2,32"          two beeps, half volume.
  196.         Msc_Beep",64"           one beep, full volume.
  197.  
  198. Mac_Macros and Msc_Suspend
  199. --------------------------
  200.  
  201. When either of these functions are executed and disable macros or suspend
  202. MachV, the SAME hotkey must be used to re-enable.
  203.  
  204. =========================================================================
  205. New Functions
  206. -------------
  207.  
  208.         Msc_Meter
  209.         Msc_PutMsg_ARexx
  210.         Msc_Send_Upkeys
  211.         Msc_Status
  212.         Msc_Trace
  213.         Set_Variable
  214.         Win_Wait_Window
  215.         Win_Window_Open
  216.  
  217. Msc_Meter
  218. ---------
  219.  
  220. Turn the meter on or off. The meter can now be used to measure time if the
  221. rate is set to 0. You may have the meter on in different configurations 
  222. and keep track of how much time you spend in each configuration or program.
  223. Time is not counted when the screen is blanked, but online costs are.
  224.  
  225.         Msc_Meter"On"
  226.         Msc_Meter"Off"
  227.         Msc_Meter"Tog"
  228.  
  229. Msc_PutMsg_ARexx
  230. ----------------
  231.  
  232. Send a command directly to an ARexx port. With this function, you can avoid
  233. using 'run rx command'. This function is synchronous! It will not return
  234. until replied to by the receiving process.
  235.  
  236.         Msc_PutMsg_ARexx"PORTNAME,command"
  237.  
  238. Examples:
  239.  
  240.         Msc_PutMsg_ARexx"TURBOTEXT0,openfile ${ttxfile}"
  241.  
  242.         Msc_PutMsg_ARexx"EMACS1,(fill-paragraph nil)"
  243.  
  244.         Msc_PutMsg_ARexx"rexx_ced,cedtofront"
  245.  
  246. Note new 3rd argument documented in fixes.doc. Briefly, if supplied, the 
  247. message to the ARexx port will request a result and use that argument as 
  248. the name of an environment variable to store it.
  249.  
  250. Msc_Send_Upkeys
  251. ---------------
  252.  
  253. Set, clear or toggle the 'Send Up Keys'  flag. When set, an up key message
  254. is sent for each key down that is sent from a macro. This doubles the time
  255. required to send keystrokes, but some programs expect to receive key up
  256. messages.
  257.  
  258.         Msc_Send_Upkeys"On"
  259.         Msc_Send_Upkeys"Off"
  260.         Msc_Send_Upkeys"Tog"
  261.  
  262. Msc_Status (from ARexx only)
  263. ----------
  264. Check the condition of various flags with:
  265.  
  266.         Msc_Status"N"
  267.  
  268.     "N" may be one of the following:
  269.  
  270.     sunmouse          0         splines           14        
  271.     keyactivate       1         quick blank       15
  272.     mouse to menu     2         speak messages    16
  273.     menu wrap         3         debug             17
  274.     window cycle      4         button swap       18
  275.     auto poptop       5         hold quals        19
  276.     keyclick          6         hotkeys enabled   20
  277.     clock             7         send up keys      21
  278.     vertical clock    8         nocapslock        22
  279.     clock top window  9         remove lf         23
  280.     clock float       10        crlf              24
  281.     clock gadgets     11        freeze vert       25
  282.     seconds           12        freeze horz       26
  283.     meter             13        keysoff           26
  284.  
  285.  
  286.     Msc_Status returns a '1' in the ARexx variable RESULT if the flag is 
  287.     set. Example:
  288.  
  289.         address 'MACHV' 'status"17"'
  290.         if RESULT = 1 then 
  291.             say 'debugging is on'
  292.         else
  293.             say 'debugging is off'
  294.  
  295. Msc_Trace
  296. ---------
  297.  
  298. As a debugging aid, you can have each macro dumped as it executes to a
  299. console window or serial port. This is not to be confused with 'Debug'
  300. which runs SetMachV when an error is detected. Select 'Trace Serial' and 
  301. 'Trace Console' in the 'Miscellaneous Features' window, or set it with the 
  302. Msc_Trace function.
  303.  
  304.         Msc_Trace"Tog,S"    Toggle serial tracing.
  305.         Msc_Trace"Tog,C"    Toggle console tracing.
  306.  
  307.         Msc_Trace"off,S"    Serial tracing off.
  308.         Msc_Trace"off,C"    Console tracing off.
  309.  
  310.         Msc_Trace"on,S"     Serial tracing on.
  311.         Msc_Trace"on,C"     Console tracing on.
  312.  
  313. As each function is executed, the remaining portion of the macro will be
  314. sent. If you executed the macro 'win_back_to_front win_activate"T"', you
  315. will see:
  316.  
  317.         win_back_to_front win_activate"T"
  318.         win_activate"T"
  319.  
  320. Console Tracing
  321.  
  322. A window will be opened for output. This window will close when a 
  323. Msc_Trace function turns off tracing. Pressing Ctrl-C will remove MachV.
  324.  
  325. Serial Tracing
  326.  
  327. Output will be sent to the serial device at whatever rate you have
  328. selected by 'Prefs/Serial' or your terminal program. You can run a
  329. terminal program to receive this output.
  330.  
  331.  
  332. Set_Variable
  333. ------------
  334. Environment variables may be set with this function:
  335.  
  336.         Set_Variable"test,abcd"     Set the variable 'test' to 'abcd'
  337.  
  338.         Set_Variable"test,"         Deletes the variable 'test'
  339.  
  340. See below for more information.
  341.  
  342. Win_Wait_Window
  343. ---------------
  344.  
  345. A macro can wait for a window to become active before continuing. This
  346. is better than using a pause function which may wait too long or little.
  347. MachV continues to function normally while waiting, but you should not
  348. call another wait function before it returns.
  349.  
  350.     The title can be an AmigaDos pattern if desired. Example:
  351.  
  352.         win_send_menu"A,Quit" wait_window"AppTitle#?" "O"
  353.  
  354. This sends a menu selection of 'Quit' to the active window, waits for a
  355. window titled 'AppTitle...' to become active, then sends the letter 'O' 
  356. (which may simulate clicking on an 'Okay' gadget).
  357.  
  358. When wait_window returns, it still may not be safe to do a function like
  359. send_menu - the menu strip or user port may not be set yet. These cases
  360. are especially likely if other tasks are also running. You may follow the
  361. window title with a 'U' or 'M' or both. When the desired window becomes
  362. active, MachV will wait until the menu or port is set, or upto 2 seconds.
  363. The order of 'U' or 'M' does not matter.
  364.  
  365.         wait_window"$terminus1,U,M"
  366.  
  367. The maximum waiting period may also be changed (1 - 9 seconds):
  368.  
  369.         wait_window"$Workbench,M,U,4"
  370. or
  371.         wait_window"$Workbench,M,,5"
  372.  
  373. A program may still change a menu strip or user port after wait_window 
  374. returned but before you could send a message. A pause may be necessary:
  375.  
  376.         wait_window"Serial,U" pau_seconds".5" "bbo"
  377.  
  378. This will wait for the window 'Serial' to become active, then the user port
  379. to be set, then it will pause for .5 seconds, then send the keystrokes
  380. 'bbo'.
  381.  
  382. You can match an untitled window by using two vertical bars in the title. 
  383. e.g. wait_window"||"
  384.  
  385. Abort a wait_window function by pressing ESC.
  386.  
  387. Note that this returns when the desired window becomes active or immediately
  388. if it is already active. 
  389.  
  390. Win_Window_Open
  391. ---------------
  392. Test to see if a window is open:
  393.  
  394.         Win_Window_Open"title"
  395.  
  396.     This returns a '1' in the ARexx variable RESULT if the window is open.
  397.  
  398. =========================================================================
  399. Comments
  400. --------
  401.  
  402. Comments may be placed between functions by enclosing them within /* */.
  403.  
  404.         Mou_XY"340,110" /* move to next gadget */ Mou_lbd Mou_lbu
  405.  
  406. =========================================================================
  407. ARexx
  408. -----
  409.  
  410. Macros sent to MachV from ARexx programs may now be executed synchronously
  411. or asynchronously. An asynchronous macro will return before it has actually
  412. begun execution. To do this, simply prefix the macro with a "0". Examples:
  413.  
  414.         address 'MachV' 'clk_clock"off"'      synchronous
  415.  
  416.         address 'MachV' '0 clk_clock"off"'    asynchronous
  417.  
  418. When this is executed from the shell, the prompt will return immediately:
  419.  
  420.         address 'MachV' '0 pau_seconds"3" clk_clock"off"'
  421.  
  422. As many macros as you wish may be sent to MachV. They will be executed in
  423. turn.
  424.  
  425. =========================================================================
  426. Macro Toggling
  427. --------------
  428.  
  429. The vertical bar "|" used to separate a macro in half now can separate into
  430. more sections. Each section will be executed in turn. For example, when this
  431. macro is executed the first time,
  432.  
  433.         win_send_menu"A,Icon" | win_send_menu"A,Name" | 
  434.         win_send_menu"A,Date" | win_send_menu"A,Size" 
  435.  
  436. the menu selection with the text "Icon" will be sent to the active
  437. window. The next time, the "Name" selection will be sent, and so on.
  438.  
  439. This macro can be useful - it alternately sends ctrl-s and ctrl-q which
  440. can start and stop output to the shell or in a term program.
  441.  
  442.         "\Cs" | "\Cq"
  443.  
  444. =========================================================================
  445. Auto Execution
  446. --------------
  447.  
  448. There is an "Auto Execute" flag in the "Flags" window. This gets set when
  449. you enter an Exe_Auto macro or you may set it yourself. A macro need not
  450. have Exe_Auto if this flag is set, but it does need the time.
  451.  
  452.         "03:30" exe_cmd"run updatedb sys: dh0: dh1:"
  453.  
  454. This will execute at 3:30am if the "Auto Execute" flag is set.
  455.  
  456. The flag must be set or the macro will not execute, even if exe_auto is
  457. included.
  458.  
  459. If you have other configurations, be sure that you also set the 'Global'
  460. flag.
  461.  
  462. =========================================================================
  463. No Execute Message
  464. ------------------
  465.  
  466. If this flag is set, the message "Executing Macro" will not be displayed
  467. in the clock when that particular macro is being executed.
  468.  
  469. =========================================================================
  470. Text Pasting
  471. ------------
  472.  
  473. The 'Char Burst' option has been eliminated. In its place, you may choose
  474. to not have up keys sent. Up keys are not normally required but programs 
  475. have the right to expect that when it receives a key pressed, it will also
  476. receive a key up. In 'Clip Features', you may select 'Send Up Keys'. You
  477. may also set, clear or toggle this with the macro function Msc_Send_Upkeys.
  478.  
  479. =========================================================================
  480. Clip Viewer
  481. -----------
  482.  
  483. When the clipboard viewer is open and Clp_View is run a second time, the
  484. viewer will close and reopen on the front screen. Previously, it would
  485. bring the screen it was on to the front.
  486.  
  487. =========================================================================
  488. Variables
  489. ---------
  490.  
  491. Environment variables can now be used as function arguments or output
  492. as text. These can be set with the PAU_FIX_INPUT and PAU_VAR_INPUT 
  493. functions, the SET_VARIABLE"name,value,optional flags" function, or,
  494. if using global variables, from the shell using "setenv name value".
  495.  
  496. A special variable "MachVar" is set when an icon is dropped into the
  497. clock. The variable will be set to the fully qualified name of the icon.
  498. This variable is local to MachV. 
  499.  
  500. Environment variables can be either global - accessible from anywhere,
  501. or local - accessible only from MachV. 
  502.  
  503. The variable format is ${varname}. This will expand to the value of
  504. varname when the function executes. For example, if "window" was set
  505. to "Workbench", this would bring it to the front:
  506.  
  507.         Win_To_Front"${window}"
  508.  
  509. Possible uses:
  510. --------------
  511.  
  512.         Pau_Fix_Input"1,clipunit"  Clp_Paste"${clipunit}"
  513.  
  514. This pauses for you to enter one number. That number is then set to the
  515. variable "clipunit" which is then used as an argument for Clp_Paste.  Using
  516. this as a macro, you can paste from clipboard units 0 - 9.
  517.  
  518.         pau_var_input",file"  exe_cmd"${editor} ${file}"
  519.  
  520. This pauses for a variable number of keystrokes which are stored in the 
  521. variable "file" when you press ESC. The program whose name is stored in 
  522. "editor" is then run using the file name as an argument. Note the ',' in  
  523. ",file". The first argument (abort key) is optional, it defaults to ESC 
  524. (hex 45). This could have been written:
  525.  
  526.         pau_var_input"45,file"
  527.  
  528. During a pau_var_input or pau_fix_input function, characters are
  529. displayed in the clock as they are entered. Ctrl-H may be used to
  530. correct mistakes.
  531.  
  532. Note that the variable name is used without the ${} when using it as an 
  533. argument in a setting type function. If ${} were used, then the value of 
  534. the variable would be used instead.
  535.  
  536. Global and Local
  537. ----------------
  538.  
  539. In the 'Miscellaneous Features' window you may set certain parameters used
  540. by MachV when handling variables. If "Local/Global Vars" is selected then
  541. expanding a variable will first try a local variable and then a global
  542. variable. You could instead select either "Global Only Vars" or "Local Only
  543. Vars". Both Pau_Fix_Input and Pau_Var_Input functions and the Set_Variable
  544. can accept a third argument which is the hexidecimal representation of
  545. these flags.
  546.  
  547.     The values for these flags are:
  548.  
  549.     Local then global   -  0
  550.     Global Only         -  100
  551.     Local Only          -  200
  552.     Save Var            -  1000
  553.  
  554.         Set_Variable"test,abcd,1100"
  555.  
  556. This would set global variable "test" to "abcd" and also save it to 
  557. ENVARC:. Only global variables may be saved.
  558.  
  559.         Pau_Var_Input"45,test,100"
  560.  
  561. Waits for variable length input terminated with ESC (45) and then sets
  562. the global variable 'test' to that input.
  563.  
  564. Also in the 'Miscellaneous Window', you may select "Save Vars". This will
  565. cause all global variables to be saved to ENVARC: when a Pau_ or
  566. Set_Variable function is used.
  567.  
  568.     From within text in a macro:
  569.  
  570.         "This is the contents of var is ${var}"
  571.         "This is the username environment var ${username}"
  572.  
  573.     To use ${} without expanding it, you must escape the $ with a \.
  574.  
  575.         "This is the variable \${var}"
  576.  
  577. Using variables lets you change a setting in just one place. For
  578. example, in your user-startup file you could set an overscan width
  579. variable:
  580.  
  581.         SetEnv OverScanW 680
  582.  
  583.     And then use it in your NewShell command:
  584.  
  585.         exe_cmd"NewShell con:0/0/${OverScanW}/200/Shell"
  586.  
  587.     Or,
  588.  
  589.         SetEnv shell NewWShell
  590.  
  591.         exe_cmd"${Shell} con:0/0/${OverScanW}/200/${Shell}/CLOSE"
  592.  
  593.     Or for AUSH,
  594.  
  595.         SetEnv shell "NewAUSH WINDOW"
  596.  
  597.         exe_cmd"${Shell} con:0/0/${OverScanW}/200/Shell/CLOSE"
  598.  
  599. =========================================================================
  600. Clocks
  601. ------
  602.  
  603. The method used to select the screen that the clock can go on has been
  604. changed. Previously you would select one of "Workbnch", "Any Screen" or
  605. "Top Screen". Now you can enter an AmigaDos wild card pattern into a
  606. string gadget. This tells MachV what screens the clock can or can't go
  607. to. For example, #? will allow the clock to move to any screen. ~(Final
  608. Copy#?) will let the clock move to any screen except one titled "Final
  609. Copy...".
  610.  
  611. You may specify a screen with no title by using two vertical bars ||.
  612. (#?||) will match any screen with or without a title.
  613.  
  614. If there is no screen title, you may also match by the name of the
  615. program that owns a window on the screen. Preface the title with $.
  616. Example:
  617.  
  618.         $dh0:paint/dpaint
  619.  
  620. The $ cannot be used inside patterns. It must be the first character in
  621. the string.
  622.  
  623. Seconds
  624. -------
  625.  
  626. You select "Sec." in "Clock Features" to display seconds in the time.
  627.  
  628. Gadgets
  629. -------
  630.  
  631. If you have more than one configuration, macros in the first
  632. configuration that are marked as 'Clock Gadget' and 'Global', and are
  633. not attached to a hotkey (they are 'NO KEY') will display the gadget
  634. in other configuration clocks.
  635.  
  636. When an unkeyed macro is deleted, if there are gadgets in the clock the
  637. clock gadgets IDs will be updated.
  638.  
  639. AppWindow
  640. ---------
  641.  
  642. The clock is now (finally!) an AppWindow if opened on the Workbench.
  643. Icons dropped into this window will set the local environment variable
  644. "MachVar" to the fully qualified name of the icon. If multiple icons are
  645. dropped, the variable will contain all names separated by a space. e.g.
  646.  
  647.         dh0:src/app/main.c ram:readme
  648.  
  649. This may be very useful when used with a macro (which may have a gadget)
  650. such as:
  651.  
  652.         Exe_Cmd"view80 ${MachVar}"
  653.  
  654. You may want to delete this variable afterwards:
  655.  
  656.         Exe_Cmd"view80 ${MachVar}" Set_Variable"MachVar,"
  657.  
  658. Borders
  659. -------
  660.  
  661. In "Clock Features", you may select "Right Border", "Bottom Border" or
  662. "Borderless". These affect only clocks that have gadgets.
  663.  
  664. Right Border  -  The size gadget uses the right border. 
  665. Bottom Border -  The size gadget uses the bottom border. 
  666. Borderless    -  The clock has no border.
  667.  
  668. =========================================================================
  669. QEdit
  670. -----
  671.  
  672. 1.  QEdit displays <empty> for null macros. 
  673.  
  674. 2.  Auto executing macros do not get displayed in QEdit. 
  675.  
  676. 3.  ARexx macros will not be kept in your configuration if you press
  677.     <Return> while it is in the QEdit gadget. Previously you had the
  678.     delete the macro before pressing <Return>.
  679.  
  680. 4.  When the QEdit window opens, it will display the last macro edited.
  681.  
  682. =========================================================================
  683. Mouse
  684. -----
  685.  
  686. You can set the middle mouse button to any qualifier or combination of
  687. qualifiers in the 'Miscellaneous Features' window. Simply select the
  688. desired check boxes. This replaces the function 'Set_Key' which has been
  689. removed.
  690.  
  691. Note that you can still set the middle button to any other key by
  692. creating a macro for it.
  693.  
  694. SunMouse, Click To Front, Window Cycle etc.
  695. -------------------------------------------
  696.  
  697. Most mouse options now also have a string gadget which lets you choose
  698. what windows to allow that particular option to operate on. A rather
  699. useful one is to set the SunMouse string to '~(MachV#?)'. This will
  700. prevent the SunMouse from activating the clock window. Using '$Workbench'
  701. will allow the option to operate only on windows owned by Workbench.
  702.  
  703. =========================================================================
  704. SetMachV
  705.  
  706. 1.  SetMachV uses a list requester when you want to select configurations.
  707.     This is easier to use as it adjusts its height to the number of 
  708.     configurations.
  709.  
  710. 2.  Functions in the "Help" window are in lower case unless you hold
  711.     <Shift> while pressing or clicking on "Help".
  712.  
  713. 3.  Press <Shift-P> to cycle backwards through the help.
  714.  
  715. 4.  SetMachV displays <empty> for null macros.
  716.  
  717. 5.  'Print Macros' now is an external program that is run when you click
  718.     on the gadget. This can also be run from the shell. SetMachV will
  719.     look for it in the same directory as SetMachV is in. See the code 
  720.     PrintMacros.c for more details.
  721.  
  722. 6.  The volume for 'Key Click' and 'Beep' can be set in the 'Miscellaneous 
  723.     Features' window. Valid values range from 0-64.
  724.  
  725. 7.  The input handler priority can be set in the 'Miscellaneous Features'
  726.     window. Valid priorities are 51 - 127. 55 is recommended, but if you
  727.     have other programs with their own input handler, you may want to 
  728.     change this. Changes will not take effect until you save and run MachV 
  729.     again. Note that this is NOT the same thing as task priority. This is
  730.     the priority of the handler that intercepts input before intuition has
  731.     a chance to see it. It must be set above intuition which is 50.
  732.  
  733. 8.  Most buttons and check boxes have keyboard equivalents. Because of this,
  734.     pressing of say, 'M' will open the 'Mouse Features' window, but pressing
  735.     it again will not close it like in previous versions.
  736.  
  737. 9.  In order to avoid confusion, configurations will not change automatically
  738.     when SetMachV is open and running.
  739.  
  740. 10. New gadget added in 'Clock Features' to change clock borders. See above.
  741.  
  742. 11. MachV will look first for SetMachV then it will try SetMachV.020.
  743.  
  744. 12. Function name completion is now provided. When entering a function in
  745.     the macro string gadget, pressing <Alt-Tab> will complete the entry
  746.     for you. If what you have entered is ambiguous, a window with possible
  747.     completions is opened. You may then select the desired function by
  748.     pressing the associated letter. You may also press <Return> or click
  749.     on the close gadget to close the window.
  750.     Text entered will be in the same case as you entered. If you typed:
  751.  
  752.         win_to_f<Alt-Tab>
  753.  
  754.         win_to_front
  755.  
  756.     will be entered. If you entered:
  757.  
  758.         Msc_D<Alt-Tab>
  759.  
  760.         Msc_Debug
  761.  
  762.     will be entered. If you entered:
  763.  
  764.         MSC_B<Alt-Tab>
  765.  
  766.         MSC_BLANK_SCREEN
  767.  
  768.     will be entered. 
  769.  
  770.     Functions that do not require the 3 letter prefix may also be completed
  771.     using this method.
  772.  
  773.         z<Alt-Tab>
  774.  
  775.     expands to:
  776.  
  777.         zoom_window
  778.  
  779. 13. "Copy" now copies the flags as well as the macro and name.
  780.  
  781. 14. SetMachV has a new gadget, "Select Title" in the configurations section
  782.     (upper right corner). Clicking on it will bring up a list box with all
  783.     available window titles, screen titles and program names. Selecting one
  784.     of these will insert it into the configuration title string gadget. 
  785.     This replaces the programs AllTitles and AllTasks.
  786. =========================================================================
  787.  
  788.