DESCRIPTION
This file contains information about libraries that are supported
by code in OFBiz but that are left out of SVN because of licensing issues.
What is below is a list of jar files and where to put them, and the file(s)
to change to include them in the OFBiz build and/or run-time configuration.

NOTE: While these aren't included in the main SVN repository they are available
on the old Undersun SVN server in the specialized/libraries component directory.

-=- Workflow __________________________________________________________________________________________________________________________________________________

-Shark (LGPL):
  http://www.enhydra.org/workflow/shark/
  Current version : http://shark.objectweb.org/doc/1.1/release_notes/release_notes.html
  framework/shark/lib:
     js.jar
     sharkassignment-historyrelated-1.2_1.jar
     sharkassignment-standard-1.2_1.jar
     sharkassignment-xpdlstraightparticipantmapping-1.2_1.jar
     sharkauthentication-ldap-1.2_1.jar
     sharkcaching-lru-1.2_1.jar
     sharkclientapi-1.2_1.jar
     sharkcommonapi-1.2_1.jar
     sharkcorbaadmin-1.2_1.jar
     sharkcorbaclientapi-1.2_1.jar
     sharkcorbaserver-1.2_1.jar
     sharkcorbawhandler-1.2_1.jar
     sharkeventaudit-notifying-1.2_1.jar
     sharkeventaudit-smtp-1.2_1.jar
     sharkinternalapi-1.2_1.jar
     sharkinteroperability-wfxml-1.2_1.jar
     sharkkernel-standard-1.2_1.jar
     sharklimitagent-standard-1.2_1.jar
     sharklimitagent-timer-1.2_1.jar
     sharklogging-standard-1.2_1.jar
     sharkprocesslocking-memory-1.2_1.jar
     sharkrepositorypersistence-filesystem-1.2_1.jar
     sharkscripting-standard-1.2_1.jar
     sharksecurity-standard-1.2_1.jar
     sharktoolagent-standard-1.2_1.jar
     sharkusergroup-ldap-1.2_1.jar
     sharkutilities-common-1.2_1.jar
     sharkutilities-map-1.2_1.jar
     sharkutilities-misc-1.2_1.jar
     sharkwebservice-asap-1.2_1.jar
     sharkwebservice-asapapi-1.2_1.jar
     sharkwebservice-asaputils-1.2_1.jar
     sharkwebservice-wfxml-1.2_1.jar
     sharkwebservice-wfxmlapi-1.2_1.jar
     sharkwebservice-wfxmlutils-1.2_1.jar
     sharkxpdl-standard-1.2_1.jar
     wrd-1.2_1.jar
  NOTE: these jars based on a build from version 1.2_1 may be found attached
     in https://issues.apache.org/jira/browse/OFBIZ-552
     For an updated version some changes to the integration code in the
     shark component may be necessary.
  TO BUILD: once the jars are in place you can build from the
     ofbiz/framework/shark directory, or you can add it to the build
     list in the ofbiz/build.xml file in the framework-builds file list.
  TO DEPLOY: once the build is done the Shark container must be setup in the
     ofbiz-containers.xml file or other containers file being used.
     The shark-container container should be un-commented.
  TO DEPLOY, PART 2: to get the component to load on startup, and get the webapp
     in place and such the shark component needs to be uncommented in the
     framework/component-load.xml file.

  You may experiment online with Jawe XPDL editor:
  http://www.enhydra.org/workflow/jawe/index.html
  There is an example XPDL file in https://issues.apache.org/jira/browse/OFBIZ-552
  it came from http://www.wfmc.org/standards/docs/xpdl_sample/sample%20workflow%20process.xpdl
  For the moment Shark engine in OFBiz refuses to load it (OK in Jawe)

-=- Web Presentation: ________________________________________________________________________________________________________________________________________________

-JPublish/EdenLib (Apache):
  NOTE: these were removed for library compatibility reasons, not for license
        reasons; working these back in may be tricky
  http://sourceforge.net/projects/jpublish
  http://edenlib.sourceforge.net/
  framework/webapp/lib:
    JPublish.jar
    EdenLib.jar
  TO BUILD comment out exclude: framework/webapp/build.xml:
    org/ofbiz/webapp/view/GenericViewRenderer.java
    org/ofbiz/webapp/view/JPublishViewHandler.java
    org/ofbiz/webapp/view/JPublishWrapper.java
    org/ofbiz/webapp/view/FopPdfViewHandler.java
    org/ofbiz/webapp/ftl/FreeMarkerViewHandler.java
    org/ofbiz/webapp/ftl/FreeMarkerViewRenderer.java
    org/ofbiz/webapp/ftl/JpCacheIncludeTransform.java
  AND uncomment the jpublish type section portions of:
    org/ofbiz/webapp/region/Section.java

-=- Scripting: ________________________________________________________________________________________________________________________________________________

