                     This is a MacOSX port 
                    of the bouml application 
                     written by Bruno Pags.

If you wish to use bouml line commands (within a Terminal window), 
see CommandLineSupport/README-CL.txt.

REQUIREMENTS:
-------------
The PCC port needs Mac OS X 10.3.9 (untested on older versions of Mac OS X)
The INTEL port needs Mac OS X 10.4 (untested on older versions of Mac OS X)

CAUTION:
--------
-- Do not drag the bouml application outside of the bouml 
folder. The bouml folder contains an invisible folder required 
for using bouml.
-- This implementation of bouml is delivered as is. I build it for my 
own use and do not garanty that it will work on your machine.
-- Bouml if property of its author (see http://bouml.free.fr/)

KOWN Bugs:
----------
-- in the bouml default interface, the disclosure arrows do not work : 
double-clic the item, it will be opened and the arrow will disclose (I think 
it's a QT bug) ; you can avoid this annoyance by choosing a style in the
Micellaneous/Style menu (i.e. by using a Motif style instead of the aqua style) 



TECHNICAL DETAILS :

The bouml application is in fact a set of unix applications that 
are monitored by the bouml main application, and that make use 
of the qt shared library (see bouml documentation for details 
about qt).
In order to work under MacOS X, all the applications were build 
up with a MacOS X interface, but the way bouml manages 
sub-applications was left unchanged (the bouml application keeps 
launching sub-applications through unix commands). For this to 
work properly, several unix environnement variables must be set 
before launching bouml.

In this implementation, this is done though a MacOS X script 
(the bouml application), that does two things : 
1) gets its own path in order to be able to set unix  
   environnement variables giving the absolute path 
   of every bouml application and of the qt shared 
   library
2) executes a unix script that sets the necessary 
   unix environnement variables and launches bouml

The bouml folder (containing this file) is organized in the 
following way.

bouml: main folder
	README.txt : this file
	bouml.app : script application that launches bouml
	projectControl.app : script application that launches projectControl
	projectSynchro.app : script application that launches projectSynchro
	plugouts : folder containing bouml support folders
	           (empty project, and current plugouts projects)
			FileControl:
			GlobalChange:
			cpp_utilities:
			deploy:
			empty:
			genpro:
			html:
			rose:
			singleton:
			sm_generator:
			sort:
                        uml_projection:
			usecase_wizard:
			xmi:
			xmi2:
			xmi2import:
        lang: folder containing localization files like fr.lang
                        The format of these localization files is specific to bouml (this should be fixed some day).
                        Thus, the default Mac OS X localization mecanism does not work.
                        Instead, the init.csh script defines a BOUML_LIB_DIR which points to this folder.
                        The command `defaults read NSGlobalDomain AppleLocale` gives the preferred user language,
                        and is used to set the LANG variable, which then is used by bouml to set the LANG variable
                        in the $HOME/.boumlrc preferences.
	.bin: hidden folder containing all the bouml applications and plugouts
			bouml.app
			browsersort.app
			cpp_generator.app
			cpp_reverse.app
			cpp_util.app
			deplcl.app
			file_control.app
			ghtml.app
			global_change.app
			gpro.app
			gxmi.app
			gxmi2.app
			idl_generator.app
			irose.app
			ixmi2.app
			java_catalog.app
			java_generator.app
			java_reverse.app
                        java_roundtrip.app
			php_generator.app
			php_reverse.app
			plug_out_upgrade.app
			projectControl.app
			projectSynchro.app
			python_generator.app
			roundtrip_body.app
			singleton.app
			stmgen.app
			uml_proj.app
			usecasewizard.app
	.lib: hidden folder containing other resources 
		1) qt shared library
			qtlib: folder containing version 3.3.7 of Trolltech QT library
			   libqt.3.dylib
		2) init.csh, init-projectControl.csh, init-projectSyncho.csh
			unix shell scripts that sets environnement variables
			and launch bouml, projectControl, and projectSynchro respectively
		3) launch-bouml_src.txt, launch-projectControl.txt, launch-projectSynchro.txt
			Text files : Applescript sources of the script applications

This implementation was tested under MacOS X 10.3.9 (for PPC) and Mac OS X 10.4 (for Intel)
