RUL.DLL - Language Support for RUL files

2/27/2001 The file I tested used different comment characters. However,
          this is supposedly already supported by the InstallScript lexer.
	  Will pass for now.

06/26/2000  Loading instructions modified for CodeWright version 6.5.

This DLL was provided by a customer. No source code was provided. 
Please send any question or feedback to jonathan.jarvis@openmarket.com

Similar information is available at:
http://www2.folio.com/is/CodeWright/CodeWright.htm

If you don't own a copy of CodeWright, download a 30 day trial version
from from www.Starbase.com

Configuring
===========
a. Copy RUL.DLL to the CodeWright directory.
b. Select Customize from the menu bar, Libraries from the menu 
   and the Load CodeWright Dll dialog displays.  Press the Add
   button and browse for RUL.dll.  Open the dll and Press Ok 
   to dismiss the dialog.  
c. Open a rul file.
d. Select 'Language...' from the Customize menu.
e. Add a new file type of rul.  One may already exist.
f. On the Tabs/Indenting tab, check Smart Indenting, 
g. On the Templates tab, check Template Expansion.
h. On the coloring tab, select the DLL radio button.  This specifies
   that the RUL DLL will be used for language coloring instead of a
   lexer.

Features
========
1 - Keyword Highlighting
2 - Template Expansion
3 - Smart indenting
4 - Name Completion
5 - Using the InstallShield Help files

1 - Keyword Highlighting (Language Dependent ChromaCoding)
Keywords are highlighted in different colors. All function names are red. All system variables
are magenta. Flow control keywords are dark blue. Comments are green.
To change the color for system variables, functions, flow control, or comments, select the Color tab on the
Preferences dialog on the Document menu.
System variables use the Alternate 9 color. 
Functions use the Alternate 4 color.
Flow controls use the Keywords color.
Comments use the Comments color.


2 - Template Expansion
The template expansion feature provides you with a "fill in the blanks" form for all of the
InstallShield functions.  When this feature is enabled, typing a function name followed by a
space will cause all of the parameters to be filled in. For example, if you type AddFolderIcon
followed by a space, CodeWright will complete the function by adding:
(szProgramFolder, szItemName, szCommandLine, szWorkingDir, szIconPath, nIcon, szShortCutKey, nFlag);
If this feature becomes annoying, turn it off or don't type a space after a function name and
before the '('.

3 - Smart indenting
Smart indenting automatically indents when you press [Enter] after typing certain words.  For 
example, a line in a .rul file might begin with 'if' or 'for'.  When you press enter to terminate
the line the next line will automatically be indented.

4 - Name Completion
By typing part of a variable, function, or other symbol name into a document and then pressing
[Ctrl][Space] CodeWright then attempts to anticipate your typing by
completing the name for you
from words previously typed in the script file.

5 - Access the InstallScript Language Reference Help file from
CodeWright.
(This feature only work with the full trial version or the commercial version.)
From the help menu choose 'Configure index file...'. Add LANGREF.HLP to the Filename list found in
'C:\Program Files\InstallShield\InstallShield 5.1 Professional Edition\Program' directory. Press 
Save. Place you cursor on a function name and press F1. Select the InstallScript Language Reference
Help file. Select Ok.


Updates
=======

version 1.02 - 08-03-98

Added Preprocessor directives
#elif
#else
#error
#ifdef
#undef

version 1.01 - 07-14-98

Added Predefined constants:
LIST_NULL
COMPONENT_INFO_DATE_EX
ISLANG_ENGLISH_BELIZE  
ISLANG_ENGLISH_TRINIDAD
ISLANG_FARSI_STANDARD
ISLANG_SPANISH_PUERTORICO
ISLANG_SWEDISH
ISLANG_SWEDISH_FINLAND
ISLANG_SWEDISH_STANDARD
ISLANG_THAI_STANDARD

Added Flow control keywords:
#endif
#if
#ifndef
#include

Fixed comment bug with the following type of comment
/***** Comment *****/

System Variables changed to use the Alternate 9 color



