RimStar Editor 4.0
|
RimStar first goal is to get you up and running fast. RimStar
realize that learning a new set of keystrokes is a real turn off. We have eliminated
this problem by supplying Brief, Epsilon, Multi-Edit, CUA, SlickEdit, EPM, PWB and
Borland's IDE keyboard mappings with the editor. These keyboard mappings are available
under the Keys pulldown menu.
Once you're up and running you will want to take advantage of editor's powerful
features.
You will find all the features you have come to expect from an editor plus many,
many more. Features you can really use like a 'C' macro language, a source browser,
unlimited undo and redo, and keystroke macros just to name a few.
RimStar Feature List
SyntaColor(Syntax highlighting)
Complete 'C' Macro language
Source browser for 'C'
Unlimited undo and redo
No limits on files, file size, or windows
No limits on line length
Timed auto save
Multi-threaded for no waiting (OS/2 only)
Configurable tool bar
Access PDK Toolkit help for function under cursor
Compile and jump to errors
Multi-buffer regular expression search and replace
Column, line and block selection, search and replace
Auto-indent
Smart indenting
Template editing
Multi-document interface
Keystroke record/playback
Block indent/outdent
Hex mode editing
Bookmarks
Complete on-line help
OS/2 .x32 bit PM Multi-document interface
Win32s 32 bit Multi-document interface
Use of Virtual Memory
Previous versions of the editor used an internal virtual memory
sub-system. Current versions of the editor utilize the virtual memory support of
the operating system. The size and number of files which can be edited depends on
the amount of free hard disk space you have for the operating system's swap file
to use.
Virtual memory is used to retain all undo/redo and text buffer contents, which can
cause quite large swap files.
RimStar Environment Variables
(Windows Only) The configuration file now supports an alternate
implementation of specifying the information provided by the RSE_FLAGS, RSE_PATH,
and RSE_INF environment variables within it instead of using environment variables.
If you use environment variables they will over-ride the setting in the configuration
file. We suggest you use the configuration file, since it is easier than setting
environment variables, the RSE_CPP and RSE_INCLUDE environment variables are used
by the Macro Compiler and Source Browser programs and you should set these, the
next version will remove the requirement for any environment variables being set..
When the setup program installs the editor it sets the following entries in your
RSE_CFG.INI file (basedir is the directory in which setup installed the editor):
[Environment]
Flags=-Is3 -Iw3 -A
Path=<basedir>MACROS
INF=<basedir>RSEMAN.HLP
Environment variables are used to insure that the editor knows where to look for
files, information, etc. that it needs. If you are running Windows NT, Windows 95
or Windows 3.1 you will need to set some of them. The OS/2 installation program
sets all of these in the CONFIG.SYS file for you. The Windows version of the setup
program does not automatically set these environment variables, you should set them
after installing the editor. For Windows 3.1x/95: set them in your AUTOEXEC.BAT
file. For Windows NT: set them via the Control Panel - System icon or in your AUTOEXEC.BAT.
The environment variables the editor uses are defined below: The next release of
the editor will move all these settings (except RSE_CFG) into the editor configuration
file.
RSE_CFG This will tell the editor where to find its global configuration file.This
environment variable is required.
i.e.set RSE_CFG=c:\rse\rse_cfg.ini
RSE_CPP Points to the 'C' pre-processor. For Windows NT or Windows 3.1 this was
installed in the directory, d:\rse\dos or d:\rse\nt.. For OS/2 the path
is d:\rse
i.e. NT/95: set RSE_CPP=c:\rse\nt\cpp.exe
WIN3.1x: set RSE_CPP=c:\rse\dos\cpp.exe
OS/2: set RSE_CPP=c:\rse\cpp.exe
RSE_FLAGS Specifies the indenting style and width of indentation for c files.
-IsN indenting style where N is:
0 = none
1 = regular indenting
2 = smart indenting
3 = template editing
4 = alternate template
5 = quick smart indenting
6 = quick template editing
7 = quick alternate template
See c_indent.rm and c_smart.rm files in the MACROS directory for more information.
If you need assistance configuring the smart indenting please give RimStar a call.
-IwN sets the indent width where N is the width of an indent level. This allows
the indent width and the width of tab stops to be two different values. Please note
that the indent width is a fixed number of spaces, while the tab stop settings (Options.Global
settting) are actual column numbers. This means that if you want the tabs every
3 columns you would set the tab stops to '4, 7' and the indent width to 3, ie. -Iw3.
These flags can also be set on the command line when invoking the editor. (See Starting
the Editor)
i.e. set RSE_FLAGS=-Is3 -Iw4 -A - mPVCS
RSE_INCLUDE Points to the macros subdirectory(s) to find the macro include files.
Multiple directories must be separated by a semicolon.
i.e. set RSE_INCLUDE=c:\rse\macros
RSE_INF Points to the help file searched when the Help for function under the cursor
function ( HelpQueryInfHelp) is invoked. For Windows versions only one file can
currently be specified, the OS/2 version permits multiple files separated by the
'+' character to be defined
i.e. set RSE_INF=c:\mscv\help\mscxx.hlp
RSE_PATH Points to the subdirectory(s) that contains the compiled (.obm) macro files.
Multiple directories can be specified, separated by ';' (a semicolon)
i.e. set RSE_PATH=c:\rse\macros
RSE_SBD Points to the browser database to load on editor startup. This can be a
relative filename, or a fully qualified file name.
i.e.set RSE_SBD=sbd.sbd
'C' Source Browser Setup
Once installation is complete you can run your 'C' source files through the Source
Browser.
The Source Browser provides reference and definition locations for functions global
variables, and typedefs. The Source Browser refers to these names (functions, variable,
typedef names) as symbols. If you create a browser database for your project you
can virtually eliminate the time wasted searching through modules for symbols. (For
informationon editor macro functions used to browse code, see Source Browser Operations.)
The next version of the editor due out in November 1995 will support C++ source
browsing.
To use the source browser you first need to run you source code modules through
the browser parser SB.EXE which creates files with the extension _sb. This can be
accomplished from the command prompt by typing: SB *.c. SB works like a 'C' compiler,
it needs to be able to load the header files that your source code includes, it
will use the INCLUDE environment variable to find header files. Any macro definitions
that you pass as compiler switches to compile your code should also be passed to
SB.
i.e. [C:\RSE]SB *.c
SB accepts the following switches:
-D used to define macros needed by your source code
-I used to specify include directories. You can only have one directory per -I
switch, but you can use multiple -I switches.
-Fo output filename
Note: If the browser compiler fails to parse your source code please call us. The
file CUSTOMIZ.H is automatically included to handle special non_ANSI keywords. If
the compiler appears to be giving you errors on a special keyword that is not in
CUSTOMIZ.H, try #defining it to nothing CUSTOMIZ.H and re-run your source file(s).
To place the _sb files into a browser database use SBD.EXE. This can be accomplished
from the command prompt by typing:
e.g. SBD sbd -a *._sb
SBD.EXE accepts the following switches:
-a add module
-d delete module
-z zap (recreate) database
-v view contents
You will probably want to add the appropriate dependencies to youe make file to
keep the browser database up-to-date. That way the Source Browser will keep current
with the changes you make in your code. See the MAKEFILE included in the MACROS
subdirectory for an example of how this can be done.
CONTACT AUTHOR:
Brian L. Smith
brians@rimstar.com
http://www.rimstar.com/
@Macarlo, Inc.
@Macarlo's Shareware & Web
OS/2
Java Lobby Member
Java Site Accredited
[TOP] [HOME] [INDEX]