IMPROV FOR WINDOWS, RELEASE 2.1 - RELEASE NOTES

This document contains notes about Improv(R) Release 2.1.
The notes describe problems you might encounter and 
provide information not available in the Improv Handbook,
Improv in Action, and the Help systems. To print this 
document, choose File Print.

NEW FEATURES
WK4 Import/Export-- Improv can now import and export 
1-2-3(R) files in WK4 format. For more complete information
search in Help under "Importing."

Working Together Icons-- Improv now has a set of SmartIcons
that allow you to launch other Lotus applications from 
within Improv.  For more complete information search in 
Help under "Customizing SmartIcons" for "Using the Working 
Together SmartIcons Set." 

Notes Data Exchange-- Improv can now exchange data with 
Lotus Notes(R). Improv supports text, numbers, and date/time 
numbers in editable Notes fields. For more complete information
search in Help under "Data exchange."

INSTALL
1. If your system is running the DOS SHARE utility when 
you install Improv, then the Improv Install program will 
be unable to delete a temporary file named INSTMAIN.EXE, 
which is located in the subdirectory named LOTUSTMP, 
which is located in your Windows directory. After you 
complete the Install program, manually delete the file 
INSTMAIN.EXE and then remove the LOTUSTMP directory.

2. For Server installations, after setting up the \Lotshare
directory, create a subdirectory named \Improv.v20. This
directory will contain the license files. The full path
will be \Lotshare\Improv.v20.

IMPROV GUIDED TOUR
1. For optimal viewing of the Guided Tour, before you 
launch Improv for the first time, turn off any screen 
saver program and switch to the Windows 3.1 VGA display 
driver.

2. Improv attempts to load the Guided Tour the first time 
that you launch the program. If you delete the Guided Tour 
before launching Improv for the first time, be sure to 
change the following line in the IMPROV.INI file, which is 
located in your Windows directory: Change FirstTime=YES to 
FirstTime=NO. Changing this line prevents Improv from 
trying to launch the tour.

SAMPLE SCRIPTS
The following sample library scripts are provided in the 
Scripts directory.  To find out more about how these 
scripts work, open the .LSS files and read the descriptive 
comments in the scripts. The scripts marked with an asterisk
(*) are attached to SmartIcons.
*COLORCEL.LSS - Allows you to assign colors to cells, based 
on their values. There is an option to color "All Cells on 
Recalc." When the option is checked, each time the worksheet
recalculates, the script checks every cell value. To turn 
this option off,  run the script again, and uncheck the 
option.
*LOADTMPL.LSS - Allows you to view a dialog box that lets 
you choose from a list of worksheet templates to open. 
*ADDINS20.LSS - Registers the add-in @functions for use in
formulas.
SEARCH.LSS - Allows you to search for and/or replace cell 
values or text of formulas.
SCRPUTIL.LSS - Includes a set of utilities for writing 
Improv applications in LotusScript.

DEFAULT PATHS
When specifying default paths in the Default Paths dialog 
box (Tools\User Setup\Paths), do not enter a trailing 
backslash at the end of a subdirectory path.  For example, 
enter C:\IMPROV\MYFILES, not C:\IMPROV\MYFILES\. All root 
directories must end with a backslash.  For example, enter 
D:\.

PRINTING
1. Multi-line text in a model may appear truncated when 
you print to an HP LaserJet III.  To correct this, check 
Send TrueType as Graphics in the Options panel of the 
Print Setup dialog box and then print the model.

2. Settings on the Print Setup dialog box--for example, 
paper size--are not saved with the Improv model. If you 
open an existing model and notice, for example, that the 
layout of a presentation has changed, check the paper size 
specified in the Print Setup dialog box.

3. If you set worksheet grid line styles to double lines, 
the space between the lines may not appear in a print 
preview. However, the lines will print correctly.

LOTUS CHART(TM)
1. If you get the message "Cannot create a chart" when 
you open a file containing charts, do not save the file 
or you will lose the charts previously contained in the 
file. Instead, when you get the message, click the Explain 
button to get more information about resolving the problem. 
Then close the file without saving it.

2. The only information that is linked between the 
worksheet and a chart is the data that you plot. The 
legend names and X-axis names are not linked. Therefore, 
if you edit an item name, the chart does not update to 
reflect the new name.

3. To cut and paste data and keep a chart of that data 
updated, cut and paste the cells only. If you cut and paste 
items, the chart does not update. 

4. The High-Low-Close-Open (HLCO) chart layouts that have 
bars at the bottom and lines at the top will not display 
correctly unless the chart has five or six data series.

5. The High-Low-Close-Open (HLCO) chart layouts that have 
no bars at the bottom or lines at the top will not display 
correctly unless the chart has four or fewer data series.

6. If you enter a maximum value for the chart scale, the 
chart may not display it if there is not enough room.  
To correct this, enlarge the chart vertically, change the 
major ticks value, or change the minimum value.

7. You cannot format the series labels in a pie chart. 
The series labels for other chart types take their format 
from the Y-axis label format.

8. In a 3D chart, the X-axis tick labels may overlap or 
appear truncated. To correct this, enlarge the plot of the 
chart or assign a font in a smaller point size to the X-axis.

9. Assigning some fonts to the Y-axis title in a chart 
results in horizontal text rather than vertical text 
appearing in the print preview; however, the printout 
appears correctly.  These fonts include FixedSys, Helvetica 
Narrow, MS Sans Serif, MS Serif, Palatino, System, and 
ZapfChancery.