-JavaScript/Rhino (NPL 1.1):
  http://www.mozilla.org/js
  TO BUILD comment out exclude: base/build.xml:org/ofbiz/base/util/OfbizJsBsfEngine.java

-applets (Netscape javascript plugin : Sun Binary Code License Agreement - BCLA)
  Developpers : http://wp.netscape.com/eng/mozilla/3.0/handbook/javascript/packages.htm
  This link is also interesting : http://forum.java.sun.com/thread.jspa?threadID=516303&tstart=225
  NOTE: applications/product/src/ShipmentScaleApplet.java needs  netscape.javascript.JSObject
     If you're using the Sun JDK/JRE 1.4 or greater, the jar is located under jre/lib and it's called plugin.jar.
     You may also find it in the old Undersun SVN server in the specialized/libraries component directory.
  TO BUILD: Copy plugin.jar in framework/base/lib. This seems only needed under Windows.


-=- Reporting: ________________________________________________________________________________________________________________________________________________

-JasperReports (LGPL):
  http://sourceforge.net/projects/jasperreports
  TO BUILD comment out excludes:
    framework/webapp/build.xml:org/ofbiz/webapp/view/JasperReportsPdfViewHandler.java,org/ofbiz/webapp/view/JasperReportsXmlViewHandler.java
    applications/content/build.xml:org/ofbiz/content/report/JREntityListIteratorDataSource.java,org/ofbiz/content/report/JRMapCollectionDataSource.java
  Also upgrade the itext2.0.1.jar to itext.2.1.7.jar (this will however break the birt report generator.)

- JIMI (used by FOP ):
  http://java.sun.com/products/jimi
    FOP may require a library called JIMI to print certain graphical formats such as GIFs.  Jimi is a Sun library which cannot
    be included in OFBIZ due to licensing incompatibility, but you can download it yourself at: http://java.sun.com/products/jimi/
    and rename the ZIP file that comes with it as jimi-xxx.jar, then copy it into the same directory as fop.jar, which at this time
    is ${ofbiz.home}/framework/webapp/lib/

-=- POS _______________________________________________________________________________________________________________________________________________________

-GTK Swing (LGPL):
  http://sourceforge.net/projects/gtkswing/
  TO DEPLOY: base/config/pos-containers.xml:org.gtk.java.swing.plaf.gtk.GtkLookAndFeel for look and feel
-JavaPOS hardware drivers
  TO DEPLOY: specialpurpose/pos/lib/

  Epson Printer TM-T88III (Proprietay licence) needs jpos18-controls.jar (version specific)
  https://www.epson-pos.com/cgi-bin/sdssm/main/td_login.jsp
     epsonJposService180.jar
     epsonJposServiceCommon.jar

 Star (Proprietay licence)
 http://www.star-micronics.co.jp/service/s_print/starjavapos_win32-linux-macosx_yyyymmdd.zip.htm
     starjavapos.jar


-=- Office (Word, etc) File Handling __________________________________________________________________________________________________________________________

-OpenOffice UNO (LGPL)
  http://udk.openoffice.org/
  applications/content/lib/uno:
    XFlatXml.jar
    XMergeBridge.jar
    XSLTFilter.jar
    XSLTValidate.jar
    htmlsoff.jar
    java_uno.jar
    java_uno_accessbridge.jar
    juh.jar
    jurt.jar
    jut.jar
    officebean.jar
    ridl.jar
    unoil.jar
  TO BUILD comment out exclude: applications/content/build.xml:org/ofbiz/content/openoffice/*

-=- Accounting: Payment Processing ____________________________________________________________________________________________________________________________

-CyberSource
  applications/accounting/lib/cybersource:
    cybsclients.jar
    cybssecurity.jar
  TO BUILD comment out exclude: applications/accounting/build.xml:org/ofbiz/accounting/thirdparty/cybersource/**

-Securepay
  applications/accounting/lib/cybersource:
	Base64.jar
	securepayxmlapi_obf.jar
	xercesImpl-2.4.0.jar
	xmlParserAPIs-2.4.0.jar
  TO BUILD comment out exclude: applications/accounting/build.xml:org/ofbiz/accounting/thirdparty/securepay/**

-WorldPay
  applications/accounting/lib/worldpay:
    config
    config/currency.properties
    config/keystore
    config/keystore/wcc
    config/keystore/wcc/public-1.key
    config/keystore/wcc/revision
    cryptix-lib
    cryptix-lib/Cryptix.properties
    cryptix.jar
    ijce-lib
    ijce-lib/IJCE.properties
    ijce-lib/java.security.fallback
    ijce-lib/TargetHelp.html
    readme.txt
    select.jar
    select.properties
  TO BUILD comment out exclude: applications/accounting/build.xml:org/ofbiz/accounting/thirdparty/worldpay/**