═══ 1. SLink - The SMART Editor Introduction ═══ SLink - The SMART Editor Hyperlink Source Code Processor Version 2.1B September 1995 (C) 1991, 1994, 1995 One Up Corporation All Rights Reserved See Also: Main Menu Macros SLStart Error Codes Accelerator Keys ═══ 2. SLink - The SMART Editor Main Menu ═══ The SLink - The SMART Editor Main Menu includes the following entries:  File - File Functions.  Ref(erence) - Reference Files.  Edit - Edit Functions.  Clip - Clip File Functions.  More - More Functions.  Link - Link Functions.  Macro - Macro Functions.  Start - Command Files.  Options - Option Functions.  WorkFrame/2 Errors - OS/2 WorkFrame Error Functions.  Help - Help Functions. ═══ 3. File Menu ═══ The File Menu provides selections for the manipulation of files within SLink - The SMART Editor. SLink - The SMART Editor can also be closed from this menu. A list of opened files appears at the end of the menu selections. When you have a Full Screen Window, file number 0 is the file referred to as the Current SLink - The SMART Editor File. With a split screen, the Current SLink - The SMART Editor File is either file 0 or 1. Access Alt-F For additional information select one of the following topics:  Main Menu  Open File  Save Current File  SaveAs File  Save All Files  Refresh  Clear Window  Open Waiting Files  Clear Waiting Files List  Close Current File  Close All Files and Save  Close All Files  Exit SLink - The SMART Editor  File Housekeeping ═══ 3.1. Open File ═══ The Open File command displays file information, opens existing files or creates a new file for editing. You must specify the name of the files to be opened or created. Features 1. When a file is opened, it is read into the current SLink - The SMART Editor buffer and closed. All updates are made to the buffer. When you save a file, the file is written. 2. You can open an existing file in read only mode or edit mode. The default open mode is defined in the Setup Options. When you open a file in edit mode (not Read Only mode), a backup file is created by copying this file to the SLink - The SMART Editor BACKUP directory. If Disable Edit Backups if the Setup Options has been checked, then no backup file will be created. 3. You can create a new file. This will always be opened in edit mode. 4. You can change the current directory by the following actions: You can double-click on a directory in the directory listbox, or you can type in the directory name in the file data entry box and choose the Select or Open button. When you enter the directory name in the file data entry box, you can type in the full path terminated by a slash; e.g. C:\OS2\SUBDIR\. When you type in the directory name without being preceded by the drive, however, you do not have to terminate the name with a slash; e.g. if you are positioned at C:\OS2\CURRDIR and you want to go to the next higher directory, you can type in '..' or 'OS2'. 5. You can open a file with Word Wrap. 6. You can open an existing file in Hexadecimal Format. This will always be opened in Read Only Mode. You can optionally open the file in normal text mode and also open the Reference Menu - Current Hexadecimal File. 7. You can view the size and date/time stamp of a file. When you click on a file in the files listbox or type in the filename and choose the Select button, the size and date of the file are displayed. 8. You can select which files appear in the Filenames listbox by using a wildcard. You can choose the *.* button and all files within the current directory will be displayed. You can choose the *.C button and all files with a C extension will be displayed. You can type in your own wildcard in the Wildcard data entry box and choose the Display button and only those files satisfying your wildcard will be displayed. You can choose one of the default Wildcard masks by selecting from the list of Wildcards. 9. You can open multiple files. Select the files to be opened from the Files listbox and then press Open. All files will be opened in the specified edit and word wrap mode. 10. When you open a file, the current SLink - The SMART Editor directed is set to the directory containing the file being opened. You can open a file without changing the current SLink - The SMART Editor directory. Access  Alt-O  Alt-F, O (File Menu, Option O) Controls  Dir: The current directory is displayed.  File: You may type in a new directory path; if you type in the full path, this must end with a \ (e.g. C:\NEWDIR\). When you choose the Select or Open button, the directories listbox and files listbox are updated. You may type in the name of the file to be opened or whose size and date will be displayed (e.g. NEWFILE.C). You may type in the full path, drive, directory, and filename (e.g. C:\NEWDIR\NEWFILE.C) of the file to be opened or created or whose size and date will be displayed.  Size: The size of the selected filename is displayed.  Date/Time: The Date/Time stamp of the selected filename is displayed.  Drives This listbox contains drives. You may select the base drive from this list.  Directories Button This button will popup a user maintainable list box to contain your most often used directories.  Directories Listbox This listbox contains directories. You may select the base directory from this list.  Filenames Button This button will popup a user maintainable list box to contain your most often accessed filenames.  Filenames Listbox This listbox contains a list of files satisfying the current wildcard (usually *.*) which are contained within the selected drive and directory. You may select the filename of the file to be opened or viewed.  Display (D) The Display button updates the Filenames listbox according to the current wildcard which is displayed in the Wildcard data entry box. You either choose the *.* button, the *.C button, type in your own wildcard in the Wildcard data entry box or select from the list of wildcards and then choose the Display button.  Wildcard: The Wildcard data entry box allows you to type in your own filenames wildcard. When you choose the Display button, the Filenames listbox is updated. When you press the arrow to the right of the Wildcard data entry box, a list of wildcards appear; you can select from this list.  *.* (*) The *.* button updates the Filenames wildcard. When you choose this button, the Filenames listbox displays all of the files in the current directory. Double click (right mouse button) on this button to customize the button for your own use.  *.C (C) The *.C button updates the Filenames wildcard. When you choose this button, the Filenames listbox displays all of the files in the current directory satisfying the *.C wildcard. Double click (right mouse button) on this button to customize the button for your own use.  ReadOnly (R) This Checkbox controls the edit mode in which the files are to be opened. When you check this Checkbox, the files being opened are opened in Read-only mode; i.e.,the files cannot be edited. If a new file is being created, it is always opened with write enabled; this Checkbox is ignored. This is initialized according to the Read-only mode in the Setup Options.  WordWrap (W) This Checkbox controls the word wrap mode in which the files are to be opened. When you check this Checkbox, the files being opened are opened with word wrap enabled. This is initialized according to the word wrap mode in the Setup Options.  Hex (X) This Checkbox controls the display format of the file after it is opened. When you check this Checkbox, the file is displayed in hex format and cannot be edited. If you clear this Checkbox, the file is displayed is standard ASCII text format.  No Chg Dir (N) When a file is opened, the directory containing the file being opened becomes the current SLink - The SMART Editor directory. If this Checkbox is checked, the current SLink - The SMART Editor directory is not updated.  Open (O) When you choose the Open button, the previously defined files are opened and made available to The SMART Editor. If a file does not exist, you will be asked if you want to create it. If the file data entry box contains a directory name, the directory is changed when you choose this button.  Run (R) When you choose the Run button, a popup panel will allow you to select process run options. This option allows you to select an .EXE or .CMD file and spawn the selected process.  Cancel When you choose the Cancel button, the current command is cancelled.  Clear (E) When you choose the Clear button, the selections from the files listbox are cleared.  Help (H) When you choose the Help button, the corresponding on-line help is displayed. See Also: Change Button Text Main Menu Files Menu Setup Options ═══ 3.2. Save Files Menu ═══ The Save Files Menu allows you to save the SLink - The SMART Editor files without closing them. Access  Alt-F, S (Files Menu, Option S) See Also: Main Menu Files Menu Save File Save As File Save All Files File Housekeeping File Open ═══ 3.3. Save Current File ═══ The Save command saves the current file. Features 1. If multiple files are opened, only the current file is saved. If there is only one SLink - The SMART Editor window, the current file is displayed in that window and is listed as file 0 at the top of the list of files in the File Menu. If there are multiple windows, the current file is contained in the SLink - The SMART Editor window which has the focus. It is in the first or second position in the list of files in the File Menu. 2. The name of the file is the filename you selected when you opened the file. The filename of the current file is displayed at the top of the SLink - The SMART Editor screen. 3. The original file exists in The SMART Editor BACKUP directory. If Disable Edit Backups if the Setup Options has been checked, then no backup file will have been created. 4. All undo and redo entries for the file being saved are initialized. Access  F4  Alt-F, S, S (File Menu, Save Submenu, Option S) See Also: Main Menu Files Menu Save As File Save All Files File Housekeeping File Open ═══ 3.4. Save As File ═══ The Save As command allows you to save the current file using a new filename. Features 1. The current file remains unchanged in the current directory. The current file also exists in The SMART Editor BACKUP directory unless Disable Edit Backups if the Setup Options has been checked, then no backup file will have been created. If there is only one SLink - The SMART Editor window, the current file is displayed in that window and is listed as file 0 at the top of the list of files in the File Menu. If there are multiple windows, the current file is contained in the SLink - The SMART Editor window which has the focus. It is in the first or second position in the list of files in the File Menu. 2. The name of the current file is the filename you selected when you opened the file. The filename of the current file is displayed at the top of the SLink - The SMART Editor screen. 3. You must define the new directory and filename. If the new filename exists, you are asked if you want to overwrite that file. Access  Alt-F, S, A (File Menu, Save Submenu, Option A) Controls  Select [S] When you choose this button, the Select File Dialog Panel is displayed. You are prompted to select the drive, directory and/or filename. This becomes the new name of the file to be saved when you choose the OK button.  [data entry box] You may type in the drive, directory and/or filename in this data entry box. This becomes the name of the file to be saved when you choose the OK button.  OK When you choose the OK button, the current file is saved as the previously defined filename.  Cancel When you choose the Cancel button, the current command is cancelled.  Help (H) When you choose the Help button, the corresponding on-line help is displayed. See Also: Main Menu Files Menu Save File Save All Files File Housekeeping File Open ═══ 3.5. Save All Files ═══ The Save All Files command saves all updated The SMART Editor files. Features 1. The name of the file is the filename you selected when you opened the file. 2. The original file exists in The SMART Editor BACKUP directory unless Disable Edit Backups if the Setup Options has been checked, then no backup file will have been created. 3. All undo and redo entries for the files being saved are initialized. Access  Shift F4  Alt-F, S, L (File Menu, Save Submenu, Option L) See Also: Main Menu Files Menu Save File Save As File Close Current File Close All Files File Housekeeping ═══ 3.6. Refresh Current File ═══ The Refresh Current File command replaces the current file with a clean copy from disk. Features 1. The name of the file is the filename you selected when you opened the file. 2. If the file has been updated, you will be prompted to save the file. Access  Alt-F, R (File Menu, Option R) See Also: Main Menu Files Menu File Open Save File Close Current File File Housekeeping ═══ 3.7. Clear Window ═══ The Clear Window command clears the window with the focus but does not close the displayed file. Access  Alt-F, N (File Menu, Option N) See Also: Main Menu Files Menu File Open Save File Close Current File File Housekeeping ═══ 3.8. Open Waiting Files ═══ The Open Waiting Files command opens the file(s) passed from SLStart or the WorkFrame. Features 1. When a file is sent to SLink - The SMART Editor from SLStart or the WorkFrame, the filename is placed in a buffer. If "Notify Received File" on the Options Menu is checked, you will be beeped and the title bar will display "Files Waiting" when files are waiting to be opened. If "Restore - Receive File" on the Options Menu is checked, all passed files will be opened and SLink - The SMART Editor (if minimized) will be restored when a file is passed to SLink - The SMART Editor. 2. Select "Open Waiting Files" to open all waiting files. Access  F10  Alt-F, W (File Menu, Option W) See Also: Main Menu Files Menu Clear Waiting Files Notify Received Files Restore Received Files ═══ 3.9. Clear Waiting Files ═══ The Clear Waiting Files command ignores the file(s) passed from SLStart or the WorkFrame. Features 1. When a file is sent to SLink - The SMART Editor from SLStart or the WorkFrame, the filename is placed in a buffer. If "Notify Received File" on the Options Menu is checked, you will be beeped and the title bar will display "Files Waiting"when files are waiting to be opened. If "Restore - Receive File" on the Options Menu is checked, all passed files will be opened and SLink - The SMART Editor (if minimized) will be restored when a file is passed to SLink - The SMART Editor. 2. Select "Clear Waiting Files" to ignore all waiting files. Access  Alt-F, E (File Menu, Option E) See Also: Main Menu Files Menu Open Waiting Files Notify Received Files Restore Received Files ═══ 3.10. Close Current File ═══ The Close Current File command closes the current file. Features 1. The current file, when closed, is removed from the list of files at the end of the File Menu. If there is only one SLink - The SMART Editor window, the current file is displayed in that window and is listed at the top of the list of files in the File Menu. If there are multiple windows, the current file is contained in the SLink - The SMART Editor window which has the focus. It is in the first or second position in the list of files in the File Menu. 2. The name of the file is the filename you selected when you opened the file. The filename of the current file is displayed at the top of the SLink - The SMART Editor screen. 3. If the current file has been edited, you will have the option to save the file prior to closing it. 4. After the file is closed, the SLink - The SMART Editor window where the file was displayed is cleared. Access  Control C  Alt-F, C (File Menu, Option C) See Also: Main Menu Files Menu Save File Save As File Save All Files Close All Files File Housekeeping ═══ 3.11. Close All Files with Save ═══ The Close All Files with Save command closes all opened files. If a file has been updated. it will be saved prior to closing it. Features 1. All files are removed from the list of files at the end of the File Menu. 2. The SLink - The SMART Editor screen is cleared. If there is a split screen, both windows are cleared. Access  Alt X  Alt-F, V (File Menu, Option V) See Also: Main Menu Files Menu Save File Save As File Save All Files Close Current File Close All Files File Housekeeping ═══ 3.12. Close All Files ═══ The Close All Files command closes all opened files. Features 1. If any file has been edited, the 'SAVE FILES IN CLOSING' panel is displayed and you will have the option to save the changed files prior to closing. If you do not save the edited files prior to closing them, all changes are lost. 2. All files are removed from the list of files at the end of the File Menu. 3. The SLink - The SMART Editor screen is cleared. If there is a split screen, both windows are cleared. Access  Control A  Alt-F, F (File Menu, Option F) Controls  [edited files listbox] This listbox contains the filenames of all of The SMART Editor files which have been opened and edited. You may select from this list which files are to be saved.  Save All [A] When you choose the Save All button, all edited files are saved prior to closing them.  Save None [N] When you choose the Save None button, no files are saved. All files are closed and all changes are lost.  Save Selected [S] When you choose the Save Selected button, all files selected in the edited files listbox are saved prior to closing them. If you close an edited file without saving it, all changes in that file are lost.  Cancel When you choose the Cancel button, the current command is cancelled.  Help (H) When you choose the Help button, the corresponding on-line help is displayed. See Also: Main Menu Files Menu Save File Save As File Save All Files Close Current File File Housekeeping ═══ 3.13. Exit ═══ The Exit command terminates the SLink - The SMART Editor program. Features 1. If any file has been edited, the 'SAVE FILES IN CLOSING' panel is displayed and you will have the option to save the changed files prior to exiting. If you do not save the edited files prior to exiting, all changes are lost. Access  Control X  Alt-F, X (File Menu, Option X) See Also: Main Menu Files Menu File Housekeeping ═══ 3.14. File Housekeeping ═══ File Housekeeping allows you to save and close files. Features 1. All opened files are displayed in a listbox. Each file is preceded by the file mode; R for Read Only or E for Edit mode. Each file is also preceded by the edit status; NCH if there were no changes or CHG if the file has been edited. 2. You can select which files are to be closed and/or saved. You can select all files that are displayed in the opened files listbox by choosing the Select All Files button. You can clear all files that have been selected from the opened files listbox by choosing the UnSelect All Files button. You can click on specific files from the opened files listbox. 3. You can save the selected files without closing them by choosing the Save Selected Files button. You can have SLink - The SMART Editor prompt you prior to saving each file by checking the Verify Each File checkbox. 4. You can close the selected files. You can close the selected files without saving them by choosing the Close Selected Files - NO SAVE button. You will lose all changes to edited files. You can close the selected files and, if you have changed them, first save them by choosing the Close Selected Files - WITH SAVE (if Changed) button. You can have SLink - The SMART Editor prompt you prior to saving or closing each file by checking the Verify Each File check box. Access  Control H  Alt-F, H (File Menu, Option H) Controls  [opened files listbox] This listbox contains the filenames of all of The SMART Editor files which have been opened. Each file is prefixed by the Open Mode (R for Read Only, or E for Edit Mode) and Status (NCH for No Changes Made, or CHG if changes were made to the file). You may select one or more files from this list which are acted upon by the control buttons described below.  Select All Files [A] When you choose the Select All Files button, all files in the opened files listbox are selected.  Unselect All Files [U] When you choose the Unselect All Files button, all files in the opened files listbox are deselected.  Verify Each File [V] When you check the Verify Each File checkbox, SLink - The SMART Editor prompts you prior to closing and saving each selected file in the opened files listbox.  Save Selected Files [S] When you choose the Save Selected Files button, all files selected from the open files listbox are saved.  Close Selected Files - WITH SAVE [C] When you choose the Close Selected Files - WITH SAVE (if changed) button, all files selected in the opened files listbox are closed; those files which have been edited are saved prior to closing them.  Close Selected Files - NO SAVE [N] When you choose the Close Selected Files - NO SAVE button, all files selected in the opened files listbox are closed; all changes made to those files which have been edited are lost.  Cancel When you choose the Cancel button, the current command is cancelled.  Help (H) When you choose the Help button, the corresponding on-line help is displayed. See Also: Main Menu Files Menu Save File Save As File Save All Files Close Current File Close All Files ═══ 4. SLStart ═══ SLStart is a tiny monitor and loading program to pass files for SLink - The SMART Editor to open. This is used with the IBM WorkFrame/2 to open multiple files without creating multiple instances. This is also used in make or compile command files to send an error file automatically back to SLink - The SMART Editor. If you keep a copy of SLink - The SMART Editor minimized on your desktop, you can reduce the overhead to load SLink - The SMART Editor and open a file by executing SLStart and passing the name of the file as an argument; e.g. "SLStart myfile.c". See Also: Ignore SLStart Open Waiting Files Clear Waiting Files Notify Received Files Restore Received Files Auto Restore .********************************************************************** ═══ 5. Ref Menu ═══ The Ref Menu defines SLink - The SMART Editor System files and user defined files which are available for easy access. When selected, these files are opened in Read Only mode. Access Alt-R For additional information select one of the following topics:  Main Menu  Find Files List  Multi-File Search List  Multiple Definition List  Multiple XRef List  Clip File  Current Hexadecimal Format  Tracks  Macro Output  Call Tree  Other Link Displays  Function Def List  Mod/Functions List  Unreferenced Functions Def List  Defines List  Globals List  User Specified List  Dialogs List  Define Files A->H  User Defined Files ═══ 5.1. REF Find Files List ═══ The Find File reference file contains the results of the last Find Files command. Features 1. This file is stored in the file L##Find.Lst in the TEMP directory; ## identifies the instance of SLink - The SMART Editor for whom the list was generated. Each file satisfying the last Find File command is listed with its size and date/time stamp. When you double-click on one of the listed files, it is opened in the default edit mode specified in the Setup Options Default Open - Read Only Mode, and displayed. Access  Alt-R, 0 (Ref Menu, Option 0) See Also: Main Menu Ref Menu Find Files Function ═══ 5.2. REF Multi-File Search List ═══ The Multi-File Search List reference file contains the matches found from the last Multi-File String Search command. Features 1. This file is stored in the file L##Srch.Lst in the TEMP directory; ## identifies the instance of SLink - The SMART Editor for whom the list was generated. 2. Each match found in the last Multi-File String Search command is listed with the full path of the file containing the match, the line and column number where the string was found, and the line containing the matched string. 3. When you double-click on a path, the file is opened in the default edit mode specified in the Setup Options Default Open - Read Only Mode, and displayed. The cursor is placed at the line and column containing the matched string. Access  Alt-R, 1 (Ref Menu, Option 1) See Also: Main Menu Ref Menu Multi-File Search ═══ 5.3. REF Multiple Definitions List ═══ The Multiple Definition List contains the results of the last Link-To Definition command when multiple definitions are found in the database. Features 1. This file is stored in the file L##MDef.Lst in the TEMP directory; ## identifies the instance of SLink - The SMART Editor for whom the list was generated. 2. The Multiple Definitions List is generated when the Link-To Definitions command is executed. You can generate this list from the Edit Menu - Link To Definition command. You can generate this list from double-clicking on a function with the left mouse button. You can generate this list from the Link Menu - Link To Item command. 3. Each file satisfying the last Link-To Definitions command is listed with the full path of the file containing the match, the line and column number where the function definition was found, and the line containing the matched function definition. 4. When you double-click on a path, the file is opened in the default edit mode specified in the Setup Options Default Open - Read Only Mode, and displayed. The cursor is placed at the line and column containing the matched function definition. Access  Alt-R, 2 (Ref Menu, Option 2) See Also: Main Menu Ref Menu Mouse Actions ═══ 5.4. REF Multiple XRef List ═══ The Multiple XRef List contains the results of the last Link-To References command. Features 1. This file is stored in the file L##MRef.Lst in the TEMP directory; ## identifies the instance of SLink - The SMART Editor for whom the list was generated. 2. The Multiple References List is generated when the Link-To References command is executed. You can generate this list from the Edit Menu - Link To References command. You can generate this list from double-clicking on a function with the right mouse button. You can generate this list from the Link Menu - Link To Item command. 3. Each file satisfying the last Link-To References command is listed with the full path of the file containing the match, the line and column number where the function definition or reference was found, an indicator when the match is a definition (* DEF), and the line containing the matched function definition or reference. 4. When you double-click on a path, the file is opened in the default edit mode specified in the Setup Options Default Open - Read Only Mode, and displayed. The cursor is placed at the line and column containing the matched function. Access  Alt-R, 3 (Ref Menu, Option 3) See Also: Main Menu Ref Menu Mouse Actions ═══ 5.5. REF Clip File ═══ The Clip File contains the current clip file data. Features 1. The file defined by the Rename Clip File command is opened in the default edit mode specified in the Setup Options Default Open - Read Only Mode, and displayed. Access  Alt-R, 4 (Ref Menu, Option 4) See Also: Main Menu Ref Menu Clip Menu ═══ 5.6. REF Current Hexadecimal Format ═══ The Current Hexadecimal Format file contains the current SLink - The SMART Editor file in hexadecimal format. Features 1. When you select the Current Hexadecimal Format Reference file, the current SLink - The SMART Editor file is converted to Hexadecimal. The Hex format is stored in the file L##Hex.Lst in the TEMP directory; ## identifies the instance of SLink - The SMART Editor for whom the list was generated. The generated file is opened in Read Only mode and displayed. 2. If you opened the current SLink - The SMART Editor file in Hexadecimal format, there will not be a Current Hexadecimal Format Reference file. Access  Alt-R, 5 (Ref Menu, Option 5) See Also: Main Menu Ref Menu File Menu: Open ═══ 5.7. REF Tracks ═══ The Tracks file contains a history of the SLink - The SMART Editor file access. Features 1. Each time a SLink - The SMART Editor file is moved out of a SLink - The SMART Editor window, an entry is made into the Tracks history file. Each entry contains the file name and the latest line and column number referenced. The latest entry is stored on the top of the list. The top entry does not reflect the current line and column information since it is not updated as the file is being updated. 2. The tracks history is stored in the file L##Trk.Lst in the TEMP directory; ## identifies the instance of SLink - The SMART Editor for whom the list was generated. 3. When you select this file, it is opened in Read Only mode and displayed. Access  F2  Alt-R, 6 (Ref Menu, Option 6) See Also: Main Menu Ref Menu ═══ 5.8. REF Macro output ═══ The Macro Output file contains all output generated from non-interactive Rexx Macros. Features 1. The Macro Output is stored in the file SL_@##.Out in the TEMP directory; @ defines the day of the week, ## identifies the instance of SLink - The SMART Editor for whom the list was generated. 2. When you select this file, it is opened in Read Only mode and displayed. 3. This file can be cleared by selecting Clear Macro Output from the Macro Menu. Access  Alt-R, 7 (Ref Menu, Option 7) See Also: Main Menu Ref Menu Clear Macro Output Rexx Environments ═══ 5.9. REF Current Call Tree ═══ The Current Call Tree reference file contains the Call Tree for the current SLink - The SMART Editor database. Features 1. The Call Tree is one of the standard reports from the SLink - The SMART Editor database. It is generated when the SLink - The SMART Editor database is created. See Create SLink - The SMART Editor DB or Create DB with IFDEFs. It is generated when the SLink - The SMART Editor database is updated. See Incremental Update DB. You can generate it at any time by selecting to Rebuild the Call Tree. 2. It shows the hierarchal interrelationship of the functions defined in the SLink - The SMART Editor database. 3. Each SLink - The SMART Editor database has its own Call Tree. The file containing the call tree, SL_Call.Rpt, resides in the same directory as the database. 4. When the Call Tree reference file is selected, the call tree for the current SLink - The SMART Editor database is opened in Read Only mode and displayed. The current SLink - The SMART Editor database is defined by the Current DB Path. Access  Alt-R, 8 (Ref Menu, Option 8) See Also: Main Menu Ref Menu Link Menu ═══ 5.10. REF Other Link Displays ═══ The Other Link Displays Submenu allows you to access the reports associated with the current SLink - The SMART Editor database. See Also: Main Menu Ref Menu Link Menu Function Definition List Module/Function List Unreferenced Functions List #Defines List Globals List User Specified List Dialogs List ═══ 5.11. REF Current Function Def List ═══ The Current Function Definition List reference file contains the Function Definition Report for the current SLink - The SMART Editor database. Features 1. The Function Definition List is one of the standard reports from the SLink - The SMART Editor database. It is generated when the SLink - The SMART Editor database is created. See Create SLink - The SMART Editor DB or Create DB with IFDEFs. It is generated when the SLink - The SMART Editor database is updated. See Incremental Update DB. You can generate it at any time by selecting to Rebuild the Function Definition List. 2. It lists each of the functions defined in the SLink - The SMART Editor database. The functions are listed in alphabetical order. Each function is displayed with the path of the module in which it resides and the line and column number within that module. 3. Each SLink - The SMART Editor database has its own Function Definition List. The file containing the report, SL_Funct.Rpt, resides in the same directory as the database. 4. When the Function Definition List reference file is selected, the report for the current SLink - The SMART Editor database is opened in Read Only mode and displayed. The current SLink - The SMART Editor database is defined by the Current DB Path. 5. When you double-click on a path, the file is opened in the default edit mode specified in the Setup Options Default Open - Read Only Mode, and displayed. The cursor is placed at the line and column containing the associated function definition. 6. When you double-click on a function, the link-to command is executed. If you clicked with the left mouse button, the Link-To Definition command is executed. If you clicked with the right mouse button, the Link-To References command is executed. Access  Alt-R, 9, A (Ref Menu, Other Link Displays, Option A) See Also: Main Menu Ref Menu Link Menu Mouse Actions ═══ 5.12. REF Current Mod/Function List ═══ The Current Module/Function List reference file contains the Module/Function List for the current SLink - The SMART Editor database. Features 1. The Module/Function List is one of the standard reports from the SLink - The SMART Editor database. It is generated when the SLink - The SMART Editor database is created. See Create SLink - The SMART Editor DB or Create DB with IFDEFs. It is generated when the SLink - The SMART Editor database is updated. See Incremental Update DB. You can generate it at any time by selecting to Rebuild the Module/Function List. 2. It lists the function definitions for each source module defined in the SLink - The SMART Editor database. The modules are listed in alphabetical order. The functions are listed in the order they appear within the source module. Each function is displayed with the path of the module in which it resides and the line and column number within that module. 3. Each SLink - The SMART Editor database has its own Module/Function List. The file containing the report, SL_Mods.Rpt, resides in the same directory as the database. 4. When the Module/Function List reference file is selected, the report for the current SLink - The SMART Editor database is opened in Read Only mode and displayed. The current SLink - The SMART Editor database is defined by the Current DB Path. 5. When you double-click on a path, the file is opened in the default edit mode specified in the Setup Options Default Open - Read Only Mode, and displayed. The cursor is placed at the line and column containing the associated function definition. 6. When you double-click on a function, the link-to command is executed. If you clicked with the left mouse button, the Link-To Definition command is executed. If you clicked the right mouse button, the Link-To References command is executed. Access  Alt-R, 9, B (Ref Menu, Other Link Displays, Option B) See Also: Main Menu Ref Menu Link Menu Mouse Actions ═══ 5.13. REF Current Unreferenced Functions List ═══ The Current Unreferenced Function Definition List reference file contains the Unreferenced Function Definition Report for the current SLink - The SMART Editor database. Features 1. The Unreferenced Functions List is one of the standard reports from the SLink - The SMART Editor database. It is generated when the SLink - The SMART Editor database is created. See Create SLink - The SMART Editor DB or Create DB with IFDEFs. It is generated when the SLink - The SMART Editor database is updated. See Incremental Update DB. You can generate it at any time by selecting to Rebuild the Unreferenced Functions List. 2. It lists each of the functions defined in the SLink - The SMART Editor database but having no references. The functions are listed in alphabetical order. Each function is displayed with the path of the module in which it resides and the line and column number within that module. 3. Each SLink - The SMART Editor database has its own Unreferenced Functions List. The file containing the report, SL_Unref.Rpt, resides in the same directory as the database. 4. When the Unreferenced Functions List reference file is selected, the report for the current SLink - The SMART Editor database is opened in Read Only mode and displayed. The current SLink - The SMART Editor database is defined by the Current DB Path. 5. When you double-click on a path, the file is opened in the default edit mode specified in the Setup Options Default Open - Read Only Mode, and displayed. The cursor is placed at the line and column containing the associated function definition. 6. When you double-click on a function, the link-to command is executed. If you clicked with the left mouse button, the Link-To Definition command is executed. If you clicked with the right mouse button, the Link-To References command is executed. Access  Alt-R, 9, C (Ref Menu, Other Link Displays, Option C) See Also: Main Menu Ref Menu Link Menu Mouse Actions ═══ 5.14. REF Current Defines List ═══ The Current Defines List reference file contains the Defines Report for the current SLink - The SMART Editor database. It includes all #define definitions found in the database. Features 1. The Defines List is not one of the standard reports from the SLink - The SMART Editor database. This report is generated only when #defines are included in the build of the database. It is generated when the SLink - The SMART Editor database is created. See Create SLink - The SMART Editor DB or Create DB with IFDEFs. It is generated when the SLink - The SMART Editor database is updated. See Incremental Update DB. You can generate it at any time by selecting to Rebuild the Defines List. 2. It lists each of the #defines defined in the SLink - The SMART Editor database. The defines are listed in alphabetical order. Each define is displayed with the path of the module in which it resides and the line and column number within that module. 3. Each SLink - The SMART Editor database has its own Defines List. The file containing the report, SL_Defin.Rpt, resides in the same directory as the database. 4. When the Defines List reference file is selected, the report for the current SLink - The SMART Editor database is opened in Read Only mode and displayed. The current SLink - The SMART Editor database is defined by the Current DB Path. 5. When you double-click on a path, the file is opened in the default edit mode specified in the Setup Options Default Open - Read Only Mode, and displayed. The cursor is placed at the line and column containing the associated #define definition. 6. When you double-click on a function, the link-to command is executed. If you clicked with the left mouse button, the Link-To Definition command is executed. If you clicked with the right mouse button, the Link-To References command is executed. Access  Alt-R, 9, D (Ref Menu, Other Link Displays, Option D) See Also: Main Menu Ref Menu Link Menu Mouse Actions ═══ 5.15. REF Current Globals List ═══ The Current Globals List reference file contains the Globals Report for the current SLink - The SMART Editor database. Each global variable defined in the database is included in this report. Features 1. The Globals List is not one of the standard reports from the SLink - The SMART Editor database. This report is generated only when globals are included in the build of the database. It is generated when the SLink - The SMART Editor database is created. See Create SLink - The SMART Editor DB or Create DB with IFDEFs. It is generated when the SLink - The SMART Editor database is updated. See Incremental Update DB. You can generate it at any time by selecting to Rebuild the Globals List. 2. It lists each of the globals defined in the SLink - The SMART Editor database. The globals are listed in alphabetical order. Each global is displayed with the path of the module in which it resides and the line and column number within that module. 3. Each SLink - The SMART Editor database has its own Globals List. The file containing the report, SL_Glob.Rpt, resides in the same directory as the database. 4. When the Globals List reference file is selected, the report for the current SLink - The SMART Editor database is opened in Read Only mode and displayed. The current SLink - The SMART Editor database is defined by the Current DB Path. 5. When you double-click on a path, the file is opened in the default edit mode specified in the Setup Options Default Open - Read Only Mode, and displayed. The cursor is placed at the line and column containing the associated global definition. 6. When you double-click on a function, the link-to command is executed. If you clicked with the left mouse button, the Link-To Definition command is executed. If you clicked with the right mouse button, the Link-To References command is executed. Access  Alt-R, 9, E (Ref Menu, Other Link Displays, Option E) See Also: Main Menu Ref Menu Link Menu Mouse Actions ═══ 5.16. REF User Defined Functions List ═══ The Current User Specified Function List reference file contains the User Specified Function Report for the current SLink - The SMART Editor database. This contains all user specified functions that are referenced in the database. Features 1. The User Specified Function List is not one of the standard reports from the SLink - The SMART Editor database. This report is generated only when user specified functions are included in the build of the database. It is generated when the SLink - The SMART Editor database is created. See Create SLink - The SMART Editor DB or Create DB with IFDEFs. It is generated when the SLink - The SMART Editor database is updated. See Incremental Update DB. You can generate it at any time by selecting to Rebuild the User Specified Function List. 2. It lists each of the user specified functions referenced in the SLink - The SMART Editor database. The user specified functions are listed in alphabetical order. 3. Each SLink - The SMART Editor database has its own User Specified Function List. The file containing the report, SL_User.Rpt, resides in the same directory as the database. 4. When the User Specified Function List reference file is selected, the report for the current SLink - The SMART Editor database is opened in Read Only mode and displayed. The current SLink - The SMART Editor database is defined by the Current DB Path. 5. When you double-click on a function, the link-to command is executed. If you clicked with the right mouse button, the Link-To References command is executed. Access  Alt-R, 9, F (Ref Menu, Other Link Displays, Option F) See Also: Main Menu Ref Menu Link Menu Mouse Actions ═══ 5.17. REF Dialogs List ═══ The Current Dialogs List reference file contains the Dialogs Report for the current SLink - The SMART Editor database. Features 1. The Dialogs List is not one of the standard reports from the SLink - The SMART Editor database. This report is generated only when dialogs are included in the build of the database. It is generated when the SLink - The SMART Editor database is created. See Create SLink - The SMART Editor DB or Create DB with IFDEFs. It is generated when the SLink - The SMART Editor database is updated. See Incremental Update DB. You can generate it at any time by selecting to Rebuild the Dialogs List. 2. It lists each of the dialogs defined in the SLink - The SMART Editor database. These are defined by the DLGBOXTEMPLATE and WINDOWTEMPLATE key words. The dialogs are listed in alphabetical order. Each dialog is displayed with the path of the module in which it resides and the line and column number within that module. 3. Each SLink - The SMART Editor database has its own Dialogs List. The file containing the report, SL_DlgBx.Rpt, resides in the same directory as the database. 4. When the Dialogs List reference file is selected, the report for the current SLink - The SMART Editor database is opened in Read Only mode and displayed. The current SLink - The SMART Editor database is defined by the Current DB Path. 5. When you double-click on a path, the file is opened in the default edit mode specified in the Setup Options Default Open - Read Only Mode, and displayed. The cursor is placed at the line and column containing the associated dialog definition. 6. When you double-click on a function, the link-to command is executed. If you clicked with the left mouse button, the Link-To Definition command is executed. If you clicked with the right mouse button, the Link-To References command is executed. Access  Alt-R, 9, G (Ref Menu, Other Link Displays, Option G) See Also: Main Menu Ref Menu Link Menu Mouse Actions ═══ 5.18. REF Define Files A to H ═══ The Define Files A to H command defines 8 quick access files. Features 1. You may select 8 files that are easily accessed. These files are referenced as File A through File H. For each file, you may select the filename (Select File DialogBox) or type in the directory and filename. For each file, you may type in a description which will appear under the Ref menu. Access  Alt-R, X (Ref Menu, Option X) See Also: Main Menu Ref Menu ═══ 5.19. REF User Defined File ═══ File A-H is the easy access file you defined as "File A-H" in the Define Files A to H command. Features 1. The name of the file displayed in the Reference Menu is the menu description you entered for the file in the Define Files A to H command. 2. The file that you defined in the Define Files A to H command is available for easy access. When selected, this file is opened in the default Open File mode. Access  Alt-R, A-H (Ref Menu, Option A-H) See Also: Main Menu Ref Menu ═══ 6. Edit Menu ═══ The Edit Menu allows you to edit and search data within the current file in SLink - The SMART Editor. The Edit Menu also allows you to define and execute the Link-To command. Access Alt-E For additional information select one of the following topics:  Main Menu  Undo Redo Menu  Undo  Redo  Multiple Undo\Redo  Cut  Copy  Paste  Paste File at Cursor  Delete  Current File Search Menu  Search Current File  Search Backwards  Continue Search  Replace String  Select String  Link To Definition  Link To Reference  Blocks  Indents Menu  Indent Selected  De-Indent Selected  To Upper Case  To Lower Case  First Upper Case  Reverse Case  Braces Menu  Find Beginning Brace  Find Ending Brace  Select Braced Code  Parens Menu  Find Beginning Paren  Find Ending Paren  Select Paren Code  Carriage Returns Menu  Remove Carriage Returns  Insert Carriage Returns  Goto Line  Left Justify Line at Cursor  Word Wrap  Change File Edit Mode ═══ 6.1. Undo Redo Menu ═══ The Undo Redo Menu allows you to undo edits or redo edits, either singly or by using a slider. Access  Alt-E, U (Edit Menu, Option U) See Also: Main Menu Edit Menu Undo Redo Multiple Undo\Redo ═══ 6.2. Undo ═══ The Undo command restores the current file to the state prior to the last edit function. Features 1. SLink - The SMART Editor automatically saves each edit event. The number of edit events saved is defined by the Setup Options Max Undos\Redos parameter. If 0 is specified, no undo\redo events are saved. 2. When you save the file, all Undo events and Redo events are cleared. The Undo and Redo events pertain to the edit events subsequent to the last file open or save. 3. In some cases, SLink - The SMART Editor creates a temporary undo file. When the edit event inserts a file which exceeds a predetermined file size, a temporary file is created. When the inserted or deleted text exceeds a predetermined size, a temporary file is created. The temporary undo file is written to the TEMP directory. 4. The undo command deletes the last edit function. 5. The redo command restores the undo edit event. 6. If there are any redo events, the undo command restores the last redo event. For example, if you initially entered ABCDEF: ...if you executed Undo next, the last edit event (F) would be deleted and ABCDE would be contained in the file. ...if you executed Redo next, the last edit event (UNDO F) would be restored and ABCDEF would be contained in the file. ...if you again executed Undo, the last edit event (REDO F) would be deleted, and ABCDE would be contained in the file. Access  Alt U  Alt-E, U, U (Edit Menu, Undo/Redo Submenu, Option U) See Also: Main Menu Edit Menu Redo Multiple Undo\Redo Setup Options ═══ 6.3. Redo ═══ The Redo command restores the current file to the state prior to the last undo edit function. Features 1. SLink - The SMART Editor automatically saves each edit event. The number of edit events saved is defined by the Setup Options Max Undos\Redos parameter. If 0 is specified, no undo\redo events are saved. 2. When you save the file, all Undo events and Redo events are cleared. The Undo and Redo events pertain to the edit events subsequent to the last file open or save. 3. In some cases, SLink - The SMART Editor creates a temporary undo file. When the edit event inserts a file which exceeds a predetermined file size, a temporary file is created. When the inserted or deleted text exceeds a predetermined size, a temporary file is created. The temporary undo file is written to the TEMP directory. 4. The undo command restores the restores the current file to the state prior to the last edit event. 5. The redo command restores the last undo edit event. If there are no Undo events, there can be no Redo event. 6. If there are any redo events, the undo command restores the last redo event. For example, if you initially entered ABCDEF: ...if you executed Undo next, the last edit event (F) would be deleted and ABCDE would be contained in the file. ...if you executed Redo next, the last edit event (UNDO F) would be restored and ABCDEF would be contained in the file. ...if you again executed Undo, the last edit event (REDO F) would be deleted, and ABCDE would be contained in the file. Access  Control U  Alt-E, U, R (Edit Menu, Undo/Redo Submenu, Option R) See Also: Main Menu Edit Menu Undo Multiple Undo\Redo Setup Options ═══ 6.4. Multiple Undo\Redo ═══ The Multiple Undo\Redo command restores the current file to the state prior to the indicated Undo or Redo edit function. Features 1. SLink - The SMART Editor automatically saves each edit event. The number of edit events saved is defined by the Setup Options Max Undos\Redos parameter. If 0 is specified, no Undo\Redo events are saved. 2. When you save the file, all Undo events and Redo events are cleared. The Undo and Redo events pertain to the edit events subsequent to the last file open or save. 3. In some cases, SLink - The SMART Editor creates a temporary undo file. When the edit event inserts a file which exceeds a predetermined file size, a temporary file is created. When the inserted or deleted text exceeds a predetermined size, a temporary file is created. The temporary undo file is written to the TEMP directory. 4. The Undo command deletes the last edit event. 5. The Redo command restores the last Undo edit event. 6. If there are any Redo events, the Undo command restores the last Redo event. For example, if you initially entered ABCDEF: ...if you executed Undo next, the last edit event (F) would be deleted and ABCDE would be contained in the file. ...if you executed Redo next, the last edit event (UNDO F) would be restored and ABCDEF would be contained in the file. ...if you again executed Undo, the last edit event (REDO F) would be deleted, and ABCDE would be contained in the file. Access  Alt-E, U, M (Edit Menu, Undo/Redo Submenu, Option M) Controls  Undo [U] When you select the Undo button, SLink - The SMART Editor deletes the last edit function. If there are any Redo events, the last Redo event will be deleted; otherwise the last edit event will be deleted.  Redo [R] When you select the Redo button, SLink - The SMART Editor restores the last Undo edit event.  Undo\Redo Scrollbar The scrollbar elevator position corresponds to the number of Undo and Redo events. The scrollbar elevator is positioned at the right if there are no Redo edit functions available. The scrollbar elevator is positioned at the left if there are no Undo edit functions available. You can execute the Undo command by moving the elevator to the left; this will decrease the number of Undo events and increase the number of Redo events by the amount you move the elevator. You can execute the Undo command by clicking on the left arrow. If you hold the mouse button on the arrow, multiple edit events will be deleted. You can execute the Redo command by moving the elevator to the right; this will increase the number of Undo events and decrease the number of Redo events by the amount you move the elevator. You can execute the Redo command by clicking on the right arrow. If you hold the mouse button on the arrow, multiple edit events will be restored.  Steps available The number of Undo steps available are displayed below the Undo button. The number of Redo steps available are displayed below the Redo button.  Cancel When you choose the Cancel button, the Multiple Undo/Redo function is terminated. All undo and redo events executed will be kept.  Help (H) When you choose the Help button, the corresponding on-line help is displayed. See Also: Main Menu Edit Menu Undo Multiple Undo\Redo Setup Options ═══ 6.5. Copy To Paste ═══ The Copy To Paste command copies data to the paste buffer. Features 1. The data within the current file is copied to the paste buffer. If you have selected data, the selected data is copied. If no data is selected, the entire line containing the cursor is copied. 2. The data contained in the paste buffer can be retrieved later using the Paste Function. Access  Keypad Plus  Control Insert  Alt-E, C (Edit Menu, Option C) See Also: Main Menu Edit Menu Cut Select to Clip File ═══ 6.6. Paste ═══ The Paste command copies the data from the paste buffer into the current file at the current cursor location. Features 1. The pasted data can be unpasted by using the Undo Last Edit command. Access  Shift Insert  F12  Alt-E, P (Edit Menu, Option P) See Also: Main Menu Edit Menu Copy To Paste Cut To Paste Read Into Cursor Paste to Clip File Clip File to Paste Insert Clip File at Cursor ═══ 6.7. Paste File At Cursor ═══ The Paste File At Cursor command copies a file to the current cursor position within the current file. Features 1. You must define the file to be copied. The Select File Dialog Panel is displayed. You are prompted to select the drive, directory and/or filename. Access  Alt-E, O (Edit Menu, Option O) See Also: Main Menu Edit Menu Paste Insert Clip File at Cursor ═══ 6.8. Cut ═══ The Cut command moves data from the current file to the paste buffer. Features 1. The data within the current file is moved to the paste buffer. If you have selected data, the selected data is moved. If no data is selected, the entire line containing the cursor is moved. 2. After the data is moved to the paste buffer it is deleted from the current file. 3. The data contained in the paste buffer can be retrieved later using the Paste Function. 4. The cut data can be uncut by using the Undo Last Edit command. Access  Keypad Minus  Shift Delete  Alt-E, T (Edit Menu, Option T) See Also: Main Menu Edit Menu Copy To Paste ═══ 6.9. Delete Data ═══ The Delete command deletes data from the current file. Features 1. The data within the current file is deleted. If you have selected data, the selected data is deleted. If no data is selected, the character at the current cursor location is deleted. 2. The deleted data can be undeleted by using the Undo Last Edit command. Access  Del Key  Alt-E, D (Edit Menu, Option D) See Also: Main Menu Edit Menu Cut Copy ═══ 6.10. Current File Search Menu ═══ The Current File Search Menu allows you to search the current file for a predetermined string. Access  Alt-E, H (Edit Menu, Option H) See Also: Main Menu Edit Menu Search Current File Search Backwards Continue Search Search and Replace Multi-File Search ═══ 6.11. Search Current File ═══ The Search Current File command searches the current file for a predefined string. Features 1. You must define the string to be searched. You will be prompted to type in the string to be searched. You can type in a new string. You can define the string prior to executing this command with the Select String command. You can choose the Last Search button and the string used in the last search is selected. You can define the search function by clicking once with the mouse (the word at the current cursor position will be selected). 2. The search starts from the current cursor position unless the Search From Top checkbox is checked. 3. The match will be done without regard to upper and lower case unless the Case Sensitive checkbox is checked. 4. If a search is found, the cursor is moved to the string satisfying the search and the string is highlighted. Access  F5  Alt-E, H, H (Edit Menu, Current File Search Submenu, Option H) Controls  Enter String: The data entry box allowing you to type in the string to be searched. The Last Search button redisplays the last string searched in this data entry box.  Case Sensitive (C) The Case Sensitive toggle defines whether the string to be searched is to be case sensitive (upper and lower case must be matched).  Search From Top (T) The Search From Top toggle defines whether the search should begin at the beginning of the current file or from the current cursor position in the current file.  Last Search (L) The Last Search button redefines the search string as the search string from the last search.  OK When you choose the OK button, the previously defined search is done.  Cancel When you choose the Cancel button, the current command is cancelled. See Also: Main Menu Multi-File Search Edit Menu Search Backwards Continue Search Replace ═══ 6.12. Search Backwards ═══ The Search Backwards command searches the current file backwards for a predefined string. Features 1. You must define the string to be searched. You will be prompted to type in the string to be searched. You can type in a new string. You can define the string prior to executing this command with the Select String command. You can define the search function by clicking once with the mouse (the word at the current cursor position will be selected). You can choose the Last Search button and the string used in the last search is selected. 2. The search starts from the current cursor position and searches backwards to the beginning of the file. 3. The match will be done without regard to upper and lower case unless the Case Sensitive checkbox is checked. 4. If a search is found, the cursor is moved to the string satisfying the search and the string is highlighted. Access  Control F5  Alt-E, H, K (Edit Menu, Current File Search Submenu, Option K) Controls  Enter String: The data entry box allowing you to type in the string to be searched. The Last Search button redisplays the last string searched in this data entry box.  Case Sensitive (C) The Case Sensitive Toggle defines whether the string to be searched is to be case sensitive (upper and lower case must be matched).  Last Search (L) The Last Search button redefines the search string as the search string from the last search.  OK When you choose the OK button, the previously defined search is done.  Cancel When you choose the Cancel button, the current command is cancelled. See Also: Main Menu Multi-File Search Edit Menu Search Current File Continue Search Replace Multi-File/String Replace ═══ 6.13. Continue Search ═══ The Continue Search command continues the previously defined search. Features 1. The search must have been previously defined. You can define the search with the Search Current File command. You can define the search with the Search Backwards command. 2. If a search is found, the cursor is moved to the string satisfying the search and the string is highlighted. Access  Shift F5  Alt-E, H, O (Edit Menu, Current File Search Submenu, Option O) See Also: Main Menu Multi-File Search Edit Menu Replace Multi-File/String Replace ═══ 6.14. Replace String ═══ The Replace String command searches the current file for a predefined search string and replaces it with the predefined replace string. Features 1. You must define the string to be searched. You can type in a new string. You can define the string prior to executing this command with the Select String command. You can define the search function by clicking once with the mouse (the word at the current cursor position will be selected). You can choose the Last Search button and the string used in the last search is selected. 2. You must define the replace string. 3. The search starts from the current cursor position. 4. The match will be done with regard to upper and lower case. A case sensitive search on the string to be replaced is done. 5. If a search is found the cursor is moved to the string satisfying the search and the string is highlighted. If verify is checked, you are shown the replace string and are prompted to verify the replacement. If the replacement is verified or if the verify is unchecked, the replace string replaces the search string at the current cursor location. 6. The search continues until there are no more matches satisfying the search string. 7. You can search the entire file. 8. You can select a portion of the file and then search only the selected code. Access  F6  Alt-E, S (Edit Menu, Option S) Controls  Replace: The data entry box allowing you to type in the string to be searched.  With: The data entry box allowing you to type in the string to be used to replace the matched data.  Verify Replacement (V) The Verify Replacement checkbox defines whether you are to be prompted prior to replacing the found search string.  Selected Text Only The Selected Text Only checkbox is enabled when you select text prior to the selecting the Replace command. When this checkbox is checked, only the selected code will be searched. If you remove the check, the entire file will be searched.  From the Top The From the Top checkbox is enabled when you uncheck Selected Text Only. When this checkbox is checked replacement will begin at the begining of the file, otherwise it begins at the current cursor position.  OK When you choose the OK button, the previously defined search and replace is done.  Cancel When you choose the Cancel button, the current command is cancelled.  Help (H) When you choose the Help button, the corresponding on-line help is displayed. See Also: Main Menu Multi-File Search Edit Menu Search Search Backwards Continue Search Multi-File/String Replace ═══ 6.15. Select String ═══ The Select String command saves the indicated string for later use with Search, Replace, Link To Definition, or Link To Reference. Features 1. If there is no selected text, the word at the current cursor position is selected. 2. If you have selected text, the highlighted text is selected. Access  F11  Alt-E, G (Edit Menu, Option G) See Also: Main Menu Edit Menu Search Current File Multi-File Search Replace Link To Definition Link To Reference Link To Item ═══ 6.16. Link To Definition ═══ The Link To Definition command searches the current SLink - The SMART Editor Database for all definitions of the previously defined function. Features 1. The function to search has to be previously defined. You can define the search function by the Select String command. You can define the search function by selecting the function with the mouse. Refer to Mouse Actions. You can define the search function by clicking once with the mouse (the word at the current cursor position will be selected). You can define the search function by selecting the function with the keyboard. Refer to Text Selection. 2. The current SLink - The SMART Editor Database has to be previously defined. You can generate the database by the Create SLink - The SMART Editor DB or Create DB with IFDEF commands. You can select the database by the Current DB Path command. 3. If more than one definition is found, the results are written to the L##MDef.Lst file in the TEMP directory; ## identifies the instance of SLink - The SMART Editor for whom the list was generated. The REF Multiple Definition List is updated with the results of the search. The L##MDef.Lst file is opened in Read Only mode. Each file satisfying the Link To Definitions command is listed with the full path of the file containing the match, the line and column number where the function definition was found, and the line containing the matched function definition. When you double-click on a path, the source file is opened in the default edit mode specified in the Setup Options Default Open - Read Only Mode, and displayed. The cursor is placed at the line and column containing the matched function definition (or the beginning of the comment preceding the definition, if Link To Comment was specified in the SLink - The SMART Editor Options). 4. If only one definition is found, the source file containing the definition is opened. The cursor is placed at the beginning of the definition (or the beginning of the comment preceding the definition, if Link To Comment was specified in the SLink - The SMART Editor Options). Access  Shift F11  Alt-E, F (Edit Menu, Option F) See Also: Main Menu Edit Menu Select String Link To Reference Link To Item Setup Options ═══ 6.17. Link To Reference ═══ The Link To Reference command searches the current SLink - The SMART Editor Database for all definitions and references to the previously defined function. Features 1. The function to search has to be previously defined. You can define the search function by the Select String command. You can define the search function by selecting the function with the mouse. Refer to Mouse Actions. You can define the search function by clicking once with the mouse (the word at the current cursor position will be selected). You can define the search function by selecting the function with the keyboard. Refer to Text Selection. 2. The current SLink - The SMART Editor Database has to be previously defined. You can generate the database by the Create SLink - The SMART Editor DB or Create DB with IFDEF commands. You can select the database with the Current DB Path command. 3. If more than one match is found, the results are written to the L##MRef.Lst file in the TEMP directory; ## identifies the instance of SLink - The SMART Editor for whom the list was generated. The REF Multiple XRef List is updated with the results of the search. The L##MRef.Lst file is opened in Read Only mode. Each file satisfying the Link To References command is listed with the full path of the file containing the match, the line number where the function definition was found, and the line containing the matched function definition. When you double-click on a path, the source file is opened in the default edit mode specified in the Setup Options Default Open - Read Only Mode, and displayed. The cursor is placed at the line and column containing the matched function definition (or the beginning of the comment preceding the definition, if Link To Comment was specified in the SLink - The SMART Editor Options). 4. If only one match is found, the source file containing the match is opened. The cursor is placed at the line containing the match. Access  Control F11  Alt-E, N (Edit Menu, Option N) See Also: Main Menu Edit Menu Select String Current DB Path Link To Definition Link To Item Multiple Ref List ═══ 6.18. Blocks ═══ The Block command provides a method to manipulate columns of text. Features 1. The Blocks dialog panel is modeless and will stay visible while you manipulate the text columns. You can enter the column numbers and line numbers of the block or mouse select the columns or lines and press 'Columns Selected' or 'Lines Selected'. The 'Undo' will undo the last manipulation step (such as Cut). Only one step is remembered as a unit. However the standard Undo/Redo function is still available. 'Ditto' allows you to repeat an insert of whatever is in the paste buffer for the number of lines selected. The insertion will be at the column of the cursor when this command is executed. Access  Control F10  Alt-E, N (Edit Menu, Option B) See Also: Main Menu Edit Menu ═══ 6.19. Block Indents Menu ═══ The Block Indents Menu allows you to indent or de-indent a selected block of text. Access  Alt-E, E (Edit Menu, Option I) See Also: Main Menu Edit Menu Indent Selected De-Indent Selected ═══ 6.20. Indent a Selected block ═══ The Indent command allows you to indent a selected block of text a tab spacing at a time. Simply select the text to be indented and press for each indentation. Access  Tab  Alt-E, E (Edit Menu, Option I, Option I) See Also: Main Menu Edit Menu Indents Menu De-Indent Selected ═══ 6.21. De-Indent a Selected Block ═══ The De-Indent command allows you to de-indent a slected block of text one tab spacing at a time. Select the text to be de-indented and press +. Access  Shift + Tab  Alt-E, E (Edit Menu, Option I, Option R) See Also: Main Menu Edit Menu Indents Menu Indent Selected ═══ 6.22. Cases Menu ═══ The Cases Menu allows you to change the case of the selected text within the current file. Access  Alt-E, E (Edit Menu, Option E) See Also: Main Menu Edit Menu To Upper Case To Lower Case First Upper Case Reverse Case ═══ 6.23. To Upper Case ═══ The To Upper Case Command allows you to change the selected text within the current file to upper case. Access  Alt-E, E, U (Edit Menu, Cases Submenu, Option U) See Also: Main Menu Edit Menu To Lower Case First Upper Case Reverse Case ═══ 6.24. To Lower Case ═══ The To Lower Case Command allows you to change the selected text within the current file to lower case. Access  Alt-E, E, L (Edit Menu, Cases Submenu, Option L) See Also: Main Menu Edit Menu To Upper Case First Upper Case Reverse Case ═══ 6.25. First Upper Case ═══ The First Upper Case Command allows you to change the selected text within the current file so that each word of the selected text begins with upper case, and the rest of each word is lower case. Access  Alt-E, E, F (Edit Menu, Cases Submenu, Option F) See Also: Main Menu Edit Menu To Upper Case To Lower Case Reverse Case ═══ 6.26. Reverse Case ═══ The Reverse Case Command allows you to change the case of the selected text within the current file; upper case is changed to lower case, lower case is changed to upper case. Access  Alt-E, E, R (Edit Menu, Cases Submenu, Option R) See Also: Main Menu Edit Menu To Upper Case To Lower Case First Upper Case ═══ 6.27. Braces Menu ═══ The Braces Menu allows you to identify braced code within the current file. Access  Alt-E, B (Edit Menu, Option B) See Also: Main Menu Edit Menu Find Beginning Brace Find Ending Brace Select Braced Code ═══ 6.28. Find Beginning Brace ═══ The Find Beginning Brace command moves the cursor to the preceding beginning brace ( { ) and highlights it. Features 1. The current cursor location is saved prior to executing the Find Beginning Brace command. The previous location saved by the Save Cursor Position command is lost. You can return to the location prior to the Find Beginning Brace command by selecting the Goto Cursor Position command. 2. In order to walk the beginning braces, you must place the cursor inside the desired braced code. The first call to Find Beginning Brace places the cursor directly after the beginning brace. To go to the next higher level, move the cursor left two positions so that it is outside the previous level but inside the next level. Access  Alt-E, B, B (Edit Menu, Braces Submenu, Option B) See Also: Main Menu Edit Menu Find Ending Brace Select Braced Code ═══ 6.29. Find Ending Brace ═══ The Find Ending Brace command moves the cursor to the following end_brace ( } ) and highlights it. Features 1. The current cursor location is saved prior to executing the Find Ending Brace command. The previous location saved by the Save Cursor Position command is lost. You can return to the location prior to the Find Ending Brace command by selecting the Goto Cursor Position command. 2. You can walk the ending braces by making repeated calls to Find Ending Brace. Access  Control F8  Alt-E, B, E (Edit Menu, Braces Submenu, Option E) See Also: Main Menu Edit Menu Find Beginning Brace Select Braced Code ═══ 6.30. Select Braced Code ═══ The Select Braced Code command selects the code contained by the next higher level of braces ( {...} ). Features 1. Each time this is called, the next higher level of braces is selected. 2. You must use the scroll bar to see the selected code when it is off the screen. If you use the Page-Up, Page-Down or Arrow keys, the highlighted code is deselected. If you type in a key from the keyboard, the selected text will be replaced by the key you entered. If this happens, use the Undo Last Edit command to replace the lost code. Access  Shift F8  Alt-E, B, S (Edit Menu, Braces Submenu, Option S) See Also: Main Menu Edit Menu Find Beginning Brace Find Ending Brace ═══ 6.31. Parens Menu ═══ The Parens Menu allows you to identify code within parens within the current file. Access  Alt-E, A (Edit Menu, Option A) See Also: Main Menu Edit Menu Find Beginning Paren Find Ending Paren Select Code Within Parens ═══ 6.32. Find Beginning Paren ═══ The Find Beginning Paren command moves the cursor to the preceding beginning paren and highlights it. Features 1. The current cursor location is saved prior to executing the Find Beginning Paren command. The previous location saved by the Save Cursor Position command is lost. You can return to the location prior to the Find Beginning Paren command by selecting the Goto Cursor Position command. 2. In order to walk the beginning parens, you must place the cursor inside the desired paren code. The first call to Find Beginning Paren places the cursor directly after the beginning paren. To go to the next higher level, move the cursor left two positions so that it is outside the previous level but inside the next level. Access  Alt-E, A, B (Edit Menu, C Parens Submenu, Option B) See Also: Main Menu Edit Menu Find Ending Paren Select Code Within Parens ═══ 6.33. Find Ending Paren ═══ The Find Ending Paren command moves the cursor to the following end_paren and highlights it. Features 1. The current cursor location is saved prior to executing the Find Ending Paren command. The previous location saved by the Save Cursor Position command is lost. You can return to the location prior to the Find Ending Paren command by selecting the Goto Cursor Position command. 2. You can walk the ending parens by making repeated calls to Find Ending Paren Access  Control F7  Alt-E, A, E (Edit Menu, Parens Submenu, Option E) See Also: Main Menu Edit Menu Find Beginning Paren Select Code Within Parens ═══ 6.34. Select Code Within Parens ═══ The Select Code Within Parens command selects the code contained by the next higher level of parens. Features 1. Each time this is called, the next higher level of parens is selected. 2. You must use the scroll bar to see the selected code when it is off the screen. If you use the Page-Up, Page-Down or Arrow keys, the highlighted code is deselected. If you type in a key from the keyboard, the selected text will be replaced by the key you entered. If this happens, use the Undo Last Edit command to replace the lost code. Access  Shift F7  Alt-E, A, S (Edit Menu, Paren Submenu, Option S) See Also: Main Menu Edit Menu Find Beginning Paren Find Ending Paren ═══ 6.35. Carriage Returns Menu ═══ The Carriage Returns Menu allows you to insert or remove carriage returns within selected code in the current file. Access  Alt-E, U (Edit Menu, Option U) See Also: Main Menu Edit Menu Remove Carriage Returns Insert Carriage Returns ═══ 6.36. Remove Carriage Returns ═══ This function removes carriage returns that are not null lines within selected code in the current file. A space will be inserted at the point of the return. Access  Alt-E, U (Edit Menu, Option U) See Also: Main Menu Edit Menu Insert Carriage Returns ═══ 6.37. Insert Carriage Returns ═══ The Insert Carriage Returns function inserts a hard carriage return at the end of all lines greater that 70 characters within selected code in the current file. Word wrap must be active in the current file for this function to determine where to insert the carriage return. This function is provided for us in converting word processing documents to IPFC format where line lengths are limited to 128 characters. Access  Alt-E, U (Edit Menu, Option U) See Also: Main Menu Edit Menu Find Beginning Paren Remove Carriage Returns ═══ 6.38. GoTo Line ═══ The GoTo Line command prompts you for the line number desired and then moves the cursor to that location within the current file. Access  Alt G  Alt-E, L (Edit Menu, Option L) See Also: Main Menu Edit Menu GoTo Marker GoTo Cursor Position ═══ 6.39. Left Justify Line At Cursor ═══ The Left Justify Line At Cursor command moves the current line of data to begin at the location of the cursor. Access  F7  Alt-E, J (Edit Menu, Option J) See Also: Main Menu Edit Menu ═══ 6.40. Word Wrap ═══ The Word Wrap command controls the word wrap display of the current SLink - The SMART Editor file. Features 1. When you check word wrap, all characters extending beyond the right edge of the screen are continued on the next display line. 2. When you do not check word wrap, you must use the horizontal scroll bar to access all characters extending beyond the right edge of the screen. 3. The file is opened according to the Word Wrap mode in the Setup Options. When you execute this command, the current state of word wrap is changed. If word wrap is currently checked, it will be unchecked. If word wrap is currently unchecked, it will be checked. 4. The current status of word wrap is displayed with the current file information to the left of the horizontal scrollbars. SLink - The SMART Editor Header. When word wrap is checked, a 'w' appears following the line, column, and file edit mode. Access  Control W  Alt-E, W (Edit Menu, Option W) See Also: Main Menu Edit Menu ═══ 6.41. Change Edit Mode ═══ The Change Edit Mode command changes the file mode from Read Only to Edit Mode or Edit Mode to Read Only. Features 1. The current file mode is changed from Read Only to Edit or from Edit to Read Only. The default file mode is defined in the Setup Options. but can be overridden when you open the file. If the file has been edited, you will have the option to save the file prior to changing the mode to Read Only. Access  Control E  Alt-E, M (Edit Menu, Option M) See Also: Main Menu Edit Menu File Open ═══ 7. Clip Menu ═══ The Clip Menu allows for the movement of data into and out of the SLink clip file. Access Alt-I For additional information select one of the following topics:  Main Menu  Select to Clip File  Paste to Clip File  Clip File to Paste  Insert Clip File at Cursor  Display Clip File  Rename Clip File  Clear Clip File  Clip File Mode - Append ═══ 7.1. Select To Clip File ═══ The Select to Clip File command copies the selected data within the current file to the clip file. Features 1. The clip filename is defined by the Rename Clip File command. The REF Clip File is updated with the results of this command. 2. You can replace or append the selected data depending on the Clip File Mode - Append command. When you have checked the Append mode, the selected text is added to the end of the current clip file. When you have not checked the Append mode, the selected text replaces the current data in the clip file. 3. The data contained in the clip file can be retrieved later using the Clip File to Paste command or the Insert Clip File at Cursor command. Access  Shift F9  Alt-I, S (Clip Menu, Option S) See Also: Main Menu Clip Menu Copy To Paste ═══ 7.2. Paste To Clip File ═══ The Paste to Clip File command copies the paste buffer to the clip file. Features 1. The clip filename is defined by the Rename Clip File command. The REF Clip File is updated with the results of this command. 2. You can replace or append the selected data depending on the Clip File Mode - Append command. When you have checked the Append mode, the paste buffer is added to the end of the current clip file. When you have not checked the Append mode, the paste buffer replaces the current data in the clip file. 3. The data contained in the clip file can be retrieved later using the Clip File to Paste command or the Insert Clip File at Cursor command. Access  Control F9  Alt-I, P (Clip Menu, Option P) See Also: Main Menu Clip Menu Paste ═══ 7.3. Clip File To Paste ═══ The Clip File To Paste command copies the data from the clip file to the paste buffer. Features 1. The clip filename is defined by the Rename Clip File command. Access  Alt-I, F (Clip Menu, Option F) See Also: Main Menu Clip Menu Copy To Paste Cut To Paste ═══ 7.4. Insert Clip File at Cursor ═══ The Insert Clip File at Cursor command copies the clip file to the current cursor position within the current file. Features 1. The clip filename is defined by the Rename Clip File command. Access  Control I  Alt-I, C (Clip Menu, Option C) See Also: Main Menu Clip Menu Read Into Cursor Paste ═══ 7.5. Display Clip File ═══ The Display Clip File command opens the clip file in Read Only mode and displays it. Features 1. The clip filename is defined by the Rename Clip File command. 2. The clip file can also be displayed by the REF Clip File command. Access  Alt-I, D (Clip Menu, Option D) See Also: Main Menu Clip Menu ═══ 7.6. Rename Clip File ═══ The Rename Clip File command defines the name of the clip file. Features 1. You must specify the name of the clip file. The default filename is SL_Clip.Tmp in the TEMP directory. The Select File Dialog Panel is displayed. You are prompted to select the drive, directory and/or filename. 2. All clip commands use the clip file that is defined here. Access  Alt-I, N (Clip Menu, Option N) Controls  Select The Select button prompts you to select the name of the clip file (the Select File dialog panel will be displayed for filename selection).  Filename data entry panel You may type in the name of the file (e.g. CLIPFILE.TXT). This can optionally include the full path.  OK When you choose the OK button, the previously defined filename is used for the clip filename.  Cancel When you choose the Cancel button, the current command is cancelled.  Help (H) When you choose the Help button, the corresponding on-line help is displayed. See Also: Main Menu Clip Menu ═══ 7.7. Clear Clip File ═══ The Clear Clip File command clears the contents of the clip file. Features 1. The clip filename is defined by the Rename Clip File command. Access  Alt-I, E (Clip Menu, Option E) See Also: Main Menu Clip Menu ═══ 7.8. Clip File Mode ═══ The Clip File Mode command checkbox toggles between appending or overwriting data to the clip file. Features 1. The clip filename is defined by the Rename Clip File command. 2. When you have checked the Append mode, the Select to Clip File command and Paste to Clip File command add the text to the end of the current clip file. 3. When you have not checked the Append mode, the Select to Clip File command and Paste to Clip File command replace the current data in the clip file. Access  Alt-I, M (Clip Menu, Option M) See Also: Main Menu Clip Menu ═══ 8. More Menu ═══ The More Menu allows for editing involving multiple SLink - The SMART Editor files or general SLink - The SMART Editor commands and options. Access Alt-M For additional information select one of the following topics:  Main Menu  Copy Files  Delete Files  Find Files  Search Files  File Attributes  Show OS/2 Window  Multi-File/String Replace  Replace Multiple Words  Printing Menu  Print Current File  Printer Setup  Print Formatting Options  Window Configuration  Window Control Menu  Sync Scroll  Swap Windows  Swap Focus  HyperTrack Menu  HyperTrack Backwards  HyperTrack Forwards  Place Marker Menu  Set Marker  Goto Marker  Cursor Menu  Save Cursor Position  Goto Cursor Position  Snapshot Menu  Take Snapshot  Restore Snapshot  File Buffers Menu  Next File  Last File ═══ 8.1. Copy Files ═══ The Copy Function copies and moves files. Features 1. You can specify that the source filenames are contained in a file. This file must be created with the Maintain Files List command. You must check the 'From' is a List checkbox. 2. If you do not specify the source in a file ('From" is a List), you must define the source directory. You can double-click on a directory in the From directory listbox. You can type in a valid directory name in the From File data entry box and choose the CD 1 button. When you type in a higher level directory name in the file data entry box, you must type in the full path terminated by a slash; e.g. C:\OS2\SUBDIR\. unless '..' is entered. When you type in a lower level directory name, you do not have to type in the full path; you can type in the sub-directory name. If you do type in the full path preceded by the drive, however, you do not have to terminate the name with a slash. 3. You can select which files appear in the From Filenames listbox by using a wildcard. You can choose the *.* button and all files within the current directory will be displayed. You can choose the *.C button and all files with a C extension will be displayed. You can choose the *.H button and all files with an H extension will be displayed. You can type in your own wildcard in the Wildcard listbox and choose the Display button and only those files satisfying your wildcard will be displayed. You can press the arrow to the right of the Wildcard listbox and select from the list of wildcards that are displayed. 4. You can deselect all files in the From Filenames listbox by choosing the Clear button. 5. You can specify that all sub-directory files which satisfy the file specifications are to be included in the copy or move. The sub-directories will automatically be created during the copy process if they do not exist on the destination. 6. You can copy to multiple floppies. When the destination device is floppy and the files to be copied do not fit on the current floppy, you will be prompted to insert a new floppy. The necessary sub-directories will be created on the new floppy if they do not already exist. 7. You must define the destination directory. You can double-click on a directory in the To directory listbox. You can type in a valid directory name in the To File data entry box and choose the CD 2 button. When you type in a higher level directory name in the file data entry box, you must type in the full path terminated by a slash; e.g. C:\OS2\SUBDIR\. unless '..' is entered. When you type in a lower level directory name, you do not have to type in the full path; you can type in the sub-directory name. If you do type in the full path preceded by the drive, however, you do not have to terminate the name with a slash. 8. You can make a destination sub-directory. The new directory is created off of the current destination directory. You can type in a directory name in the To File data entry box and choose the Make Dir button. If you choose the Make Dir button and there is no directory name entered in the To File data entry box, the new directory name is derived from the last directory name in the current source directory. 9. You can qualify the files that are to selected by defining file Parameters. You can specify date/time stamp restrictions. You can specify file attribute restrictions. 10. You can specify two levels of verification. You can verify which source sub-directories are to be included. When the file to be copied or moved already exists on the destination, you can specify that you want to be prompted before overwriting that file. 11. The available space on the destination drive is displayed. The free space is updated as the copy is executed. Access  Alt C  Alt-M, C (More Menu, Option C) Controls  [From] Dir: The directory containing the files to be copied is displayed.  [From] File: This data entry box displays the source file(s) selected and allows you to type the source filename(s) to be copied or moved. When one file is selected, its filename is displayed. When multiple files are selected, '(multiple files)' is displayed. When a wildcard is selected, it will be displayed; e.g. *.C. To change a directory, you may type in a new directory path and choose the CD 1 button. The directory name must end with a \ (e.g. C:\NEWDIR\). The From Directories listbox and Files listbox are updated. You may type in the name of the file to be copied or moved (e.g. NEWFILE.C). You may type in the full path, drive, directory, and filename (e.g. C:\NEWDIR\NEWFILE.C) of the file to be copied or moved.  Drives This listbox contains drives. You may select the base drive from this list.  (From) Directories Button This button will popup a user maintainable list box to contain your most often accessed directories.  (From) Directories Listbox This listbox contains directories. You may select the base directory from this list.  (From) Match Press this button to match the 'To' directory with the 'From' directory.  (From) Filenames This listbox contains a list of files satisfying the current wildcard (usually *.*) which are contained within the selected source drive and directory. You may select the filename(s) of the file(s) to be copied or moved.  Display (D) The Display button updates the From Filenames listbox according to the current wildcard which is displayed in the Wildcard data entry box.  Wildcard: The Wildcard data entry box allows you to type in your own From Filenames wildcard. When you choose the Display button, the From Filenames listbox is updated. When you press the arrow to the right of the Wildcard data entry box, a list of Wildcards appears. You can select a wildcard form this list.  CD 1 (1) The CD 1 button changes the source directory to the directory name entered on the From File data entry box.  Clear (E) When you choose the Clear button, all files in the From Filenames listbox are deselected.  *.* (*) The *.* button updates the From Filenames wildcard. When you choose this button, the From Filenames listbox displays all of the files in the current source directory. Double click (right mouse button) on this button to customize the button for your own use.  *.C (C) The *.C button updates the From Filenames wildcard. When you choose this button, the From Filenames listbox displays all of the files in the current source directory satisfying the *.C wildcard. Double click (right mouse button) on this button to customize the button for your own use.  *.H (H) The *.H button updates the From Filenames wildcard. When you choose this button, the From Filenames listbox displays all of the files in the current directory satisfying the *.H wildcard. Double click (right mouse button) on this button to customize the button for your own use.  Select All (A) When you check the Select All Checkbox, all files in the From Filenames listbox are selected.  Include All Sub-Dirs (S) When you check the Include All Sub-Dirs Checkbox, all files from all sub-directories which satisfy the current wildcard will be included in the copy or move. If a destination sub-directory name does not exist, it will be created.  [To] Dir: The destination directory that is to contain the copied or moved files is displayed.  [To] File: This data entry box displays the filename of the file to contain the copied or moved file. This is valid only when one file is being copied or moved. To change a directory, you may type in a new directory path and choose the CD 2 button. The directory name must end with a \ (e.g. C:\NEWDIR\). The To Directories listbox and Files listbox are updated. You may type in the name of the destination file (e.g. NEWFILE.C). You may type in the full path, drive, directory, and filename (e.g. C:\NEWDIR\NEWFILE.C) of the destination file.  Drives This listbox contains drives. You may select the base drive from this list.  Directories Button This button will popup a user maintainable list box to contain your most often accessed directories.  (To) Directories Listbox This listbox contains directories. You may select the base directory from this list.  (To) Filenames This listbox contains a list of files satisfying the current wildcard (usually *.*) which are contained within the selected destination drive and directory. You may select the destination filename.  Make Dir (K) When you choose the Make Dir button, a new directory is created off of the current destination directory. If there is a directory name entered in the To File data entry box, it defines the name of the new directory. Otherwise, the name is derived from the last directory name in the current source directory.  CD 2 (2) The CD 2 button changes the destination directory to the directory name entered on the To File data entry box.  Same File (2) Press this button to automatically enter a filename in the 'To' filename file that will be the same as the 'From' filename field. Note: if multiple files have been chosen in the 'From' filename field, this button will have no effect.  Verify File to Overwrite (O) When you check the Verify File to Overwrite Checkbox, you will be prompted each time a source file already exists in the destination directory. When you uncheck this Checkbox, the destination file will be overwritten.  Verify Sub-Dirs (U) When you check the Verify Sub-Dirs Checkbox, you will be prompted for each sub-directory involved in the copy.  From Is A List (F) When you check the From Is A List Checkbox, the source file to be copied is a file containing the list of files to be copied. This file should be previously created with the Link-Maintain a List of Files command.  [drive free] The current destination drive is displayed with the amount of available free space.  Copy [Y] When you choose the Copy button, the previously defined files are copied from the source to the destination.  Move [M] When you choose the Move button, the previously defined files are moved from the source to the destination. The files will be deleted from the source directory.  Cancel When you choose the Cancel button, the current command is cancelled.  Help (L) When you choose the Help button, the corresponding on-line help is displayed.  Parameters (P) The Parameters button activates a Parameters dialog panel which enables you to define parameters affecting the selection of files in the copy or move.  Parameters Status The Parameters Status displays the status of the file parameters. If there are parameters set, the display will say 'SET'; otherwise the display will say 'none'. See Also: Main Menu More Menu Maintain Files List Parameters Dialog Panel ═══ 8.2. Delete Files ═══ The Delete Files command deletes files and directories. Features 1. You must define the directory containing the files to be deleted. You can double-click on a directory in the Directory listbox. 2. You can select which files appear in the Filenames listbox by entering a wildcard. You can select a wildcard from a list of wildcards that is displayed when you press the arrow to the right of the wildcard data entry box. You can choose the *.* button and all files within the current directory will be displayed. You can choose the *.C button and all files with a C extension will be displayed. You can type in your own wildcard in the Wildcard listbox and choose the Display button and only those files satisfying your wildcard will be displayed. 3. You can deselect all files in the Filenames listbox by choosing the Clear button. 4. You can specify that all files displayed in the Filenames listbox are to be deleted by checking the Delete All Files Displayed checkbox. 5. You can delete all subdirectory files matching the selection criteria by checking the Delete Sub-Directory Files checkbox. 6. You can delete directories. You can delete the current directory by checking the Remove THIS Directory checkbox. All files within the current directory will automatically be deleted. You will be prompted before the directory is removed. You can remove all subdirectories and their files by checking the Remove Sub-Directories checkbox. If you check the Verify Sub-Directories checkbox, you will be prompted first. 7. You can be prompted prior to deleting each file if you check the Verify Each File Delete checkbox. 8. The amount of free space on the current drive is displayed. The free space is updated as the delete is executed. Access  Alt D  Alt-M, D (More Menu, Option D) Controls  Dir: The current directory is displayed.  File: You may type in the name of the file to be deleted (e.g. NEWFILE.C). You may type in the full path, drive, directory, and filename (e.g. C:\NEWDIR\NEWFILE.C) of the file to be deleted.  Drives This listbox contains drives. You may select the base drive from this list.  Directories Button This button will popup a user maintainable list box to contain your most often accessed directories.  Directories Listbox This listbox contains directories. You may select the base directory from this list.  Filenames This listbox contains a list of files satisfying the current wildcard (usually *.*) which are contained within the selected drive and directory. You may select the filename(s) of the file(s) to be deleted.  Display (D) The Display button updates the Filenames listbox according to the current wildcard which is displayed in the Wildcard data entry box.  Wildcard: The Wildcard data entry box allows you to enter your own filenames wildcard. When you choose the Display button, the Filenames listbox is updated. When you press the arrow to the right of the Wildcard data entry box, a list of Wildcards appears. You can select a wildcard form this list.  [drive free] The current drive is displayed with the amount of available free space.  Delete All Files Displayed (A) When you check the Delete ALL Files Displayed Checkbox, all files in the Filenames listbox are selected.  Delete Sub-Dir. Files (S) When you check the Delete Sub-Dir. Files Checkbox, all files in all sub-directories will be deleted.  Verify Each File Delete (V) When you check the Verify Each File Delete Checkbox, you will be prompted for each file to be deleted.  Remove THIS Directory (T) When you check the Remove THIS Directory Checkbox, the current directory will be deleted.  Remove Sub-Dirs (M) When you check the Remove Sub-Dirs Checkbox, all sub-directories will be deleted.  Verify Sub Dirs (E) When you check the Verify Sub Dirs Checkbox, you will be prompted for each sub-directory to be deleted.  Delete [L] When you choose the OK-Delete button, the previously defined files and directories are deleted.  Cancel When you choose the Cancel button, the current command is cancelled.  Clear [R] When you choose the Clear button, the files listbox is deselected.  *.* (*) The *.* button updates the Filenames wildcard. When you choose this button, the Filenames listbox displays all of the files in the current directory. Double click (right mouse button) on this button to customize the button for your own use.  *.C (C) The *.C button updates the Filenames wildcard. When you choose this button, the Filenames listbox displays all of the files in the current directory satisfying the *.C wildcard. Double click (right mouse button) on this button to customize the button for your own use.  Help (H) When you choose the Help button, the corresponding on-line help is displayed. See Also: Main Menu More Menu ═══ 8.3. Find Files ═══ The Find Function locates all of the copies of the specified file(s). Features 1. You must specify the name of the file(s) to be searched. You can specify a wildcard; e.g. *.C. You can specify a specific filename; e.g.Myfile.C. 2. You must specify the directories to be searched. You can change the current directory. You can specify the root directory is the base directory by checking the Root is Base Directory check box; if this is not checked, the directory entered in the Base Directory data entry box is the base directory. You can specify that sub-directories are also to be searched by checking the Search Sub-directories checkbox; if this is not checked, only the base directory is searched. 3. You can search multiple drives. When you select the multiple drive options, you can check the drives that you wish to search. The search results of all of the drives will be contained in the same report. 4. The search will continue until all directories have been totally searched unless you check the Find First Only checkbox. 5. You can search multiple directories. At the completion of each selected directory, you will be prompted to change to the next directory. At the completion of all directories, press 'Done' to stop the process. 6. You can qualify the files that are to selected by defining file Parameters. You can specify date/time stamp restrictions. You can specify file attribute restrictions. You can specify that the file search display be in the 'List-of-Files' format for use in SMART or wherever a files list is required. 7. The results are stored in the L##Find.Lst file which resides in the TEMP directory; ## identifies the instance of SLink - The SMART Editor for whom the list was generated. The L##Find.Lst file is opened in Read-only Mode. The REF Find Files List is updated with the results. Each file satisfying the search is listed with its size and date/time stamp. When you double-click on one of the listed files, it is opened in the default edit mode specified in the Setup Options Default Open - Read-only Mode, and displayed. Access  Alt N  Alt-M, N (More Menu, Option N) Controls  Enter File To Find You must type in the filename of the file to be located.  Base Dir [data entry box]: The base directory is displayed. You can type in a new base directory.  Drives This listbox contains drives. You may select the base drive from this list.  Directories Button This button will popup a user maintainable list box to contain your most often used directories.  Directories Listbox This listbox contains directories. You may select the base directory from this list.  Multiple Directories (M) When you check the Multiple Directories Checkbox, you will be prompted at the end of each directory to select the next drive to be searched. The results of all of the directories will be contained in the same report.  Multiple Drives (M) When you check the Multiple Drives Checkbox, you can select drives to be searched including an option to search all fixed drives. The results of all of the drives will be contained in the same report.  ROOT is Base Dir (R) When you check the ROOT is Base Dir Checkbox, the root directory of the current drive becomes the base directory for the find. When you uncheck the ROOT is Base Dir Checkbox, the directory displayed in the Base Directory data entry box becomes the base directory for the find.  Search Sub-Dirs (S) When you check the Search Sub-Dirs Checkbox, all sub-directories will be included in the find.  Find First Only (O) When you check the Find First Only Toggle, the find is terminated after finding the first occurrence of filename. When the Find First Only Toggle is unchecked, the find locates all occurrences of filename.  List-of-Files Format (O) By checking this option box, the find file display will be in the format for 'List-of-Files'. This display can be saved an used anywhere a list is required by SMART or The SMART Editor. This saves a great deal of your time when you are preparing a list-of-files of all .C and ,H files in the root and all sub-directories of your project.  File Types You can select the file types to be included in the search. You can select the *.C, *.H or *.LST buttons. You can enter your own wildcard in the file types data entry box. Double click ( right mouse button) on this button to customize the button for your own use. You can select from a list of predefined file types by pressing the down arrow to the right of the file types data entry box, selecting a file type, and then pressing the arrow to the left of the file types box.  Parameters (P) The Parameters button activates a Parameters Dialog Panel which enables you to define parameters affecting the selection of files in the find.  Parameters Status The Parameters Status displays the status of the file parameters. If there are parameters set, the display will say 'PARAMETERS SET'; otherwise the display will say 'NO PARAMETERS'.  Find [F] When you choose the Find button, the previously defined find is executed.  Cancel When you choose the Cancel button, the current command is cancelled.  Chg Dir [D] When you choose the Chg Dir button, the current directory is changed to the directory previously defined in the Base Dir data entry box.  Help (L) When you choose the Help button, the corresponding on-line help is displayed. See Also: Change Button Text Main Menu More Menu Find Files List ═══ 8.4. Multi-File Search ═══ The Multi-File Search command searches all of the specified files for the defined search string. Features 1. You must define the string to be searched. You can type in a new string. You can define the string prior to executing this command with the Select String command. You can define the search function by clicking once with the mouse (the word at the current cursor position will be selected). You can choose the Last Search button and the string used in the last search is selected. 2. You must define the directory containing the files to be searched. You can change the current directory. You can double-click on a directory in the Directory listbox. You can check the Search Sub Directories check box and the selected directory will be treated as a base directory; all sub directories will also be searched. 3. You must define which files are to be searched. You can choose the *.* button and all files within the specified directory will be searched. You can choose the *.C button and all files with a C extension within the specified directory will be searched. You can choose the *.H button and all files with an H extension within the specified directory will be searched. You can type in your own filename or wildcard in the File Selection data entry box. You can select from a list of predefined file types 4. The scan status is displayed showing the status of the search. The Percent Complete Bar displays the percent complete based on the file sizes of all files to be searched. The Elapsed Time displays the time that has elapsed since the search started. The Time Remaining displays the time remaining to complete the search, based on the estimated time. The Estimated Total Scan Time displays the total time to do the search. The Number of Files Completed is the number of files that have been searched. The Number of Files to Scan is the total number of file to be searched. The Size of All Files Scanned is the total file size of all files to be searched. The Filename of Current File Scanned is the name of the current file being searched. The Number of Matches is the number of matches found. 5. If you specified in the Setup Options that you want to be notified, you will be beeped when the search is done. 6. The results are stored in the L##Srch.Lst file which resides in the TEMP directory; ## identifies the instance of SourceLink for whom the list was generated. The L##Srch.Lst file is opened in Read-only Mode. The REF String Search List is updated with the results. Each match found is listed with the full path of the file containing the match, the line and column number where the string was found, and the line containing the matched string. When you double-click on a path, the file is opened in the Setup Options Default Open - Read-only Mode, and displayed. The cursor is placed at the matched string. Access  Alt-S  Alt-M, S (More Menu, Option S) Controls  Drives This listbox contains drives. You may select the base drive from this list.  Directories Button This button will popup a user maintainable list box to contain your most often accessed directories.  Directories Listbox This listbox contains directories. You may select the base directory from this list.  Enter Search String You must type in the string to be searched. The Last Search button redisplays the last string searched in this data entry box.  Case Sensitive (A) The Case Sensitive Toggle defines whether the string to be searched is to be case sensitive (upper and lower case must be matched).  Search Sub-Dirs (S) When you check the Search Sub-Dirs Checkbox, all sub-directories will be included in the search.  File Selection This data entry box displays the filename or wildcard of files to be searched. You may type in the filename or wildcard of files to be searched. You can select from a list of predefined file types by pressing the down arrow to the right of the file selections data entry box, selecting a file type, and then pressing the arrow to the left of the file selections data entry box.  *.* (*) The *.* button updates the File Selection data entry box. When you choose this button, all files in the specified directories will be searched. Double click (right mouse button) on this button to customize the button for your own use.  *.C (C) The *.C button updates the File Selection data entry box. When you choose this button, all files matching the *.C wildcard in the specified directories will be searched. Double click (right mouse button) on this button to customize the button for your own use.  *.H (H) The *.H button updates the File Selection data entry box. When you choose this button, all files matching the *.H wildcard in the specified directories will be searched. Double click (right mouse button) on this button to customize the button for your own use.  Base Dir: The base directory is displayed. You can type in a new base directory.  Search Current File Press this button to search the current displayed file only. This will override any other file and directory search specification.  OK When you choose the OK button, the previously defined search is executed. The scan status is displayed showing the following information: Percent Complete Bar Elapsed Time Time Remaining Estimated Total Scan Time Number of Files Completed Number of Files to Scan Size of All Files Scanned Filename of Current File Scanned Number of Matches Found The results are written in the "L##Srch.Lst" file in the TEMP directory; ## identifies the instance of SourceLink for whom the list was generated. The L##Srch.Lst file is then opened in Read-only mode.  Cancel When you choose the Cancel button, the current command is cancelled.  Last Search (T) The Last Search button redefines the search string as the search string from the last search.  Chg Dir [D] When you choose the Chg Dir button, the current directory is changed to the directory previously defined in the Base Dir data entry box.  Help (L) When you choose the Help button, the corresponding on-line help is displayed. See Also: Main Menu Multi-File Search List Search Current File ═══ 8.5. File Attributes ═══ The file attributes command sets the attributes of any directory or file. Features 1. You can display the attributes of directories and files. The current directory is displayed at the top of the panel (Dir:); its attributes are displayed directly below the directory name (Dir Attributes:). If you click on a single file, its name is displayed in the File data entry box and its attributes are displayed beside the name (File Attr:). Each file displayed in the Filenames listbox has its attributes displayed directly beside its name. 2. You can change the current directory by the following actions: You can double-click on a directory in the directory listbox. You can type in the directory name in the file data entry box and choose the ChgDir button. When you type in a higher level directory name in the file data entry box, you must type in the full path terminated by a slash; e.g. C:\OS2\SUBDIR\. unless '..' is entered. When you type in a lower level directory name, you do not have to type in the full path; you can type in the sub-directory name. If you do type in the full path preceded by the drive, however, you do not have to terminate the name with a slash. 3. You can select which files appear in the Filenames listbox by using a wildcard. You can choose the *.* button and all files within the current directory will be displayed. You can choose the *.C button and all files with a C extension will be displayed. You can type in your own wildcard in the Wildcard listbox and choose the Display button and only those files satisfying your wildcard will be displayed. You can press the arrow to the right of the Wildcard listbox and select from the list of wildcards that are displayed. 4. You can set the attributes on all selected files and/or directories. You can set the attributes on selected files only by checking the Set Files Only checkbox. You can set the attributes on directories only by checking the Set Directory Header Only checkbox. You can set the attributes on selected files and directories by checking the Set Files and Directory Headers checkbox. 5. You can specify which files are selected. You can click on multiple files in the Filenames listbox. You can check the Select All Displayed checkbox and all files displayed in the Filenames listbox will be selected. You can choose the Clear Selections button and all files displayed in the Filenames listbox will be deselected. You can include all sub-directory files by checking the Include ALL Sub-dirs checkbox. 6. You can have SourceLink prompt you prior to setting the attributes on directory headers by checking the Verify Set Dirs checkbox. 7. You can select which attributes are to be set. You can check the Archive checkbox. When you choose the Set Attributes button this attribute will be set on all selected files and/or directories. You can check the Read-only checkbox. (This attribute specifies that the associated file/directories are available for Read-only; i.e. they cannot be updated or deleted.) When you choose the Set Attributes button this attribute will be set on all selected files and/or directories. You can check the Hidden checkbox. (This attribute specifies that the associated file/directories are not normally displayed or selected; e.g. when you copy files, hidden files will not be copied unless you specifically set the hidden attribute in the Parameters Dialog Panel or know the name and type in it.) When you choose the Set Attributes button this attribute will be set on all selected files and/or directories. You can check the System checkbox. (This attribute specifies that the associated file/directories are not normally displayed or selected; e.g. when you copy files, system files will not be copied unless you specifically set the hidden attribute in the Parameters Dialog Panelor know the name and type in it.) When you choose the Set Attributes button this attribute will be set on all selected files and/or directories. Access  Alt A  Alt-M, A (More Menu, Option A) Controls  Dir: The current directory is displayed.  Dir Attributes: The attributes of the current directory are displayed.  File: You may type in a new directory path; this must end with a \ (e.g. C:\NEWDIR\) unless moving to a sub-directory. The directories listbox, files listbox and File Attributes are updated. You may type in the name of the file to be updated (e.g. NEWFILE.C). You may type in the full path, drive, directory, and filename (e.g. C:\NEWDIR\NEWFILE.C) of the file to be updated.  File Attributes: The attributes of the current file are displayed.  Drives This listbox contains drives. You may select the base drive from this list.  Directories Button This button will popup a user maintainable list box to contain your most often accessed directories.  Directories Listbox This listbox contains directories. You may select the base directory from this list.  Filenames This listbox contains a list of files satisfying the current wildcard (usually *.*) which are contained within the selected drive and directory. You may select the filename of the file to be updated.  Attributes: The attributes of each file in the Filenames listbox are displayed.  ChgDir (G) The ChgDir button updates the current directory from the directory selected in the Directories listbox or entered in the File data entry box.  Display (P) The Display button updates the Filenames listbox according to the current wildcard which is displayed in the Wildcard data entry box.  Wildcard: The Wildcard data entry box allows you to type in your own filenames wildcard. When you choose the Display button, the Filenames listbox is updated. You can press the arrow to the right of the Wildcard listbox and select from the list of wildcards that are displayed.  *.* (*) The *.* button updates the Filenames wildcard. When you choose this button, the Filenames listbox displays all of the files in the current directory. Double click (right mouse button) on this button to customize the button for your own use.  *.C (C) The *.C button updates the Filenames wildcard. When you choose this button, the Filenames listbox displays all of the files in the current directory satisfying the *.C wildcard. Double click (right mouse button) on this button to customize the button for your own use.  Archive (A) This Checkbox defines the archive attribute. When you check this Checkbox, the archive attribute is enabled.  Read-only (R) This Checkbox defines the Read-only attribute. When you check this Checkbox, the Read-only attribute is enabled.  Hidden (D) This Checkbox defines the Hidden attribute. When you check this Checkbox, the Hidden attribute is enabled.  System (S) This Checkbox defines the System attribute. When you check this Checkbox, the System attribute is enabled.  Select ALL Displayed [L] All files in the Files listbox are selected.  Verify Set Dir [V] If this option is checked, you are prompted before making any changes to the directory attributes.  Include All Sub-Directories (I) If this option is checked, all sub-directory files are included in the update.  Set Files Only [F] If this is checked, only files will be updated; directory headers will not be updated.  Set Files and Directory Headers [N] If this is checked, files and directory headers will be updated.  Set Directory Header Only [O] If this is checked, only the directory header will be updated; files will not be updated.  Set Attributes [T] When you choose the Set Attribute button, the files and directories selected above will be updated with the previously defined attributes.  Clear Selections [E] When you choose the Clear Selections button, all files in the files listbox are de_selected.  Cancel When you choose the Cancel button, the current command is cancelled.  Help (H) When you choose the Help button, the corresponding on-line help is displayed. See Also: Main Menu More Menu ═══ 8.6. Show OS/2 Window ═══ The Show OS/2 Window command creates or displays an OS/2 window associated with the SourceLink session. Features 1. An OS/2 Window will be created and accessible for the duration of the SourceLink session. 2. The CMD.EXE command processor is the default, however, you can assign an alternate command processor such as 4OS2. The alternate command processor is specified in the Setup Options Command Processor data entry box. Access  Alt W  Alt-M, W (More Menu, Option W) See Also: Main Menu More Menu ═══ 8.7. Multi-File Replace Function ═══ The Multi-File/String Replace command allows you to replace multiple strings within multiple files. Features 1. You must define the files to be searched. You must previously create a file which contains a list of all of the files that are involved in the multi-file replace. This file must be created with the Maintain Files List command. You can type in the filename of this file or select the filename with the Select File Dialog Panel command. 2. You must define the search strings and replace strings. You must previously create a file containing all of the search and replace strings which act on each file in the list of files. Each replace string set contains 2 lines; a line containing the string to be searched, followed by a line containing the replace string. Each line is terminated by a carriage return. 3. There are several levels of verification allowed. You can specify No verification is to be done. All files will be updated with all matched strings. You can specify File verification. For each source file, the filename will be displayed and you will be prompted to specify whether the file should be updated. You can specify String verification. For each string, the string will be displayed and you will be prompted to specify whether the string should be replaced in the specified files. You can specify Replace iteration verification. For each string within each file, the cursor will be placed at the search string, the replace string will be displayed, and you will be prompted to specify whether the string at that location should be replaced. 4. For each search found, the cursor is moved to the string satisfying the search and the string is highlighted. If replace verification is checked, you are shown the replace string and are prompted to verify the replacement. If the replacement is verified or if the verify is not checked, the replace string replaces the search string at the current cursor location. 5. The search continues until all matches in all files are replaced. Access  Alt-M, R (More Menu, Option R) Controls  Select Files: [F] This entry allows you to select the file containing the list of files to be searched (the File Select dialog panel will be displayed for filename selection). You may select the filename or type in the directory and filename. This file must be previously created with the Maintain a List of Files command.  Files data entry box. This Files data entry box allows you to type in the file containing the list of files to be searched. This file must be previously created with the Maintain a List of Files command.  Select Replacements: [R] This entry allows you to select the file containing the list of strings to be searched and replaced. You may select the filename or type in the directory and filename. This file must be previously created. Each replace string set contains a line containing the string to be searched, followed by a line containing the replace string. Each line is terminated by a carriage return.  Replacements data entry box. The Replacements data entry box allows you to type in the file containing the list search and replace strings. This file must be previously created. Each replace string set contains a line containing the string to be searched, followed by a line containing the replace string. Each line is terminated by a carriage return.  OK When you choose the OK button, the previously defined multi-file replace is done.  Cancel When you choose the Cancel button, the current command is cancelled.  Help (H) When you choose the Help button, the corresponding on-line help is displayed. See Also: Main Menu More Menu Multi-File Search Search Search Backwards Continue Search Replace Maintain Files List Select File ═══ 8.8. Replace Multiple Words ═══ The Replace Multiple Words command allows you to replace multiple words within multiple files. The words must not contain a terminator such as space, colon, period, etc. Features 1. You must define the files to be searched. You must previously create a file which contains a list of all of the files that are involved in the multiple word replace. This file must be created with the Maintain Files List command. You can type in the filename of this file or select the filename with the Select File Dialog Panel command. 2. You must define the search strings and replace strings. You must previously create a file containing all of the search and replace strings which act on each file in the list of files. Each replace string line contains a word to be replaced followed by a space and then the replacement. Each line is terminated by a carriage return. 3. There are several levels of verification allowed. You can specify No verification is to be done. All files will be updated with all matched strings. You can specify File verification. For each source file, the filename will be displayed and you will be prompted to specify whether the file should be updated. You can specify String verification. For each string, the string will be displayed and you will be prompted to specify whether the string should be replaced in the specified files. You can specify Replace iteration verification. For each string within each file, the cursor will be placed at the search string, the replace string will be displayed, and you will be prompted to specify whether the string at that location should be replaced. 4. For each search found, the cursor is moved to the string satisfying the search and the string is highlighted. If replace verification is checked, you are shown the replace string and are prompted to verify the replacement. If the replacement is verified or if the verify is not checked, the replace string replaces the search string at the current cursor location. 5. The search continues until all matches in all files are replaced. Access  Alt-M, W (More Menu, Option W) Controls  Files List Select This entry allows you to select the file containing the list of files to be searched (the File Select dialog panel will be displayed for filename selection). You may select the filename or type in the directory and filename. This file must be previously created with the Maintain a List of Files command.  Files entry box. This Files entry box allows you to type in the file containing the list of files to be searched. This file must be previously created with the Maintain a List of Files command.  Words List Select [R] This entry allows you to select the file containing the list of words to be searched and replaced. You may select the filename or type in the directory and filename. This file must be previously created. Each line in this file must contain a line having the word to be replaced followed by the replacement word. Each line is terminated by a carriage return.  Words List entry box The Replacements data entry box allows you to type in the file containing the list search and replace strings. This file must be previously created. Each replace string set contains a line containing the string to be searched, followed by a line containing the replace string. Each line is terminated by a carriage return.  Overwrite Original File Select this radio button to overwrite file with replacements.  Verify File Overwrite Check this box to enable notification and verification for each file overwrite.  Output files using Mapped Extensions Select this radio button to create new files with replacements using file extension mapping.  Extensiopn Mapping Press this button to popup a maintenance panel of file extensions.  Words in Comments Check this box to also search for words in comments.  Words in Quotes Check this box to also search for words in quotation.  Verify Each Replacement Check this box to enable notification and verification of each replacement. You may disable this feature during the replacement process.  Verify Each File Check this box to enable notification and verification of each file processed.  Process When you choose the Process button, the search and replace will begin.  Cancel When you choose the Cancel button, the current command is cancelled.  Help (H) When you choose the Help button, the corresponding on-line help is displayed. See Also: Main Menu More Menu Multi-File Search Search Search Backwards Continue Search Replace Maintain Files List Select File ═══ 8.9. Printing ═══ The Print Menu controls the printer setup, the formatting and selection of the print file, and the generation of the printed report. Access  Alt-M, P (More Menu, Option P) See Also: Main Menu More Menu Print Current File Printer Setup Print Formatting ═══ 8.10. Print Current File ═══ The Print File command allows you to print the current file or selected text from the current file. Features 1. The Print File command formats the current file for printing. All tabs are converted to spaces according to the Tab Spacing assignment in the Setup Options. Each page is printed with a heading which includes the filename, date/time of the file, and page number. If the current file has not been edited, the date displayed is the original date of the file; if the file has been edited, however, the current date/time is displayed. The formatted file, print.fmt, is written to the TEMP directory. 2. You can print selected text from the current file. When you select this menu option with selected text, you can print the selected text or the entire file. When you select this menu option with no text selected, you print the entire file. Access  Alt P  Alt-M, P, P (More Menu, Printing SubMenu, Option P) See Also: Main Menu More Menu Printer Submenu Printer Setup Print Formatting ═══ 8.11. Printer Setup ═══ The Printer Setup Command allows you to select the printer and its properties. Access  Alt-M, P, S (More Menu, Printing SubMenu, Option S) See Also: Main Menu More Menu Printer Submenu Print Current File Print Formatting ═══ 8.12. Print Formatting ═══ The Print Formatting Command allows you to specify the formatting of the document being printed. Access  Alt-M, P, O (More Menu, Printing SubMenu, Option O) See Also: Main Menu More Menu Printing Submenu Print Current File Printer Setup ═══ 8.13. Window Configuration Menu ═══ The Window Configuration Menu defines a full screen or split screen for SourceLink. Features 1. You have the option of displaying one file only which uses the entire screen. 2. You may split the screen, vertically or horizontally, allowing the display of two files at the same time. Access  Alt-M, I (More Menu, Option I) See Also: Main Menu More Menu Sync Scroll Swap Windows Swap Focus Full Screen Split Horizontal 50/50 Screen Split Horizontal 25/70 Screen Split Horizontal 75/25 Screen Split Vertical 50/50 Screen Split Vertical 25/75 Screen Split Vertical 75/25 Screen ═══ 8.14. Window Configuration Full Screen ═══ The Window Configuration Full Screen creates a full screen for SourceLink. Only one file is displayed which uses the entire screen. Access  Alt-M, I, Full Window (More Menu, Option I, Full Window) See Also: Main Menu More Menu Window Configuration Menu ═══ 8.15. Window Configuration Horizontal Split 50/50 ═══ The Window Configuration Horizontal Split 50/50 creates a horizontal split screen with two windows of equal size. Each window can contain a display a SourceLink File. Access  Alt-M, I, Horizontal 50/50 (More Menu, Option I, Horizontal 50/50 Window) See Also: Main Menu More Menu Window Configuration Menu ═══ 8.16. Window Configuration Horizontal Split 25/75 ═══ The Window Configuration Horizontal Split 25/75 creates a horizontal split screen with two windows of unequal size. The top window is smaller. Each window can contain a display a SourceLink File. Access  Alt-M, I, Horizontal 25/75 (More Menu, Option I, Horizontal 25/75 Window) See Also: Main Menu More Menu Window Configuration Menu ═══ 8.17. Window Configuration Horizontal Split 75/25 ═══ The Window Configuration Horizontal Split 75/25 creates a horizontal split screen with two windows of unequal size. The top window is larger. Each window can contain a display a SourceLink File. Access  Alt-M, I, Horizontal 75/25 (More Menu, Option I, Horizontal 75/25 Window) See Also: Main Menu More Menu Window Configuration Menu ═══ 8.18. Window Configuration Vertical Split 50/50 ═══ The Window Configuration Vertical Split 50/50 creates a vertical split screen with two windows of equal size. Each window can contain a display a SourceLink File. Access  Alt-M, I, Vertical 50/50 (More Menu, Option I, Vertical 50/50 Window) See Also: Main Menu More Menu Window Configuration Menu ═══ 8.19. Window Configuration Vertical Split 25/75 ═══ The Window Configuration Vertical Split 25/75 creates a vertical split screen with two windows of unequal size. The left window is smaller. Each window can contain a display a SourceLink File. Access  Alt-M, I, Vertical 25/75 (More Menu, Option I, Vertical 25/75 Window) See Also: Main Menu More Menu Window Configuration Menu ═══ 8.20. Window Configuration Vertical Split 75/25 ═══ The Window Configuration Vertical Split 75/25 creates a vertical split screen with two windows of unequal size. The left window is larger. Each window can contain a display a SourceLink File. Access  Alt-M, I, Vertical 75/25 (More Menu, Option I, Vertical 75/25 Window) See Also: Main Menu More Menu Window Configuration Menu ═══ 8.21. Window Control Menu ═══ The Window Control Menu allows you to control the interaction between split windows. Access  Alt-M, O (More Menu, Option O) See Also: Main Menu More Menu Sync Scroll Swap Windows Swap Focus ═══ 8.22. Sync Scroll ═══ The Sync Scroll command enables you to lock two files together so that they scroll together. Features 1. This command is enabled when there are two windows displayed. 2. The active window becomes the master, the other window the slave. When the master window is scrolled, the slave window scrolls too. When the slave window is scrolled, however, the master window does not follow. Access  Alt-M, O, S (More Menu, Window Control Submenu, Option S) See Also: Main Menu More Menu Swap Focus Swap Windows ═══ 8.23. Swap Windows ═══ The Swap Windows command swaps the files displayed on the screen. Features 1. This command is enabled when there are two windows displayed. 2. Each file is moved to the other display window. Access  Alt-M, O, W (More Menu, Window Control Submenu, Option W) See Also: Main Menu More Menu Swap Focus ═══ 8.24. Swap Focus ═══ The Swap Focus command moves the focus from the active window to the inactive window, thereby activating the inactive window. Features 1. This command is enabled when there are two windows displayed. 2. The active window contains the current SourceLink file. 3. When you swap the focus, you make the file from the inactive window the current SourceLink file. Access  Alt-M, O, F (More Menu, Window Control Submenu, Option F) See Also: Main Menu More Menu Swap Windows ═══ 8.25. Hypertrack Menu ═══ The Hypertrack Menu allows you to go backward and forward along an established hyperlink path. A hyperlink path includes all hyperlinks for symbols, defines, globals, dialog panels and your own private link specifications. Hypertracking is like the multiple Undo/Redo function. After you have double clicked (or opened files) on your way through your source code, you may traverse backward along this path by selecting to hypertrack in the reverse direction. You then have the option of moving forward along the previously created hyperpath by selecting to hypertrack in the forward direction. Access  Alt-M, H (More Menu, Option H) See Also: Main Menu More Menu Hypertrack Forward Hypertrack Backward ═══ 8.26. Hypertrack Forward ═══ The Hypertrack Forward command returns the cursor to the forward link in the hypertrack chain. Hypertracking is like the multiple Undo/Redo function. After you have double clicked (or opened files) on your way through your source code, you may traverse backward along this path by selecting to hyperlink in the reverse direction. You then have the option of moving forward along the previously created hyperpath by selecting to hyperlink in the forward direction. Access  Control F  Alt-M, H, F (More Menu, Hypertrack Submenu, Option F) See Also: Main Menu More Menu Hypertrack Backward ═══ 8.27. Hypertrack Backward ═══ The Hypertrack Backward command returns the cursor to the backward link in the hypertrack chain. Hypertracking is like the multiple Undo/Redo function. After you have double clicked (or opened files) on your way through your source code, you may traverse backward along this path by selecting to hyperlink in the reverse direction. You then have the option of moving forward along the previously created hyperpath by selecting to hyperlink in the forward direction. Access  Control B  Alt-M, H, B (More Menu, Hypertrack Submenu, Option B) See Also: Main Menu More Menu Hypertrack Forward ═══ 8.28. Place Marker Menu ═══ The Place Marker Menu allows you to assign the current cursor position to a marker or move the cursor to a preset marker. Access  Alt-M, M (More Menu, Option M) See Also: Main Menu More Menu Set Marker Goto Marker ═══ 8.29. Set Marker ═══ The Set Marker command assigns the current cursor location to a marker, a number between 0 through 9. Features 1. The assignment of the marker number is dependent upon how you accessed this command. If you accessed this command through Alt-(0-9), the marker number is set to the specified number, 0 to 9. If you accessed this command through Alt-M, M, M, SourceLink assigns the next available marker number. 2. The current cursor location is saved. You can return to the saved location by the Goto Marker command. Each marker can save a location within a separate SourceLink file. Access  Alt (0-9)  Alt-M, M, S (More Menu, Marker Submenu, Option S) See Also: Main Menu More Menu Save Cursor Position ═══ 8.30. GoTo Marker ═══ The GoTo Marker command moves the cursor to indicated marker location. Features 1. You must type in the marker number desired. You must have previously defined the marker location with the Set Marker command. 2. The marker can be located in a different SourceLink file; the file containing the marker becomes the current file. Access  Alt M  Alt-M, M, G (More Menu, Marker Submenu, Option G) See Also: Main Menu More Menu GoTo Line GoTo Cursor Position ═══ 8.31. Cursor Menu ═══ The Cursor Menu allows you to save and restore the cursor position on a temporary basis. Access  Alt-M, U (More Menu, Option U) See Also: Main Menu More Menu Save Cursor Position Goto Cursor Position ═══ 8.32. Save Cursor Position ═══ The Save Cursor Position command saves the current cursor location. Features 1. You can save the current cursor position. 2. SourceLink automatically saves the current cursor position. The Find Beginning Brace command saves the cursor position before moving the cursor. The Find Ending Brace command saves the cursor position before moving the cursor. The Goto Marker command saves the cursor position before moving the cursor. The Goto Line command saves the cursor position before moving the cursor. The Link-To commands save the cursor position before moving the cursor. 3. You can return to the saved cursor position with the Goto Cursor Position command. Access  Control S  Alt-M, U, S (More Menu, Cursor Submenu, Option S) See Also: Main Menu More Menu Set Marker ═══ 8.33. GoTo Cursor Positon ═══ The GoTo Cursor Position command moves the cursor to the saved cursor position. Features 1. The saved cursor position is the location saved from the Save Cursor Position command or saved automatically by SourceLink. The Find Beginning Brace command saves the cursor position before moving the cursor. The Find Ending Brace command saves the cursor position before moving the cursor. The Goto Marker command saves the cursor position before moving the cursor. The Goto Line command saves the cursor position before moving the cursor. The Link-To commands save the cursor position before moving the cursor. 2. The saved position can be located in a different SourceLink file; the file containing the saved position becomes the current file. Access  Control G  Alt-M, U, G (More Menu, Cursor Submenu, Option G) See Also: Main Menu More Menu GoTo Line Goto Marker ═══ 8.34. Snapshot Menu ═══ The Snapshot Menu allows you to take a snapshot of the current file or restore snapshots. Access  Alt-M, N (More Menu, Option N) See Also: Main Menu More Menu Take a Snapshot Restore a Snapshot ═══ 8.35. Take a Snapshot ═══ The Snapshot command writes the current file to a temporary snapshot file. Features 1. The system automatically takes shapshots based on the Snapshot Edit Events parameter in the Options Menu. When the file being edited meets the number of edit events specified, SourceLink creates a snapshot file. This command takes a snapshot of the current file now. The number of edit events still triggers the automatic snapshot. 2. The snapshot file resides in the SourceLink BACKUP directory. Each SourceLink file being edited has its own snapshot file. 3. When SourceLink terminates normally, all snapshot files are deleted. 4. When SourceLink is aborted, the snapshot files can be selectively restored by the Snapshot Restore command in the More Menu. Access  Control T  Alt-M, N, S (More Menu, Snapshot Submenu, Option S) See Also: Main Menu More Menu Setup Options Snapshot Restore ═══ 8.36. Restore a Snapshot ═══ The Snapshot Restore command restores snapshot files. Features 1. The system automatically takes shapshots based on the Snapshot Edit Events parameter in the Options Menu. When the file being edited meets the number of edit events specified, SourceLink creates a snapshot file. 2. You can take a snapshot of the current file at any time by executing the Snapshot command in the Files menu. 3. The snapshot files reside in the SourceLink BACKUP directory. Each SourceLink file being edited during one SourceLink session has its own snapshot file. 4. This command allows you to selectively restore the snapshot files. Access  Alt-M, N, R (More Menu, Snapshot Submenu, Option R) Controls  Snapshot Files This entry displays the number of snapshot files.  Snapshot Files Listbox This entry displays each of the snapshot files. Each entry consists of the name of the file associated with the snapshot, the line number in the file when the snapshot was taken, the date and time of the snapshot, and the filename of the snapshot file.  Restore Selected [R] When you choose the Restore Selected button, all selected snapshot files will be opened.  Restore All [A] When you choose the Restore All button, all snapshot files will be opened.  Cancel When you choose the Cancel button, the current command is cancelled.  Help (H) When you choose the Help button, the corresponding on-line help is displayed. See Also: Main Menu More Menu Setup Options Snapshot ═══ 8.37. Buffers Menu ═══ The Buffers Menu allows you to make the previous or next file in the files list the current file. Access  Alt-M, B (More Menu, Option B) See Also: Main Menu More Menu Last File Next File ═══ 8.38. Last File (Back) ═══ The Last File or Back command makes the previous file current. Features 1. The file that was previously current in the window which has the focus is displayed and made current. Access  Alt B  Alt-M, B, L (More Menu, Buffers Submenu, Option L) See Also: Main Menu More Menu Next File ═══ 8.39. Next File ═══ The Next File command circulates through the SourceLink open file list making the last file in the list the current file. Features 1. The selection of the next file is dependent on the sequence of the files in the SourceLink list of opened files. The list of opened SourceLink files appears at the end of the File Menu. The first entry in the list is always the current file when there is no split screen. If there is a split screen, the first and second entries in the list are the displayed files. The window with the focus is the current file. 2. When the next file is selected, it becomes the current file. It is moved to the top of the list if there is no split screen. It is moved to the first or second position in the list if there is a split screen. Access  Alt Minus  Alt-M, B, N (More Menu, Buffers Submenu, Option N) See Also: Main Menu More Menu Last File ═══ 9. Link Menu ═══ The Link Menu creates and defines the SLink - The SMART Editor Database. List-Of-Files files are created and maintained from this menu. Access Alt-K For additional information select one of the following topics:  Main Menu  Link To Item  Current DB Path  Maintain a List of Files  Create SLink - The SMART Editor DB  Create DB with IFDEF  Incremental Update DB  Review Defines for IFDEF  Rebuild Link Displays Menu  Rebuild All Reports  Call Tree Report  Function Def List  Modules/Functions List  Unreferenced Function Definition List  #define List  Globals List  User Specified List  Dialog List ═══ 9.1. Link To Item ═══ The Link To Item command searches the current SLink - The SMART Editor Database for all definitions and/or references of any item stored in the database. Features 1. The item to be linked can be a function, global, #define, dialog, or user defined function. Only items included in the build can be linked to. 2. You must define the item to be linked. You can define the link item by the Select String command. You can define the link item by selecting the item with the mouse. Refer to Mouse Actions. You can define the link item by clicking once with the mouse (the word at the current cursor position will be selected). You can define the link item by selecting the item with the keyboard. Refer to Text Selection. You can type in the link item in the Enter Item to Link data entry box. 3. The current SLink - The SMART Editor Database has to be previously defined. You can generate the database by the Create SLink - The SMART Editor DB or Create DB with IFDEF commands. You can select the database by the Current DB Path command. 4. You can select to link to a group of items. If you select to Match Leading Characters, then a match is found when the beginning of the item name in the database matches the defined link item. 5. The match will be done without regard to upper and lower case unless the Case Sensitive checkbox is checked. 6. You can select to match on definitions only. If more than one definition is found, the results are written to the L##MDef.Lst file in the TEMP directory; ## identifies the current instance of SLink - The SMART Editor. The REF Multiple Definition List is updated with the results of the search. The MultDef.Lst file is opened in Read Only mode. 7. You can select to match on definitions and references. If more than one match is found, the results are written to the L##MRef.Lst file in the TEMP directory; ## identifies the current instance of SLink - The SMART Editor. The REF Multiple XRef List is updated with the results of the search. The L##MRef.Lst file is opened in Read Only mode. 8. If only one match is found, the source file containing the match is opened. The cursor is placed at the line and column containing the match. 9. If multiple matches were found, you can link to any item in the generated link file (L##MDef.Lst or L##MRef.Lst). Each file satisfying the link is listed with the full path of the file containing the match, the line and column number where the definition or reference was found, and the line containing the matched item. When you double-click on a path, the source file is opened in Read Only mode and displayed. The cursor is placed at the line containing the matched definition (or the beginning of the comment preceding the definition, if Link To Comment was specified in the Setup Options) or reference. Access  Control L  Alt-K, L (Link Menu, Option L) Controls  Enter Item To Link The name of the item to be linked must be entered in this data entry box.  Match Whole Word [W] When you check Match Whole Word, a match is found only when the entire item name matches the entered Item To Link. This is mutually exclusive with Match Leading Characters.  Match Leading Characters [L] When you check Match Leading Characters, a match is found when the beginning of the item name matches the entered Item To Link. For example, if "abc" were entered as the Item To Match, items "abc" and "abcdef" would both be considered as matches. This is mutually exclusive with Match Whole Word.  Case Sensitive (C) When you check Case Sensitive, a match is found only when the item name matches the entered Item To Link with upper and lower case matching. This is mutually exclusive with NOT Case Sensitive.  NOT Case Sensitive (N) When you check NOT Case Sensitive, a match is found when the item name matches the entered Item To Link without regard to upper and lower case matching. For example, if "FuncAbc" were entered as the Item To Match, functions "funcabc" and FuncAbc" would both be considered as matches. This is mutually exclusive with Case Sensitive.  Definition (D) When you choose the Definition button, a search is made within the current SLink - The SMART Editor Database for the previously defined Link To Item definitions. If more than one definition is found, the results are written in the L##MDef.Lst file in the TEMP directory; ## identifies the current instance of SLink - The SMART Editor. The L##MDef.Lst file is then opened in Read Only mode. You may then double-click on any entry; the source file is opened and the cursor is placed at the beginning of the definition (or the beginning of the comment preceding the definition, if Link To Comment was specified in the Setup Options). If only one definition is found, the source file containing the definition is opened and the cursor is placed at the beginning of the definition (or the beginning of the comment preceding the definition, if Link To Comment was specified in the Setup Options). User Specified items may not have a definition.  References (R) When you choose the References button, a search is made within the current SLink - The SMART Editor Database for the previously defined Link To Item definitions and references. If more than one match is found, the results are written in the L##MRef.Lst file in the SL_TEMP2 directory as defined in CONFIG.SYS; ## identifies the current instance of SLink - The SMART Editor. The L##MRef.Lst file is then opened in Read Only mode. You may then double-click on any entry; the source file is opened and the cursor is placed at the beginning of the definition (or the beginning of the comment preceding the definition, if Link To Comment was specified in the SLink - The SMART Editor Options). If only one definition is found, the source file containing the definition is opened and the cursor is placed at the beginning of the definition (or the beginning of the comment preceding the definition, if Link To Comment was specified in the Setup Options), or reference.  Cancel When you choose the Cancel button, the current command is cancelled.  Help (H) When you choose the Help button, the corresponding on-line help is displayed. See Also: Main Menu Link Menu Current DB Path Multiple Def List Multiple XRef List ═══ 9.2. Current DB Path ═══ The Current DB Path command defines the current SLink - The SMART Editor Database path. Features 1. You can change the The SMART Editor current database directory by the following actions: You can double-click on a directory in the directory listbox, or you can type in the directory name in the New Path data entry box. When you type in the directory name, you must type in the full path. Access  Control P  Alt-K, D (Link Menu, Option D) Controls  Current: The current SLink - The SMART Editor Database directory is displayed.  New Path: You may type in a new SLink - The SMART Editor Database directory path.  Directories This listbox contains drives and directories. You may select the current SLink - The SMART Editor Database drive or directory from this list.  Filenames This listbox contains a list of all files which are contained within the selected drive and directory.  OK When you choose the OK button, the current SLink - The SMART Editor Database path is updated.  Cancel When you choose the Cancel button, the current command is cancelled.  Help (H) When you choose the Help button, the corresponding on-line help is displayed. See Also: Main Menu Link Menu ═══ 9.3. Maintain A List Of Files ═══ The Maintain A List Of Files command creates, updates or displays the files defined by a list-of-files. Features 1. You must define the name of the file containing the list-of-files. The Select File Dialog Panel is displayed. You are prompted to select the drive, directory and/or filename. You can create a new file or open an existing file. 2. You can add or delete files from the list-of-files. The Maintain Files List Dialog Panel is displayed. You may add or delete files from the list-of-files. To add files, the Add Files To List dialog panel is displayed where you can select the files to add to the list-of-files. When you specify to Store the files, the list-of-files is updated. Access  Alt-K, M (Link Menu, Option M) See Also: Main Menu Link Menu ═══ 9.4. Create SLink - The SMART Editor DB ═══ The Create SLink - The SMART Editor DB command creates a SLink - The SMART Editor Database and related reports. Features 1. You must previously create a file which contains a list-of-files to be included in the database, This file must be created with the Maintain Files List command. You can type in the filename of this file or select the filename with the Select File Dialog Panel command. 2. You must specify which items are to be linked. After you select the list-of-files, the Link Database Options Dialog Panel is displayed. You are prompted to select the types of items to be linked, the name of the User Specified file, and the root function name for the Call Tree. 3. SLink - The SMART Editor will scan each of the files in the list-of-files two times. The first scan is to locate all item definitions. The second scan is to locate all item references. The status of the scans is displayed with the Create DB Scan Status panel. 4. SLink - The SMART Editor will create the database in the directory containing the list-of-files. If the database exists, it will be overwritten. 5. SLink - The SMART Editor will create new function reports. The reports will be created in the directory containing the list-of-files. The Call Tree will be generated if the root function is specified in the Link Database Options Dialog Panel. The Function Def List will always be generated. The Modules/Functions List will always be generated. The Unreferenced Function Definition List will always be generated. The #define List is generated only when #defines are specified in the Link Database Options Dialog Panel. The Globals List is generated only when Globals are specified in the Link Database Options Dialog Panel. The User Specified List is generated only when User Specified items are specified in the Link Database Options Dialog Panel. The Dialog List is generated only when Dialogs are specified in the Link Database Options Dialog Panel. Access  Alt-K, C (Link Menu, Option C) See Also: Main Menu Link Menu Link Database Options Dialog Panel ═══ 9.5. Create SLink - The SMART Editor DB With IFDEFS ═══ The Create SLink - The SMART Editor DB With IFDEFs command creates a SLink - The SMART Editor Database and related reports. Only functions within the defined preprocessor statements are included in the database. Features 1. You must previously create a file which contains a list-of-files to be included in the database, This file must be created with the Maintain Files List command. You can type in the filename of this file or select the filename with the Select File Dialog Panel command. 2. SLink - The SMART Editor will scan each of the files in the list-of-files for preprocessor statements. All variables contained on #if, #ifdef and #elif defined preprocessor statements will be captured by SLink - The SMART Editor. You will be prompted with the Set IFDEF Defines dialog panel to set the defines you want active for the version of the database you are currently building. 3. When you continue, you must specify which items are to be linked. The Link Database Options Dialog Panel is displayed. You are prompted to select the types of items to be linked, the name of the User Specified file, and the root function name for the Call Tree. 4. SLink - The SMART Editor will scan each of the files in the list-of-files two times for functions. The first scan is to locate all item definitions which fall within the defined pre-processor statements. The second scan is to locate all item references which fall within the defined preprocessor statements. The status of the scans is displayed with the Create DB Scan Status panel. 5. SLink - The SMART Editor will create the database in the directory containing the list-of-files. If the database exists, it will be overwritten. 6. SLink - The SMART Editor will create new function reports. The reports will be created in the directory containing the list-of-files. The Call Tree will be generated if the root function is specified in the Link Database Options Dialog Panel. The Function Def List will always be generated. The Modules/Functions List will always be generated. The Unreferenced Function Definition List will always be generated. The #define List is generated only when #defines are specified in the Link Database Options Dialog Panel. The Globals List is generated only when Globals are specified in the Link Database Options Dialog Panel. The User Specified List is generated only when User Specified items are specified in the Link Database Options Dialog Panel. The Dialog List is generated only when Dialogs are specified in the Link Database Options Dialog Panel. Access  Alt-K, I (Link Menu, Option I) See Also: Main Menu Link Menu Link Database Options Dialog Panel ═══ 9.6. Update SLink - The SMART Editor DB ═══ The Update SLink - The SMART Editor DB updates the current SLink - The SMART Editor database. Features 1. You must define the name of the file containing the list-of-files. The Select File Dialog Panel is displayed. You are prompted to select the drive, directory and/or filename. 2. SLink - The SMART Editor examines the list-of-files to determine which files have been changed. Files added to the list-of-files will update the database. Files deleted from the list-of-files will update the database. Files changed since the database was created will update the database. 3. If required, the database will be updated and the applicable reports will be regenerated. If the database was created with IFDEFs, the setting of the IFDEFs when the database was first created are still active. Access  Alt-K, U (Link Menu, Option U) See Also: Main Menu Link Menu Create SLink - The SMART Editor DB Create SLink - The SMART Editor DB With IFDEFs ═══ 9.7. Review Defines For IFDEFs command ═══ The Review Defines For IFDEFs displays the defines associated with the current SLink - The SMART Editor database. Features 1. You select the current database by the Current DB Path command. 2. This command is valid only if you previously generated the database with the Create DB with IFDEF command. 3. The state of each preprocessor define is displayed. Access  Alt-K, V (Link Menu, Option V) Controls  Symbol listbox All of the defines found in the SLink - The SMART Editor Database source files are displayed.  Current Value The value of each define displayed in the Symbol listbox is displayed.  OK When you choose the OK button, you returns to the menu.  Help (H) When you choose the Help button, the corresponding on-line help is displayed. See Also: Main Menu Link Menu ═══ 9.8. Rebuild Link Displays Menu ═══ The Rebuild Link Displays Menu allows you to recreate the current SLink - The SMART Editor Database reports. Features 1. You select the current database by the Current DB Path command. 2. The reports are automatically created when the database is created or updated. The generation of the reports is dependent upon the items being included in the database; e.g. if Globals are not included in the database, the Globals report is not generated. You can regenerate each of the reports individually or specify to regenerate all of the reports. Access  Alt-K, B (Link Menu, Option B) For additional information select one of the following topics:  Main Menu  Link Menu  Rebuild All Reports  Call Tree Report  Function Def List  Modules/Functions List  Unreferenced Function Definition List  #define List  Globals List  User Specified List  Dialog List ═══ 9.9. Rebuild All Reports ═══ You can generate all of the reports associated with the Current Database. Features 1. You select the current database by the Current DB Path command. The reports will be created in the directory containing the list-of-files. 2. Only those reports generated at the time of the build of the database can be rebuilt. The Call Tree can always be generated regardless of whether it was generated when the database was built. The Function Def List will always be generated. The Modules/Functions List will always be generated. The Unreferenced Function Definition List will always be generated. The #define List is generated only when #defines are specified in the Link Database Options Dialog Panel. The Globals List is generated only when Globals are specified in the Link Database Options Dialog Panel. The User Specified List is generated only when User Specified items are specified in the Link Database Options Dialog Panel. The Dialog List is generated only when Dialogs are specified in the Link Database Options Dialog Panel. Access  Alt-K, B, A(Link Menu, Rebuild Link Displays Menu, Option A) See Also: Main Menu Link Menu Create SLink - The SMART Editor DB ═══ 9.10. Call Tree Report ═══ You can generate the Call Tree Report associated with the Current DB Path. Features 1. You select the current database by the Current DB Path command. 2. You must select the Call Tree Root Function Name, which defines the starting point for the tree. The default is main(). 3. You must specify the number of levels for the tree. The default is 20. 4. The report is stored in the file SL_Call.Rpt in the Current SLink - The SMART Editor database path. The Call Tree Reference File will be updated. 5. This report shows the hierarchal interrelationship of the functions defined in the SLink - The SMART Editor database. Access  Alt-K, B, B(Link Menu, Rebuild Link Displays Menu, Option B) See Also: Main Menu Link Menu Create SLink - The SMART Editor DB ═══ 9.11. Function Definition List ═══ You can generate the Function Definition List associated with the Current DB Path. Features 1. You select the current database by the Current DB Path command. 2. The report is stored in the file SL_Funct.Rpt in the Current SLink - The SMART Editor database path. The Func Def Reference File will be updated. 3. It lists each of the functions defined in the SLink - The SMART Editor database. The functions are listed in alphabetical order. Each function is displayed with the path of the module in which it resides and the line and column number within that module. Access  Alt-K, B, C(Link Menu, Rebuild Link Displays Menu, Option C) See Also: Main Menu Link Menu Create SLink - The SMART Editor DB ═══ 9.12. Module/Functions List ═══ You can generate the Module/Functions List associated with the Current DB Path. Features 1. You select the current database by the Current DB Path command. 2. The report is stored in the file SL_Mods.Rpt in the Current SLink - The SMART Editor database path. The Mod/Function List Reference File will be updated. 3. It lists the function definitions for each source module defined in the SLink - The SMART Editor database. The modules are listed in alphabetical order. The functions are listed in the order they appear within the source module. Each function is displayed with the path of the module in which it resides and the line and column number within that module. Access  Alt-K, B, D(Link Menu, Rebuild Link Displays Menu, Option D) See Also: Main Menu Link Menu Create SLink - The SMART Editor DB ═══ 9.13. Unreferenced Function Definition List ═══ You can generate the Unreferenced Function Definition List associated with the Current DB Path. Features 1. You select the current database by the Current DB Path command. 2. The report is stored in the file SL_Unref.Rpt in the Current SLink - The SMART Editor database path. The Unreferenced Func Def Reference File will be updated. 3. It lists each of the functions in the SLink - The SMART Editor database that are defined but unreferenced. The functions are listed in alphabetical order. Each function is displayed with the path of the module in which it resides and the line and column number within that module. Access  Alt-K, B, E(Link Menu, Rebuild Link Displays Menu, Option E) See Also: Main Menu Link Menu Create SLink - The SMART Editor DB ═══ 9.14. # Define List ═══ You can generate the #Define List associated with the Current DB Path only when #defines were specified when the database was built. Features 1. You select the current database by the Current DB Path command. 2. The report is stored in the file SL_Defin.Rpt in the Current SLink - The SMART Editor database path. 3. It lists each of the #defines in the SLink - The SMART Editor database. The #defines are listed in alphabetical order. Each #define is displayed with the path of the module in which it resides and the line and column number within that module. Access  Alt-K, B, F(Link Menu, Rebuild Link Displays Menu, Option F) See Also: Main Menu Link Menu Create SLink - The SMART Editor DB ═══ 9.15. Globals List ═══ You can generate the Globals List associated with the Current DB Path only when Globals were specified when the database was built. Features 1. You select the current database by the Current DB Path command. 2. The report is stored in the file SL_Glob.Rpt in the Current SLink - The SMART Editor database path. The Globals Reference File will be updated. 3. It lists each of the Globals defined in the SLink - The SMART Editor database. The globals are listed in alphabetical order. Each global is displayed with the path of the module in which it resides and the line and column number within that module. Access  Alt-K, B, G(Link Menu, Rebuild Link Displays Menu, Option G) See Also: Main Menu Link Menu Create SLink - The SMART Editor DB ═══ 9.16. User Specified List ═══ You can generate the User Specified List associated with the Current DB Path only when the User Specified List was specified when the database was built. Features 1. You select the current database by the Current DB Path command. 2. The report is stored in the file SL_User.Rpt in the Current SLink - The SMART Editor database path. The User Defined Function Reference File will be updated. 3. It lists each of the functions defined in the User Specified List and referenced in the SLink - The SMART Editor database. The functions are listed in alphabetical order. Access  Alt-K, B, H(Link Menu, Rebuild Link Displays Menu, Option H) See Also: Main Menu Link Menu Create SLink - The SMART Editor DB ═══ 9.17. Dialog List ═══ You can generate the Dialog List associated with the Current DB Path. Features 1. You select the current database by the Current DB Path command. 2. The report is stored in the file SL_DlgBx.Rpt in the Current SLink - The SMART Editor database path. The Dialog Reference File will be updated. 3. It lists each of the dialogs defined in the SLink - The SMART Editor database. These are defined by the DLGBOXTEMPLATE and WINDOWTEMPLATE key words. The dialogs are listed in alphabetical order. Each dialog entry is displayed with the path of the module in which it resides and the line and column number within that module. Access  Alt-K, B, I(Link Menu, Rebuild Link Displays Menu, Option I) See Also: Main Menu Link Menu Create SLink - The SMART Editor DB ═══ 10. Macro Menu ═══ The Macro Menu permits the execution of REXX macros in several different environments. The User may define his own macros to be added to the User Defined Macro pull down menu. There they will be available for execution. SLink - The SMART Editor provides several predefined macros which can be customized. SLink - The SMART Editor also provides many built-in macros which extend SLink - The SMART Editor functionality to the Rexx environment. Please refer to the following for more information:  Rexx Introduction  Rexx Environments  Macro Execution Options  S_ Quick Reference  S_ Macros  S_ Errors  Define User Menu Item  User Defined Macros  Run Macro File  Macro Trace On  Notify Macro Completion  Clear Macro Output  Interactive Commands Window  Show Interactive Window  Templates ═══ 10.1. Rexx Introduction ═══ INTRODUCTION REXX (the REstructured eXtended eXecutor) language is a general purpose programming language supported by OS/2. Rexx macros do not need to be compiled. Anywhere an OS/2 command file is used, a REXX program can be used. Rexx files can contain OS/2 commands as well as REXX instructions. SLink - The SMART Editor has provided many macros which extend the functionality of REXX; these macro names all begin with 'S_'. Rexx macros can be run with trace for debugging. Additional on-line help is available in the OS/2 supplied file REXX.INF usually residing in the \OS2\BOOK directory. SYNTAX The first line of any Rexx file must start with a comment in the first column of the first line. Comments are delimited by /* and */. Literal strings are delimited by single quote or double quote. A variable which has not been assigned any value has the default value of the variable name. For example, MY_VAR upon the start of the program has the value of 'MY_VAR'. If you set MY_VAR=3, however, the value of MY_VAR would then have the value of 3. When passing an argument to an S_ macro, enclose them in quotes if they are not to be evaluated by the Rexx compiler; i.e., if the variable name is passed instead of the value of the variable. HPFS long filenames must be enclosed in double quotes ("). ═══ 10.2. Rexx Environments ═══ SLink - The SMART Editor permits Rexx macros to be run in three different environments. When multiple environments are active, the following overrides the specific environment conditions: 1. When Trace is enabled, it is enabled in all environments. 2. When the Interactive Output Window is enabled, all macro output goes to that window. The macro stdout output is captured by SLink - The SMART Editor and piped to either the Interactive window or to the SLink - The SMART Editor Macro Output file. Because of this, you may not pipe any output from within your Rexx Macro. MACRO FILE with OUTPUT FILE You can run a macro file with all output going to a stdout file. The Macro Output is stored in the file SL_@##.Out in the TEMP directory; @ defines the day of the week, ## identifies the current instance of SLink - The SMART Editor. The stdout file can be displayed from the "REF Menu - Macro Output" file entry. The stdout file can be cleared from the "MACRO Menu - Clear Macro Output" entry. Trace statements are embedded in the output file. When multiple macros are run at the same time in this environment, the output is interspersed. When either of the other two environments exist, the interactive window also exists, and all output will go to the interactive window. This environment becomes the MACRO FILE with OUTPUT WINDOW environment. MACRO FILE with OUTPUT WINDOW You can run a macro file with all output going to the interactive window. This is enabled from selecting Interactive Macro Window from the MACRO MENU and then selecting Run Macro File from the FILE MENU in the Interactive window. All macro output from the macro is displayed in the interactive window. All trace output from the macro is displayed in the interactive window. You can trace the next instruction in the file by pressing ENTER from the Interactive Command Input window or by selecting Trace Next from the Interactive File menu. You can reexecute the last instruction in the file by entering '=' in the Interactive Command Input window or by selecting Trace Last from the Interactive File menu. Any output generated from the MACRO FILE with OUTPUT FILE environment will be interspersed with the output generated from the macro file initiated from this environment. INTERACTIVE You can run a macro interactively. You can enter a Rexx statement and execute it. You can load a file in the commandlist window and selectively execute statements to run. A single statement is executed. All macro output is displayed in the interactive window. All trace output is displayed in the interactive window. OS/2 commands can be run. ═══ 10.3. Macro Execution Options ═══ You can specify options to be used when running Macro files. 1. Macro Trace On - this turns trace on or off in all of the Macro environments. 2. Notify Macro Completion - this generates a message box when the macro file execution is completed. 3. Clear Macro Output - this clears the Macro Output file. The Macro Output is stored in the file SL_@##.Out in the TEMP directory; @ defines the day of the week, ## identifies the current instance of SLink - The SMART Editor. ═══ 10.4. Define User Menu Item ═══ The Define User Menu Item command registers up to 15 of your own macro files which will appear in the drop down menu under "User Defined Macros". Features 1. You may define 16 macro files that are easily accessed by the User Defined Macros entry under the MACRO menu. 2. When the Define User Menu Item command is entered, the Menu Maintenance Dialog appears. All user defined macros are displayed in a listbox. You can add, change or delete an entry in the listbox. 3. When a macro is added or changed, the Menu Registration Dialog appears. You must specify the legend that will appear in the User Defined Macro Drop Down Menu. You must select or enter the macro filename. You can specify an argument that will be passed to the macro. You can specify an accelerator key that will be associated with the macro. You can specify that you are to be notified upon macro completion. Access  Alt-A, D (Macro Menu, Option D) See Also: Main Menu Macro Menu User Defined Macros Macro Menu Maintenance Dialog Macro Registration Dialog ═══ 10.5. User Defined Macros ═══ Selection of User Defined Macros displays a drop down menu containing the macros that were defined by the Define User Menu Item command. Selection of any entry from the drop down menu results in the execution of that macro in the MACRO FILE with OUTPUT FILE environment. Access  Alt-A, U (Macro Menu, Option U) See Also: Main Menu Macro Menu User Macro Definition Macro Menu Maintenance Dialog Macro Registration Dialog Rexx Environments ═══ 10.6. Run Macro File ═══ The Run Macro File command runs a Rexx Macro File. Features 1. You must specify the name of the macro file. The Select File Dialog Panel is displayed. You are prompted to select the drive, directory and/or filename. 2. You may define an argument that will be passed to the macro. 3. You can run the macro with or without trace enabled. 4. The macro will be run in the MACRO FILE with OUTPUT FILE environment. Access  Alt-A, R (Macro Menu, Option R) See Also: Main Menu Macro Menu User Macro Definition Macro Menu Maintenance Dialog Macro Registration Dialog Macro Trace On Rexx Environments ═══ 10.7. Macro Trace On ═══ The Macro Trace On allows you to enable TRACE when running a Rexx Macro File. When Trace is enabled, it is enabled in all environments. All trace output is interspersed with the normal Macro Output. It will appear with the current macro output; either the Macro Output File or the Interactive Window, depending on the current Rexx environment. Access  Alt-A, O (Macro Menu, Option O) See Also: Main Menu Macro Menu Rexx Environments ═══ 10.8. Notify Macro Completion ═══ The Notify Macro Completion command allows you to be notified (beeped) whenever a Rexx Macro File has completed processing. Access  Alt-A, N (Macro Menu, Option N) See Also: Main Menu Macro Menu ═══ 10.9. Clear Macro Output ═══ The Clear Macro Output command clears the output file, SL_@##.Out, containing the output generated from Rexx Macros. When running in the MACRO FILE with OUTPUT FILE environment, the Macro Output is stored in the file SL_@##.Out in the TEMP directory; @ defines the day of the week, ## identifies the current instance of SLink - The SMART Editor. The stdout file can be displayed from the "REF Menu - Macro Output" file entry. Access  Alt-A, C (Macro Menu, Option C) See Also: Main Menu Macro Menu Rexx Environments REF Macro Output ═══ 10.10. Interactive Macro Window ═══ The Interactive Command Window creates an Interactive Session. Features 1. You can enter Rexx commands interactively. 2. You can load a Macro File and interactively step through the file. 3. The output appears in the Interactive Window. This output can be saved. 4. You can run the interactive session with trace enabled. Access  Alt-A, I (Macro Menu, Option I) See Also: Main Menu Macro Menu Macro Interactive Commands Menu ═══ 10.11. Show Interactive Macro Window ═══ The Show Interactive Window displays the Interactive Macro Window. Access  Alt-I, S (Macro Menu, Option S) See Also: Main Menu Macro Menu Interactive Window Rexx Environments ═══ 10.12. Templates ═══ SLink - The SMART Editor has provided a C Templates macro which can be used from any SLink - The SMART Editor window. Features 1. Automated 'C' templates are generated from the supplied macro "SMARTC.REX" in the SLink - The SMART Editor subdirectory SLINK2\MACROS. You can modify this macro to meet your specific template needs. You can add your own templates. To invoke the template macro, within your SLink - The SMART Editor file type an identifier for the desired template: 2. f (for) generates for( ; ; ) 3. b (braces) generates { } 4. w (while) generates while( ) 5. s (switch) generates switch( ) 6. c (case) generates case : 7. d (do) generates do { } while 8. i (if) generates if( ) 9. cl(comment line) prompts you for a comment and then generates a new line with the comment: /* comment */ 10. ce(comment at end of line) prompts you for a comment and then generates the comment in column 45 of the current line. If it won't fit, inserts a line before the current line and generates the comment in line 45 of the inserted line. Comment: /* comment */ 11. h (header) prompts you for a comment and then generates a function header. Access  Alt-A, T (Macro Menu, Option T) ═══ 11. Macro Interactive Commands Menu ═══ The SLink - The SMART Editor Interactive Main Menu includes the following entries:  File - File Functions.  Edit - Edit Functions.  Output - Interactive Window Output Functions.  Command List - Command List Window Functions.  Close - Close Function.  Help - Help Functions. ═══ 11.1. Interactive Commands - File Menu ═══ The File Menu allows you to run a macro file in interactive mode. The output of the macro will be displayed in the interactive window. You can step through the file with by enabling trace. Access Alt-F For additional information select one of the following topics:  Main Menu  Macro Interactive Commands Menu  Run Macro File Interactively  Enable/Disable Trace  Trace Last  Trace Next ═══ 11.2. Run Macro File Interactively ═══ The Run Macro File Interactively command allows you to run a Rexx Macro File with the output directed to the interactive window. Features 1. You must specify the name of the macro file. The Select File Dialog Panel is displayed. You are prompted to select the drive, directory and/or filename. 2. You may define an argument that will be passed to the macro. 3. You can run the macro with or without trace enabled. 4. The macro will be run in the MACRO FILE with WINDOW OUTPUT environment. Access  Alt-F, R (Interactive Window: File Menu, Option R) See Also: Main Menu Interactive Main Menu Macro Menu Rexx Environments Interactive Trace On Run Macro NonInteractively ═══ 11.3. Interactive Trace On ═══ The Interactive Trace On command allows you allows you to enable or disable TRACE. The Trace Output is directed to the interactive window. When Trace is enabled, it is enabled in all environments. All trace output is interspersed with the normal Macro Output. It will appear with the current macro output in the Interactive Window. Access  Alt-F, O (Interactive Window: File Menu, Option O) See Also: Main Menu Interactive Main Menu Macro Menu Rexx Environments Interactive Trace On ═══ 11.4. Interactive Trace Last ═══ The Interactive Trace Last command allows you re-execute the previous interactive Rexx command. The last command in the macro file being run is re-executed. The Trace Output is directed to the interactive window. All trace output is interspersed with the normal Macro Output. It will appear with the current macro output in the Interactive Window. Access  Alt-F, T (Interactive Window: File Menu, Option T) See Also: Main Menu Interactive Main Menu Macro Menu Rexx Environments Trace Next ═══ 11.5. Interactive Trace Next ═══ The Interactive Trace Next command allows you execute the next command in the macro file being run interactively. The Trace Output is directed to the interactive window. All trace output is interspersed with the normal Macro Output. It will appear with the current macro output in the Interactive Window. Access  Alt-F, N (Interactive Window: File Menu, Option N) See Also: Main Menu Interactive Main Menu Macro Menu Rexx Environments Trace Last ═══ 11.6. Interactive Commands - Edit Menu ═══ The Edit Menu allows you to manipulate the data in the interactive display window. Access Alt-E For additional information select one of the following topics:  Main Menu  Macro Interactive Commands Menu  Undo  Cut  Copy  Paste  Delete ═══ 11.7. Interactive Window Undo ═══ The Interactive Window Undo command restores the interactive window to the state prior to the last cut, copy, paste or delete command executed in the interactive window. Access  Alt U  Alt-E, U (Interactive Window: Edit Menu, Option U) See Also: Main Menu Interactive Main Menu Macro Menu Undo ═══ 11.8. Interactive Window Cut ═══ The Interactive Window Cut command moves data from the interactive window to the paste buffer. Features 1. The data within the interactive window is moved to the paste buffer. If you have selected data, the selected data is moved. If no data is selected, the entire line containing the cursor is moved. 2. After the data is moved to the paste buffer it is deleted from the interactive window. 3. The data contained in the paste buffer can be retrieved later using the Paste Function. 4. The cut data can be uncut by using the Undo command. Access  Shift Del  Alt-E, T (Interactive Window: Edit Menu, Option T) See Also: Main Menu Interactive Main Menu Macro Menu Undo Copy Paste ═══ 11.9. Interactive Window Copy ═══ The Interactive Window Copy command copies data from the interactive window to the paste buffer. Features 1. The data within the interactive window is copied to the paste buffer. If you have selected data, the selected data is copied. If no data is selected, the entire line containing the cursor is copied. 2. The data contained in the paste buffer can be retrieved later using the Paste Function. Access  Control Insert  Alt-E, C (Interactive Window: Edit Menu, Option C) See Also: Main Menu Interactive Main Menu Macro Menu Cut Paste ═══ 11.10. Interactive Window Paste ═══ The Interactive Window Paste command copies data from the paste buffer to the current cursor position within the interactive window. The pasted data can be unpasted by using the Undo command. Access  Shift Insert  Alt-E, P (Interactive Window: Edit Menu, Option P) See Also: Main Menu Interactive Main Menu Macro Menu Cut Copy Undo ═══ 11.11. Interactive Window Delete ═══ The Interactive Window Delete command deletes data from the interactive window. Features 1. The data within the interactive window is deleted. If you have selected data, the selected data is deleted. If no data is selected, the character at the current cursor location is deleted. 2. The deleted data can be undeleted by using the Undo command. Access  Del  Alt-E, D (Interactive Window: Edit Menu, Option D) See Also: Main Menu Interactive Main Menu Macro Menu Cut Copy Undo ═══ 11.12. Interactive Commands - Output Menu ═══ The Output Menu allows you to clear the data in the interactive display window and copy the data in the interactive window to the clip file. Access Alt-U For additional information select one of the following topics:  Main Menu  Macro Interactive Commands Menu  Clear  Copy to Clip ═══ 11.13. Interactive Window Clear ═══ The Interactive Window Clear command clears the interactive window. Access  Alt-U, C (Interactive Window: Output Menu, Option C) See Also: Main Menu Interactive Main Menu Macro Menu Rexx Environments Copy To Clip ═══ 11.14. Interactive Window Copy To Clip ═══ The Interactive Window Copy To Clip command copies the selected data in the interactive window to the clip file. If no data is selected, the entire contents of the interactive window is copied. Access  Alt-U, F (Interactive Window: Output Menu, Option F) See Also: Main Menu Interactive Main Menu Macro Menu Clear ═══ 11.15. Interactive Commands - Command List Menu ═══ The Command List Menu allows you to create and manipulate a list of commands associated with the interactive window. Access Alt-C For additional information select one of the following topics:  Main Menu  Macro Interactive Commands Menu  Open List  Recover Last Command  Recover Selected Command  Delete Selected Command  Load List  Save List  Copy List  Delete List  Close List ═══ 11.16. Open Command List Window ═══ The Open Command List Window command opens a commandlist window where commands can be loaded, accessed, and saved. When the commandlist window is opened, any command entered in the interactive window is copied to the interactive commandlist window. Access  Alt-C, O (Interactive Window: Command List Menu, Option O) See Also: Main Menu Interactive Main Menu Macro Menu CommandList Menu ═══ 11.17. Recover Last Command ═══ The Recover Last Command entry retrieves the last entry from the commandlist window and copies it to the interactive window data entry box where it can be executed. Access  Alt L  Alt-C, L (Interactive Window: Command List Menu, Option L) See Also: Main Menu Interactive Main Menu Macro Menu CommandList Menu ═══ 11.18. Recover Selected Command ═══ The Recover Selected Command entry retrieves the selected entry from the commandlist window and copies it to the interactive window data entry box where it can be executed. Access  Alt S  Alt-C, R (Interactive Window: Command List Menu, Option R) See Also: Main Menu Interactive Main Menu Macro Menu CommandList Menu ═══ 11.19. Delete Selected Command ═══ The Delete Selected Command entry deletes the selected entry from the commandlist window. Access  Alt D  Alt-C, D (Interactive Window: Command List Menu, Option D) See Also: Main Menu Interactive Main Menu Macro Menu CommandList Menu ═══ 11.20. Load Command List ═══ The Load Command List entry loads a file into the commandlist window. The Open File Dialog Panel is displayed. You are prompted to select the drive, directory and/or filename. Once the file is loaded, the commands can be selected by the "Recover Selected Command" entry. Access  Alt O  Alt-C, A (Interactive Window: Command List Menu, Option A) See Also: Main Menu Interactive Main Menu Macro Menu CommandList Menu Recover Selected Command ═══ 11.21. Save Command List ═══ The Save Command List entry saves the contents of the command list window to a file. The Open File Dialog Panel is displayed. You are prompted to select the drive, directory and/or filename. Access  Alt-C, S (Interactive Window: Command List Menu, Option S) See Also: Main Menu Interactive Main Menu Macro Menu CommandList Menu Load List ═══ 11.22. Copy Command List ═══ The Copy Command List entry copies the contents of the command list window to the interactive window. Access  Alt-C, C (Interactive Window: Command List Menu, Option C) See Also: Main Menu Interactive Main Menu Macro Menu CommandList Menu Load List Save List ═══ 11.23. Clear Command List ═══ The Clear Command List entry clears the command list window. Access  Alt-C, E (Interactive Window: Command List Menu, Option E) See Also: Main Menu Interactive Main Menu Macro Menu CommandList Menu Load List Save List ═══ 11.24. Close Command List ═══ The Close Command List entry closes the command list window. Access  Alt-C, T (Interactive Window: Command List Menu, Option T) See Also: Main Menu Interactive Main Menu Macro Menu CommandList Menu Open List Clear List Load List Save List ═══ 11.25. Interactive Commands - Close ═══ The Close entry closes the interactive window. Access Alt-S For additional information select one of the following topics:  Main Menu  Macro Interactive Commands Menu ═══ 12. Help Menu ═══ The Help Menu defines the help functions for SLink - The SMART Editor. Access Alt-H For additional information select one of the following topics:  Main Menu  Help Index  Help Contents  General Help  Keys Help  Product Information  Using Help .********************************************************************** ═══ 13. Start Menu ═══ The Start Menu allows the user to define and execute command files. Access Alt-T For additional information select one of the following topics:  Main Menu  Define Menu Item  Run  User Commands ═══ 13.1. Define Menu Item ═══ The Define Menu Item command registers up to 15 of your own commands which will appear in the drop down menu below "Define Menu Item". Features 1. You can register up to 16 of your own commands which will appear in the drop down menu under "Start". 2. These processes are independent (detached) from SLink - The SMART Editor. You may close SLink - The SMART Editor and the processes running will not be terminated. 3. You can enter a set of commands to be executed. Enter a system command in the entry field for "command". This will allow you to enter something simple like: "COPY Myfile A:" or a set of commands like: "C: & CD \mydir & DIR *.* > dir.txt & SLSTART dir.txt". This convenience option eliminates the requirement for creating a separate command file for simple operations, if you choose to do so. Note that the command line above uses the ampersand to concatenate multiple commands on the same command line. Up to 127 characters are allowed. (The command line shown above sets a path; gets a directory and pipes it to a file; then sends this back to SLink - The SMART Editor via SLStart.) 4. When the Define Menu Item command is entered, the Command Menu Items Dialog appears. All user defined commands are displayed in a listbox. You can add, change or delete an entry in the listbox. 5. When a command is added or changed, the Menu Registration Dialog appears. You must specify the legend that will appear in the Start Drop Down Menu. This can be the command file filename or the command line or the name of an executable file. You can specify an argument that will be passed to the command file or executable. You can specify an accelerator key that will be associated with the command. You can specify that the command is a command file. This means that CMD.EXE or the command processor selected in the Setup Options will be executed. If you are spawning an executable from a "Start" menu item DO NOT check "Command File". If the item to be spawned is a command file or a command line as shown above, CHECK the box "Command" in the "Command Menu Item" panel. Access  Alt-T, D (Start Menu, Option D) See Also: Main Menu Menu Maintenance Dialog Menu Registration Dialog User Commands ═══ 13.2. RUN ═══ The Run panel allows you to configure the process to spawn from SLink - The SMART Editor. Features 1. You can specify the file to execute or command file to spawn. 2. You can specify the file file type (.EXE or .CMD). 3. You can specify the Session Type. Access  Alt-T, D (Start Menu, Option R) See Also: Main Menu User Commands ═══ 13.3. User Defined Commands ═══ Selection of User Defined Commands displays a drop down menu containing the commands that were defined by the Define Menu Item command. Selection of any entry from the drop down menu results in the execution of that command. Access  Alt-T, 0-9A-F (Start Menu, Option 0-9A-F) See Also: Main Menu Define Menu Item ═══ 14. Options Menu ═══ The Options Menu defines The SMART Editor runtime options. Access Alt-O For additional information select one of the following topics:  Main Menu  Setup Options  Set Screen Colors  Set Screen Font  Store SLink - The SMART Editor INI File  Where is SLINK  Enable WorkFrame/2 Errors  Ignore SLStart  Disable Project Id  Notify Received File  Restore Received File  Auto Open Waiting Files ═══ 14.1. Setup Options ═══ The Setup Options command enables you to define the parameters which control SLink - The SMART Editor commands. Features 1. You can customize SLink - The SMART Editor execution. You can control the maximum number of opened files. You can control the maximum number of edit events prior to taking a snapshot. You can control the maximum number of Undo/Redo events to be saved. You can specify the command processor that will be used for Start Menu command execution and the generated SLink - The SMART Editor OS/2 window. You can control the default directory for SLink - The SMART Editor commands by checking or unchecking Directory Tracking. This defines whether the current directory is maintained between commands. If directory tracking is checked, the directory defined in one command (e.g. copy) would be set as the default for all of the other commands (e.g. Search, Delete, etc.). You can specify whether a linked function should point to the function definition or the comment preceding the function definition. You can specify which mouse button is to be used for linking to definitions and which mouse button is to be used for linking to references. You can specify whether you should be notified (beeped) when a scan or copy command is completed. 2. File options are defined here which govern all opened files. You can specify the number of spaces allocated to the tab character (tab spacing). You can specify the default file open mode for all files. They can be opened in Read Only mode or Edit mode. You can specify the default Word Wrap mode for all files. When you check word wrap, all characters extending beyond the right edge of the screen are continued on the next display line. When you uncheck word wrap, you must use the horizontal scroll bar to access all characters extending beyond the right edge of the screen. You can specify the default auto indent mode for all files. When auto indent is checked, the cursor is automatically lined up at the left justified position of the previous line whenever a carriage return is entered. You can specify the default tab-to-spaces save mode for all files. When this entry is checked, tabs will be replaced by spaces when the file is saved. You can control the creation of backup files when opening a file in edit mode. 3. You can specify a Start-up Macro to be run when SLink - The SMART Editor starts and a Closing Macro to be run when SLink - The SMART Editor is closed. Access  Control O  Alt-O, O (Options Menu, Option O) Controls  Default Open - Read Only [R] This entry defines whether SLink - The SMART Editor files are to be opened in Read Only Mode or Edit Mode. This can be overridden when a specific file is opened.  Display Column Numbers [D] This entry allows you to enable or disable the column number display from the top of the file display window.  Display with Word Wrap [W] This entry defines whether SLink - The SMART Editor files are to be opened with Word Wrap enabled or disabled. This can be overridden for a specific file from the options menu.  Notify Scan Completion [N] This entry enables or disables the notification (beep) at the termination of a scan. This would be triggered following a String Search or Link.  Snapshot Edit Events [S] This data entry box defines the number of edit events prior to taking a snapshot. A snapshotb is a temporary view of the file saved by SLink - The SMART Editor.  Directory Tracking [K] This entry defines whether the current directory is maintained between commands. If directory tracking is checked, the directory defined in one command (e.g. copy) would be set as the default for all of the other commands (e.g. Search, Delete, etc.).  Auto Indent [I] When this entry is checked, the cursor is automatically lined up at the left justified position of the previous line whenever a carriage return is entered.  Tabs to Spaces [T] When this entry is checked, tabs will be replaced by the number of spaces defined by the Tab Spacing Option when the file is saved.  Link to Comment [O] When this entry is checked, the link-to command will link to the comment preceding the linked function definition.  Independent Insert/Overwrite [O] When this entry is checked, each window on the desktop has its own insert/overwrite state. When this entry is not checked, the insert/overwrite state is the same for all windows on the desktop. To determine which mode your version of OS/2 supports, do the following:  Enter text into the Startup Macro data entry box  Enter text into the Closing Macro data entry box  Press the Insert key in one of the data entry boxes  Place the cursor in the other data entry box Note the results - if the state of the second data entry box changes to agree with the state of the first data entry box, then you do not have independent insert/overwrite windows, so do NOT check this box. If the state of the second data entry box does not change, then you do have independent insert/overwrite windows, so you must check this box.  Disable Edit File Backup [B] When this entry is checked, no backup file is created when a SLink - The SMART Editor file is opened in edit mode. If you are secure without a backup copy of each file opened for edit, and need to conserve the space, this option will disable backup file creation. When this entry is not checked and a file is opened in edit mode, a backup file is created by copying this file to the SLink - The SMART Editor BACKUP directory. This option does not change any of the functions for snapshots, saving files or "Save As" file saves.  Max Undo/Redos This data entry box defines the number of saved edit events. These saved events will available for Undo and Redo commands. SLink - The SMART Editor will allocate 1 undo/redo buffer per edit file. The size of this buffer depends upon the number of saved edit events. If memory is limited, this number should be reduced.  Max Open Files This data entry box defines the number of files that can be opened by SLink - The SMART Editor. If a request is made to open a file and there are already Max files opened, SLink - The SMART Editor will close the oldest unchanged file.  Tab Spacing This data entry box defines the number of spaces allocated for the tab character. When the Tabs to Spaces-Save option is active, SLink - The SMART Editor will replace the tab with the number of spaces set by this option.  Select Command Processor [E] The Command Processor option enables you specify the command processor that will be used for Start Menu command execution and the generated SLink - The SMART Editor OS/2 window. CMD.EXE is the default.  Start-up Macro [P] The Start-up Macro option enables you to define a macro that will be run automatically when SLink - The SMART Editor is started. You must select or enter the name of the macro file. You can enter an argument that will be passed to the macro.  Closing Macro [C] The Closing Macro option enables you to define a macro that will be run automatically when SLink - The SMART Editor is closed. The closing macro, if selected, will be processed prior to the file closing dialog panel, allowing you to get the list of the files opened prior to closing. You must select or enter the name of the macro file. You can enter an argument that will be passed to the macro.  Cancel When you choose the Cancel button, the current command is cancelled.  Help (H) When you choose the Help button, the corresponding on-line help is displayed. See Also: Main Menu File Open Link To [item] Function ═══ 14.2. Set Screen Colors ═══ The Set Screen Colors command enables you to set screen colors. Features 1. You can set the colors of the Read Only Screen. Each time a file is opened in Read Only mode, it will be displayed with the colors defined for this screen. 2. You can set the colors of the Edit Screen. Each time a file is opened in Edit mode, it will be displayed with the colors defined for this screen. 3. You can set the colors of the current screen. This is a temporary assignment and applies only to the window containing the current SLink - The SMART Editor window. 4. You can set the foreground and background colors. The Screen Colors Dialog Panel helps you select the desired colors for each screen. Access  Alt-O, C (Options Menu, Option C) See Also: Main Menu Options Menu Set Screen Font ═══ 14.3. Set Screen Font ═══ The Set Screen Font command enables you to set the typeface, size and style of the font used on all SLink - The SMART Editor files. Features 1. The Screen Font Dialog Panel helps you select the desired font. 2. The current file and all files subsequently opened will have the new font. Access  Alt-O, F (Options Menu, Option F) See Also: Main Menu Options Menu Set Screen Colors Screen Font Dialog Panel ═══ 14.4. Store The SMART Editor INI File ═══ You can customize your The SMART Editor INI file and store it in the directory of your choice. This supports the Multiple Project Configuration environment. You can configure SLink - The SMART Editor for specific projects. In this way each instance of SLink - The SMART Editor can maintain a Project identity with its own command files, macro files, tracks file, directories, reference files and pointer to the project link database. To create a project, the procedure is quite simple. 1. In a directory that you wish to be "home base" for the project, select the Store SLink - The SMART Editor INI file function to save the current SLink - The SMART Editor configuration to the SLink - The SMART Editor INI file (SLINK2.INI). 2. Copy an icon of SLink - The SMART Editor and create a project desktop folder, or display another SLink - The SMART Editor icon object on your desktop. Select "settings" and name this instance of SLink - The SMART Editor as your project. Specify the default directory as the directory that you dropped a copy of SLINK2.INI into the Store SLink - The SMART Editor INI File function. 3. When you start SLink - The SMART Editor, it will look into the default start-up directory for the configuration file for this specific instance. 4. When you close this instance of SLink - The SMART Editor, a LastTrks.Log file will be stored in the same directory as the project .INI file, ready to pick up where you left off the next time you open this instance of SLink - The SMART Editor. 5. If SLink - The SMART Editor starts and cannot find a configuration file in the default directory. 6. If there is an alternate SLink - The SMART Editor default path, it will be used. 7. If you have multiple instances of SLink - The SMART Editor running, and you wish to insure that files are directed from SLStart to a specific instance of SLink - The SMART Editor you can use a special identification parameter. In the setting for your project SLink - The SMART Editor specify a start-up parameter of: "/p:ID" where ID is any short project identification code such as "PrjA". Any time you wish to direct a file from SLStart, place this same parameter as an argument to SLStart, along with the filename to open. You can turn off the SLink - The SMART Editor Project ID after SLink - The SMART Editor has been started by simply selecting the "Disable Project ID" menu item under "Options". If you run with only one instance of SLink - The SMART Editor at a time, this ID is not necessary. When you have an instance of SLink - The SMART Editor identified with a project ID, that instance will ONLY receive filenames from an SLStart with a corresponding project ID. All others will be ignored. Access  Alt-O, S (Options Menu, Option S) See Also: Main Menu Options Menu Ignore SLStart Disable Project ID ═══ 14.5. Where is SLink ═══ A pop-up panel will identify the path for the current SLink executable and the path for the SLink.INI configuration file. If you have multiple copies of SLink this will help identify the executable. Since multiple instances of SLink can be driven from individual configuration files, this panel will identify the current file. Access  Alt-O, S (Options Menu, Option S) See Also: Main Menu Options Menu ═══ 14.6. Enable WorkFrame/2 Errors ═══ You can interact with the WorkFrame and accept compile errors transferred from the IBM WorkFrame/2. SLink - The SMART Editor is fully compatible to the IBM WorkFrame/2. You can drag and drop files and/or send files, send errors, and start an errors session between SLink - The SMART Editor and WorkFrame/2. When configuring WorkFrame/2, specify SLSTART.EXE (Not SLINK.EXE). This allows the IBM WorkFrame/2 to send files to SLink - The SMART Editor without creating new instances. Features 1. You can process compile errors directly from the IBM WorkFrame/2. Start with an instance of SLink - The SMART Editor running (minimized or sized). Check to insure that you have checked "Enable WorkFrame/2 Errors" under the "Options" menu of SLink - The SMART Editor. The WorkFrame/2 Editor configuration should be assigned to "SLSTART.EXE" with parameters "%a %z". Compile your file or run a 'make' from the WorkFrame/2 "Action" menu. The WorkFrame/2 Language settings should be set to "IBM C-Set/2", (assuming you are using the IBM compiler), otherwise you will not have access to on-line help for the errors, nor will you be able to go directly to the column position of the selected error (just the line number). In the WorkFrame/2 Monitor window, your compile errors will scroll by. At the conclusion of your compile, you can send these errors to SLink - The SMART Editor by double clicking on an error line in the Monitor Window or by selecting an error line (single mouse click), then pressing the right mouse button down (center button for 3 button mice) and dragging the errors over to SLink - The SMART Editor. Release the mouse button to complete the drop. If you have double clicked on the error to view, you will be notified when the WorkFrame has transferred the source code file representing the error. Open the SLink - The SMART Editor "Files" menu, and press "Open Waiting Files". The source code for the error will appear in the SLink - The SMART Editor window, and an ErrorsList box will appear. You can select any error for this source file by selecting the error from the SLink - The SMART Editor ErrorsList Box. You can even get help for any of the errors by pressing the "Help" button. If you wish to "Hide" this ErrorsList Box, you can do so. If you wish to later show the box, press "Show ErrorsList" under the "Errors" menu in SLink - The SMART Editor. When you have completed your session with this particular source file in error press "Close ErrorList". The errors session will automatically be closed with a specific source file if you close the WorkFrame/2 Monitor Window or you select another source file with errors from the WorkFrame/2 Monitor Window. 2. The "Errors" menu item on the main menu bar is present only during an errors session with the WorkFrame/2. 3. You have the freedom to perform any SLink - The SMART Editor functions while you are in a WorkFrame/2 error session. 4. The errors session can be started without a running instance of SLink - The SMART Editor. In this case, SLStart will start SLink - The SMART Editor. If SLink - The SMART Editor is started and a file other than the source file for the errors is visible (or in focus if the screen is split), you will need to re-initiate the errors session once SLink - The SMART Editor is running by either of the two methods described above. This may occur if you have a start-up macro that will load a file other than the file in error. Access  Alt-O, W (Options Menu, Option W) See Also: Main Menu Options Menu WorkFrame/2 Next Error WorkFrame/2 Prior Error Show ErrorList Hide ErrorList WorkFrame/2 Help on Error Close ErrorList ═══ 14.7. Ignore SLStart ═══ SLStart is a tiny monitor and loading program to pass files for SLink - The SMART Editor to open. This is used with the IBM WorkFrame/2 to open multiple files without creating multiple instances. This is also used in make or compile command files to send an error file automatically back to SLink - The SMART Editor. You can ignore processing files passed via the SLStart interface. Check this item if you do not want any files sent from SLStart If this is the only instance of SLink - The SMART Editor, SLStart will create a new instance if a file is to be opened. Access  Alt-O, I (Options Menu, Option I) See Also: Main Menu Options Menu Notify Received File Restore Received File Auto Restore Enable WorkFrame/2 Errors ═══ 14.8. Disable Project Id ═══ You can turn off the SLink - The SMART Editor Project ID after SLink - The SMART Editor has been started with this command. This refers to the Multiple Project Configuration environment. You can configure SLink - The SMART Editor for specific projects. In this way each instance of SLink - The SMART Editor can maintain a Project identity with its own command files, macro files, tracks file, directories, reference files and pointer to the project link database. When you have an instance of SLink - The SMART Editor identified with a project ID, that instance will only receive filenames from an SLStart with a corresponding project ID. All others will be ignored. Access  Alt-O, P (Options Menu, Option P) See Also: Main Menu Options Menu Ignore SLStart Store The SMART Editor INI File ═══ 14.9. Notify Received File ═══ You can specify that you are to be notified (BEEP-BEEP) whenever SLStart passes you a file. You can open the received files using "Open Waiting Files" under the "File" menu. The SLink - The SMART Editor title bar will indicate "Waiting Files" whether this item is checked or not checked. Access  Alt-O, N (Options Menu, Option N) See Also: Main Menu Options Menu Ignore SLStart Restore Received File ═══ 14.10. Restore Received File ═══ If SLink - The SMART Editor is minimized it will be restored upon receipt of files from SLStart. Access  Alt-O, R (Options Menu, Option R) See Also: Main Menu Options Menu Ignore SLStart Notify Received File Auto Open Waiting Files ═══ 14.11. Auto Open Waiting Files ═══ Choose this option to automatically open files sent to SLink - The SMART Editor from SLStart. Files will be opened ONLY if the receiving instance of SLink - The SMART Editor has a blank screen showing and is not in a scanning process. Access  Alt-O, A (Options Menu, Option A) See Also: Main Menu Options Menu Ignore SLStart Notify Received File ═══ 15. WorkFrame/2 Errors Menu ═══ The WorkFrame/2 Errors Menu allows the user to interface with the IBM WorkFrame/2 for processing compilation errors. The "Errors" menu item on the main menu bar is present only during an errors session with the WorkFrame/2. Access Alt-S For additional information select one of the following topics:  Main Menu  Enable WorkFrame/2 Errors  WorkFrame/2 Next Error  WorkFrame/2 Prior Error  Show ErrorList  Hide ErrorList  WorkFrame/2 Help on Error  Close ErrorList ═══ 15.1. WorkFrame/2 Next Error ═══ The WorkFrame/2 Next Error allows you to process the next error in the WorkFrame/2 errorlist. Access  Alt-S, N (WorkFrame/2 ErrorList Menu, Option N) For additional information select one of the following topics:  Main Menu  WorkFrame/2 ErrorList Menu  WorkFrame/2 Prior Error  Show ErrorList ═══ 15.2. WorkFrame/2 Prior Error ═══ The WorkFrame/2 Prior Error allows you to process the previous error in the WorkFrame/2 errorlist. Access  Alt-S, P (WorkFrame/2 ErrorList Menu, Option P) For additional information select one of the following topics:  Main Menu  WorkFrame/2 ErrorList Menu  WorkFrame/2 Next Error  Show ErrorList ═══ 15.3. Show ErrorList ═══ The Show ErrorList allows you to display the WorkFrame/2 errorlist. Access  Alt-S, S (WorkFrame/2 ErrorList Menu, Option S) For additional information select one of the following topics:  Main Menu  WorkFrame/2 ErrorList Menu  WorkFrame/2 Next Error  WorkFrame/2 Prior Error  Hide ErrorList  Close ErrorList ═══ 15.4. Hide ErrorList ═══ The Hide ErrorList allows you to hide the WorkFrame/2 errorlist. Access  Alt-S, H (WorkFrame/2 ErrorList Menu, Option H) For additional information select one of the following topics:  Main Menu  WorkFrame/2 ErrorList Menu  Show ErrorList  Close ErrorList ═══ 15.5. WorkFrame/2 Help on Error ═══ The WorkFrame/2 Help on Error allows you to get help on the current error in the WorkFrame/2 errorlist. Access  Alt-S, E (WorkFrame/2 ErrorList Menu, Option E) For additional information select one of the following topics:  Main Menu  WorkFrame/2 ErrorList Menu  WorkFrame/2 Next Error  WorkFrame/2 Prior Error ═══ 15.6. Close ErrorList ═══ The Close ErrorList allows you to close the WorkFrame/2 errorlist. Access  Alt-S, C (WorkFrame/2 ErrorList Menu, Option C) For additional information select one of the following topics:  Main Menu  WorkFrame/2 ErrorList Menu  Hide ErrorList ═══ 16. Help Menu ═══ The Help Menu defines the help functions for SLink - The SMART Editor. Access Alt-H For additional information select one of the following topics:  Main Menu  Help Index  Help Contents  General Help  Keys Help  Product Information  Using Help  Enter View Help  Link To View Help  Enter Help Window  Link To Help Window  Hide Help Window ═══ 16.1. Using Help ═══ Help for Using the Help Facility ═══ 16.2. Help Index ═══ Index to SLink - The SMART Editor Help. ═══ 16.3. Contents Help ═══ Table of Contents for SLink - The SMART Editor Help. ═══ 16.4. Link to View Help ═══ The Link to View Help command starts an OS/2 window containing View Help. Features 1. SLink - The SMART Editor creates an OS/2 session containing the .INF document and displays it. 2. If you click on a word and enter ALT_V, this command automatically links to View Help. If the "Enter View Help" panel specifies to "Use Automatic Lookup", the NDX files will be searched for the selected string. If the "Enter View Help" panel specifies to lookup a specific document (INF file) or environment variable, then the file(s) related to that entry are searched for the selected string. Access  Alt V  Alt-H, V (Help Menu, Option V) See Also: Main Menu Help Menu Enter View Help ═══ 16.5. Enter View Help command ═══ The Enter View Help command defines the type of lookup to be performed and the topic to be viewed and then searches the View Help system for a match. Features 1. You can define a single .INF document to be searched. 2. You can open a specified .INF document to display the help contents. 3. You can specify that all .NDX files are to be searched. 4. You can define a topic to be displayed. If no topic is defined, the .INF index is displayed. 5. To insure that you are properly "connected" to View Help, please verify the following: Insure that the paths for all .NDX files are either listed in the CONFIG.SYS SET DPATH= statement, or the .NDX files reside in the SLink - The SMART Editor directory HELPINDX subdirectory. Insure that your CONFIG.SYS contains the entry SET BOOKSHELF=[Path1];[Path2];...where [Path] is the path for any .INF Files. Access  Control V  Alt-H, R (Help Menu, Option R) Controls  Enter Help Topic You may enter the topic within the .INF document to be viewed.  Lookup Mode-Document Filename or Environment Variable [D] Select this option if you want to search a specific .INF file or a list of .INF files defined in an environment variable. You must enter the path and filename of the .INF document or the CONFIG.SYS environment variable that defines where to search for .INF documents.  Lookup Mode-Use Automatic NDX Lookup [N] Select this option if you want to search all of the .NDX index files for a match.  INF Files This displays a listbox of available .INF files. You can select from this listbox a specific file to be searched with the Lookup Mode-Document Filename option.  Lookup [L] The Lookup button accesses the defined .NDX or .INF documents, searches for the defined topic, and displays the corresponding help information. If there is no topic defined, the .INF index is displayed. The NDX files are searched when the lookup mode is Use Automatic NDX lookup. The INF file(s) are searched when the lookup mode is Document Filename or Environment Variable.  Open INF [I] The Open INF button opens the specified .INF document and displays the contents directory of the help file. This button is available only when the lookup mode is Document Filename or Environment Variable.  Close [C] When you choose the Close button, the current command is cancelled.  Select INF [S] This button moves the selected INF file from the INF files listbox to the Document Filename or Environment Variable data entry box.  Help [H] When you choose the Help button, the corresponding on-line help is displayed. See Also: Main Menu Help Menu Link to View Help ═══ 16.6. Enter QuickHelp Window ═══ The Enter Help Window command starts an OS/2 window containing the help facility specified in this panel. To insure that you are properly "connected" to the Microsoft Quick Help facility, verify the following: SET HELPFILES=[Path1]\*.HLP;[PATH2]\*.HLP... where [Path] is the path for any QuickHelp .HLP files. Help files for specific applications (such as DLGEDT.HLP) are NOT Quick help files and are not in a compatible format for QuickHelp. These files should not appear in the same path as the QuickHelp files. Insure that the executable for your help facility is in a path defined in CONFIG.SYS. Access  Control Q  Alt-H, P (Help Menu, Option P) Controls  Enter Help Path Filename You must enter the path and filename of the help facility program and associated parameters. The default is qh.exe -m32 -l33 -rb -q where qh.exe is the QuickHelp program to be executed, -m32 and -l33 define the number of lines for the QuickHelp display, -rb specifies that the right mouse button can be used for historical QuickHelp selections and -q specifies that the QuickHelp banner is not to be displayed. See Also: Main Menu Help Menu Display QuickHelp Window Hide QuickHelp Window ═══ 16.7. Link To Help Window ═══ The Link to Help Window command displays the Help Window. Features 1. The Help Window must have been previously specified by the Enter Help Window command. 2. The help topic is either the word that you have mouse clicked or selected. Access  Alt Q  Alt-H, L (Help Menu, Option L) See Also: Main Menu Help Menu Hide QuickHelp Window ═══ 16.8. Hide Help Window ═══ The Hide Help Window command hides the Help Window. Features 1. The Help Window must have been previously started by the Enter Help Window command and displayed by the Display QuickHelp Window command. Access  Alt Esc  Alt-H, W (Help Menu, Option W) See Also: Main Menu Help Menu ═══ 17. Dialogs ═══ The miscellaneous Dialogs are grouped together here. For additional information select one of the following topics:  Set Ifdefs  Create DB Scan  Call Tree Root  Maintain Files List  Add Files To List  Set Parameters  Set Screen Colors  Set Screen Font  Select File  Open File  Link Database Options  Change Button Text ═══ 17.1. Set IFDEF Defines Dialog Panel ═══ The Set IFDEF Defines Dialog Panel displays all of the defines found in the SLink - The SMART Editor Database and allows you to selectively assign a value to them. When a define is Set to a value of '1', it is considered to be DEFINED or enabled. This is the same as specifying the define with a DEFINED parameter on the compile statement. When a define is Set to a value of '0', it is considered to be UNDEFINED or disabled. Access  Link Menu: Create SLink - The SMART Editor Database With IFDEFs Controls  Symbol listbox All of the defines found in the SLink - The SMART Editor Database source files are displayed. You may select from this listbox in order to assign them values.  Current Value The current value of each define displayed in the Symbol listbox is displayed.  New Define Value The value to be assigned to the defines selected from the Symbol listbox may be entered. This is updated by the Set '1' button and the Set '0' button; you may also type in any number.  Set '1' [1] The Set '1' button assigns the New Define Value to 1. This specifies that the defined symbol is DEFINED. This button is mutually exclusive with the Set '0' button.  Set '0' [0] The Set '0' button assigns the New Define Value to 0. This specifies that the defined symbol is UNDEFINED. This button is mutually exclusive with the Set '1' button.  Clear Selection [R] The Clear Selection button deselects all symbols in the Symbol listbox.  Select All [A] The Select All button assigns the New Define Value to all symbols in the Symbol listbox.  Set Selected [S] The Set Selected button assigns the New Define Value to all selected symbols in the Symbol listbox.  OK When you choose the OK button, the creation of the SLink - The SMART Editor Database continues.  Cancel When you choose the Cancel button, the current command is cancelled.  Help (H) When you choose the Help button, the corresponding online help is displayed. See Also: Main Menu Link Menu Create SourceLInk DB With Defines ═══ 17.2. Create DB Scan Status Dialog Panel ═══ The Create DB Scan Status Dialog Panel displays the status of the scans involved in the process of creating the SLink - The SMART Editor Database. Access  Link Menu: Create SLink - The SMART Editor Database Controls  Pass The Create Database command scans the source files twice. The current pass is displayed.  Percent Complete The percent completion (by file size) is displayed.  Elapsed Time The time that has elapsed since the beginning of the first scan is displayed.  Time Remaining The estimated time remaining to complete both passes of the scan is displayed.  Estimated Total Scan The estimated total time for both passes of the scan is displayed.  Files Completed The number of files scanned during the current pass is displayed.  Out Of The number of files to be scanned during each pass is displayed.  Total Files Size The total size of all files to be scanned is displayed.  Scanning File The filename of the file currently being scanned is displayed.  Cancel When you choose the Cancel button, the current command is cancelled. See Also: Main Menu Link Menu Create SLink - The SMART Editor Database ═══ 17.3. Call Tree Root Dialog Panel ═══ The Call Tree Root Dialog Panel prompts you for the name of the root function for the SLink - The SMART Editor Database Call Tree Report. The default is main(). You may specify the maximum levels for the tree. The default is 20. The report, showing the tree of functions contained in the database, is then created. Access  Link Menu: Create SLink - The SMART Editor DB  Link Menu: Rebuild Reports Controls  Link DB Path The Current SLink - The SMART Editor Database path is displayed.  Root Function Data entry You must type in the name of the top level function from which the tree will be created.  Maximum Levels You must type in the maximum number of levels of the function tree.  OK When you choose the OK button, the previously defined call tree is created. During the report generation, the current function name is displayed.  Cancel When you choose the Cancel button, the current command is cancelled.  Help (H) When you choose the Help button, the corresponding online help is displayed. See Also: Main Menu Link Menu Create SLink - The SMART Editor Database CallTree Report ═══ 17.4. Maintain Files List Dialog Panel ═══ The Maintain Files List Dialog Panel enables you to add and delete files contained in a list-of-files. Access  Link Menu: Maintain A List Of Files Controls  Files List Filename The list-of-files filename is displayed.  Filenames Count The number of files contained in the list-of-files is displayed.  Filenames listbox The Filenames listbox displays each entry contained in the list-of-files file. You may select one or more files from this list, then choose the Delete button and the selected files will be deleted from the list-of-files.  Store [S] The Store button saves the contents of the list-of-files in the list-of-files file.  Cancel When you choose the Cancel button, the current command is cancelled.  Add [A] The Add button displays the Add Files To List where you can add files to the list-of-files.  Delete [D] The Delete button removes all files selected in the Filenames listbox from the list-of-files file.  Delete All [L] The Delete All button removes all files from the list-of-files file.  Help (H) When you choose the Help button, the corresponding online help is displayed. See Also: Main Menu Link Menu Maintain A List Of Files ═══ 17.5. Add Files To List Dialog Panel ═══ The Add Files To List Dialog Panel prompts you for the name of the files to add to the list-of-files. Access  List-Of-Files Files List Dialog Panel Controls  Dir: The current directory is displayed.  Filename: You may type in a new directory path; this must end with a \ (e.g. C:\NEWDIR\). The directories listbox and files listbox are updated. You may type in the name of the file to be added (e.g. NEWFILE.C). You may type in the full path, drive, directory, and filename (e.g. C:\NEWDIR\NEWFILE.C) of the file to be added.  Drives This listbox contains drives. You may select the base drive from this list.  Directories Button This button will popup a user maintainable list box to contain your most often accessed directories.  Directories Listbox This listbox contains directories. You may select the base directory from this list.  Filenames This listbox contains a list of files satisfying the current wildcard (usually *.*) which are contained within the selected drive and directory. You may select multiple filenames.  Display (D) The Display button updates the Filenames listbox according to the current wildcard which is displayed in the Wildcard data entry box.  Wildcard: The Wildcard data entry box allows entry of a new filenames wildcard. When you choose the Display button, the Filenames listbox is updated.  *.* (*) The *.* button updates the Filenames wildcard. When you choose this button, the Filenames listbox displays all of the files in the current directory. Double click (right mouse button) on this button to customize the button for your own use.  *.C (C) The *.C button updates the Filenames wildcard. When you choose this button, the Filenames listbox displays all of the files in the current directory satisfying the *.C wildcard. Double click (right mouse button) on this button to customize the button for your own use.  Add [A] When you choose the Add button, all selected files will be added to the previously defined list-of-files.  Close [C] When you choose the Close button, you are returned to the List-of-files Files List Dialog panel.  Select All [S] When you choose the Select All button, all displayed files will be added to the previously defined list-of-files.  Help (H) When you choose the Help button, the corresponding online help is displayed. See Also: Main Menu Edit Menu Link - Maintain List Of Files Menu ═══ 17.6. Set Parameters Dialog Panel ═══ The Set Parameters Dialog Panel enables you to qualify the files that are to be copied, moved or found. Access  Copy Menu: Parameters  Find Function: Parameters Controls  After (Incl) [A] When you check the After (Incl) Checkbox, all files with a date and time equal to or later than the displayed after/equal date and time are included in the copy, move or find.  Equal (Date) [E] When you check the Equal (Date) Checkbox, all files with a date equal to the displayed after/equal date are included in the copy, move or find.  (After/Equal) Date (mm-dd-yy) The month, day, and year associated with the After or Equal Checkbox is displayed and can be updated.  Before [B] When you check the Before Checkbox, all files with a date prior to the displayed before date are included in the copy, move or find. When the After or Equal Checkbox is also checked, all files between the after/equal date/time and the before date/time are included in the copy, move or find.  (Before).Date (mm-dd-yy) The month, day, and year associated with the Before Checkbox is displayed and can be updated.  File Attributes [F] When you check the File Attributes Checkbox, only files matching all of the selected file attributes are involved in the copy, move or find. When you uncheck the File Attributes Checkbox, only files with the Archive and ReadOnly attributes are involved in the copy, move or find.  Archive [V] When you check the Archive Checkbox, files with the Archive file attribute may be involved in the copy, move or find.  Read Only [R] When you check the Read-only Checkbox, files with the Read-only file attribute may be involved in the copy, move or find.  System [S] When you check the System Checkbox, files with the System file attribute may be involved in the copy, move or find.  Hidden [H] When you check the Hidden Checkbox, files with the Hidden file attribute may be involved in the copy, move or find.  OK When you choose the OK button, the previously defined parameters are saved. See Also: Main Menu Copy Files Find Files File Attributes ═══ 17.7. Set Screen Colors Dialog Panel ═══ The Set Screen Colors Dialog Panel enables you to set the foreground and background colors of the Default Read Only Screen, Default Edit Screen, and current screen. Access  Options Menu: Set Screen Colors Controls  Foreground listbox The foreground listbox contains the foreground colors. As an entry is selected, the foreground of the Sample box is updated.  Background listbox The background listbox contains the background colors. As an entry is selected, the background of the Sample box is updated.  Sample Box The Sample Box displays the currenly selected foreground and background colors.  Current Screen Colors [C] When you check the Current Screen Colors Checkbox, the selected screen colors will be assigned to the current SLink - The SMART Editor screen when you choose the Save button.  Default Read Only Screen [R] When you check the Default Read-only Screen Checkbox, the selected screen colors will be assigned to the Default SLink - The SMART Editor Read-only screen (when a file is in Read-only mode, it will be displayed according to the selected colors). This is assigned when you choose the Save button.  Default Edit Screen [E] When you check the Default Edit Screen Checkbox, the selected screen colors will be assigned to the Default SLink - The SMART Editor Edit screen (when a file is in Edit Mode, it will be displayed according to the selected colors) This is assigned when you choose the Save button.  Save [S] When you choose the Save button, the previously defined colors are assigned to the pre-enabled screens (current screen, Read-only, Edit ).  Close [O] When you choose the Close button, the current command is cancelled.  Reset [T] When you choose the Reset button, the color settings are reset to the colors assigned prior to entering this dialog panel.  Help (H) When you choose the Help button, the corresponding online help is displayed. See Also: Main Menu More Menu Set Screen Colors ═══ 17.8. Set Screen Font Dialog Panel ═══ The Set Screen Font Dialog Panel enables you to set the font for all of the SLink - The SMART Editor files. Access  More Menu: Set Screen Font Controls  Typeface listbox The Typeface listbox contains the available typefaces. As an entry is selected, the typeface of the Sample box is updated and the Size listbox is updated.  Size listbox The Size listbox contains the available type size for the selected typeface. As an entry is selected, the type size of the Sample box is updated.  Bold Style [B] The Bold Checkbox allows the typeface to appear in bold style. When you check this Checkbox, the typeface of the Sample box is updated.  Italic Style [I] The Italic Checkbox allows the typeface to appear in italic style. When you check this Checkbox, the typeface of the Sample box is updated.  Sample Box The Sample Box displays the currenly selected typeface, size, and style.  Save [S] When you choose the Save button, the previously defined font selections are saved.  Cancel When you choose the Cancel button, the current command is cancelled.  Reset [T] When you choose the Reset button, the font settings are reset to the font assigned prior to entering this dialog panel.  Help (H) When you choose the Help button, the corresponding online help is displayed. See Also: Main Menu More Menu Set Screen Font ═══ 17.9. Open File Dialog Panel ═══ The Open File Dialog Panel prompts you for the name of the file. Access  Link Menu: Maintain A List Of Files  Link Menu: Select File For List Of Files  Interactive Window: CommandList Menu: Load List Controls  Dir: The current directory is displayed.  File: You may type in a new directory path; this must end with a \ (e.g. C:\NEWDIR\). The directories listbox and files listbox are updated. You may type in the name of the file to be selected (e.g. NEWFILE.C). You may type in the full path, drive, directory, and filename (e.g. C:\NEWDIR\NEWFILE.C) of the file to be selected.  Size: The size of the selected filename is displayed.  Drives This listbox contains drives. You may select the base drive from this list.  Directories Button This button will popup a user maintainable list box to contain your most often accessed directories.  Directories Listbox This listbox contains directories. You may select the base directory from this list.  Filenames Button This button will popup a user maintainable list box to contain your most often accessed filenames.  Filenames Listbox This listbox contains filenames. You may select a filename from this list.  Display (D) The Display button updates the Filenames listbox according to the current wildcard which is displayed in the Wildcard data entry box.  Wildcard: The Wildcard data entry box allows entry of a new filenames wildcard. When you choose the Display buttond, the Filenames listbox is updated according to this wildcard.  *.* (*) The *.* button updates the Filenames wildcard. When you choose this button, the Filenames listbox displays all of the files in the current directory. Double click (right mouse button) on this button to customize the button for your own use.  *.C (C) The *.C button updates the Filenames wildcard. When you choose this button, the Filenames listbox displays all of the files in the current directory satisfying the *.C wildcard. Double click (right mouse button) on this button to customize the button for your own use.  *.LST (L) The *.LST button updates the Filenames wildcard. When you choose this button, the Filenames listbox displays all of the files in the current directory satisfying the *.LST wildcard. Double click (right mouse button) on this button to customize the button for your own use.  OK When you choose the OK button, the previously defined file is opened and read into the current file at the current cursor location.  Cancel When you choose the Cancel button, the current command is cancelled.  Help (H) When you choose the Help button, the corresponding online help is displayed. See Also: Main Menu Edit Menu Link - Maintain List Of Files Menu Interactive Menu - CommandList - Load List ═══ 17.10. Select File Dialog Panel ═══ The Select File Dialog Panel prompts you for the name of the file. Access  File Menu: Save As File  Edit Menu: Read Into Cursor  Clip Menu: Rename Clip File  Macro Menu: Run Macro File  Interactive Window: File Menu: Run Macro File Controls Controls  Select The Select button prompts you to select the name of the macro file (the Select File dialog panel will be displayed for filename selection).  Filename data entry box You may type in the name of the file (e.g. MYMACRO.TXT). This can optionally include the full path.  OK When you choose the OK button, the previously defined macro is executed.  Cancel When you choose the Cancel button, the current command is cancelled.  Help (H) When you choose the Help button, the corresponding online help is displayed.  Trace On (T) This entry allows you to enable or disable the current state of Macro Trace. See Also: Main Menu Edit Menu Link - Maintain List Of Files Menu Interactive Commands Window ═══ 17.11. Link Database Options Dialog Panel ═══ The Link Database Options Dialog Panel prompts you for the items that are to included in the build of the database. Access  Link Menu: Create SLink - The SMART Editor DB  Link Menu: Create DB with Ifdefs Controls  List-of-Files Filename The List of Files for the database being built is displayed.  Functions [F] The Functions link type specifies that function definitions are to be included in the database. This is always set. The functions report, SL_Funct.Rpt, is generated. It resides in the same directory as the database. It can be viewed from the REF menu.  #Define Symbols [Y] The #Define Symbols link type specifies that #defines symbols are to be included in the database. This includes #define statements in C and EQU, =, or EXTRN ABS statements in MASM. If this entry is checked, the database will scan for this link type and all items found will be included in the database. The #define report, SL_Defin.Rpt, is generated. It resides in the same directory as the database. It can be viewed from the REF menu.  Globals [G] The Globals link type specifies that global variables are to be included in the database. This includes all variables before the first function definition in a C file and BYTE, WORD, DWORD, FWORD, QWORD, TBYTE, DB, DD, DW, DF, DQ or DT statements in MASM. If this entry is checked, the database will scan for this link type and all items found will be included in the database. The globals report, SL_Glob.Rpt, is generated. It resides in the same directory as the database. It can be viewed from the REF menu.  Dialog Templates [D] The Dialog Templates link type specifies that Dialog Templates are to be included in the database. This includes all DLGTEMPLATE and WINDOWTEMPLATE in a C file. If this entry is checked, the database will scan for this link type and all items found will be included in the database. The Dialog Templates report, SL_DlgBx.Rpt, is generated. It resides in the same directory as the database. It can be viewed from the REF menu.  User Specified List [U] The User Specified link type specifies that all symbols contained in the indicated User Specified List file are to be included in the database. The User Specified report, SL_User.Rpt, is generated. It resides in the same directory as the database. It can be viewed from the REF menu. The "User Specified List" file is defined as follows: 1. An ascii file with one line per symbol specification. 2. The link specification is either the leading characters of keyword strings, such as: "Win*", "Dos*", "Gpi*" or string literals, such as: "MyStuff", "A_Macro". 3. All specifications are case sensitive. 4. If you wish to have the point of reference for these keywords show up in the call tree at the point of reference, add a comma and "C" to the specification. For example, you want to show all Win, Dos and Gpi calls in your function call tree, create a user link specification file as follows: Win*,C Dos*,C Gpi*,C  Select [S] You can select or type in the filename of the User Specified Link List. This is applicable only when the User Specified List is checked.  Root Function for Call Tree [R] The Root Function for Call Tree specifies that a function call tree is to be included in the database. The Call Tree shows the hierarchial inter-relationship of the functions defined in the SLink - The SMART Editor database. User Specified functions will also appear when the user specified symbol in the user specified list file includes the C parameter. The Call Tree report, SL_Call.Rpt, is generated. It resides in the same directory as the database. It can be viewed from the REF menu. When you check the Call Tree report, you must enter the name of the root function of the call tree.  Proceed [P] When you choose the Proceed button, the previously defined link is done; the database build is executed.  Cancel When you choose the Cancel button, the database build is cancelled.  Help (H) When you choose the Help button, the corresponding online help is displayed. See Also: Main Menu Link Menu Ref Menu ═══ 17.12. Menu Maintenance Dialog Panel ═══ The Menu Maintenance Dialog Panel displays the user defined menu entries. Menu Entries can be added, changed or deleted. Access  Macro Menu: User Macro Definition  Start Menu: Define Menu Item Controls  Menu Items The defined menu items are displayed in a list box.  Add [A] Add an item to the listbox. This results in the Menu Registration Dialog Panel being displayed and the addition being saved.  Change [C] Change the currently selected listbox item. This results in the Menu Registration Dialog Panel being displayed and the change being saved.  Delete [D] Delete the currently selected listbox item. You will be prompted prior to deleting the item from the listbox. p. OK [O] When you choose the OK button, you return to where you were prior to entering this dialog.  Help (H) When you choose the Help button, the corresponding online help is displayed. See Also: Main Menu Define Macro Menu Item Define Command Menu Item ═══ 17.13. Popup Selection Panel ═══ The Popup Selection Panel displays user lists for paths or filenames. List entries can be added, changed or deleted. Access  File Open Menu: Directories, Filenames  All other file and directory selection dialogs Controls  Title Bar The ascii data file containing the displayed items is displayed in the dialog title bar.  List Items The stored items are displayed in a list box. Double clicking on an item is the same as selection + pressing "Process".  Process [A] The contents of the list box are written to the data file. The selected item is returned to the calling dialog panel for processing.  Cancel [A] The dialog panel is closed with no selection returned to the calling panel.  Store [A] The contents of the list box are written to the data file. The dialog panel is closed with no selection returned to the calling panel.  Add [D] The string in the entry box above the list is added to the list box contents. Case sensitive duplicates are not added to the list. This item is stored in the data file when 'Process' or 'Save' is pressed.  Delete [D] The currently selected listbox item is deleted from the list and the next item is selected.  Help (H) When you choose the Help button, the this online help is displayed. ═══ 17.14. Menu Registration Dialog Panel ═══ The Menu Registration Dialog Panel allows you to define a User Menu Item. You must enter the legend that will appear in the menu's Drop Down Menu. You must select or enter the menu entry's filename. You can specify an argument that will be passed to the menu entry when it is executed. You can specify an accelerator key that will be associated with the menu entry. If a macro and a command file have the same accelerator key, the macro will override the command file. Either the macro or command file will override a SLink - The SMART Editor accelerator key assignment. If the menu item is a macro (from the Macro Menu), you can specify that you are to be notified upon macro completion. If the menu item is a command (from the Start Menu), you can specify that the entry is a command file. Access  Macro Menu: User Macro Definition: Add or Change  Start Menu: Define Menu Item: Add or Change Controls  Menu Item Legend [L] The Menu Item Legend defines the text that will appear on the drop down menu.  Select [S] You may select or enter the filename of the Macro Menu macro file or the Start Menu command file to be executed. You can enter a set of commands to be executed. You can enter a system command in the entry field for "command". This will allow you to enter something simple like: "COPY Myfile A:" or a set of commands like: "C: & CD \mydir & DIR *.* > dir.txt & SLSTART dir.txt". This convenience option eliminates the requirement for creating a separate command file for simple operations, if you choose to do so. Note that the command line above uses the ampersand to concatenate multiple commands on the same command line. Up to 127 characters are allowed. (The command line shown above sets a path; gets a directory and pipes it to a file; then sends this back to SLink - The SMART Editor via SLStart.)  Arguments You may specify arguments that will be passed to the macro file or command file when it is executed.  Set Accelerator Key [T] You can attach an accelerator key to the menu item. When this is checked, you must define the accelerator key.  Key You must specify the accelerator key to be used. It can be 0-9, a-z, F1-F12. This key can be used in conjunction with the ALT, CONTROL, or SHIFT keys.  Alt [A] When Alt is selected, the ALT key is used in conjunction with the defined accelerator key and is attached to the menu item.  Control [C] When Control is selected, the CONTROL key is used in conjunction with the defined accelerator key and is attached to the menu item.  Shift [I] When Shift is selected, the SHIFT key is used in conjunction with the defined accelerator key and is attached to the menu item.  Command File [F] If you are spawning an executable from the Start menu, DO NOT check "Command File". If the item to be spawned is a command file or a command line as shown above, then check "Command File".  Notify Upon Completion [F] When you are defining a macro menu item, you can specify that you want to be Beeped whent he macro has finished execution. p. OK [O] When you choose the OK button, you the menu item is registered.  Cancel When you choose the Cancel button, the current command is cancelled.  Help (H) When you choose the Help button, the corresponding online help is displayed. See Also: Main Menu Define Macro Menu Item Define Command Menu Item ═══ 17.15. Change Button Text Dialog Panel ═══ The Change Button Text Dialog Panel Dialog Panel allows you to specify the value of the wild card buttons in the file/selection dialogs. The values entered in this panel will display on the button and will be saved for future use. Access Double click, right mouse button on the button to change  Open File  Select File  File Find  Delete Files/Directories  Copy Files/Directories  File Attributes  Add Files to Contents  String Search Controls  Enter New Value Entry Field You may type in the wild card string (eg. *.*).  OK When you choose the OK button, the entered wildcard will be associated with the button.  Cancel When you choose the Cancel button, the current entry is cancelled.  Help (H) When you choose the Help button, the corresponding online help is displayed. See Also: Main Menu Edit Menu Link - Maintain List Of Files Menu Interactive Commands Window ═══ 18. Error Codes ═══ The Errors generated by SLink - The SMART Editor are listed here. For additional information select one of the following topics:  Main Menu  File Handling Errors  Link Database Errors  S_ Errors  Rexx Errors ═══ 18.1. File Handling Errors ═══ The File Handling Errors are errors returned from a file I/O operation. File handling error codes ========================= Code Probable Cause 0 No Error 1 Invalid Function 2 File Not Found 3 Path Not Found 4 Too Many Open Files 5 Access Denied 6 Invalid Handle 7 Arena Trashed 8 Not Enough Memory 9 Invalid Block 10 Bad Environment 11 Bad Format 12 Invalid Access 13 Invalid Data 15 Invalid Drive 16 Current Directory 17 Not Same Device 18 No More Files 19 Write Protect 20 Bad Unit 21 Not Ready 22 Bad Command 23 CRC 24 Bad Length 25 Seek 26 Not Dos Disk 27 Sector Not Found 28 Out Of Paper 29 Write Fault 30 Read Fault 31 General Failure 32 Sharing Violation 33 Lock Violation 34 Wrong Disk 35 Fcb Unavailable 36 Sharing Buffer Exceeded 50 Not Supported 80 File Exists 81 Duplicate Fcb 82 Cannot Make 83 Fail I24 84 Out Of Structures 85 Already Assigned 86 Invalid Password 87 Invalid Parameter 88 Net Write Fault 89 No Proc Slot 90 Not Frozen 93 No Items 95 Interrut 100 Too Many Semaphores 101 Excl Sem Already Owned 102 Sem Is Sem 103 Too Many Sem Requests 104 Invalid At Interrupt Time 105 Sem Owner Died 106 Sem User Limit 107 Disk Change 108 Drive Locked 109 Broken Pipe 110 Open Failed 111 Buffer Overflow 112 Disk Full 113 No More Search Handles a ═══ 18.2. Link Database Errors ═══ The Link Database Errors are errors returned from a database operation. Link Data Base error codes ========================== Code Probable Cause 1 Not Enough Memory 2 Cannot Open DB 3 Cannot Close DB 4 Cannot Init DB 5 Cannot Create Module Rec 6 Cannot Add Rec 7 Cannot Find Def 8 Cannot Create Owner Rec 9 Cannot Create Path Rec 10 Cannot Find Module Rec 11 Cannot Find Path Rec 12 Duplicate Func Def 13 List Too Big 14 Cannot Create File 15 Write Error 16 File Created 17 Cannot Find Preprocessor Variable 18 Invalid Preprocessor 19 Cannot Create Ifdef Rec 20 Too Many Preprocessor Variables 21 Pm Error 22 Invalid Preprocessor Variables 23 Too Many Defined Preprocessors 24 Too Many Preprocessor Constants 25 Have Constant 26 Cannot Create Listfile Rec 27 Cannot Find Listfile Rec 28 Preprocessor Not Initialized 29 Invalid Db Version 30 Cannot Create Version Record 31 Cannot Find Version Record 32 Preprocessor Stack Exceeded 33 User Terminated 34 Cannot Create Type Rec 35 Cannot Create Userfile Rec 36 Cannot Open User File 37 Read Error 38 Cannot Create User Entry Rec 39 Cannot Find Userfile Rec 40 INvalid Arg 41 Cannot Find Ref 42 Multiple Database Access 43 Module Name Too Big ═══ 18.3. S_ Errors ═══ The S_ Errors are errors returned from a built in S_ macro function. Macro error codes ================= Code Probable Cause 1 Invalid Argument 2 Miscellaneous Error 3 No Memory 4 File Open Error 5 Size Exceeded 6 File Write Error 7 Invalid Filename 8 Cannot Access Drive 9 Demo Error 10 Hex File not Allowed 11 Empty File 12 Empty Window 13 Read-only Window 14 Cannot Access File 15 Binary File not Allowed 16 File Read Error 17 Not Found 18 Updated File 19 Undo Error 20 File is Opened 21 No Selection 22 Print Error 23 Clip File Error 24 Not Set 25 No Available Buffers 26 No Entries 27 Snap File Error 28 No Disk Space 29 User Variable Error 30 Cannot Access Directory 31 No Link Database Path 32 Link Database Not Found 33 Cannot Open Database 34 Function Not Found 35 Cannot Access Database 36 Cannot Create Report 37 Macro Name Missing 38 Macro File Not Found 39 Cannot Spawn Command 40 Misc. File Error 41 Function Not Defined ═══ 18.4. Rexx Errors ═══ The Rexx Errors are errors returned from Rexx when executing a Rexx macro. Macro error codes ================= Code Probable Cause 1 Too many opened files 2 Expression > 64000 characters 3 Rexx program cannot be read from disk 4 The system interrupted execution of your program 5 Memory resources exhausted 6 Unmatched "/*" or quote 7 WHEN or OTHERWISE expected 8 Unexpected THEN or ELSE 9 Unexpected WHEN or OTHERWISE 10 Unexpected or unmatched END 11 Nesting of control statements exceeded 12 Clause length exceeded (may be missing quote) 13 Invalid character outside of a literal string 14 Incomplete DO/SELECT/IF 15 Invalid hex or binary string 16 Label specified on SIGNAL not found 17 Unexpected PROCEDURE 18 THEN expected 19 String or symbol expected following CALL or SIGNAL 20 Symbol expected 21 Invalid data on end of clause 23 Invalid character string 24 Invalid TRACE request 25 Invalid subkeyword found 26 Invalid whole number 27 Invalid DO syntax 28 Invalid LEAVE or ITERATE 29 Environment name on ADDRESS too long (>250) 30 Name or string too long (>250) 31 Name starts with numeric or "." 33 Invalid expression result 34 Logical value not 0 or 1 35 Invalid expression (grammatical error) 36 Unmatched "(" 37 Unexpected "," or ")" 38 Invalid template or pattern 39 Too many nested parens, functions, etc 40 Incorrect call to routine 41 Invalid numeric expression 42 Arithmetic overflow/underflow 43 CALL routine not found 44 Function did not return data 45 No data specified on RETURN 46 Invalid variable reference 48 Failure in system service (stream input, etc) 49 Severe Error within REXX 115 RXSUBCOM parameters are incorrect 116 RXSUBCOM parameter REGISTER is incorrect 117 RXSUBCOM parameter DROP is incorrect 118 RXSUBCOM parameter LOAD is incorrect 119 Invalid OS/2 filename ═══ 19. S_ Macros ═══ S_ Macros are the built in macros supplied by SLink - The SMART Editor. These macros can be called from any Rexx command file. These macros supply the following functionality:  Cursor Movement  SLink - The SMART Editor Files  External Files  Edit  Paste  Clip  Get  Search and Replace  Windows  Misc See Also:  S_ Quick Reference ═══ 19.1. S_ Quick Reference ═══ SLink - The SMART Editor provides the following S_ built in Rexx macros. S_BEG_OF_FILE (no arguments) Move the cursor to the beginning of the current file. S_BEG_OF_LINE (no arguments) Move the cursor to the beginning of the current line. S_BEG_OF_SCREEN (no arguments) Move the cursor to the beginning of the current page. S_CAN_I_WRITE (filename, ReturnVariable) Can the specified file be written to. S_CD (new_pathname) Change the current directory. S_CHG_CASE (case_mode) Change the case of the selected text. S_CHG_CLIP_MODE (no arguments) Change the mode of the clip file. S_CHG_EDITMODE (no arguments) Change the edit mode of the current file. S_CHG_WORDWRAP (no arguments) Change the word wrap mode of the current file. S_CLEAR_MACRO_OUTPUT (no arguments) Clear the macro output file. S_CLOSE_ALL_FILES (no arguments) Close all SLink - The SMART Editor files. S_CLOSE_CURR_FILE (no arguments) Close the current SLink - The SMART Editor file. S_CLOSE_FILE (file_handle) Close the specified non-SLink - The SMART Editor file. S_CLOSE_SL_FILE (buffer_number) Close the SLink - The SMART Editor file contained in the specified buffer. S_COPY_CLIP_TO_PASTE (no arguments) Copy the clip file to the paste buffer. S_COPY_PASTE_TO_CLIP (no arguments) Copy the paste buffer to the clip file. S_COPY_SEL_TO_CLIP (no arguments) Copy the selected text to the clip file. S_COPY_SEL_TO_PASTE (no arguments) Copy the selected text to the paste buffer. S_CUT_SEL_TO_PASTE (no arguments) Cut the selected text to the paste buffer. S_DEL_CHAR (no arguments) Delete the current character. S_DEL_LINE (no arguments) Delete the current line. S_DEL_SELECTED (no arguments) Delete the selected text. S_DEL_TO_EOL (no arguments) Delete to end of line. S_DEL_WORD (no arguments) Delete the current word. S_DISPLAY_CLIP (no arguments) Display the clip file. S_DISPLAY_REF_FILE (reference_file_id) Display the specified reference file. S_DOES_FILE_EXIST (filename, ReturnVariable) Does the specified file exist. S_END_OF_FILE (no arguments) Move the cursor to the end of the current file. S_END_OF_LINE (no arguments) Move the cursor to the end of the current line. S_END_OF_SCREEN (no arguments) Move the cursor to the end of the current page. S_GET_BUFF_COL_NUM (buffer_number, ReturnVariable) Get the column number of the specified SLink - The SMART Editor file. S_GET_BUFF_EDITMODE (buffer_number, ReturnVariable) Get the edit mode of the specified SLink - The SMART Editor file. S_GET_BUFF_FILENAME (buffer_number, ReturnVariable) Get the file name of the specified SLink - The SMART Editor file. S_GET_BUFF_LINE_NUM (buffer_number, ReturnVariable) Get the current line number of the specified SLink - The SMART Editor file. S_GET_BUFF_WORDWRAP (buffer_number, ReturnVariable) Get the word wrap mode of the specified SLink - The SMART Editor file. S_GET_CLIP_FILENAME (ReturnVariable) Get the clip file name. S_GET_COL_NUM (ReturnVariable) Get the current column number. S_GET_CURR_CHAR (ReturnVariable) Get the character at the cursor. S_GET_CURR_CHGSTATUS (ReturnVariable) Get the change status of the current SLink - The SMART Editor file. S_GET_CURR_EDITMODE (ReturnVariable) Get the edit mode of the current SLink - The SMART Editor file. S_GET_CURR_FILENAME (ReturnVariable) Get the filename of the current SLink - The SMART Editor file. S_GET_CURR_SL_DIR (ReturnVariable) Get the current SLink - The SMART Editor directory. S_GET_CURR_WORD (ReturnVariable) Get the word at the cursor. S_GET_CURR_WORDWRAP (ReturnVariable) Get the word wrap mode of the current SLink - The SMART Editor file. S_GET_CURSOR_POS (ReturnVariable) Get the cursor position of the current SLink - The SMART Editor file. S_GET_DISK_SPACE (DriveNum, ReturnVariable) Get the available disk space for the specified drive. S_GET_ENV_INFO (EnvironmentVariable, ReturnVariable) Get the environment information for the specified environment variable. S_GET_FILE_BUFFNUM (filename, ReturnVariable) Get the buffer number for the specified SLink - The SMART Editor file. S_GET_FILE_INFO (filename, ReturnVariable) Get the file size and date and time for the specified file. S_GET_LINE_LEN (ReturnVariable) Get the length of the current line. S_GET_LINE_NUM (ReturnVariable) Get the current line number. S_GET_NUM_SL_FILES (ReturnVariable) Get the number of opened SLink - The SMART Editor files. S_GET_REF_FILENAME (ReferenceFileId, ReturnVariable) Get the file name of the specified reference file. S_GET_SELECTED_SIZE (ReturnVariable) Get the length of the selected text. S_GET_SELECTED_TEXT (ReturnVariable) Get the selected text. S_GET_SL_INI_PATH (ReturnVariable) Get the path of the current SLINK2.INI file. S_GOTO_BEG_BRACE (no arguments) Move the cursor to the beginning brace. S_GOTO_BUFF (buffer_number) Display the SLink - The SMART Editor file contained in the specified buffer. S_GOTO_COL (column_number) Move the cursor to the specified column number. S_GOTO_END_BRACE (no arguments) Move the cursor to the ending brace. S_GOTO_LINE (line_number) Move the cursor to the specified line number. S_GOTO_MARK (marker_number) Move the cursor to the specified marker. S_GOTO_POS (no arguments) Move the cursor to the saved cursor position. S_INDENT (no arguments) Indent the current line to the beginning of the previous line. S_INSERT_CLIP (no arguments) Insert the clip file at the current cursor position. S_INSERT_FILE (filename) Insert the specified file at the current cursor position. S_INSERT_LINE (string) Insert the specified string at the current cursor position and append a carriage return. S_INSERT_PASTE (no arguments) Insert the paste buffer at the current cursor position. S_INSERT_STRING (string) Insert the specified string at the current cursor position. S_IS_DRIVE_PROTECTED (drive, ReturnVariable) Is the specified drive write protected. S_IS_FILE_BINARY (filename, ReturnVariable) Is the specified file contain non_ascii data. S_LISTBOX (listbox_entries_filename, listbox_title, ReturnVariable) Display, update and select from a listbox. S_MARK_CURR_POS (marker_number) Set the specified marker to the current cursor position. S_MSG (msg_line1, msg_line2, msg_line3, ReturnVariable) Display a message and wait for the user to respond. S_NEXT_CHAR (no arguments) Move the cursor right one character. S_NEXT_LINE (no arguments) Move the cursor down one line. S_NEXT_PAGE (no arguments) Move the cursor down one page. S_NEXT_WORD (no arguments) Move the cursor right one word. S_OPEN_FILE (file_exists_mode, newfile_mode, filename, ReturnVariable) Open the specified non-SLink - The SMART Editor file. S_OPEN_SL_FILE (open_mode, edit_mode, wrap_mode, filename) Open the specified SLink - The SMART Editor file. S_PREV_BUFFER (no arguments) Display the file previously displayed in the current SLink - The SMART Editor window. S_PREV_CHAR (no arguments) Move the cursor left one character. S_PREV_LINE (no arguments) Move the cursor up one line. S_PREV_PAGE (no arguments) Move the cursor up one page. S_PREV_WORD (no arguments) Move the cursor left one word. S_PRINT_CURR_FILE (no arguments) Print the current file. S_PRINT_SELECTED (no arguments) Print the selected text. S_PROMPT (prompt_msg, ReturnVariable) Display a Message and return the user's string response. S_READ_FILE (file_handle, length, ReturnVariable) Read the specified non-SLink - The SMART Editor file. S_REDO Redo the last undo edit function. S_RENAME_CLIP_FILE (new_clipname) Rename the clip file. S_REPLACE (search_string, replace_string, ReturnVariable) Replace all occurrences of the search string with the replace string within the current file. S_SEARCH_BACK (case_sensitive, string) Search backwards within the current file for the specified string. S_SEARCH_FWD (case_sensitive, top_of_file, string) Search forwards within the current file for the specified string. S_SEARCH_NEXT (no arguments) Search for the next occurrence of the previously defined string. S_SET_DB_PATH (DBpath) Set the path for the link database. S_SAVE_ALL_FILES (no arguments) Save all changed SLink - The SMART Editor files. S_SAVE_CURR_FILE (no arguments) Save the current SLink - The SMART Editor file. S_SAVE_POS (no arguments) Save the current cursor position. S_SAVE_SL_FILE (buffer_number) Save the specified SLink - The SMART Editor file. S_SAVEAS_CURR_FILE (new_filename) Save the current file with the specified file name. S_SELECT_BRACED_CODE (no arguments) Select the code within braces. S_SELECT_LINE (no arguments) Select the current line. S_SELECT_PAGEDOWN (no arguments) Select the next page. S_SELECT_PAGEUP (no arguments) Select the previous page. S_SELECT_WORD (no arguments) Select the current word. S_SPLIT_SCREEN (split_mode) Split the screen. S_SWAP_FOCUS (no arguments) Swap the focus to the other window in a split screen. S_SWAP_WINDOWS (no arguments) Swap the files in a split screen. S_SYNC_SCROLL (no arguments) Synch scroll the files in a split screen. S_WRITE_FILE (file_handle, length, data_to_write, ResultVariable) Write to the specified non-SLink - The SMART Editor file. S_UNDO (no arguments) Undo the last edit function. ═══ 19.2. Cursor Movement ═══ The Cursor Movement macros permit the control of the cursor within the opened SLink - The SMART Editor files. S_BEG_OF_FILE S_BEG_OF_LINE S_BEG_OF_SCREEN S_END_OF_FILE S_END_OF_LINE S_END_OF_SCREEN S_GOTO_BEG_BRACE S_GOTO_COL S_GOTO_END_BRACE S_GOTO_LINE S_GOTO_MARK S_GOTO_POS S_INDENT S_MARK_CURR_POS S_NEXT_CHAR S_NEXT_LINE S_NEXT_PAGE S_NEXT_WORD S_PREV_CHAR S_PREV_LINE S_PREV_PAGE S_PREV_WORD S_SAVE_POS ═══ 19.2.1. S_BEG_OF_FILE ═══ S_BEG_OF_FILE Move the cursor to the beginning of the current file. This is the same as CONTROL-HOME. ═══ 19.2.2. S_BEG_OF_LINE ═══ S_BEG_OF_LINE Move the cursor to the beginning of the current line within the current file. This is the same as HOME. ═══ 19.2.3. S_BEG_OF_SCREEN ═══ S_BEG_OF_SCREEN Move the cursor to the beginning of the current page within the current file. This is the same as SHIFT-HOME. ═══ 19.2.4. S_END_OF_FILE ═══ S_END_OF_FILE Move the cursor to the end of the current file. This is the same as CONTROL-END. ═══ 19.2.5. S_END_OF_LINE ═══ S_END_OF_LINE Move the cursor to the end of the current line within the current file. This is the same as END. ═══ 19.2.6. S_END_OF_SCREEN ═══ S_END_OF_SCREEN Move the cursor to the end of the current page within the current file. This is the same as SHIFT-END. ═══ 19.2.7. S_GOTO_BEG_BRACE ═══ S_GOTO_BEG_BRACE Move the cursor to the preceding beginning brace ( { ) and highlight it. Reference  Edit Menu, Braces, Find Beginning Brace ═══ 19.2.8. S_GOTO_COL ═══ S_GOTO_COL Move the cursor to the specified column number within the current file. If the desired column is contained within a TAB, the cursor will be positioned at the next tab location; this macro does not replace tabs with spaces. Arguments  column number Example S_GOTO_COL 40 ═══ 19.2.9. S_GOTO_END_BRACE ═══ S_GOTO_END_BRACE Move the cursor to the following ending brace ( } ) and highlight it. Reference  Edit Menu, Braces, Find Ending Brace ═══ 19.2.10. S_GOTO_LINE ═══ S_GOTO_LINE Move the cursor to the specified line number within the current file. Arguments  line number Example S_GOTO_LINE 123 Reference  Edit Menu, GoTo Line ═══ 19.2.11. S_GOTO_MARK ═══ S_GOTO_MARK Move the cursor to the position saved by the specified marker number. The marker must have been previously set by the S_MARK_CURR_POS macro. Arguments  marker number - this can be 0 through 9 Example S_GOTO_MARK 2 Reference  More Menu, Place Markers, GoTo Marker ═══ 19.2.12. S_GOTO_POS ═══  S_GOTO_POS Move the cursor to the last saved position. The saved position is defined by the S_SAVE_POS macro. The saved position is set by SLink - The SMART Editor automatically when the following commands are executed: Find Beginning Brace, Find Ending Brace, Goto Marker, Goto Line, and Link-To. Reference  More Menu, Cursor, GoTo Cursor Position ═══ 19.2.13. S_INDENT ═══ S_INDENT Move the cursor to the position on the current line so that it is lined up with the left justified position of the previous line. This command is used when you create a new line and want to position at the indention of the previous line. Reference  Options, Setup Options, Auto Indent ═══ 19.2.14. S_MARK_CURR_POS ═══ S_MARK_CURR_POS Set the specified marker number to the current cursor position within the current file. If the marker is already set, it will be reset. Arguments  marker number - this can be 0 through 9 Example S_MARK_CURR_POS 2 Reference  More Menu, Place Markers, Set Marker ═══ 19.2.15. S_NEXT_CHAR ═══ S_NEXT_CHAR Move the cursor to the next character in the current file. This is the same as Right Arrow. ═══ 19.2.16. S_NEXT_LINE ═══ S_NEXT_LINE Move the cursor to the next line in the current file. This is the same as Down Arrow. ═══ 19.2.17. S_NEXT_PAGE ═══ S_NEXT_PAGE Move the cursor to the next page in the current file. This is the same as PageDown. ═══ 19.2.18. S_NEXT_WORD ═══ S_NEXT_WORD Move the cursor to the next word in the current file. This is the same as CONTROL-Right Arrow. ═══ 19.2.19. S_PREV_CHAR ═══ S_PREV_CHAR Move the cursor to the previous character in the current file. This is the same as Left Arrow. ═══ 19.2.20. S_PREV_LINE ═══ S_PREV_LINE Move the cursor to the previous line in the current file. This is the same as Up Arrow. ═══ 19.2.21. S_PREV_PAGE ═══ S_PREV_PAGE Move the cursor to the previous page in the current file. This is the same as PageUp. ═══ 19.2.22. S_PREV_WORD ═══ S_PREV_WORD Move the cursor to the previous word in the current file. This is the same as CONTROL-Left Arrow. ═══ 19.2.23. S_SAVE_POS ═══ S_SAVE_POS Save the position of the cursor within the current file. This should be used for saving the position of the cursor on a temporary basis. SLink - The SMART Editor automatically saves the cursor (and overwrites your saved position) when the following commands are executed: Find Beginning Brace, Find Ending Brace, Goto Marker, Goto Line, and Link-To. Use S_MARK_CURR_POS to save the cursor position for a longer period. Reference  More Menu - Cursor - Save Cursor Position ═══ 19.3. SLink - The SMART Editor Files ═══ The SLink - The SMART Editor File macros control the manipulation of SLink - The SMART Editor files. S_CHG_EDITMODE S_CHG_WORDWRAP S_CLOSE_ALL_FILES S_CLOSE_CURR_FILE S_CLOSE_SL_FILE S_DISPLAY_REF_FILE S_GOTO_BUFF S_INSERT_FILE S_OPEN_SL_FILE S_PREV_BUFFER S_PRINT_CURR_FILE S_SAVE_ALL_FILES S_SAVE_CURR_FILE S_SAVE_SL_FILE S_SAVEAS_CURR_FILE ═══ 19.3.1. S_CHG_EDITMODE ═══ S_CHG_EDITMODE This macro changes the file mode of the current file. The file edit modes are Read-only and Edit. The file mode will not be changed for hex files. The file mode will not be changed if the file has been updated. Reference  Edit Menu, Change File Edit Mode ═══ 19.3.2. S_CHG_WORDWRAP ═══ S_CHG_WORDWRAP This macro changes the wordwrap mode of the current file. Reference  Edit Menu, Word Wrap On/Off ═══ 19.3.3. S_CLOSE_ALL_FILES ═══ S_CLOSE_ALL_FILES This macro closes all SLink - The SMART Editor files. If the file has changed, it will be saved first. If the file is in hex mode, it will not be saved. Example S_CLOSE_ALL_FILES Reference  File Menu, Close All Files with Save ═══ 19.3.4. S_CLOSE_CURR_FILE ═══ S_CLOSE_CURR_FILE This macro closes the current file. If the file has been changed, it will be saved first. Reference  File Menu, Close Current File ═══ 19.3.5. S_CLOSE_SL_FILE ═══ S_CLOSE_SL_FILE This macro closes the file specified by buffnum, the buffer number containing the file to be closed. If the file has been changed, it will be saved first. Arguments  buffer number ( 0 - 12 ) Example S_CLOSE_SL_FILE buffnum_of_myfile ═══ 19.3.6. S_DISPLAY_REF_FILE ═══ S_DISPLAY_REF_FILE This macro displays the specified reference file. Reference File 1 = Find Files List, 2 = String Search List, etc. Refer to the Ref pull down menu. Arguments  reference file ( 0 - 7, A - H ) Example S_DISPLAY_REF_FILE reffile Reference  Ref Menu ═══ 19.3.7. S_GOTO_BUFF ═══ S_GOTO_BUFF This macro makes the indicated buffer the current SLink - The SMART Editor file. Arguments  buffer number ( 0 - 12 ) Example S_GOTO_BUFF buffnum_of_lastfile ═══ 19.3.8. S_INSERT_FILE ═══ S_INSERT_FILE This macro opens the specified file and reads it into the current file at the current cursor position. A binary file cannot be inserted. A file cannot be inserted into the current file if it is Read-only. The filesize of the inserted file is limited to 64000. Arguments  filename - the name of the file to be inserted Example S_INSERT_FILE insert_filename Reference  Edit Menu, Paste File at Cursor ═══ 19.3.9. S_OPEN_SL_FILE ═══ S_OPEN_SL_FILE This macro opens the specified file, reads it into the SLink - The SMART Editor buffer, and makes it available to SLink - The SMART Editor for editing. If the file exists, it is opened in the default file mode (edit or read-only); otherwise it is opened in edit mode. If the file is binary, it will be opened in hex mode. The SLink - The SMART Editor current drive and directory are updated. Arguments  open mode 0 = error if the file doesn't exist 1 = create the file if it doesn't exist  edit mode R = read-only E = edit D = default edit mode  word wrap mode Y = wrap N = no wrap  filename - the name of the file to be opened Example 'S_OPEN_SL_FILE 1 E N' my_filename Reference  File Menu, Open/New ═══ 19.3.10. S_PREV_BUFFER ═══ S_PREV_BUFFER This macro displays and makes current the file that was previously displayed in the current window. Reference  More Menu, File Buffers, Last File ═══ 19.3.11. S_PRINT_CURR_FILE ═══ S_PRINT_CURR_FILE This macro prints the current file. Hex files are not printed. Reference  More Menu, Printing, Print Current File ═══ 19.3.12. S_SAVE_ALL_FILES ═══ S_SAVE_ALL_FILES This macro saves all files. Any file in hex mode will not be saved. Example S_SAVE_ALL_FILES Reference  File Menu, Save ═══ 19.3.13. S_SAVE_CURR_FILE ═══ S_SAVE_CURR_FILE This macro saves the current file. If the file is in hex mode, it will not be saved. Example S_SAVE_CURR_FILE Reference  File Menu, Save ═══ 19.3.14. S_SAVE_SL_FILE ═══ S_SAVE_SL_FILE This macro saves the file specified by buffnum, the buffer number containing the file to be saved. If the file is in hex mode, it will not be saved. Arguments  buffer number ( 0 - 12 ) Example S_SAVE_SL_FILE buffnum_of_myfile ═══ 19.3.15. S_SAVEAS_CURR_FILE ═══ S_SAVEAS_CURR_FILE This macro saves the current file with a new filename. If the file is in hex mode, it will not be saved. Arguments  new_filename Example S_SAVEAS_CURR_FILE new_filename Reference  File Menu, Save As ═══ 19.4. External Files ═══ The External File macros control the manipulation of external files. S_CAN_I_WRITE S_CD S_CLOSE_FILE S_DOES_FILE_EXIST S_IS_FILE_BINARY S_OPEN_FILE S_READ_FILE S_WRITE_FILE ═══ 19.4.1. S_CAN_I_WRITE ═══ S_CAN_I_WRITE This macro checks if the specified file can be written to and returns the result - either TRUE or FALSE. Arguments  filename - the name of the file to check  UserVarName - the name of the variable to contain the the results (TRUE or FALSE). Example S_CAN_I_WRITE MyFilename WRITE_OK ═══ 19.4.2. S_CD ═══ S_CD This macro changes the directory to the specified path. Arguments  path - the new directory Example S_CD 'C:\OS2\SYSTEM' S_CD '..' ═══ 19.4.3. S_CLOSE_FILE ═══ S_CLOSE_FILE This macro closes the specified file. Arguments  file handle - this is returned to the user by the S_OPEN_FILE macro Example S_CLOSE_FILE MyFileHandle ═══ 19.4.4. S_DOES_FILE_EXIST ═══ S_DOES_FILE_EXIST This macro checks if the specified file exists and returns the result - either TRUE or FALSE. Arguments  filename - the name of the file to check  UserVarName - the name of the variable to contain the the results (TRUE or FALSE). Example S_DOES_FILE_EXIST MyFilename EXISTS ═══ 19.4.5. S_IS_FILE_BINARY ═══ S_IS_FILE_BINARY This macro checks if the specified file is binary and returns the result - either TRUE or FALSE. Arguments  filename - the name of the file to check  UserVarName - the name of the variable to contain the the results (TRUE or FALSE). Example S_IS_FILE_BINARY MyFilename ISBINARY ═══ 19.4.6. S_OPEN_FILE ═══ S_OPEN_FILE This macro opens the specified file and returns the file handle. Arguments  file exists mode O = Open the file if it exists R = Replace the file if it exists  new file mode C = Create the file if it does not exist F = Error if the file does not exist  filename - the name of the file to be opened  UserVarName - the name of the variable to contain the returned file handle. //** Example 'S_OPEN_FILE R C' my_filename MY_FILEHANDLE ═══ 19.4.7. S_READ_FILE ═══ S_READ_FILE This macro read the specified file and returns the data read. Arguments  file handle - this is returned to the user by the S_OPEN_FILE macro  number of bytes - the number of bytes to read (max 255)  UserVarName - the name of the variable to contain the file data. Example S_READ_FILE MyFileHandle LenToRead BUFFER ═══ 19.4.8. S_WRITE_FILE ═══ S_WRITE_FILE This macro writes the specified data to the specified file and returns the actual count of data written. Arguments  file handle - this is returned to the user by the S_OPEN_FILE macro  number of bytes - the number of bytes to write (max 255)  data to write  UserVarName - the name of the variable to contain the number of bytes written. Example S_WRITE_FILE MyFileHandle 14 'This is a File' COUNT S_WRITE_FILE MyFileHandle LENGTH(DATA) DATA BYTES_WRITTEN ═══ 19.5. Edit ═══ The Edit macros allow the editing of a SLink - The SMART Editor file. S_CHG_CASE S_DEL_CHAR S_DEL_LINE S_DEL_SELECTED S_DEL_TO_EOL S_DEL_WORD S_INSERT_LINE S_INSERT_STRING S_PRINT_SELECTED S_REDO S_SELECT_BRACED_CODE S_SELECT_LINE S_SELECT_PAGEDOWN S_SELECT_PAGEUP S_SELECT_WORD S_UNDO ═══ 19.5.1. S_CHG_CASE ═══ S_CHG_CASE This macro changes the case of the selected text. Arguments  mode 1 = all upper case 2 = all lower case 3 = first character of each word upper case, rest lower 4 = reverse case Example S_CHG_CASE 2 Reference  Edit Menu, Cases ═══ 19.5.2. S_DEL_CHAR ═══ S_DEL_CHAR This macro deletes the character at the current cursor position in the current file. ═══ 19.5.3. S_DEL_LINE ═══ S_DEL_LINE This macro deletes the line containing the cursor in the current file. ═══ 19.5.4. S_DEL_SELECTED ═══ S_DEL_SELECTED This macro deletes the selected text in the current file. ═══ 19.5.5. S_DEL_TO_EOL ═══ S_DEL_TO_EOL This macro deletes the text from the current cursor position to the end of the line in the current file. ═══ 19.5.6. S_DEL_WORD ═══ S_DEL_WORD This macro deletes the word containing the cursor in the current file. ═══ 19.5.7. S_INSERT_LINE ═══ S_INSERT_LINE This macro inserts the designated string into the current file at the current cursor position and appends a carriage return. The maximum string length is 80 characters. The current file must be in edit mode. Arguments  string to insert Example S_INSERT_LINE 'This is a new line of text' ═══ 19.5.8. S_INSERT_STRING ═══ S_INSERT_STRING This macro inserts the designated string into the current file at the current cursor position. The maximum string length is 80 characters. The current file must be in edit mode. Arguments  string to insert Example S_INSERT_STRING TEXT_TO_INSERT ═══ 19.5.9. S_PRINT_SELECTED ═══ S_PRINT_SELECTED This macro prints the selected text in the current file. Hex files are not printed. Reference  More Menu, Printing, Print Current File/Select ═══ 19.5.10. S_REDO ═══ S_REDO This macro restores the current file to the state prior to the last 'Undo' function. Reference  Edit Menu, Undo/Redo, Redo ═══ 19.5.11. S_SELECT_BRACED_CODE ═══ S_SELECT_BRACED_CODE This macro selects the text contained by the next higher level of braces ( {...} ) in the current file. ═══ 19.5.12. S_SELECT_LINE ═══ S_SELECT_LINE This macro selects the line containing the cursor in the current file. ═══ 19.5.13. S_SELECT_PAGEDOWN ═══ S_SELECT_PAGEDOWN This macro adds the next page to the current selection or the current line if there is no selection in the current file. ═══ 19.5.14. S_SELECT_PAGEUP ═══ S_SELECT_PAGEUP This macro adds the previous page to the current selection or the current line if there is no selection in the current file. ═══ 19.5.15. S_SELECT_WORD ═══ S_SELECT_WORD This macro selects the word containing the cursor in the current file. A word is a string delimited by a space, or a newline. ═══ 19.5.16. S_UNDO ═══ S_UNDO This macro restores the current file to the state prior to the last edit function. Reference  Edit Menu, Undo/Redo, Undo ═══ 19.6. Paste ═══ The Paste macros allow the movement of data from a SLink - The SMART Editor file to the paste buffer and back. S_COPY_SEL_TO_PASTE S_CUT_SEL_TO_PASTE S_INSERT_PASTE ═══ 19.6.1. S_COPY_SEL_TO_PASTE ═══ S_COPY_SEL_TO_PASTE This macro copies the current selection to the paste buffer. If there is no selection, the current line will be copied to the paste buffer. ═══ 19.6.2. S_CUT_SEL_TO_PASTE ═══ S_CUT_SEL_TO_PASTE This macro copies the current selection to the paste buffer. If there is no selection, the current line will be copied to the paste buffer. The copied text is then deleted from the SLink - The SMART Editor file. The current file must be in edit mode. ═══ 19.6.3. S_INSERT_PASTE ═══ S_INSERT_PASTE This macro copies the paste buffer to the current cursor position within the current file. The current file must be in edit mode. ═══ 19.7. Clip ═══ The Clip macros manipulate data into and out of the current SLink - The SMART Editor clip file. S_CHG_CLIP_MODE S_COPY_CLIP_TO_PASTE S_COPY_PASTE_TO_CLIP S_COPY_SEL_TO_CLIP S_DISPLAY_CLIP S_INSERT_CLIP S_RENAME_CLIP_FILE ═══ 19.7.1. S_CHG_CLIP_MODE ═══ S_CHG_CLIP_MODE This macro changes the file mode of the current SLink - The SMART Editor clip file. The file modes are replace or append. Reference  Clip Menu, Clip File Mode - Append ═══ 19.7.2. S_COPY_CLIP_TO_PASTE ═══ S_COPY_CLIP_TO_PASTE This macro copies the current SLink - The SMART Editor clip file to the paste buffer. The clip file must be less than 64k. Reference  Clip Menu, Clip File to Paste ═══ 19.7.3. S_COPY_PASTE_TO_CLIP ═══ S_COPY_PASTE_TO_CLIP This macro copies the paste buffer to the current SLink - The SMART Editor clip file. Reference  Clip Menu, Paste to Clip File ═══ 19.7.4. S_COPY_SEL_TO_CLIP ═══ S_COPY_SEL_TO_CLIP This macro copies the selected text in the current SLink - The SMART Editor file to the current SLink - The SMART Editor clip file. Reference  Clip Menu, Select to Clip File ═══ 19.7.5. S_DISPLAY_CLIP ═══ S_DISPLAY_CLIP This macro displays the current SLink - The SMART Editor clip file. The clip file becomes the current SLink - The SMART Editor file. Reference  Clip Menu, Display Clip File ═══ 19.7.6. S_INSERT_CLIP ═══ S_INSERT_CLIP This macro copies the current SLink - The SMART Editor clip file to the current position in the current SLink - The SMART Editor file. The clip file must be less than 64k. The current SLink - The SMART Editor file must be in edit mode. Reference  Clip Menu, Paste Clip File at Cursor ═══ 19.7.7. S_RENAME_CLIP_FILE ═══ S_RENAME_CLIP_FILE This macro renames the current SLink - The SMART Editor clip file. Arguments  clippathfilename, the path and filename of the clipfile Example S_RENAME_CLIP_FILE 'F:\CLIPFILE.TXT' Reference  Clip Menu, Rename Clip File ═══ 19.8. Get ═══ The Get macros retrieve information and data. S_GET_BUFF_COL_NUM S_GET_BUFF_EDITMODE S_GET_BUFF_FILENAME S_GET_BUFF_LINE_NUM S_GET_BUFF_WORDWRAP S_GET_CLIP_FILENAME S_GET_COL_NUM S_GET_CURR_CHAR S_GET_CURR_CHGSTATUS S_GET_CURR_EDITMODE S_GET_CURR_FILENAME S_GET_CURR_SL_DIR S_GET_CURR_WORD S_GET_CURR_WORDWRAP S_GET_CURSOR_POS S_GET_DISK_SPACE S_GET_ENV_INFO S_GET_FILE_BUFFNUM S_GET_FILE_INFO S_GET_LINE_LEN S_GET_LINE_NUM S_GET_NUM_SL_FILES S_GET_REF_FILENAME S_GET_SELECTED_SIZE S_GET_SELECTED_TEXT S_GET_SL_INI_PATH ═══ 19.8.1. S_GET_BUFF_COL_NUM ═══ S_GET_BUFF_COL_NUM This macro retrieves the current column number of the current line in the SLink - The SMART Editor file contained in the specified buffer. Arguments  buffer number ( 0 - 12 )  UserVarName - the name of the variable to contain the returned column number. Example S_GET_BUFF_COL_NUM 2 COLNUM ═══ 19.8.2. S_GET_BUFF_EDITMODE ═══ S_GET_BUFF_EDITMODE This macro retrieves the edit mode of the SLink - The SMART Editor file contained in the specified buffer. This returns READONLY or EDIT. Arguments  buffer number ( 0 - 12 )  UserVarName - the name of the variable to contain the returned edit mode. Example S_GET_BUFF_EDITMODE 2 EDITMODE ═══ 19.8.3. S_GET_BUFF_FILENAME ═══ S_GET_BUFF_FILENAME This macro retrieves the filename of the SLink - The SMART Editor file contained in the specified buffer. Arguments  buffer number ( 0 - 12 )  UserVarName - the name of the variable to contain the returned filename. Example S_GET_BUFF_FILENAME 2 FILENAME2 ═══ 19.8.4. S_GET_BUFF_LINE_NUM ═══ S_GET_BUFF_LINE_NUM This macro retrieves the current line number of the SLink - The SMART Editor file contained in the specified buffer. Arguments  buffer number ( 0 - 12 )  UserVarName - the name of the variable to contain the returned line number. Example S_GET_BUFF_LINE_NUM 2 LINENUM ═══ 19.8.5. S_GET_BUFF_WORDWRAP ═══ S_GET_BUFF_WORDWRAP This macro retrieves the wordwrap mode of the SLink - The SMART Editor file contained in the specified buffer. This returns WRAP or NOWRAP. Arguments  buffer number ( 0 - 12 )  UserVarName - the name of the variable to contain the returned wordwrap mode. Example S_GET_BUFF_WORDWRAP 2 WRAPMODE ═══ 19.8.6. S_GET_CLIP_FILENAME ═══ S_GET_CLIP_FILENAME This macro retrieves the filename of the current SLink - The SMART Editor clip file. Arguments  UserVarName - the name of the variable to contain the returned clip filename. Example S_GET_CLIP_FILENAME CLIPFILENAME ═══ 19.8.7. S_GET_COL_NUM ═══ S_GET_COL_NUM This macro retrieves the column number of the cursor on the current line within the current SLink - The SMART Editor file. Arguments  UserVarName - the name of the variable to contain the returned column number. Example S_GET_COL_NUM COLNUM ═══ 19.8.8. S_GET_CURR_CHAR ═══ S_GET_CURR_CHAR This macro retrieves the character at the cursor in the current SLink - The SMART Editor file. Arguments  UserVarName - the name of the variable to contain the returned character. Example S_GET_CURR_CHAR CURRCHAR ═══ 19.8.9. S_GET_CURR_CHGSTATUS ═══ S_GET_CURR_CHGSTATUS This macro retrieves the change status of the current SLink - The SMART Editor file. TRUE or FALSE will be returned. Arguments  UserVarName - the name of the variable to contain the returned change status. Example S_GET_CURR_CHGSTATUS CHANGED ═══ 19.8.10. S_GET_CURR_EDITMODE ═══ S_GET_CURR_EDITMODE This macro retrieves the edit mode of the current SLink - The SMART Editor file. READONLY or EDIT will be returned. Arguments  UserVarName - the name of the variable to contain the returned edit mode. Example S_GET_CURR_EDITMODE FILEMODE ═══ 19.8.11. S_GET_CURR_SL_DIR ═══ S_GET_CURR_SL_DIR This macro retrieves the name of the current SLink - The SMART Editor directory. Arguments  UserVarName - the name of the variable to contain the returned directory name. Example S_GET_CURR_SL_DIR CURRDIR ═══ 19.8.12. S_GET_CURR_FILENAME ═══ S_GET_CURR_FILENAME This macro retrieves the filename of the current SLink - The SMART Editor file. Arguments  UserVarName - the name of the variable to contain the returned filename. Example S_GET_CURR_FILENAME CURRFILE ═══ 19.8.13. S_GET_CURR_WORD ═══ S_GET_CURR_WORD This macro retrieves the current word in the current SLink - The SMART Editor file. A word is a string delimited by a space, or a newline. Arguments  UserVarName - the name of the variable to contain the returned text. Example S_GET_CURR_WORD WORD ═══ 19.8.14. S_GET_CURR_WORDWRAP ═══ S_GET_CURR_WORDWRAP This macro retrieves the wordwrap mode of the current SLink - The SMART Editor file. WRAP or NOWRAP will be returned. Arguments  UserVarName - the name of the variable to contain the returned wordwrap mode. Example S_GET_CURR_WORDWRAP WRAPMODE ═══ 19.8.15. S_GET_CURSOR_POS ═══ S_GET_CURSOR_POS This macro retrieves the offset of the cursor in the current SLink - The SMART Editor file. This is relative to the beginning of the file. Arguments  UserVarName - the name of the variable to contain the returned offset. Example S_GET_CURSOR_POS CURSORPOS ═══ 19.8.16. S_GET_DISK_SPACE ═══ S_GET_DISK_SPACE This macro retrieves the available disk space on the specified disk. Arguments  drive - the letter of the specified drive  UserVarName - the name of the variable to contain the returned space. Example S_GET_DISK_SPACE C SPACE_ON_C ═══ 19.8.17. S_GET_ENV_INFO ═══ S_GET_ENV_INFO This macro retrieves the information for the specified environment variable. Arguments  EnvVar - the environment variable  UserVarName - the name of the variable to contain the returned information. Example S_GET_ENV_VAR PATH ENVPATHDATA ═══ 19.8.18. S_GET_FILE_BUFFNUM ═══ S_GET_FILE_BUFFNUM This macro retrieves the SLink - The SMART Editor buffer number containing the specified SLink - The SMART Editor file. Arguments  filename - the name of the SLink - The SMART Editor file  UserVarName - the name of the variable to contain the returned buffer number. Example S_GET_FILE_BUFFNUM FILENAME CURRBUFF ═══ 19.8.19. S_GET_FILE_INFO ═══ S_GET_FILE_INFO This macro retrieves the date, time and size of the specified file. The format of the returned data - Size: nnnnnnn Date: mm/dd/yy hh:mm:ss Arguments  filename - the name of the file  UserVarName - the name of the variable to contain the returned file information. Example S_GET_FILE_INFO MYFILE FILE_INFO ═══ 19.8.20. S_GET_LINE_LEN ═══ S_GET_LINE_LEN This macro retrieves the length of the current line in the current SLink - The SMART Editor file. Arguments  UserVarName - the name of the variable to contain the returned line length. Example S_GET_LINE_LEN LINELEN ═══ 19.8.21. S_GET_LINE_NUM ═══ S_GET_LINE_NUM This macro retrieves the current line number in the current SLink - The SMART Editor file. Arguments  UserVarName - the name of the variable to contain the returned line number. Example S_GET_LINE_NUM LINENUM ═══ 19.8.22. S_GET_NUM_SL_FILES ═══ S_GET_NUM_SL_FILES This macro retrieves the number of opened files. Arguments  UserVarName - the name of the variable to contain the returned number of files. Example S_GET_NUM_SL_FILES NUM_OF_FILES ═══ 19.8.23. S_GET_SELECTED_SIZE ═══ S_GET_SELECTED_SIZE This macro retrieves the length of the selected text in the current SLink - The SMART Editor file. Arguments  UserVarName - the name of the variable to contain the returned text length. Example S_GET_SELECTED_SIZE SELSIZE ═══ 19.8.24. S_GET_REF_FILENAME ═══ S_GET_REF_FILENAME This macro retrieves the filename of the specified reference file. Arguments  Reference File Number 1 = Find File 2 = Search File 3 = Multiple Definitions File 4 = Multiple References File 5 = Macro Output File  UserVarName - the name of the variable to contain the returned text. Example S_GET_REF_FILENAME 5 macro_output_filename ═══ 19.8.25. S_GET_SELECTED_TEXT ═══ S_GET_SELECTED_TEXT This macro retrieves the selected text within the current SLink - The SMART Editor file. Arguments  UserVarName - the name of the variable to contain the returned text. Example S_GET_SELECTED_TEXT SELTEXT ═══ 19.8.26. S_GET_SL_INI_PATH ═══ S_GET_SL_INI_PATH This macro retrieves the path containing the current SLink - The SMART Editor INI file. Arguments  UserVarName - the name of the variable to contain the returned path. Example S_GET_SL_INI_PATH INIPATH ═══ 19.9. Search and Replace ═══ The Search and Replace macros search the current SLink - The SMART Editor file for the specified string and optionally replace that data. S_REPLACE S_SEARCH_BACK S_SEARCH_FWD S_SEARCH_NEXT ═══ 19.9.1. S_REPLACE ═══ S_REPLACE This Macro searches the current SLink - The SMART Editor file for the specified search string and replaces it with the specified replace string. The maximum search string length is 80 characters. The maximum replace string length is 255 characters. There is no verification permitted - all strings found will be replaced. The count of replacements made will be returned. Arguments  search string - the string to search for terminated with a comma  replace string - the replace string terminated with a comma  UserVarName - the name of the variable to contain the returned number of replacements. Example S_REPLACE looking_for, replaced_by, NUM_REPLACED Reference  Edit Menu, Replace String ═══ 19.9.2. S_SEARCH_BACK ═══ S_SEARCH_BACK This Macro searches backwards in the current SLink - The SMART Editor file for the specified string and highlights the found text. The maximum string length is 79 characters. Arguments  Case 0 = not case sensitive 1 = case sensitive  string - the string to search for Example S_SEARCH_BACK 1 looking_for Reference  Edit Menu, Current Searches, Search Backward ═══ 19.9.3. S_SEARCH_FWD ═══ S_SEARCH_FWD This Macro searches the current SLink - The SMART Editor file for the specified string and highlights the found text. The maximum string length is 79 characters. Arguments  Case 0 = not case sensitive 1 = case sensitive  Top 0 = search from the current position 1 = search from the top of the file  string - the string to search for Example S_SEARCH_FWD 1 0 looking_for Reference  Edit Menu, Current Searches, Search Current File ═══ 19.9.4. S_SEARCH_NEXT ═══ S_SEARCH_NEXT This Macro searches again the current SLink - The SMART Editor file for the predefined string and highlights the found text. The string must have been defined by the S_SEARCH_FWD or S_SEARCH_BACK macro. Reference  Edit Menu, Current Searches, Continue Search ═══ 19.10. Windows ═══ The Windows macros allow the manipulation of files in a split screen. S_SPLIT_SCREEN S_SWAP_FOCUS S_SWAP_WINDOWS S_SYNC_SCROLL ═══ 19.10.1. S_SPLIT_SCREEN ═══ S_SPLIT_SCREEN This Macro defines a full window or split screen for displaying SLink - The SMART Editor files. Arguments  mode 0 = full screen 1 = horizontal split - 2 equal halves 2 = horizontal split - smaller on top 3 = horizontal split - smaller on bottom 4 = vertical split - 2 equal halves 5 = vertical split - smaller on left 6 = vertical split - smaller on right Example S_SPLIT_SCREEN 2 Reference  More Menu, Window Configuration ═══ 19.10.2. S_SWAP_FOCUS ═══ S_SWAP_FOCUS This Macro swaps the focus on a split screen. The focus is moved from the active window tot he inactive window, thereby activating the inactive window and making it the current SLink - The SMART Editor file. Reference  More Menu, Window Control, Swap Focus ═══ 19.10.3. S_SWAP_WINDOWS ═══ S_SWAP_WINDOWS This Macro swaps the files displayed on a split screen; each file is move to the other display window. Reference  More Menu, Window Control, Swap Windows ═══ 19.10.4. S_SYNC_SCROLL ═══ S_SYNC_SCROLL This Macro enables you to lock two SLink - The SMART Editor files together so they will scroll together. The display must be in a split screen mode. Reference  More Menu, Window Control, Sync Scroll ═══ 19.11. Misc ═══ The Misc macros define the remaining built in SLink - The SMART Editor macros. S_CLEAR_MACRO_OUTPUT S_IS_DRIVE_PROTECTED S_LISTBOX S_MSG S_PROMPT S_SET_DB_PATH ═══ 19.11.1. S_CLEAR_MACRO_OUTPUT ═══ S_CLEAR_MACRO_OUTPUT This macro clears the macro output file. The Macro Output is stored in the file SL_@##.Out in the TEMP directory; @ defines the day of the week, ## identifies the current instance of SLink - The SMART Editor. Example S_CLEAR_MACRO_OUTPUT ═══ 19.11.2. S_IS_DRIVE_PROTECTED ═══ S_IS_DRIVE_PROTECTED This macro checks if the specified drive is write protected and returns either TRUE or FALSE. Arguments  drive - the drive letter  UserVarName - the name of the variable to contain the returned TRUE or FALSE. Example S_IS_DRIVE_PROTECTED A IT_IS_PROTECTED ═══ 19.11.3. S_LISTBOX ═══ S_LISTBOX This macro displays a listbox and allows the user to update it. The listbox entries are contained in a file which is updated with the user's additions and deletions. The arguments must be separated by a comma. The listbox entries will be read from the listbox file and the listbox will be displayed. The user can press the ADD pushbutton to add entries to the listbox. The user can press the DELETE pushbutton to delete entries from the listbox. To select an entry, click on an entry in the listbox and press the OK pushbutton, or double-click on an entry in the listbox. This entry will be returned to the calling macro. The user can press the STORE pushbutton to update the listbox file with all added and deleted entries and then exit the listbox with no selected entries. The user can press the OK pushbutton, or double-click on an entry in the listbox, to update the listbox file with all added and deleted entries and then exit the listbox with the currently selected entry. The listbox will return 'CANCEL' to the macro if the CANCEL pushbutton is pressed. The listbox will return 'NOSEL' to the macro if the STORE pushbutton is pressed. If an error is encountered, the error number is returned to the macro. Arguments  ListFilename - the name of the file containing the listbox entries, each entry is contained on a separate line within the file.  ListboxTitle - the title of the listbox  UserVarName - the name of the variable to contain the returned selection or status. Example 'S_LISTBOX my_filename, title of the listbox, SELECTED_ITEM' ═══ 19.11.4. S_MSG ═══ S_MSG This macro displays a specified message, allows the user to respond OK or CANCEL, and returns the user's response. The message is limited to three lines, each a maximum of 59 characters, each terminated with a comma. Arguments  message line 1 - maximum length 59, terminated with a comma  message line 2 - maximum length 59, terminated with a comma  message line 3 - maximum length 59, terminated with a comma  UserVarName - the name of the variable to contain the returned response, OK or CANCEL. Example 'S_MSG First Line, , Third Line, USER_RESULT' ═══ 19.11.5. S_PROMPT ═══ S_PROMPT This macro displays a specified prompt message, allows the user to enter a response and press OK, or press CANCEL. The prompt message is limited to 60 characters and must be terminated with a comma. The return data is limited to 255 characters. If the user enters a response and presses OK, the response is returned. If the user presses CANCEL, then "CANCEL" is returned. Arguments  Prompt message - the prompt message to be displayed  UserVarName - the name of the variable to contain the returned data. Example S_PROMPT 'Enter the Filename,' NEWFILENAME ═══ 19.11.6. S_SET_DB_PATH ═══ S_SET_DB_PATH This macro sets the path for the link database. Arguments  path - the path for the link database. Example S_SET_DB_PATH my_db_path ═══ 20. SLink - The SMART Editor Keys ═══ The Following Accelerator keys can be used with SLink - The SMART Editor. Text Selection: Sft+Right arrow = Character. Sft+Left arrow = Character. Ctrl+Sft+L Arrow = Word. Ctrl+Sft+R Arrow = Word. Sft+PageDn = Page Down. Shift+PageUp = Page Up. Sft+Up Arrow = Line up. Sft+Down Arrow = Line down. Alt+L = Select Line. Sft+F8 = Select Code within Braces. Sft+F7 = Select Code within Parens. Movement: Right arrow = Next char. Left arrow = Previous char. Ctrl+R Arrow = Next word. Ctrl+L Arrow = Previous word. Home = Beginning of line. Ctrl+Home = Beginning of file. End = End of line. Ctrl+End = End of file. Alt+G = Go to line number. Alt+(0-9) = Set place marker. Alt+M = Go to place marker. Ctrl+S = Save cursor position. Ctrl+G = Go to cursor position. Text Insertion: Sft+Ins or F12 = Insert paste buffer. Ctrl+I = Insert clip file. Text Deletion: Ctrl+D = Delete line. Ctrl+K = Delete to EOL. Del = Delete selected text. Alt+D = File Delete. Paste Buffer: Keypad (+) = Select to buffer. Ctrl+Ins = Select to buffer. Keypad (+) = Line to buffer. Keypad (-) = Cut select to buffer. Keypad (-) = Cut line to buffer. Sft+Ins or F12 = Insert from buffer. Search and Replace: F5 = Search current file. Ctrl+F5 = Search backward. Sft+F5 = Continue search. Alt+S = Multi-File search. Alt+N = Find file. Ctrl+F8 = Find ending brace. Sft+F8 = Select Braced Code. Ctrl+F7 = Find ending paren. Sft+F7 = Select Parened Code. F6 = Replace string. Misc. Edit Functions: Alt+E = Edit Menu. Alt+U = Undo last edit command. Ctrl+U = Redo last undo. Ctrl+W = Wordwrap On/Off. F7 = Justify line at cursor. Alt+KPn = ASCII Char. (value n). where KPn = KeyPad (0-9). File Management: Alt+O = Open file. F4 = Save file. Sft+F4 = Save all files. Ctrl+C = Close current file. Ctrl+A = Close all files. Alt+X = Save all and exit. Ctrl+X = Exit SLink - The SMART Editor. F3 = Exit SLink - The SMART Editor. Ctrl+H = File Housekeeping. Ctrl+T = Snapshot. File Functions: Alt+F = Files Menu. Ctrl+E = Toggle (Edit/Read-only) Alt+B = Display previous file. Alt+(-) = Circulate through files. Alt+P = Print Current File. Alt+C = Copy files. Alt+D = Delete files. Alt+N = Find files. Alt+S = Search files for strings. Alt+R = Reference files menu. F2 = Open tracks file. LinkFunctions: Alt+K = Link Menu. Alt+K = Link Functions. Ctrl+L = Link to item. Ctrl+P = Display/Set Database path. F11 = Select String. Ctrl + F11 = Link to References. Sft + F11 = Link to Definitions. Ctrl+B = Hypertrack backwards. Ctrl+F = Hypertrack forwards. Clip File Functions: Alt+I = Clip File Menu. Sft+F9 = Select to Clip File. Ctrl+F9 = Paste to Clip File. Ctrl+I = Insert Clip File. Window Functions: Alt+F2 = Exchange focus. Sft+F2 = Exchange windows. Help: Alt+H = Help Menu. F1 = On-line Help. Ctrl+Q = Start QuickHelp window. Alt+Q = Show QuickHelp window. Alt+Esc = Hide QuickHelp window. Alt+V = Link to ViewHelp window. Ctrl+V = Enter ViewHelp Info. Misc. Functions: Ctrl+O = SLink - The SMART Editor Options. F2 = Open tracks file. Ctrl+M = Show interactive window. Ctrl+F12 = Templates. OS/2 Functions: Alt+Esc = Switch to last window. Ctrl+Esc = Display switch list. Alt+F9 = Minimize application. Alt+F10 = Maximize application. Alt+F4 = Exit application. Alt+W = OS/2 command window. Mouse Actions: Button1 Single Click - Sets cursor and selects current word ( places word in special buffer for search ]. Button1 Double Click - Link to word at cursor ( attempt to link to source definition of function or filename). Button1 Single Click - set cursor and select word. Button2 Double Click - Link to word at cursor ( attempt to link to all references of function.) Button3 Single Click - Display last file (3 button mice only). Mouse Action on File Names: If Filename is of the form - filename(n), Double Click will open file at the line specified by (n). ═══ 20.1. SLink - The SMART Editor Mouse Actions ═══ The Following Mouse Actions can be used with SLink - The SMART Editor. Button1 Single Click - Sets cursor and selects current word ( places word in special buffer for search ]. Button1 Double Click - Link to word at cursor ( attempt to link to source definition of function or filename ). Button2 Single Click - set cursor and select word. Button2 Double Click - Link to word at cursor ( attempt to link to all references of function.) Button3 Single Click - Display last file (3 button mice only). Mouse Action on File Names: If Filename is of the form - filename(n), Double Click will open file at the line specified by (n).