DP Tool Club 19

home *** CD-ROM | disk | FTP | other *** search

/ DP Tool Club 19 / CD_ASCQ_19_010295.iso / vrac / tsetd2.zip / POTPOURR.DAT < prev next >

Wrap

Text File | 1994-12-14 | 33KB | 797 lines

; ; ; SemWare Potpourri Macro data file. ; ; *WARNING* DO NOT EDIT THIS FILE DIRECTLY!!! ; ; The Potpourri macro expects this file to be in a certain format. ; ; ASCII Alternate ASCII chart Overview: This ASCII chart provides additional information for characters 0 thru 31. Keys: (none) Usage notes: This macro does not have any key assignments. To use, simply select it from the Potpourri menu. Adjust Adjusts text in a marked block to the right, left or center Overview: This macro allows you to adjust text within a block by aligning it either on the left or right, or by centering it. If a column block is marked, the macro operates on the text in the block using the leftmost and/or rightmost column boundary (as appropriate). If a line or character block is marked, it operates on the text on the lines spanned by the block, using the left and/or right margin (as appropriate). A selection menu issued by the macro allows you to choose whether you want to left adjust, right adjust, or center the text. Keys: (none) Usage notes: This macro does not have any key assignments. To use, simply select it from the Potpourri menu. Align Aligns the current line with the cursor or the previous line. Overview: Align() positions the FirstNonWhite character on the current line to the same position of the FirstNonWhite character on the previous line or the first preceding non-blank line. The cursor will then be moved to the next line in the file. AlignAtCursor() positions the FirstNonWhite character on the current line to the cursor position. The cursor will then be moved to the next line in the file. Keys: <Ctrl F5> Align() <Ctrl F6> AlignAtCursor() Usage notes: If the current line is blank, the cursor will still go to the next line of the file, but no alignment will occur. Book Gives visual display of active bookmarks. Overview: These macros will give a visual display of all active bookmarks. This comes in very handy when you cannot remember which bookmark takes you to the desired location. When you pop up the picklist, a portion of the line where bookmarks are located will be displayed so you can choose based on the content of the line. Keys: <Ctrl 1> mPlaceBookMark() <Ctrl 2> mGotoBookMark(kFORWARD) <Ctrl 3> mGotoBookMark(kBACKWARD) <Ctrl 4> mGotoBookMark(0) Usage notes: Using the <Ctrl 1> key, you can place bookmarks at any place in any file. The bookmarks are numbered in sequential order beginning with 1. Pressing the <Ctrl 2> and <Ctrl 3> keys will go to the next and previous bookmarks respectively. Pressing the <Ctrl 4> key will invoke the pick list which shows the bookmark number, file, line number, and part of the text on the line where each bookmark is located. CD A "chdir" command for TSE. Overview: Provides a facility to change the current directory within TSE. Either full or partial pathnames may be entered. Limited to drives identified by alphabetic letters followed by a colon (eg) "c:". Detailed help is available by invoking the macro and following the prompts. Calendar Displays a visual, changeable calendar. Overview: Three calendar displays are available -- Medium Size Single Month, Three Months at a time and a Small Single Month (Alt-C to toggle between them). A small calendar can be inserted into the current file with the Alt-I key combination. Here is a sample: ┌────────────────────┐ │April 5th 1993│ │Su Mo Tu We Th Fr Sa│ │ 1 2 3│ │ 4[ 5] 6 7 8 9 10│ │11 12 13 14 15 16 17│ │18 19 20 21 22 23 24│ │25 26 27 28 29 30 │ └────────────────────┘ Keys: Next Day Cursor Up or Cursor Right Previous Day Cursor Down or Cursor Left Next Month +, SpaceBar or Enter Previous Month - or BackSpace Next Year Page Up Previous Year Page Down First Day Of Month Home Last Day Of Month End First Day Of Year Ctrl-Home Last Day Of Year Ctrl-End Today Alt-T Change Calendar Type Alt-C Insert Calendar into Text Alt-I Exit Calendar Escape ClipView Simple ClipBoard Viewer utility for PROJECTS Overview: This file provides a simple clipboard viewer. It allows clipboards "A" through "Z" to be viewed. It was written as a support file for PROJECTS. Keys: (none) Usage notes: This macro is may be executed from the PROJECTS macro or may be execute directly from Potpourri or the "Execute Macro:" prompt. Clock Status line clock for TSE Overview: This clock uses binary support to help determine whether or not data is overlaying the spot where the time would go. It also retrieves its color attribute byte from the first byte on the screen, so it always knows what color to set the clock to. In addition, if "Eliminate Snow" is set within TSE, snow checking will also be done in the binary, if the card is determined by the binary to be a CGA card. Keys: (none) Usage notes: Simply load or execute this macro to display a simple clock on the statusline. Cmp2BkUp Compares the current file to a backup file Overview: The user will be prompted for a backup filename. This backup file may be inside an "ARC", "ARJ", "LZH", or "ZIP" file, or it may be a stand alone file. If the file is inside an archive, then the filename must be the same as the current filename. Note that there may be many different files inside the archive, but only the one that matches the current filename will be extracted. The two files will be split (either vertically or horizontally). Cursor movement keystrokes will be fed to both windows so that they move simultaneously, in sync with each other. Text may be scanned, and differences will be highlighted. The video mode may be changed from 25 to 28 to 43 to 50 lines to show more detail. F1 is available for help. Whitespace characters (spaces and tabs) are automatically converted to a single space character by default, in an effort to reduce false comparisons. This option may be toggled by pressing the "W" key. Once a re-sync has been accomplished, both windows will update to the end of the difference text, with the re-synced lines adjacent to each other on line 12 of the screen. Difference text will be marked in both windows, for easy comparison. Press the grey- key to retreat to the BEGINNING of the difference text, then press the grey+ key to move back to the END of the difference text. Hit the enter again to continue the search process, -- to find and highlight the next difference. Keys: (none) Usage notes: This macro is designed to be run from PROJECTS or may be executed directly from Potpourri. It is automatically purged when done. LIMITATIONS: -Line length must be under 256 characters. -although whitespace errors will NOT cause files that are already in sync to de-sync (unless the whitespace filter is turned off), TSE's basic search mechanism is used to re-sync, and whitespace cannot be filtered out here. This is usually not too big of an issue unless you completely en-tab, or de-tab one of the two files. Then re-syncing will NOT take place. -Your file decompressor must be in the path, or a "File Not Found" error message will result. The usual disclaimer -- Use these macros at your own risk! I will in NO WAY be responsible for ANY problems resulting in their use. Colors Color Syntax Highlighting Overview: Color Syntax Highlighting for TSE. Color templates are provided for files with the following extensions: .S, .C, .ASM, .ASP, .BAS, .BAT, .BTM, .CBL, .FOR, .MOD, .PAS, .PRG, .SIM, .SLT, and .SYS. Note: By default any file which does not have a color file set up for its particular extension will use the default colors defined in the COLOR.TSE file. To modify the pre-defined color groups, execute COLORS and select "Customize Color Groups" from the menu. You may easily create your own custom color template files, as well. Follow the directions given in "CUSTOM.DOC" which resides in the MAC\COLOR\ subdirectory. Additional information may be found in MAC\COLOR\COLORS.DOC. Coloring is controlled via "color template files" (having extensions of ".tse") which may be customized by you. Keys: (none) Usage notes: This macro does not have any key assignments. To use, simply select it from the Potpourri menu. Or, if you want it to load each time the editor loads, execute COLORS and select the "Add COLORS to AutoLoad List" option from the menu. This macro does not support comments or keywords partially or fully scrolled off the screen. Date Inserts current date (format includes Month spelled out) Overview: This macro inserts the current date with the full name of the month and a 4-digit year. The format is as follows: January 27, 1994. Keys: (none) Usage notes: This macro does not have any key assignments. To use, simply select it from the Potpourri menu. DelToBol Delete text from cursor to beginning of current line. Overview: This macro is the complement to the DelToEol() command. All text from the beginning of the line through the position preceding the cursor will be deleted. Keys: (none) Usage notes: This macro does not have any key assignments. To use, simply select it from the Potpourri menu. EditFile EditFile() enhancement macro Overview: This macro collection enhances EditFile() by trying to load the file from the current directory first, and if unsuccessful, it then tries the current file's directory. If wildcards are used, two picklists will be presented -- one for the current directory and one for the current file's directory. Keys: <Alt E> SmartEditfile() Usage notes: Simply load this macro and press <Alt E> to pull up the SmartEditFile() prompt. Expand Expands the current partial word based on match in current file. Overview: This macro file provides a macro that operates like a limited, dynamic Template mode. It expands, or completes, the "partial" word to the left of the cursor based on other words in the file. When you execute Expand from the Potpourri PickList, the Expand macro is assigned to <Ctrl H>. Keys: <Ctrl H> Expand() Usage notes: With this macro activated, just press <Ctrl H> each time you want to complete the partial word immediately preceding the cursor. The macro searches backward and forward in the file for words that begin with the string that you typed as the partial word. If only one match is found, the partial word is replaced with the expanded word. If multiple matches are found, the macro first displays a PickList of expanded entries from which you can choose. To select an expanded word from the PickList, move the cursor bar over the desired entry and press <Enter>. Your partial word is then replaced in the text with the expanded word you selected. Expr Calculates the value of a specified mathematical expression. Overview: This macro operates as a simple calculator, and handles decimal or hexadecimal numbers. For decimal numbers, only whole numbers are accepted. Keys: (none) Usage notes: This macro does not have any key assignments. To use, simply select it from the Potpourri menu. The following operations are available: > SHR (bitwise shift right) < SHL (bitwise shift left) ~ COMP (2's complement) % MOD (modulo division) & AND (bitwise AND) | OR (bitwise OR) ^ XOR (bitwise eXclusive-OR) + Addition - Subtraction * Multiplication / Division Precedence is as in SAL, but can be forced by using parenthesis. Hex number may be entered using C format, or ending with an 'h' or '$'. Regardless, the first character _must_ be numeric. FillNum Fill a _COLUMN_ block with a sequence of numbers. Overview: This macro fills a column block with a series of numbers that can be incremented or decremented. You specify the beginning and (optionally) ending number in the series, as well as the positive or negative amount by which to increment or decrement the series. Keys: (none) Usage notes: This macro does not have any key assignments. To use, simply select it from the Potpourri menu. FindEOL Macros to find and replace text that include the end of line. Overview: This macro file provides a group of macros that allow you to find and replace text that includes the end of line, if you specify the end of line (as "$") in the search string. These macros are useful for locating a text string that begins on one line, and ends on another. They are also useful for such tasks as: ∙ Deleting extra blank lines in a file For example, to change all occurrences of 2 blank lines to a single blank line, use this macro to search for "$$$" and replace with "$$". ∙ Removing trailing text from certain lines For example, to remove a trailing comma from any lines immediately followed by a blank line, use this macro to search for ",$$" and replace with "$$". When you execute this macro file, special find, replace, and repeat find/replace macros are assigned to keys. A message is displayed to identify the key to which each macro is assigned. Keys: <AltShift F> FindReplaceEol(TRUE) // Find only <AltShift R> FindReplaceEol(FALSE) // Find and Replace <AltShift L> RepeatFindReplaceEol() // RepeatFind Usage notes: There are a few limitations to this macro: 1 - Does not support regular expressions. 2 - Search string cannot be a single '$'. 3 - When lines are joined by replacing the '$' with nothing, the resulting line must be less than the max line length. InsMatch Inserts the matching character for a specific groups of chars. Overview: This macro causes the editor to insert the matching character for a specific group of bracketing character pairs, including the following: [], (), {}, <>, '', "". Execute this macro to toggle the "insert matching" mode ON or OFF. When ON, the matching character of a pair is automatically inserted when you type the first character. For example, if you enter the character {, this macro inserts the matching character, }. Keys: Char Inserts [ [] ' '' " "" { {} < <> Usage notes: This macro does not have any key assignments. To use, simply select it from the Potpourri menu. Each time this macro is executed, the EnterMatching state is toggled. The first time, EnterMatching is enabled. To disable, simple execute the macro again. Justify Justifies a paragraph based on the right margin. Overview: This macro work just like the WrapPara() command, but also justifies each line to the RightMargin. Keys: (none) Usage notes: This macro does not have any key assignments. To use, simply select it from the Potpourri menu. LongstLn Locates the longest line in the current file or block. Overview: This macro locates the longest line in the current file. When you execute this macro, you are positioned on the longest line, and its length is displayed on the StatusLine. If a block is marked in the current file, then the search is limited to the block. Keys: (none) Usage notes: This macro does not have any key assignments. To use, simply select it from the Potpourri menu. Para Macros to go to the end and to the next and previous paragraph. Overview: These macros will position the cursor on the next or previous paragraph, or at the end of the current paragraph. They assume that there is at least one blank line between paragraphs. Keys: <Ctrl CursorDown> NextPara() <Ctrl CursorUp> PrevPara() <Ctrl CenterCursor> EndPara() Usage notes: If you wish to make this macro a permanent part of your configuration, then simply add "Para" to the AutoLoad list on the Macro menu. Projects Project management macro for saving and restoring files Overview: Project management macro for TSE. This macro will save currently loaded files and several pre-defined editing variables as a named project. The macro may then be run to reload the previously saved files for a given project. Keys: <Ctrl K><M> ShowMainMenu() <Ctrl K><P> SaveProjectFiles() <Ctrl K><A> SaveProjectFilesAndExit() Usage notes: Executing Project will prompt the user with a menu allowing PROJECTS to be added to the AutoLoad list. Adding PROJECTS to the AutoLoad list will allow projects from the command line or from an initial picklist each time the editor is executed. To make changes to this macro or assign pre-defined functions to keys, see the "User Configurable Area" below. This file contains source for SAVING/RESTORING project information. Projects are stored in a PRJ subdirectory located just after the directory where the PROJECTS macro is located (eg) C:\TSE\MAC\PRJ. Now, when you save a project, you will be presented with a message box asking you for a project name (!!LAST!! is the default) Note that you should select your own name for the project, since !!LAST!! will be overwritten each time a project is saved. That's it -- project information will be saved, and made available for later restoration. This allows for NEAR SEAMLESS EDITING across sessions. It is UNNECESSARY to change into the PRJ subdirectory to restart a project. Simply type "e projectname" (with or without the ".PRJ" extension), and TSE will automatically open that project for you -- REGARDLESS OF THE CURRENT DIRECTORY SETTING. (Note also that it is NOT necessary to have the "PRJ" subdirectory in your path statement). Although this is convenient, there is ANOTHER WAY. Every time a project is saved, TWO project files are created -- one with the project name that you assign when you exit the editor, and the other with the name "!!LAST!!.PRJ". Since an "!" is near the beginning of the alphabet, this file should always be the first file in a picklist of files. By starting the editor with just "e <enter>", this picklist will be displayed. Simply press <enter> a second time to edit the LAST PROJECT FILES, or move through the picklist to choose another project. If you do not wish to edit a project, just press <Escape> to get the familiar "File(s) to edit" box. Saved information is as follows: ALL FILENAMES currently being edited. ALL STANDARD BOOKMARKS across ALL files. ALL AUDIT BOOKMARKS across ALL files. ALL KEYSTROKE MACROS (including scrap macro). The CURRENT DRIVE AND DIRECTORY. The VIDEO MODE (25, 28, 43, or 50 lines). The MAIN CLIPBOARD DATA (all marking types). Up to 26 NAMED CLIPBOARDS (single characters "A" through "Z" only). Any MARKED BLOCK (all marking types). The state of INSERT. The state of AUTOINDENT. The state of WORDWRAP. The state of the RIGHT MARGIN. The state of the HEX display function. The state of the BINARY display function. ALL HISTORY information. RePage Places page-breaks in current file based on printer settings. Overview: This macro places formfeed characters (ASCII 12) throughout a file, based on the page size. (The page size is determined by the value of the PrintLinesPerPage variable, which can be set from the Print Menu, by selecting "Lines Per Page" under "Set Options"). When you execute this macro, it pauses on each line where a formfeed should go, according to the page size, and places a cursor bar on that line. You can then select that line on which to place the formfeed, or move the cursor bar to a previous line in the file to select a different line on which to place the formfeed. After you select the line for the formfeed, the macro resumes, relative to the location of the selected line. Keys: (none) Usage notes: This macro does not have any key assignments. To use, simply select it from the Potpourri menu. Shift Enables <Shift>+cursor-keys to emulate CUA-style block marking. Overview: This macro modifies the <Shift>+cursor-keys to emulate CUA-style block marking and manipulating. It also assigns other keys to comply with CUA standards, including key assignments for Paste (from the System ClipBoard), CopyBlock (from the System ClipBoard), Cut (to the System ClipBoard), and DelBlock. Keys: <Shift Ins> Paste() <Ctrl Ins> Copy() <Shift Del> Cut() <Ctrl Del> DelBlock() <Shift CursorRight> ShiftCursor() <Shift CursorLeft> ShiftCursor() <Shift CursorUp> ShiftCursor() <Shift CursorDown> ShiftCursor() <Shift Home> ShiftCursor() <Shift End> ShiftCursor() <Shift PgUp> ShiftCursor() <Shift PgDn> ShiftCursor() Usage notes: If you wish to make this macro a permanent part of your configuration, then simply add "Shift" to the AutoLoad list on the Macro menu. ShowKey Displays information about keys available in TSE. Overview: This macro displays information about the assignable keys on the keyboard. When you execute this macro, an information chart is displayed on the screen. You then press a key or key-combination (using the <Ctrl>, <Shift>, and <Alt> keys). If the key is one that the editor recognizes as an assignable key, a line is displayed in the chart that identifies the following information for that key: ∙ screen display character (if applicable) ∙ ASCII code ∙ scan code ∙ hexadecimal representation ∙ decimal representation ∙ key name (that is, the "name" to use for that key in an editor k assignment) If the key is not assignable, nothing is displayed when you press the key. Keys: (none) Usage notes: This macro does not have any key assignments. To use, simply select it from the Potpourri menu. Sum Sums a column of numbers marked as a _COLUMN_ block. Overview: This macro sums up a column of numbers that have been marked in the text as a column block. The result is optionally inserted in the text. Sum handles decimal and hexadecimal numbers. For decimal numbers, it accepts positive and negative (identified with a preceding "-" sign) numbers, as well as decimal-point fractions. Keys: (none) Usage notes: This macro does not have any key assignments. To use, simply select it from the Potpourri menu. Sums either base 10 (decimal), base 16 (hexadecimal), or mixed. For base 10, a fractional part is allowed and may be up to 8 decimal places. Fractions are disallowed for hexadecimal numbers. For base 16, a preceding '0x' is ignored as is a trailing 'h' For mixed base, a preceding '0x' or a valid hexadecimal letter a-f or a trailing 'h' forces base 16 for that entry. Otherwise, base 10 is assumed. The fractional part is maintained within (-1,1) to avoid overflow. Commas within a number are ignored. Only the final result is placed in the necessary form for display. To find a number, the cursor scans left to right until a numeric sign or valid number is encountered. Only whitespace is skipped. Also, only one sign is allowed. In other words, --1 is not allowed. TabUtil Converts tab characters to spaces, or spaces to tab characters. Overview: This macro converts tab characters in the current file to spaces, or converts spaces to tab character. When invoked, a menu is presented allowing you to select Entab or Detab. To limit the scope of the conversion to a block, execute the macro from within a marked block. NOTE that it will convert the entire line that the blocks cross. Usage notes: This macro does not have any key assignments. To use, simply select it from the Potpourri menu. When entabbing, if a tab character or a single or double quote is encountered, the rest of that line is not entabbed. Where A "whereis" command for TSE. Overview: This command will search a drive or multiple drives for the specified file, and present the user with a list of all such found files. From this list, you can either edit or delete the file. Usage notes: Normally, whereis searches the drives that have been specified via the configuration menu. However, you can override the default by specifying one or more drives along with the filename, as in: "cde:*.doc", which would search drives "c", "d", and "e" for all "*.doc" files. Searches may also include a path, for instance: C:\TSE\*.MAC will find all ".MAC" files in all of the TSE subdirectories. (eg) C:.\*.EXE will find all ".EXE" files beginning with the current directory. Wipe Move or Cut a block and fill will spaces. Overview: This macro file provides two macros: MoveWipe, which is a variation of the MoveBlock command; and CutWipe, which is a variation of the Cut (to the System ClipBoard) command. When you execute Wipe from the Potpourri PickList, MoveWipe is assigned to <AltShift M>, and CutWipe is assigned to <Shift Grey*>. These macros behave similarly to the commands on which they are based, except that the area of text from which the block is moved or cut, is filled with spaces. Also, with MoveWipe, if a column block is moved, the editor overlays existing text with the contents of the block, rather than inserting the contents of the block into its new location. Keys: <AltShift M> MoveWipe() <AltShift Grey-> CutWipe() Usage notes: If you wish to make this macro a permanent part of your configuration, then simply add "Shift" to the AutoLoad list on the Macro menu.