FONTS
1. To assign a font size that is not listed in the InfoBox 
or on the status bar, you must use LotusScript--for example, 
use the command SetIntProperty(0, TextSize, 72) to specify 
a 72-point font. In header/footer text, enter a format code 
to specify the desired font --for example, {F 72}.

2. Improv does not support SuperText and SuperPrint 
(Releases 1.1, 1.2, 2.0, 2.1) from Zenographics.

TEXT EXPORT
If you export an unsaved file to a text file, there is no 
limit to the size of the file you can export. If you export 
a saved file to a text file, you can export a maximum of 
8192 rows and 256 columns.

FILE IMPORT
1. Remove password protection from a file before you 
import the file into Improv.

2. Remove embedded charts and graphic objects from a 
Microsoft(R) Excel 4.0 file before you import the file 
into Improv.

3. When you import a 1-2-3 or Excel file that contains 
many formulas, the import may take a long time. To import 
the worksheet faster, don't import the formulas.  To do 
this, uncheck Import Formulas in the Worksheet Import 
dialog box.

4. When you import a 1-2-3 or Excel file, most functions 
will be translated into their Improv equivalents; however, 
you may need to recreate some manually after you import 
the file. For more information, see Appendix B of the 
Improv Handbook, which lists 1-2-3 and Excel functions and 
their Improv equivalents.

5. Improv can import Excel 4.0 files. If you upgraded from 
Excel 3.0 to Excel 4.0, you must save Excel 3.0 files as 
Excel 4.0 files before you import them into Improv. 

DDE LINKS
A DDE link may break without warning if Improv is the 
server and you rename, group, or ungroup items that are 
included in a linked selection. If the link breaks, 
delete the link formula and recreate the link.

COLLATE OPTIONS
In the International dialog box (Tools/UserSetup/International),
the ASCII option actually displays the ANSI character set.

LOTUSSCRIPT
1. Be aware of the following issues with scripts that use 
the CloseModel or CloseIWindow functions to close models:
a) If you have a library script that closes the model it is 
attached to, do not attach it to a model. Instead, use a 
model script for this purpose. 
b) Do not debug a library or model script that uses
the CloseModel function to close the file that contains 
the script.

2. Within a script, reading files from a floppy device 
that is not ready and then choosing the Cancel option from 
a "Drive not ready" message will cause Improv and Windows 
to crash. To work around this problem, scripts should first 
include another file operation that checks the drive to make 
sure that it is ready. For example, include the dir$ 
function in the script, along with a way to exit the script 
if the dir$ fails. Then if the drive is not ready, choosing 
Cancel will succeed, but the dir$ will fail and the script 
will stop. If the drive is ready, the script can continue 
with the file operation that you originally wanted to perform.

3. If you do not use U.S. as your International country 
setting, you should note the following. Using "\$" within 
the second argument to the format$ function will cause the 
"$" to appear at the beginning of the resulting text--for 
example, print format$(1234.56,"#,###.##\$") will print 
$1,234.56. If you want the "$" trailing the text, use print 
format$(1234.56,"#,###.##")+"$" which will print 1,234.56$.

4. In scripts, use the float data type to store Improv cell 
values. Use the SetLongDoubleCellValue and 
GetLongDoubleCellValue functions in place of SetCellValue 
and GetCellValue to set and get Improv cell data. This will 
avoid rounding errors due to the conversion of 8 byte data 
to 10 byte data.

5. GetBrowserNote doesn't work when the selection is a model 
script.

6. GetSelection doesn't work when the selection is a library 
script.

7.  Do not assign the same name to two scripts in the same 
script library file. This includes scripts with the same 
names and different capitalization. For example, do not name 
two scripts SCRIPT1 and script1.

8.  After deleting or renaming a script name in the Script 
Name box of the script library window, you must press Enter.

9. Do not debug a script (Tools/Run Script/Debug) containing 
the command CreateChart or CmdExec(xcmd_CreateChart). Instead, 
insert a STOP statement in the script after these commands. 
Then to debug the script, run the script. The STOP statement 
will invoke the Debug window, and you will be able to debug 
the script from that point.

10. In Script Help, the description of the parameters for the
GetStringProperty is incorrect. Use the parameter IT_CONTEXT1 
to find the view/presentation/script name; use the parameter 
IT_CONTEXT2 to find the worksheet name.
 
SCRIPT RECORDING AND PLAYBACK
1. Recorded scripts may have references to the specific 
model that was operated on. To use the script on a different 
view, worksheet, or model or to make the script more general, 
edit the lines before running the recorded script.

2. You cannot generalize a script that records changes to
settings of graphic objects in Presentations because the 
names of the objects are generated by Improv.

3. The option to replace data with calculated values when 
adding a formula does not get recorded. When you run the 
script, the formula will be created, but the data values 
will not be replaced. To work around this problem, record 
clearing the cell values first and then create the formula.

4. When recording moving between views, opening the Browser 
will always be recorded. To move between views without 
opening the Browser, change the SetSelectionByName function 
call in the recorded script to CreateSelHandle, use the 
OpenIWindow command on the selection, and remove the script 
text that opens the Browser.

5. When editing text, operations such as Cut, Copy, and 
Paste  are not recorded. All that is recorded is the 
resulting edited text.

LOTUS DIALOG EDITOR
Do not use hard carriage returns when entering text for 
buttons or text boxes. Instead, resize the control to allow 
the text to wrap.

C API
The Scripts directory contains an import library file
(LIBPL.LIB) and a header file (CAPI_PUB.H) for C API users. 
To call into the Improv C API interface, create a Windows 
.DLL file that includes the CAPI_PUB.H (Improv C API 
prototypes) and links with LIBPL.LIB (Improv C API import 
library).
