#*************************************************************************
#*
#*  $RCSfile: README,v $
#*
#*  $Revision: 1.5 $
#*
#*  last change: $Author: wiede $ $Date: 2005/11/27 11:50:48 $
#*
#*  The Contents of this file are made available subject to the terms of
#*  the following license
#*
#* 	- BSD License
#*
#*	see file license.terms in this directory
#*
#*  Copyright 2005 Arnulf Wiedemann
#*
#*  Author: Arnulf Wiedemann
#*
#*  Contributor(s): 
#*
#************************************************************************/


This package is the tclurtp package.

This directory contains a TCL only implementation of a package to provide
access to the OpenOffice.org UNO interface using the urp socket protocol of
OpenOffice.org.

Most of the information of the interfaces, properties etc. available in a
specific OpenOffice.org package is figured out using core reflection and 
introspection, so different versions of OpenOffice.org should be no problem,
as long as the urp interface is not changing.

This package is only providing basic access to the UNO interfaces and
properties. In order to have easy access to a higher level functionality you
should use the TCL packages built on top of this package: tcluno, itcluno and
unospection.

For using this package the auto_path variable must contain the directory above
tclurtp for the pkgIndex.tcl file to work properly and the program must have a
call:
package require tcluno_soffice
together with the command line option -urtp

There must be an OpenOffice.org process already running started with:
"-accept=socket,host=localhost,port=2002;urp;"
Options on command line (mostly debugging options) for urtp bridge:
-urtp			use the Tcl only version instead of tcluno library
-urtp_binary		use the Tcl urtp binary packing (deprecated no longer needed as that is the default)
-urtp_send_debug	be verbose on sending and receiving of messages
-urtp_binary_send_debug	be verbose on sending and receiving of messages 
			together with -urtp_binary option (dump binary stuff)
-urtp_debug		be verbose
-urtp_reflection_debug	be verbose on doing core reflection
-urtp_command_debug	be verbose on commands from the caller of this library
-urtp_unmarshal_debug	be verbose on unmarshalling the binary replies
-urtp_invoke_debug	be verbose on preparing the XInvocation invoke method call
