
----------------------------------------------
Sun WorkShop TeamWare 2.0 (Beta) Release Notes
----------------------------------------------

These release notes provide you with last-minute news and supplemental
information about the 2.0 (Beta) release of Sun WorkShop TeamWare.

These notes are organized into the following sections:

What's New?	New Names
		New Motif Interface
		CDE Online Help (see Documentation) -- NEW!
		Building -- NEW!
		DistributedMake -- NEW!
		Merging (formerly FileMerge)
		Versioning (formerly VersionTool)
		Configuring (formerly CodeManager)

Software Notes	List of known problems and special features of this 
		TeamWare version.

Documentation	List of documentation sources, where to find information 
		such as README's, patches, system requirements, and errata.

To contact us, choose Help--> Send Comments in any of the TeamWare main 
windows. 


New Names
---------
The names of the graphical user interface have changed.

TeamWare 1.0		TeamWare 2.0
------------		------------
CodeManager  is now	Configuring
VersionTool  is now	Versioning
FreezePoint  is now	Freezepointing
FileMerge    is now	Merging


The command line interface is unchanged.  You can type in the old names 
and the applications will appear using the new names within the application.


New Motif Interface
-------------------
The new Motif interface works with the Motif and Common Desktop Environment 
desktops.

Due to the different window systems, there will be visual differences
and selection with the mouse buttons is different.
These changes do not affect compatibility with existing workspaces.

To make a selection in the Motif/CDE interface, click the left mouse 
button to select the first item, and extend the selection by clicking 
the left mouse button on another item while pressing the Shift key  
(this action is called Shift-SELECT).  If you press Shift-SELECT on 
an item that is already selected, that item is deselected.


Building -- NEW!
----------------
* The old SPARCworks MakeTool has been replaced by the new TeamWare MakeTool.

* The build window icon is not animated.

* The default build command is dmake (DistributedMake).

* Copy and paste work differently.

* Now integrated with editor-of-choice.

* Now integrated with compilers' help message catalogs.

* The dependency tree window shows the relationships between targets and 
  the state of those targets.

*The Jobs graph shows the build progress of the servers in use.

Usage Note
- - - - - -
If you use a script to run a build, you should build outside of Workshop.
Make sure your makefile assumes that the compiler output is 
piped to another tool and processed in parallel.


DistributedMake -- NEW!
-----------------------
* ParallelMake in TeamWare 1.x has been enhanced and replaced by
  DistributedMake.

* DistributedMake will concurrently distribute multiple jobs to 
  multiple remote build servers.


Merging (formerly FileMerge)
----------------------------
* Many commonly used features are now available from buttons on the main
  window, rather than from menu items.

* The "Up" and "Down" buttons in the center of the window refer to the
  next/previous diffs (resolved or not) for either file.

* There are two sets of "Accept", "Next" and "Accept & Next" buttons;
  each apply to the file in the pane below them.
  The "Accept & Next" button means that after the accept, move to the
  next unresolved diff in that pane. "Accept" accepts the diff (on that 
  side) and stays at that difference.  The "Next" button will move to
  the next unresolved diff.

* The synchronized scrolling may not be exact in the (lower) merged output 
  window.

* Motif-style extend select (Shift-SELECT) is not yet available

* Marking diffs as done cannot be undone with the "Undo" button or menu

* Colors can now be set using these resources:
	XFileMerge*addedLineColor
	XFileMerge*changedLineColor
	XFileMerge*deletedLineColor


Versioning (formerly VersionTool)
---------------------------------

The workspace program has two new subcommands: 

Move Files	Moves files within a workspace.
Delete Files	Removes files in a workspace.

The Versioning window has a menu bar entry for these subcommands.
The menu bar is enabled when the windows shows files that are within 
a workspace.

In earlier releases of TeamWare 1.x, these commands were available from
the command line as sccsmv and sccsrm (these commands are no longer
available).


Configuring (formerly CodeManager)
----------------------------------

* This version does not support reparenting by dragging and dropping 
  while holding down the shift key. 


Software Notes
--------------

TeamWare SCCS Restrictions	Lists the sccs subcommands to avoid in 
				TeamWare workspaces.

Usage Tracking			Describes usage tracking and how to disable it,
				if desired.

TeamWare SCCS Restrictions
- - - - - - - - - - - - - -
Avoid using the sccs subcommands cdc, comb, fix, and rmdel in 
TeamWare workspaces.

Using these commands can alter SCCS history files which will make 
them impossible for TeamWare to track.  These commands also have 
undesirable side effects when used on files that exist in 
multiple workspaces that eventually may be merged.

cdc	Can cause unnecessary branching and confusing histories.
comb	Completely rebuilds the SCCS history file. 
fix	A front-end for rmdel.
rmdel	SCCS restricts the use of the rmdel command to remove only the
	most recent (leaf) delta on a branch.
	If you remove a delta that also exists in another workspace, it is
	possible that another user will add a delta in the other workspace.
	The delta that was removed in your workspace will no longer be a 
	leaf delta when the files are merged.

Usage Tracking
- - - - - - - -
Usage tracking provides a way for Sun Developer Products to 
collect information on how developers like you use its tools. 
This information can then be used to improve future revisions of 
the products.

Usage tracking is implemented in this Beta release of the Sun WorkShop 
TeamWare tools.  It will also be implemented in the Beta release, but not 
in the final release of the product.  See the instructions below to turn 
off usage tracking.

Here is an example of data that will be collected:

  bringover -p /set/tw/simple3/ws/parent_ws -w /set/tw/simple6 \
  /ws/child_ws .
  release: 2.0
  machine: simple
  OS: 5.4
  architecture: sun4m
  start time: 05/20/96 00:04:11
  elapsed time: 271 seconds
  exit status: 0
  parent: /set/tw/simple3/ws/parent_ws
  child: /set/tw/simple6/ws/child_ws
  child ws created
  examined: 1711
  create: 1711

TeamWare users can turn off usage tracking in one of two ways:

1. Globally, by commenting out the email address in the file:
   /<install_dir>/TW2.0/lib/usage_mail_addr

   This will disable usage tracking in all the TeamWare tools 
   installed in the <install_dir> directory.

2. Locally, by setting the UT_NO_USAGE_TRACKING environment variable.
   No usage tracking data will be extracted from environments where this
   variable is set.


Documentation
-------------

The Common Desktop Environment Online Help is now available.
Choose Help--> Contents to view the help volume.

Where is?
- - - - - -
Documentation		See the online help and the references listed below.

README's		Check the install directory:
			/<install_dir>/SUNWspro/READMEs/tw_release_notes

Patches			Look in the Patch directory on the CD.

System Requirements	See the Installation Guide.

Recommended Compilers	See the Installation Guide.

Registration		See Help--> About TeamWare.


References
- - - - - -
* Common Desktop Environment Help (available from the TeamWare Help menu)
* man pages

Errata
- - - -
* Online books (AnswerBook documentation) are not available.
* The links to Netscape Navigator and AnswerBook from the online help volume 
  have not been implemented.
* The TeamWare video is under construction.



