Welcome to Together
Windows®
Information
System Requirements
for Windows
CPU:
|
Pentium, 166MHz or faster |
Recommended: Pentium, 233MHz;
for large projects:
Pentium-II, 300MHz or faster
(for the case of running MS JVM) |
Memory: |
64 MB or more |
Recommended: 96 MB;
for large projects and running scripts: 128 MB |
Hard disk space: |
15 MB on NTFS partition;
15-33MB on FAT partition (depending on cluster size) |
Not including the size of virtual machine |
Video: |
SVGA, minimum high color mode |
Recommended screen resolution:
1024x768 or more |
OS: |
Windows 95® or
Windows NT® 4.0 or
Windows 98  |
Service Pack 3 for Windows NT 4.0 is required for Microsoft JVM |
Java VM or JDK:
|
(see Java VM info below) |
Required to run Together |
HTML browser - required to view and print online
help documentation and generated documentation. |
CD-ROM drive or Internet connection - required
for installation/download and information update. |
Java™ Virtual machine
(VM) information
Together has been tested on the following Java VMs under Windows
NT/95
-
Sun® Java™ Virtual Machine Versions 1.1.3, 1.1.4, 1.1.5,
1.1.6, and 1.1.7.
Recommended versions: 1.1.5 or 1.1.6.
Comments to other versions:
1.1.2, the one included with Borland JBuilder 1.0, causes a lot
of drawing problems and is not recommended.
1.1.7 is recommended if you work under Windows 98.
-
Sun® Java™
Virtual Machine Version 1.2 (JDK 1.2 Release Candidate 2) under Windows
NT.
Note: you should specify the -noverify parameter in the command
line invoking JVM 1.2 for Together.
Note: JDK 1.2 under Windows 95/98 is not yet supported.
-
Microsoft® VM for Java™, build numbers 2339 (SDK for Java
2.0), 2424 (SDK for Java 2.02, also shipped with Internet Explorer 4.01),
2829 (SDK for Java 3.0), and 2925 (SDK for Java 3.1).
Recommended version: 5.00.2925 (build 2925 from SDK for Java 3.1)
Comments to other versions:
Not recommended to use with Together: builds 2252 - printing doesn't
work, 2405 - scripts don't properly run.
Builds 2828 and 2924 that were available at Microsoft as VMs of
SDK 3.0 and 3.1 respectively for some period are as good as official releases:
2829 and 2925.
Note: Service Pack 3 for Windows NT 4.0 must be installed before
installation of Microsoft® VM for Java. See faq.html
file for more information.
Installation
The installation process varies depending upon the product version and
what variant of the installer you have obtained. In addition to the pure-Java
installer Together has Windows-specific installers.
Installing Together using the pure-Java
Installer:
-
You must have a Java VM already installed on your computer.
-
Run together.class in your
Java virtual machine and follow the JShield Wizard's instructions.
-
You can run ready-made batch files:
-
install_windows_sunvm.bat to run the Java installer under Sun
VM
-
install_windows_msvm.bat to
run the Java installer under Microsoft VM
These files may require corrections depending on your environment. Also
you can use them as samples for invoking other Java VMs.
Note that the pure Java installer creates a Together program folder
in the Personal profile.
Installing Together using the NT/95/98
installer:
-
Before installing on Windows NT workstations, log in with Administrator
rights. The Together program folder is then created in the All-Users profile.
Otherwise, the folder is created in the current Personal profile and is
visible only in that profile.
-
Run setup.exe and follow the InstallShield Wizard's instructions.
-
The installer creates program icon for starting Together.exe.
This launcher automatically selects the Java VM installed at your computer
and runs Together in it. If you have both MS JVM and Sun JRE, then
MS JVM is chosen by default. If you want to run Sun JRE by default, add
the parameter: -sun in the command line string of the corresponding
program shortcut.
-
The installer also creates the file Together.bat, which gives
an example of how to run Together under Sun JRE. You should configure
this batch file according to your environment and needs; it is located
in ./bin directory of your Together installation.
-
The Installer checks to see if Microsoft Office is installed at your computer.
If so, it presents an option to copy the Together.dot document
template to the MS Office Templates folder. Use this template for pre-defined
formatting when you work with generated RTF documentation in Microsoft
Word. If Office is not installed, you can find Together.dot in the root
folder of your Together installation. For more information about
generating documentation in RTF format, see Scripts
reference.
Java Virtual Machine installation
-
Java VM installation is automatically started if the version of the
Together
installer you are running includes a Java VM installer.
-
Installation of Microsoft VM for Java will not run in NT if Service Pack
3 for NT has not been installed previously.
Start-up
To run Together from the Windows Task Bar, click sequentially:
Start | Programs | Together | Together
The pure Java installer under NT/95/98 does not automatically add
entries to the Start menu. You can add your own Start menu command or run
Together.exe
from Windows Explorer. See comments regarding default JVM
startup above.
Using JRE
The installer creates the file Together.bat which contains an
example of how to run
Together under Sun JRE. You should configure
this file for your needs. By default it invokes Sun JRE, which should be
accessible on the system search path. If not, specify the full path to
the JRE executable file.
In addition, this batch contains -ms and -mx options of jre command.
The larger the number, the more memory JRE holds, so make sure you have
enough to support the number you specify. Increasing the default is only
recommended if working with extremely LARGE projects.
After startup:
-
Choose File | New Project... to create a new Together project, or
File | Open Project... to open an existing project.
-
To work with existing source code, create the project in a directory, which
contains source files (directly or in its subdirectories).
Registered file type
The Together installer for Windows registers the "Together project
file" type (having .tpr extension) to enable opening an existing
project file in Together. Just double-click such a file in Explorer
to open it in Together. Together starts up and opens the
project.
See also: "Opening a project file
on startup" in general Readme.
For more information, see Getting
Started part of the HTML Documentation.
Troubleshooting
If you experience problems, check the faq.html file
where you'll find answers to questions dealing with installation, start-up
and VM-specific issues.
SYSTEM
REQUIREMENTS JAVA VIRTUAL MACHINE
INSTALLATION
STARTUP
TROUBLESHOOTING