
	Sun WorkShop Visual 2.0
	October 1996

=============================================================================

Introduction:

	WorkShop Visual, version 2.0 (a component of the Sun Visual WorkShop
	for C++, release 3.0) is an interactive tool for creating robust
	Motif-based graphical user interfaces with minimal effort.

Table of Contents :
	A. New Features
	B. Changes to Features
	C. Software (In)compatibilities
	D. Current Software Bugs
	E. Fixed Software Bugs
	F. Documentation Errata
	G. Porting generated applications to other platforms
	H. Using visu_record and visu_replay without a license

____________________________________________________________________________
A. New Features

   1.	Record/Replay of X events.
	A facility for recording and replaying X events that allows you to
	build test suites, record command sequences for later inspection, build
	scripts for creating and re-creating screen snapshots, and much more.

   2.	Design Capture.
	Allows you to extract the widget tree from any running dynamically
	linked Motif application. The design is  written to a Visual design
	file (.xd). You can then use Visual for further development of the
	design.	Use this feature if the sources have been lost, the GUI was
	handcoded or the GUI was designed using a different GUI builder.

   3.	Integration with the new programming environment.
	Visual is integrated with the new WorkShop. It uses the same default
	text editing facility used when browsing and debugging, and maintains
	picklists for .xd files and make targets.

   4.	AppGuru.
	The AppGuru quickstarts a GUI by providing a way to construct a simple
	design that can be loaded into Visual for further work.

   5.	A new HTML based help system.
	The online help system provides easily-accessible help for visu. It is
	available in source form for inclusion in applications you build.

	And much much more!

____________________________________________________________________________
B. Changes to Features

   1.	Much improved editor for resource bindings.
	Allows you to specify resources that bind to groups of widgets.

   2.	Multiple selection in the widget tree.
	The resource panels show only resources shared by all selected widgets.

   3.	Improvements to the pixmap editor including support for loadable color
	palettes.

   4.	Improved user interface to the code generator.

   5.	Bundling of cross platform code generation facility with WorkShop.
	No need to get an extra license to use it.

   6.	New command "visuroot".
	This new command will echo the location that Visual has been installed
	at. The command is used in Makefiles generated by Visual. This obviates
	the need to set the environment variable VISUROOT.
	You can upgrade existing Makefiles by adding the following line:
		VISUROOT:sh= visuroot

____________________________________________________________________________
C. Software (In)compatibilities

   1.	WorkShop Visual 2.0 requires one of the following configurations:

	Sparc & Intel:
	- Solaris 2.4 and the Motif runtimes from the Solaris 2.5 release
	- Solaris 2.5 or above and the Motif runtimes from the corresponding
		Solaris release

	PPC:
	- Solaris 2.5.1 or above and the Motif runtimes from the corresponding
		Solaris release

    2.	The following XRT widgets (XRT Product CD Vol. 5) are supported by
	WorkShop Visual:

		XRT/graph       2.4.0
		XRT/3d          2.1.0
		XRT/table       2.2.0

    3.	The following INT widgets are supported by WorkShop Visual:

	The complete INT widget set, version 2.2, is supported by
	WorkShop Visual.

    4. Using Visual or any other Motif client with remote display on
       a system running an xnews-based OpenWindows system (bundled
       with SunOS prior to Solaris 2.3) requires that you install
       one of the following patches:

	- Solaris 1.x/OpenWindows 2:	100176
	- Solaris 1.x/OpenWindows 3:	100444
	- Solaris 2.2:			100989

    5. The File Selection dialog in Motif in Solaris 2.4 and 2.5.1
       sometimes fails to display the files and directories to pick from
       (there is a problem with the horizontal scrollbar).
       If you run into this problem you should apply one of the following
       patches to your system:
       Solaris 2.4 -> 102226
       Solaris 2.5.1 -> 103461

____________________________________________________________________________
D. Current Software Bugs

  Bug ID    Synopsis
 _______    _______________________________________________________________
 1209143    Problems with INT EditTable widget

            There is a known problem with modifying resources in an instance
            of a definition that contains a user defined widget. Doing
            this leads to multiple instances being created in the generated
            code and in the dynamic display. The .xd file may also get
            corrupted. The workaround is to not do this.
 
 _______    _______________________________________________________________
 1215042    Visual can not print Japanese title of the current hierarchy

            This is a problem in the JA locale only. The work-around is
            to leave the title blank.

_______    _______________________________________________________________
 1213655    Built application displays Japanese text as junk characters.

            Workaround:  Add the following resource setting into user's
            .Xdefaults file or the app-defaults file for the built application:
            XApplication*fontList:\
            -sun-gothic-medium-r-normal--14-120-75-75-c-120-jisx0208.1983-0;\
            -sun-gothic-medium-r-normal--14-120-75-75-c-60-jisx0202.0976-0;\
            -*-lucida sans typewriter-medium-r-*-*-12-*-*-*-*-*-*:

            where XApplication above is the application class name defined in
            the Visual "Generate" dialog.

-___________________________________________________________________________
E. Fixed Software Bugs

	No new information for this section
____________________________________________________________________________
F. Documentation Errata

	No new information for this section
____________________________________________________________________________
G. Porting generated applications to other platforms

	All source files under the WS4.0/src directory of the
	product distribution should be considered equivalent
	to source generated by WorkShop Visual. It is in other
	words OK to port them to any platform as part of a generated
	application.

____________________________________________________________________________
H. Using visu_record and visu_replay without a license

	visu_record and visu_replay will work in command line
	mode even if no license is available. This makes it possible
	to ship demo scripts to third parties without requiring
	them to buy the Visual Workshop. It also makes it possible
	for a support department to ask third parties to use visu_record
	to document steps that lead to a problem with a product.
	
	To redistribute visu_record and/or visu_replay the following
	files must be included:

	<install location>/WS4.0/bin/visu_record
	<install location>/WS4.0/bin/visu_replay
	<install location>/WS4.0/lib/xds/libaka.so
	<install location>/WS4.0/lib/xds/libcvtXm.so
	<install location>/WS4.0/lib/xds/libcvt<customwidget>.so
		(if you have any custom-widget integrations)
	<install location>/WS4.0/lib/xds/libextras.so
	<install location>/WS4.0/lib/xds/librtl.so
	<install location>/WS4.0/lib/locale/C/LC_MESSAGES/replay.mo
	<install location>/WS4.0/lib/locale/C/app-defaults/XDS
	<install location>/WS4.0/lib/locale/C/app-defaults/XDS-color
	<install location>/WS4.0/lib/locale/C/app-defaults/XDS-mono

	Also include the following in the JA locale:

	<install location>/WS4.0/lib/locale/ja/LC_MESSAGES/replay.mo
	<install location>/WS4.0/lib/locale/ja/app-defaults/XDS
	<install location>/WS4.0/lib/locale/ja/app-defaults/XDS-color
	<install location>/WS4.0/lib/locale/ja/app-defaults/XDS-mono

	It doesn't matter where the distribution goes as long as it
	keeps the same structure.
