
             1-2-3 and Freelance Graphics File Translator
                             

--------
OVERVIEW
--------
The 1-2-3 and Freelance Graphics File Translator converts spreadsheet 
and presentation graphics files between the OS/2 and Windows file 
formats. You can convert to and from the 1-2-3 .WG2 and .WK4 file 
formats and to and from the Freelance .PRS and .PRE file formats. 

Native OS/2 and Win3.1 Versions
-------------------------------
The are two versions of the 1-2-3 and Freelance Graphics File
Translator.  One version is designed to run natively on OS/2 Version
2.1 or higher; the other is designed to run on Microsoft Windows 3.1 
or higher.

This file provides information about OS/2 and Windows installation 
of the File Translator for users who want to install and run the File 
Translator on a Windows 3.1 or Windows 95 system, as well as on an 
OS/2 system. 

1-2-3 Files
-----------
The File Translator converts .WG2 files created using 1-2-3 for OS/2 
Release 2.x to the .WK4 format (the 1-2-3 Release 4.x or 5.x format).
These .WK4 files can then be read by 1-2-3 for OS/2 Warp 4.  

1-2-3 for OS/2 Warp 4 can natively read (directly from the File-Open
dialog) .WG2 format files; however, macros contained in the .WG2
files are not translated by 1-2-3 for OS/2 Warp 4.  If you have .WG2
files containing macros, you may wish to first convert them to the 
.WK4 format using the 1-2-3 and Freelance Graphics File Translator, 
and then read them into 1-2-3 for OS/2 Warp 4. The File Translator is 
designed to convert data, worksheet styles, and most macros, formulas, 
@functions, fonts, borders, and colors.  

The MACTRANS.WK4 File
---------------------
For detailed information on which macros are translated by the File 
Translator, see the MACTRANS.WK4 file located in either the 
EXTRA\TRANS\OS2 subdirectory or the EXTRA\TRANS\WIN subdirectory of
the SmartSuite for OS/2 Warp 4 CD-ROM.

This spreadsheet (which you can open with 1-2-3 for OS/2 Warp 4)
contains detailed information on the macros and keystroke commands 
translated by the File Translator. It is a rather large spreadsheet 
and may take a minute or so to open. Buttons are provided on the 
spreadsheet to take you directly to different sections or back to the
Table of Contents.

Freelance Graphics Files
------------------------
The File Translator converts .PRS files created with Freelance 
Graphics for OS/2 Release 2.x to the Freelance Graphics for Windows
Release 2.x (.PRE) format and can convert .PRE format files to the 
.PRS format. The File Translator is designed to convert data and 
SmartMaster styles as well as most fonts, borders, and colors. 

The File Translator will not convert files created with Freelance 
Graphics for OS/2 Warp 4 (.PRZ) format; however, you can save 
Freelance Graphics for OS/2 Warp 4 presentations directly to the 
Freelance Graphics for Windows Release 2.x (.PRE) format and use the 
File Translator to convert the .PRE file to the .PRS format.

------------------------------
INSTALLING THE FILE TRANSLATOR
------------------------------
To install the File Translator, simply copy the 1-2-3 and Freelance 
Graphics File Translator files onto either a local hard drive or a 
network drive to which you have access rights.

1. Insert the SmartSuite for OS/2 Warp 4 CD-ROM into your CD-ROM 
   drive.

2. Do one of the following:

   * In OS/2, open an OS/2 window.

   * In Windows, display an MS-DOS prompt.

3. Switch to the subdirectory of your choice (such as the LOTUSW4 
   subdirectory where you installed SmartSuite for OS/2 Warp 4).

4. Use the MD command to create a subdirectory for the File Translator.
   For example, type MD TRANS (to create a TRANS subdirectory).

5. Switch to the newly created subdirectory.

6. Copy the appropriate files to the new subdirectory. 
   
   The OS/2 files are located in the EXTRA\TRANS\OS2 subdirectory; 
   the Windows files are located in the EXTRA\TRANS\WIN subdirectory.

7. Exit the OS/2 window or MS-DOS prompt.

------------------------
OS/2 SYSTEM INSTRUCTIONS
------------------------

Adding a Desktop Icon for the File Translator (OS/2)
----------------------------------------------------
You can create a File Translator icon on your OS/2 desktop as follows:

1. Double-click the Templates folder (which may be located in the 
   OS/2 System folder).

2. Drag the Program icon onto the desktop to create a new Program.

3. In the Program - Settings dialog box, enter the complete path
   and file name for the File Translator. For example, type 
   C:\LOTUSW4\TRANS\OS2TRANS.EXE (for the OS/2 version).

4. Click the General tab.

5. Change the Title from "Program" to "File and Macro Translator."

6. Exit the dialog box.


Changing the File Translator Icon (on OS/2)
-------------------------------------------
If a generic icon appears, you can change it to the File Translator
icon as follows:

1. Open the File Translator's Settings Notebook.

2. Click the General tab.

3. Choose Find.

4. Enter the complete path and file name for the File Translator in 
   the Folder text box.

5. Choose Find.

6. Select the OS2TRANS.ICO icon.

7. Click OK.

8. Exit the dialog box.

-------------------------------
Windows 3.1 SYSTEM INSTRUCTIONS
-------------------------------

Adding a Desktop Icon for the File Translator (Windows 3.x)
-----------------------------------------------------------
You can create a File Translator icon on your Windows 3.x desktop
as follows:

1. Open the Program Manager.

2. Open the group where you want to add the icon (for example, the 
   "Lotus Applications" program group if you have one).

3. Choose File - New from the Windows 3.1 menu.

4. Select "Program Item" and click OK.

5. Enter a description for the icon in the Description text box.
   For example, type FILE TRANSLATOR.

6. Enter the complete path and file name for the File Translator
   in the "Command Line" text box. For example, type 
   C:\LOTUSW4\TRANS\WINTRANS.EXE.

7. Click OK.

------------------------------
WINDOWS 95 SYSTEM INSTRUCTIONS
------------------------------

Adding a Desktop Icon for the File Translator (Windows 95)
----------------------------------------------------------
You can create a File Translator icon on your Windows 95 desktop
as follows:

 1.  Click "Start."	
 
 2.  Point to "Settings."
 
 3.  Click "Taskbar."
 
 4.  Select the "Start Menu Programs" tab.
 
 5.  Click "Add."
 
 6.  Specify the Command line to match the path where you copied 
     the File Translator files; for example, type: 
     C:\LOTUS\TRANS\WINTRANS.EXE.
 
 7.  Click Next.
 
 8.  Click a folder name or create a new folder.
 
 9.  Click Next.

10.  Specify a name for the shortcut (for example, File Translator).

11.  Click Finish.

12.  Click OK.


Starting the File Translator (on Windows 95)
--------------------------------------------
1. Click "Start."

2. Point to Programs.

3. Point to the folder that contains the icon.

4. Click "File Translator."
