[adobe-source-commits] sandbox/visual_refactor Jamfile,NONE,1.1 LICENSE_1_0_0.txt,NONE,1.1 boost-build.jam,NONE,1.1 project-root.jam,NONE,1.1 read_me.txt,NONE,1.1

[Foster B. <fos...@us...>]

Update of /cvsroot/adobe-source/sandbox/visual_refactor
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv27679

Added Files:
	Jamfile LICENSE_1_0_0.txt boost-build.jam project-root.jam 
	read_me.txt 
Log Message:
SO SORRY for the large qty of emails -- creating a branch for Adobe Begin refactoring.

--- NEW FILE: LICENSE_1_0_0.txt ---
Copyright (c) 2005 Adobe Systems Incorporated

Permission is hereby granted, free of charge, to any person obtaining a copy of
this software and associated documentation files (the "Software"), to deal in
the Software without restriction, including without limitation the rights to
use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
the Software, and to permit persons to whom the Software is furnished to do so,
subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

--- NEW FILE: boost-build.jam ---
boost-build third_party/boost_tp/boost/tools/build/v2/ ;

--- NEW FILE: read_me.txt ---
Release Notes 20050401


-=-=-= REVISION HISTORY

2005/04/01	Started bringing Adobe Begin for Win32 online. Took a good chunk out of it, but bugs remain.
			Reworking of Win32 metrics measurement / UI enchancement on Win32 (by Ralph Thomas)
			Reworking of bjam build environment within adobe-source (by Ralph Thomas)
			Separation of platform code from express_viewer.cpp (by Ralph Thomas)
			Added eve_smoke, a test app for verifying Eve2 view definitions from the command line
			Reworked ui_core API for edit_text, popup, and unit_edit_text widgets
			Improved ui_core fudge code, though it still needs improvement (Mac)
			Added command line tutorial program for Adam (thanks to Peter Kummel for the discussion prompting the work)
			Fixed several ASL compilation bugs for various platforms.
			Added boost patch file to the distro (thanks to Nick Kraft for pointing out the omission)
			Multiple documentation tweaks and enhancements
			Added XCode projects for asl_lib, boost_lib, and Adobe Begin
2005/02/28	First public release! Lots of kinks to work out still, though.
2005/01/24	Many content-related documentation tweaks
			Documentation compiling with Doxygen 1.40
			Added documentation on Adam
			Added documentation for table_index
			Move iomanip to future directory
			Added an Adobe Begin widget reference
			Documentation CSS tweaks
			Added build support for GCC using Bjam
			ASL compiles with VC 7.1 again
			Started working on the tutorial section of the site
2004/12/22	Initial release to external testers.

-=-=-= COMPILING THE LIBRARIES


The Adobe Source Libraries should compile under CW 9.3, GCC 3.3 and VC 7.1, though recent testing has only been performed with CodeWarrior. The directory structure for setting up a build is as follows:

	./adobe/						# from the .zip file or CVS
	./third_party/boost_tp/boost/	# This is the boost 1.32.0 release

You will need to patch Boost 1.32.0 before compiling (see the Known Issues section of this readme for more information on patching Boost).


-=-=-= LIBRARY DOCUMENTATION


Documentation can be found at:

	./adobe/documentation/html/index.html

Navigating the documentation is more difficult than preferred (Doxygen does not give us much control over the sidebar). The easiest way to navigate is by expanding the "Modules" group in the sidebar.  Remember that the book headings in the side bar are also pages (click on the "Modules" link instead of its "+" icon) - some good information is buried there.

All of the serialization code (iomanip stuff) is experimental and will be moved to a "future" directory. To see a list of files that are being prepared for release, click on the "File List" link (not the "+") in the sidebar.


-=-=-= ADOBE BEGIN


Adobe Begin is a sample application that generates views using the Adobe Source Libraries (including Adam and Eve.) A prebuilt version of Adobe Begin for MacOS X is included in the compiled archive at:

	./binaries/metrowerks/bindebug/Adobe Begin	# full debug version
	./binaries/metrowerks/bin/Adobe Begin		# less debug version

To use the Adobe Begin simply drag a pair of Adam and Eve files (denoted by .adm and .eve respectively) onto the application. Some example files can be found in:

	./adobe/test/visual/examples/

To build Adobe Begin yourself you will need CodeWarrior 9.3 for MacOS X. (Time did not permit the release of a buildable implementation of Adobe Begin for any other platform.) You will also need to have the proper directory structure in place (see above).


-=-=-= KNOWN ISSUES


The copy of boost must be patched with a small number of minor changes - see "boost_1_32_0_patch_01.txt" for the list of changes. You can use the Unix patch command to make the necessary changes, but first make sure all the line endings in the effected files are Unix line endings.

We are aware the release is generally quite cumbersome, and are still figuring out how to package releases more efficiently.

--- NEW FILE: Jamfile ---
#
# This Jamfile triggers the build of the visual demo and adam tutorial.
#

--- NEW FILE: project-root.jam ---
use-project /boost : third_party/boost_tp/boost ;
use-project /adobe : adobe/build ;
use-project /adobe/visual : adobe/test/visual ;
use-project /adobe/adam_tutorial : adobe/test/adam_tutorial ;