home *** CD-ROM | disk | FTP | other *** search
/ MacWorld: Complete Mac Interactive / Macworld Complete Mac Interactive CD)(1994).iso / The Best of BMUG / Utilities / Text and Speech / Alpha.5.76 / Help / Alpha Commands next >
Encoding:
Text File  |  1994-03-08  |  27.8 KB  |  561 lines  |  [TEXT/ALFA]
  1. ==============================================================================
  2. = Alpha Commands 
  3. ==============================================================================
  4.  
  5. In this list of routines, text between '<' and '>' is a placeholder for a 
  6. required parameter, text between '[' and ']' is a placeholder for an 
  7. optional parameter, and the '|' signifies a choice of two or more 
  8. alternatives.  A '+' signifies that the previous symbol can be present one 
  9. or more times, while a '*" means zero or more times.  Some commands have no 
  10. parameters, and are only expected to be called interactively.
  11.  
  12.  
  13.  
  14. The following are Alpha-specific tcl routines:
  15.  
  16. • abortEm - aborts whatever is currently happening
  17. • addMenuItem [-m] [-l <meta-characters>] <menu name> <item name> - Convert
  18.   item to menu form and add to specified menu. If '-m' specified, menu 
  19.   form conversion not done. The '-l' option allows you to use menu meta 
  20.   characters as text of menu items. If the '-l' option is used, the 
  21.   <meta-characters> string is interpreted for menu item attributes, and 
  22.   meta-characters in <item name> are included in the menu item text 
  23.   literally. For example: 
  24.       addMenuItem -m -l "/B" "Hello/C" 
  25.   would appear as the text "Hello/C" in the menu, and have "B" as its 
  26.   command equivalent.
  27. • AEBuild <app name> <aesuite> <action> <build spec> - Build and send an 
  28.   apple-event. 'AEBuild' is apple's code of the same name. The syntax of 
  29.   this command will change. However, feel free to play with it as is.
  30. • alertnote message_string
  31.   This command will display message_string in a standard Macintosh alert box.
  32. • alphaHelp - display Alpha help.
  33. • ascii (see bindings).
  34. • askyesno prompt
  35.   This command will display a Macintosh alert box with 'prompt' displayed
  36.   with the push buttons Yes and No. The command will return the 
  37.   string "yes" or "no".
  38. • backColor - set background color
  39. • backwardCharSelect - extends selection one char back
  40. • backwardChar - moves insertion one char back
  41. • backwardDeleteWord - deletes previous word
  42. • backwardWord - moves insertion one char back
  43. • balance - selects smallest set of parens, braces, or 
  44.   brackets that encloses the current selection
  45. • beep
  46. • beginningBufferSelect - extend selection to the 
  47.   beginning of the buffer
  48. • beginningLineSelect - extend selection to the 
  49.   beginning of the line
  50. • beginningOfBuffer - move insertion to the beginning 
  51.   of the buffer
  52. • beginningOfLine - move insertion to the beginning of 
  53.   the line
  54. • bind  (see bindings)
  55. • blink <pos> - blink cursor at 'pos'
  56. • breakIntoLines <string> - return 'string' with 
  57.   carriage returns and spaces inserted to satisfy 
  58.   'leftFillColumn' and 'fillColumn' variables.
  59. • bringToFront <winName> - Bring named window to front.
  60. • capitalizeRegion - capitalize all words in selected 
  61.   region 
  62. • capitalizeWord - capitalize word
  63. • cd [directory]
  64.   This command will set the current working directory to "directory". The directory 
  65.   argument may or may not end with a colon. The working directory is the directory 
  66.   in which file names that contain no colons (folders) will be located with file related 
  67.   commands. No argument means Alpha's home directory.
  68. • centerRedraw - redraw window with current line in 
  69.   the middle.
  70. • clear - clear selected text
  71. • closeAll - close all windows
  72. • colorize <fromPos> <toPos> <black blue cyan green green magenta red white yellow> -
  73.   Change the color of the specified region. 
  74. • colors <fore red> <fore green> <fore blue> <back red> <back green> <back blue>
  75. • copy - copy region
  76. • cp <fromName>+ <toName>
  77.   This command will copy the file fromName and name the new file toName, 
  78.   overwriting any existing file. This command copies both data forks, and 
  79.   the Finder information. 
  80. • createTagFile - searches all files in current file set 
  81.   and saves the locations of any function declarations
  82.   in a file called 'cTAGS'.
  83. • createTMark <name> <pos> - create a temporary 'mark' 
  84.   at location 'pos'. 
  85. • currentPosition - displays current and total bytes.
  86. • cut - deletes and saves region
  87. • deleteChar - delete char AFTER cursor
  88. • deleteMenuItem [-m] <menu name> <item name> - Convert item to menu form 
  89.   and delete from specified menu. If '-m' specified, menu form conversion 
  90.   not done. 
  91. • deleteSelection - delete current position, don't save
  92. • deleteWord - delete word after cursor
  93. • describeBinding - display the binding of the next typed key sequence. 
  94. • deleteText <pos1> <pos2> - remove text between 'pos1' 
  95.   and 'pos2'
  96. • displayMode <mode> - Up to four characters of the 'mode' string are 
  97.   displayed in the status line at the bottom of a window.
  98. • dosc [<-c 'sign' | -n appName>] [-k 'clas'] [-e 'evnt'] <-s string | -f fileName> [<-t timeout|-r>]
  99.   Send an AppleEvent, by default class 'misc', event 'dosc'.
  100.    -c 'sign' 
  101.            "sign" is a four-letter creator signature of a running application.
  102.    -n appName
  103.            "appName" is the name of a running application.
  104.    -k 'clas'
  105.            "clas" is a four-letter event class.
  106.    -e 'evnt'
  107.            "evnt" is a four-letter event class.
  108.    -s string
  109.            "string" is the text of a script to send to the other app.
  110.    -f fileName
  111.            "fileName" is the complete or relative pathname of a file the other 
  112.            application should execute.
  113.    -t timeout
  114.            "timeout" is the number of ticks Alpha should wait for a response. A 
  115.            timeout of "0" means wait forever.
  116.    -r
  117.            Do not wait for reply.
  118.    If neither of the '-c' and '-n' options is chosen, the PPC Browser is 
  119.    used. Either '-s' or '-f' must be chosen. Thus, you can have "Alpha 
  120.    5.02" and "Alpha 5.02 Copy" sending Apple events to each other, or they 
  121.    can send events to a remote server such as Apple's ToolServer. 
  122.    "$HOME:Tcl:UserCode:createStuffitArchive.tcl" contains examples of 
  123.    controlling Stuffit Deluxe via this command.
  124. • downcaseRegion - changes all uppercase letters to 
  125.   lowercase in current region
  126. • downcaseWord - changes all uppercase letters to 
  127.   lowercase in current word
  128. • dumpColors - dump current foreground and background
  129.   colors into the current buffer in Alpha-readable
  130.   format.
  131. • dumpMacro - prompts for a name and then dumps a tcl proc representation 
  132.   of the current keyboard macro into the current window.
  133. • echo <string>* - echo the strings (used 
  134.   in shells).
  135. • edit <name> [-r] [-m] - Open a file in a new window. '-r' means open 
  136.   the file read-only. '-m' means omit the function titlebar menu and  
  137.   present only the marks titlebar menu, which is labeled with the 
  138.   contents of 'markLabel'.
  139. • endBufferSelect - extend selection to the end of the 
  140.   buffer
  141. • endKeyboardMacro - stop recording keyboard macro
  142. • endLineSelect - extend selection to the end of line
  143. • endOfBuffer - move insertion to the end of the buffer
  144. • endOfLine - move insertion to the end of the line
  145. • exchangePointAndmark - exchange the current 'mark' 
  146.   w/ the current insertion point
  147. • execute - prompt user for a function or macro. The 
  148.   tab key acts as a "completion" command.
  149. • executeKeyboardMacro - execute the current keyboard 
  150.   macro
  151. • fileInfo - prompts for a file, and displays type, 
  152.   creator, sizes of both data and resource forks, last
  153.   modification time, and creation time
  154. • fileRemove - prompts for a file, and removes it
  155. • findTag - prompt user for a function name and attempt 
  156.   to use the file 'cTAGS' to locate the function's 
  157.   definition
  158. • find - bring up the find dialog
  159. • findFile - open a file in a new window
  160. • foreColor - set foreground (text) color
  161. • forwardCharSelect - extend selection one character 
  162.   forward
  163. • forwardChar - move insertion one character forward
  164. • forwardWord - move insertion one word forward
  165. • freeMem - give a rough approximation of the current 
  166.   memory reserves of ALPHA
  167. • get_directory
  168.   This command will display a standard Macintosh file dialog and request the user 
  169.   select a folder. The command will return the selected folder's full path name, or an 
  170.   empty string if the Cancel button was selected.
  171. • getAscii - displays the ASCII code for character at 
  172.   current insertion point
  173. • getfile <prompt>
  174.   This command will display an SFGetFile() and return the full path name of the 
  175.   selected file, or an empty string if CANCEL button was selected.
  176. • getfinfo <fileName>
  177.   This command will display the standard Macintosh file information in the form:
  178.   "'aeQL' 'QUIL' lvbsIdm 02/17/92 23:57:12 02/19/92 22:43:36 0,156 219 0".
  179.   The fields are the fdCreator, fdType, fdFlags, flCreationDate, flCreationtime, 
  180.   flModDate, flModTime, fdLocation.H,V, dataForlLength, rsrcForkLength, 
  181.   respectively. The fdFlags field uses characters to represent bits:
  182.     l/L    not locked/Locked
  183.     v/V    visible/notVisible
  184.     b/B    not bundled/Bundled
  185.     s/S    not system/System
  186.     i/I    not initialized/Initialized
  187.     d/D    not desktop/Desktop
  188.     m/M    not sharable/sharable
  189. • getGeometry - return a TCL list containing the left 
  190.   edge of the current window, the top, the width, and
  191.   height.
  192. • getline <prompt> <default>
  193.   This command will display a Macintosh alert box with prompt displayed, a 
  194.   text edit field with default initially in the field, and with the push 
  195.   buttons OK, Cancel.. The command will return the text entered into the 
  196.   text edit field by the user, or an empty string if the user selected the 
  197.   Cancel button. 
  198. • getMainDevice - return a list containing the left, top, right, and 
  199.   bottom of the rectangle defining the main device.
  200. • getMark - return the current mark.
  201. • getPathName - prompt the user with an SFGetFile dialog and return 
  202.   complete pathname.
  203. • getPos - return the current insertion point
  204. • getScrap - returns system TEXT scrap.
  205. • getSelect - return the currently selected text, if 
  206.   any.
  207. • getTMarks - Return a list of temporary marks. Each item of the returned 
  208.   list is a sublist containing the mark name, the complete pathname of the 
  209.   mark, and the start and finish of the selection named by the mark. The 
  210.   following is an example of the result: 
  211.  
  212.     {{temp1 External:file.c 1312 1315} {temp2 Internal:it.h 111 111}} 
  213.  
  214. • getText <pos1> <pos2> - return the text between 'pos1' 
  215.   and 'pos2'.
  216. • glob [-i] [-t <TYPE>] [-c <CRTR>]
  217.   The original glob provided by the UNIX version of tcl was not quite 
  218.   adequate for the more complex Macintosh file system. Issues such as 
  219.   invisible file handling, Finder type and creator filtering, and space 
  220.   handling in file names. Release 6 of tcl has dealt with the original 
  221.   problem with spaces in filenames, but the following options are provided 
  222.   to deal with additional Macintosh issues. 
  223.  
  224. Anyway, the new glob now takes several options. They are:
  225.     -i    This option causes glob to list invisible files also.
  226.     -t TYPE    This option causes glob to only list file with the 
  227.         indicated Finder file typeTYPE. This option may be 
  228.         used with the -c option.
  229.     -c CRTR    This option causes glob to only list file with the 
  230.         indicated Finder file creatorCRTR. This option may 
  231.         be used with the -t option.
  232.         Also note that the original glob would skip dot files
  233.         (i.e., file names the begin with a period) 
  234.         in the listing, unless the pattern began with a period.
  235.         Tickle extends this concept one step further on the
  236.         Macintosh, and skips spot files (i.e., file names that 
  237.         begin with '•'), unless the pattern starts with a spot.
  238. • goto <pos> - goto the position 'pos'.
  239. • gotoLine - go to a line number
  240. • gotoMark - goto named mark, use 'mark' in macros.
  241. • gotoTMark <name> - goto the temporary mark 'name'.
  242. • enableMenuItem <menuName> <item text> <on|off> - Either enable or 
  243.   disable the menu item of user menu 'menuName' that has text '<item 
  244.   text>'. Note that unless the menu is not only created, but also already
  245.   inserted, this command has no effect. 
  246. • icon [-f <winName>] [-c|-o|-t|-q] [-g <h> <v>] - Having to do w/ 
  247.   iconifying windows. '-c' means close (iconify) window, '-o' open, '-t' 
  248.   toggle open/close, '-q' returns either a '1' for an iconified window or a 
  249.   '0' for an uniconified window, and '-g' moves the icon to horizontal 
  250.   position <h> and vertical position 'v'. Options are executed as they 
  251.   are parsed, so the '-f' option, if present, should always be first. 
  252. • includeFile - expand the current selection to include 
  253.   the suffix and use the var 'includePath' to try to 
  254.   find the include file. 
  255. • indentLine - semi-intelligent indent. If cursor is
  256.   before first non-white space of line, the line is
  257.   indented and the selection is placed at the start
  258.   of the non-white space text
  259. • insertAscii - prompts for an ASCII code and inserts
  260.   into text.
  261. • insertFile - prompts for a file name and inserts the
  262.   corresponding file into the current window. Not
  263.   undoable.
  264. • insertMenu <name> - insert the previously created user menu 'name' into 
  265.   the menuBar. 
  266. • insertPathName - present the user w/ a SFGetFIle dialog 
  267.   and paste the complete path-name of the chosen file
  268.   into the current window
  269. • insertText [-w <win name>] <text>* - Insert 'text' at the current 
  270.   insertion point.
  271. • insertToTop - make the line that the insertion point 
  272.   is on the first line shown, and display the current 
  273.   line number along w/ the total number of lines in file
  274. • isearch - incremental search: searches w/o a dialog,
  275.   searches as you type the search pattern. Does not do
  276.   regular expression searches. 'matchWords' 
  277.   automatically set to false.
  278. • iterationCount - allows actions to be repeated many times. "option-u 44 
  279.   =" inserts 44 '='s into current window.  Also can be used to execute any 
  280.   function or macro (including the keyboard macro) many times.  Defaults to 
  281.   4.
  282. • keyAscii - insert ascii representation (in decimal)
  283.   of the keydown event, plus a modifier string, if 
  284.   necessary.
  285. • keyCode - insert the key code along w/ a string 
  286.   representing and modifiers into the current window.
  287.   Can be used to create bindings in 'Alphabits'.
  288. • killLine - kill text from insertion point to the end 
  289.   of the line. If the line has no text, delete the line 
  290.   and move succeeding lines up one.
  291. • killWindow - kill current window
  292. • launch -f <name> - launch the named app into the background. Note that 
  293.   for some yet unexplained reason, some applications (MicroSoft Word) 
  294.   won't launch completely in the background. 'launch'ing such 
  295.   applications won't insert the application into any system menu that 
  296.   specifies running applications (although "About the Finder..." will 
  297.   list it. The only way to get to such an app is through Alpha's 
  298.   'switchTo', after which the application will finish launching. The '-f' 
  299.   option gets around this by launching the application in the foreground 
  300.   instead.
  301. • lineStart <pos> - return the position of the start of
  302.   the line 'pos' is on.
  303. • listBindings - list all current bindings.
  304. • listpick [-p <prompt>] <list>
  305.   This command will display a dialog with the list displayed in a List Manager list. If 
  306.   the user presses the Cancel button, an empty string is returned. If the user selects 
  307.   the Open button, or double clicks an item in the list, that item will be returned.
  308. • load - loads hilited text, or entire window if 
  309.   nothing is hilited. 'load'ing means that whatever 
  310.   bindings or macro definitions are present in the 
  311.   loaded text take effect
  312. • lookAt [-w <name>] <pos> - return the 'pos'th character of the 
  313.   current file, or the file named by <name> if the '-w' option is specified.
  314. • makeMenuPermanent <name> - The named menu is no longer deleted from the 
  315.   menubar in response to subsequent 'removeMenu' calls.
  316. • markHilite - This is the 'Hilite' from the 'Edit'
  317.   menu. If there is a currently hilited selection, the 
  318.   selection is unhilited, leaving the mark and the 
  319.   insertion point around the old selection. If there 
  320.   is not a selection, the region between the insertion 
  321.   point and the mark is selected.
  322. • markMenuItem [-m] <menuName> <item text> <on|off> [<mark char>] - Either mark or unmark
  323.   the menu item of user menu 'menuName' that has text '<item text>'. 
  324.   Note that unless the menu is not only created, but also already
  325.   inserted, this command has no effect. 
  326. • matchBrace - moves the insertion point to the 
  327.   character that matches the character after the current 
  328.   insertion point
  329. • matchIt <brace char> <pos> - Return pos of matching brace. Recognizes 
  330.   parenthesis, square brackets, and curly braces.
  331. • maxPos - returns the number of characters in the front
  332.   window.
  333. • menu [-n <name>] [-i <num] [-m] [-p <procname>] <list of menu items> - Defines a 
  334.   new menu named 'name' (if provided w/ '-n' option). The menu is not yet 
  335.   inserted into the menubar. The menu commands may be nested for 
  336.   heirarchical menus, see 'AlphaBits.tcl' for examples. Alpha massages the 
  337.   function names to make them look better in the menus. 
  338.   '-n <num>'    Resource id of icon suite to use for menu title. 'ics#' 
  339.                 is the only resource that is really necessary.
  340.   '-n <name>'    Name the menu. Not necessary for submenus.
  341.   '-m'            No menu form. If not supplied, each menu item is split into 
  342.                   words at each capitalized letter.
  343.   '-p <name>'     The tcl proc named by 'name' is called w/ the menu item's 
  344.                   contents as it's single argument when the item is chosen. If the 
  345.                   proc returns "normal" as its result, the menu item is executed as 
  346.                   if no proc had been specified.
  347. • message <string> - prints 'string' on the status line.
  348. • mkdir <name> - creates a directory (folder) named 
  349.   'name' in the current directory.
  350. • mousePos - Returns list <row,col> of mouse position, if the mouse is 
  351.   currently over the active window. Otherwise, return error (catch w/ 
  352.   'catch').
  353. • moveInsertionHere - move the insertion point to the 
  354.   first line displayed
  355. • moveWin [win name] <left> <top> - moves current or specified window.
  356. • mtime <time> [long|short|abbrev]
  357.   Returns a date and time string using the Macintosh International Utilities. The 
  358.   long/short/abbrev specification corresponds to the date. These are the following 
  359.   formats:
  360.     short        3/16/92 9:20:46 PM
  361.     abbrev    Mon, Mar 16, 1992 9:20:49 PM
  362.     long        Monday, March 16, 1992 9:20:43 PM
  363.   The returned value actually is in the form of a list. To get text as 
  364.   above, run the result through 'join', as in "join [mtime [now] short]".
  365. • moveFile <fromName> <toName>
  366.   This command will move the file fromName to toName, overwriting any 
  367.   existing file. The move can not be made across volume (disk drives) 
  368.   boundaries. 
  369. • new - opens an untitled window
  370. • nextLine - move insertion point to next line
  371. • nextLineSelect - extend selection to the next line
  372. • nextLineStart <pos> - return the position of the start 
  373.   of the next line after position 'pos'.
  374. • nextSentence - go to next sentence ("fill.tcl").
  375. • nextWindow - select next window
  376. • now
  377.   Returns the current time as Macintosh seconds. This is the number of seconds that 
  378.   have elapsed since Midnight Jan 1, 1904.
  379. • oneSpace - converts whitespace surrounding insertion
  380.   into a single space.
  381. • openLine - insert a new line following the current 
  382.   one and move the insertion point to it
  383. • pageBack - display prev screenful, move the
  384.   insertion point if 'moveInsertion' enabled
  385. • pageForward - display next screenful, move the
  386.   insertion point if 'moveInsertion' enabled
  387. • pageSetup - display the printing PageSetup dialog.
  388. • paste - insert the last chunk of text created by 'cut' 
  389.   or 'copy'
  390. • posToRowCol <pos> - converts from absolute position to row, col.
  391. • prefixChar - used to further modify the next keystroke 
  392.   combination, in the same manner as using the shift key 
  393.   in the next keystroke
  394. • prevLineSelect - extend selection to the previous line
  395. • prevSentence - go to previous sentence ("fill.tcl").
  396. • prevWindow - select previous window
  397. • previousLine - move insertion point to the previous 
  398.   line
  399. • print - print front window
  400. • processes - returns info of active processes. A list of lists, each 
  401.   sublist contain a file-name, an application signature, the application 
  402.   memory size, and the number of ticks the application has been active.
  403. • prompt <prompt> <default> [<name> <menu item>*] - prompt dialog to 
  404.   the user with a prompt string and a default value. The prompt dialog can 
  405.   optionally include a popup menu specified by 'name' and the succeeding 
  406.   strings. Selection of the popup menu items inserts the item text into the 
  407.   editable dialog item. 'Prompt' returns the value of the editable item. 
  408.   If the 'Cancel' button is selected, the tcl returns an error and your 
  409.   script will be stopped unless you execute the command from 'catch'.
  410. • putfile <prompt> <original>
  411.   This command will display an SFPutFile() and return the full path name of the 
  412.   selected file, or an empty string if CANCEL button was selected. Original is the 
  413.   default name displayed for the user.
  414. • putScrap [<string>]+ - Concatenate strings together into the system 
  415.   scrap. The scrap can be appended to through calls of the form 'putScrap 
  416.   [getScrap] " another word"'.
  417. • pwd
  418.   This command will return the current working directory.
  419. • quit - quits ALPHA
  420. • rectMarkHilite - creates a rectangular selection 
  421.   between the mark and the insertion point.
  422. • redo - redo the next action that has been undone but 
  423.   not redone
  424. • removeMark - allows marks to be removed.
  425. • removeMenu <name> - remove menu 'name' from menubar, except those 
  426.   specified by previous 'makeMenuPermanent' calls.
  427. • removeTMark <name> - remove temporary mark.
  428. • repeatSearchBackward - repeat search backward
  429. • repeatSearchForward - repeat search forward
  430. • replaceText <pos1> <pos2> [text]+ - replaces the text
  431.   between 'pos1' and 'pos2' with 'text', where 'text' can be any number 
  432.   of arguments. Leaves insertion at end, mark at beginning of inserted 
  433.   text. 
  434. • removeColors [-f <win name>] - remove all colors from window.
  435. • removeFile <fileName>
  436.   This command will delete the file or folder 'fileName'.
  437. • restoreVars - restore variables to saved state, 
  438.   see 'saveVars'
  439. • revert - revert the file to it's last saved version
  440. • rowColToPos <row> <col> - converts to abosolute position.
  441. • rsearch - reverse incremental search, see 'isearch'.
  442. • save - save current window
  443. • saveAs - save current window with new name
  444. • saveVars - save variable state, see 'restoreVars'
  445. • scrollDownLine - same action as that which occurs when 
  446.   the down arrow in the vertical scrollbar is selected
  447. • scrollLeftCol - same action as that which occurs when
  448.   the left arrow in the horizontal scrollbar is selected
  449. • scrollRightCol - same action as that which occurs when
  450.   the right arrow in the horizontal scrollbar is 
  451.   selected
  452. • scrollUpLine - same action as that which occurs when 
  453.   the up arrow in the vertical scrollbar is selected
  454. • search [-f <num>] [-r <num] [-i <num>] [-m <num] [-n] [-l <limit>] [--] <pattern> <pos> - 
  455.   Searches for 'pattern' from position 'pos'.  The '-f', '-r', '-i', and 
  456.   '-m' options allow the 'forward', 'regExpr', 'ignoreCase', and 
  457.   'matchWord' internal variables to be set.  The '-l' option allows a 
  458.   search limit to be set.  The search fails if the a match is not found 
  459.   totally contained between 'pos' and 'limit'.  A '--' option specifies 
  460.   that the flags are finished and that the next arg is the pattern.  The 
  461.   '-n' option specifies that a failed search still returns TCL_OK.  
  462.   However, the result of the call is then just an empty string.  If the 
  463.   search succeeds, a list of two positions will be returned.  The first is 
  464.   the starting position of the match, the second is one past the last 
  465.   character.
  466.  
  467. • enterSelection - use current selection for future searches.
  468. • findInNextFile - search next file.
  469. • replaceAll - replace all further occurrences in the current file.
  470. • replace - replace the current selection
  471. • replace&FindAgain - replace the current selection and find next 
  472.   occurrence.
  473. • select <pos1> <pos2> - selects the text between 'pos1' 
  474.   and 'pos2'.
  475. • selEnd - returns the end of the hilited selection, or 
  476.   the current insertion point if no text is selected.
  477. • sendOpenEvent <-n app name> <file name> - Send an open doc event to 
  478.   another currently running application.
  479. • sendToBack <winName> - Sent named window to back.
  480. • setfinfo <fileName> [-a flags] [-c fdCreator] [-t fdTypes]
  481.   This command will set the standard Macintosh file information. The flags setting 
  482.   must be of the same format as displayed by the getfinfo flag.
  483. • setMark - set the current mark to the insertion point
  484. • setFontsTabs - bring up font and tab dialog
  485. • setNamedMark [name disp pos end] - set named mark. If optional arguments are 
  486.   present, the mark is created with prompting user. 'disp' is the 
  487.   character position of the start of the first line to be displayed, 
  488.   while 'pos' and 'end' bracket the text to be selected.
  489.   the first char 
  490. • shadowVar <name> - Associates a Tcl variable with an Alpha variable of 
  491.   the same name. Writes to the Tcl variable automatically are copied to 
  492.   the Alpha variable.
  493. • shell - open the Tcl shell.
  494. • shiftLeftRegion - shifts the current region left a tab
  495. • shiftRightRegion - shift the current region right a 
  496.   tab
  497. • sizeWin [win name] <width> <height> - sets size of current or specified window.
  498. • sortMarks - sorts all marks of open windows, w/o 
  499.   setting the dirty flag. If the files are saved, the 
  500.   marks will be saved in alphabetical order.
  501. • spacesToTabs - convert spaces in selection to tabs
  502. • startEscape - used to further modify the next 
  503.   keystroke combination, in the same manner as using the 
  504.   shift key in the next keystroke
  505. • startKeyboardMacro - start recording keyboard macro
  506. • substituteVars <string> - Takes a single string and
  507.   substitutes for all variables inside it, regardless of
  508.   depth. Unfortunately, you currently need to make 'global var' 
  509.   declarations in the proc you call this for each 'var' that might need 
  510.   to be substituted in the string (see proc.tcl for examples).
  511. • switchTo <appName> - Switches to application 'appName'.
  512. • tab - insert a tab
  513. • tabsToSpaces - convert tabs in selection to spaces.
  514. • tclFileCompletion - completes the previous word as a
  515.   file is in a shell window
  516. • tclResult - displays a dialog showing the result of 
  517.   the last TCL evaluation.
  518. • thinkReference <-t|-l> <think reference page> - Interact with Think 
  519.   Reference 2.0. '-t' retrieves a template without leaving Alpha, '-l' 
  520.   switches to Think Reference and goes to the specified page.
  521. • ticks
  522.   Returns the current TickCount. Ticks are 60ths of a seconds. TickCount is the 
  523.   number of ticks since the Macintosh was started. The command:
  524.         puts stdout [expr "[ticks] / 60"]
  525.   will print the number of seconds since the Macintosh was booted.
  526. • toggleScrollbar - toggles horizontal scrollbar on frontmost window. 
  527.   Will not succeed if scrollbar scrolled.
  528. • traceFunc on <funcName> <winName> Trace 'funcName', send output to 
  529.                                     'winName'. 
  530.   traceFunc off                        Turn function tracing off.
  531.   traceFunc status                    Display current tracing status.
  532. • undo - undo the last action that has not been undone
  533. • upcaseRegion - convert all lowercase letters to 
  534.   uppercase in the current region
  535. • upcaseWord - convert all lowercase letters to 
  536.   uppercase in the current word
  537. • version - Return string of the form "Alpha Version 5.31, Feb. 15, 1993".
  538. • watchCursor - turns the cursor into a a watch cursor.
  539. • wc <file>... - counts chars, words, lines of input files.
  540. • winFuncTitle <winName> <title> - Sets the title of the leftmost 
  541.   titlebar menu. See the section on "TitleBar Menus" in "General Help".
  542. • winNames [-f] - return a TCL list of all open windows. If '-f' option 
  543.   specified, complete pathnames are returned.
  544. • wrap - see the section on "Fill" routines.
  545. • wrapText
  546. • xtclcmd [-f filename] <cmdname> [argument_list]*
  547.   This command will load the external command cmdname and pass it the argument 
  548.   list [ cmdname argument_list... ]. External command are code resources of type 
  549.   XTCL. They may be located in the resource fork of the tickle application, or they 
  550.   may be located in a file named XTCL File in the same directory as the tickle 
  551.   application. If the optional -f filename is included, the external command will first 
  552.   be loaded from filename before the other two files.
  553.   See the appendix for a detailed description of the external tcl command interface. 
  554.   See the accompanying sources for an example of writing an XTCL.
  555. • yank - insert the last piece of deleted text of less
  556.   than 1k. Consecutive deletes are concatenated.
  557.   together.
  558. • zapInvisibles - removes chars < ascii 32, except for
  559.   LF's and CR's.
  560. • zoom - zooms the current window
  561.