home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
OS/2 Shareware BBS: 10 Tools
/
10-Tools.zip
/
smart21b.zip
/
SLINK2.HLP
(
.txt
)
< prev
next >
Wrap
OS/2 Help File
|
1995-09-15
|
267KB
|
12,935 lines
ΓòÉΓòÉΓòÉ 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 <Tab> 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 <Shift>+<Tab>.
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).