Mailing-List: contact connectors-commits-help@incubator.apache.org;
 run by ezmlm
Precedence: bulk
Reply-To: connectors-dev@incubator.apache.org
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Subject: svn commit: r1056116 - in /incubator/lcf/trunk: ./
 connectors/documentum/dfc/ connectors/documentum/upstream-diffs/
 connectors/filenet/filenet-api/ connectors/filenet/upstream-diffs/
 connectors/jcifs/jcifs/ connectors/jcifs/upstream-diffs/ connectors/j...
Date: Thu, 06 Jan 2011 23:21:02 -0000
To: connectors-commits@incubator.apache.org
From: kwright@apache.org
Message-Id: <20110106232102.7863F2388900@eris.apache.org>

Author: kwright
Date: Thu Jan  6 23:21:01 2011
New Revision: 1056116

URL: http://svn.apache.org/viewvc?rev=1056116&view=rev
Log:
Fix for CONNECTORS-134.

Added:
    incubator/lcf/trunk/connectors/documentum/dfc/README.txt
      - copied, changed from r1055956, incubator/lcf/trunk/connectors/documentum/upstream-diffs/README
    incubator/lcf/trunk/connectors/filenet/filenet-api/README.txt
      - copied, changed from r1055956, incubator/lcf/trunk/connectors/filenet/upstream-diffs/README
    incubator/lcf/trunk/connectors/jcifs/jcifs/README.txt
      - copied, changed from r1055956, incubator/lcf/trunk/connectors/jcifs/upstream-diffs/README
    incubator/lcf/trunk/connectors/jcifs/jcifs/jcifs.diffs
      - copied unchanged from r1055956, incubator/lcf/trunk/connectors/jcifs/upstream-diffs/jcifs.diffs
    incubator/lcf/trunk/connectors/jdbc/jdbc-drivers/README.txt
      - copied, changed from r1055956, incubator/lcf/trunk/connectors/jdbc/upstream-diffs/README
    incubator/lcf/trunk/connectors/livelink/lapi/README.txt
      - copied, changed from r1055956, incubator/lcf/trunk/connectors/livelink/upstream-diffs/README
    incubator/lcf/trunk/connectors/memex/mxie-java/README.txt
      - copied, changed from r1055956, incubator/lcf/trunk/connectors/memex/upstream-diffs/README
    incubator/lcf/trunk/connectors/meridio/wsdls/DMDataSet.xsd.xmldiff
      - copied, changed from r1055956, incubator/lcf/trunk/connectors/meridio/upstream-diffs/DMDataSet.xsd.xmldiff
    incubator/lcf/trunk/connectors/meridio/wsdls/MeridioDMWS_axis.wsdl.xmldiff
      - copied, changed from r1055956, incubator/lcf/trunk/connectors/meridio/upstream-diffs/MeridioDMWS_axis.wsdl.xmldiff
    incubator/lcf/trunk/connectors/meridio/wsdls/MeridioRMWS_axis.wsdl.xmldiff
      - copied, changed from r1055956, incubator/lcf/trunk/connectors/meridio/upstream-diffs/MeridioRMWS_axis.wsdl.xmldiff
    incubator/lcf/trunk/connectors/meridio/wsdls/README.txt
      - copied, changed from r1055956, incubator/lcf/trunk/connectors/meridio/upstream-diffs/README
    incubator/lcf/trunk/connectors/meridio/wsdls/RMClassificationDataSet.xsd.xmldiff
      - copied, changed from r1055956, incubator/lcf/trunk/connectors/meridio/upstream-diffs/RMClassificationDataSet.xsd.xmldiff
    incubator/lcf/trunk/connectors/meridio/wsdls/RMDataSet.xsd.xmldiff
      - copied, changed from r1055956, incubator/lcf/trunk/connectors/meridio/upstream-diffs/RMDataSet.xsd.xmldiff
    incubator/lcf/trunk/connectors/sharepoint/wsdls/README.txt
      - copied, changed from r1055956, incubator/lcf/trunk/connectors/sharepoint/upstream-diffs/README
Removed:
    incubator/lcf/trunk/connectors/documentum/upstream-diffs/
    incubator/lcf/trunk/connectors/filenet/upstream-diffs/
    incubator/lcf/trunk/connectors/jcifs/upstream-diffs/
    incubator/lcf/trunk/connectors/jdbc/upstream-diffs/
    incubator/lcf/trunk/connectors/livelink/upstream-diffs/
    incubator/lcf/trunk/connectors/memex/upstream-diffs/
    incubator/lcf/trunk/connectors/meridio/upstream-diffs/
    incubator/lcf/trunk/connectors/sharepoint/upstream-diffs/
Modified:
    incubator/lcf/trunk/CHANGES.txt

Modified: incubator/lcf/trunk/CHANGES.txt
URL: http://svn.apache.org/viewvc/incubator/lcf/trunk/CHANGES.txt?rev=1056116&r1=1056115&r2=1056116&view=diff
==============================================================================
--- incubator/lcf/trunk/CHANGES.txt (original)
+++ incubator/lcf/trunk/CHANGES.txt Thu Jan  6 23:21:01 2011
@@ -14,6 +14,11 @@ forget the index state for an output con
 ======================= Release 0.1 =======================
 Release Date:  See http://incubator.apache.org/connectors for the official release date.
 
+CONNECTORS-134: Put README.txt files in all empty directories that are meant
+for a user to supply third-party content.  This prevents the archive from not
+delivering an empty directory.
+(Ant Elder, Sebb, Karl Wright)
+
 CONNECTORS-133: Update README.txt to include incubator disclaimer.
 (Ant Elder, Sebb, Karl Wright)
 

Copied: incubator/lcf/trunk/connectors/documentum/dfc/README.txt (from r1055956, incubator/lcf/trunk/connectors/documentum/upstream-diffs/README)
URL: http://svn.apache.org/viewvc/incubator/lcf/trunk/connectors/documentum/dfc/README.txt?p2=incubator/lcf/trunk/connectors/documentum/dfc/README.txt&p1=incubator/lcf/trunk/connectors/documentum/upstream-diffs/README&r1=1055956&r2=1056116&rev=1056116&view=diff
==============================================================================
--- incubator/lcf/trunk/connectors/documentum/upstream-diffs/README (original)
+++ incubator/lcf/trunk/connectors/documentum/dfc/README.txt Thu Jan  6 23:21:01 2011
@@ -13,9 +13,26 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-Portions of this package (namely, the documentum-server process) depend on the Documentum Foundation Classes.  DFC does not in general change their API much between revs, but the underlying software may change quite a bit, and the versions of Documentum that will work with each revision also change (as would be expected).  The code that's included here was tested against DFC 5.3.5 SP2.
+Portions of this package (namely, the documentum-server process) depend on the
+Documentum Foundation Classes.  DFC does not in general change their API much
+between revs, but the underlying software may change quite a bit, and the versions
+of Documentum that will work with each revision also change (as would be expected).
+
+In order to build all the classes and processes for this connector, you must install a
+version of Documentum's DFC on your system, and then locate the pertinent jars.
+The jars are described in the included Makefile.  Bear in mind that DFC has a JNI
+component as well, so the actual documentum-server process must include access
+to the appropriate dll's or so's in order to be functional.  This is accomplished by setting
+an environment variable before running the scripts that start the ManifoldCF
+documentum connector server process.  Read the "how-to-build-and-deploy.html"
+document for details.
+
+Copy all the jars that are needed to run your version of DFC into this directory, and
+the normal connector build should create all the artifacts you need to run the connector.
+
+The code that's included here was tested against DFC 5.3.5 SP2.
+
 
-In order to build all the classes and processes for this connector, you must install a version of Documentum's DFC on your system, and then locate the pertinent jars.  The jars are described in the included Makefile.  Bear in mind that DFC has a JNI component as well, so the actual documentum-server process must include access to the appropriate dll's or so's in order to be functional.
 
 
 

Copied: incubator/lcf/trunk/connectors/filenet/filenet-api/README.txt (from r1055956, incubator/lcf/trunk/connectors/filenet/upstream-diffs/README)
URL: http://svn.apache.org/viewvc/incubator/lcf/trunk/connectors/filenet/filenet-api/README.txt?p2=incubator/lcf/trunk/connectors/filenet/filenet-api/README.txt&p1=incubator/lcf/trunk/connectors/filenet/upstream-diffs/README&r1=1055956&r2=1056116&rev=1056116&view=diff
==============================================================================
--- incubator/lcf/trunk/connectors/filenet/upstream-diffs/README (original)
+++ incubator/lcf/trunk/connectors/filenet/filenet-api/README.txt Thu Jan  6 23:21:01 2011
@@ -13,7 +13,19 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-Portions of the FileNet connector need to be compiled against a set of jars delivered along with the FileNet API.  The version of the API seems to matter; bugs are pretty rampant, and small point releases seem to be needed to correct them.
+Portions of the FileNet connector need to be compiled against a set of jars
+delivered along with the FileNet API.  The version of the API seems to matter;
+bugs are pretty rampant, and small point releases seem to be needed to correct them.
 
-The version of the jars this connector was tested against come from Filenet P8 API 4.0.0 (P8CE-4.0.0-002-Win).  The jars were re-labeled with the prefix "ibm-" to avoid collision with the names of other jars, since many of them were common with other packages such as xerces, but had been modified in some way.
+Copy the filenet API jars into this directory, and build the connector using the
+provided ant build, and all processes should be built properly.  For some versions
+of P8, there is a dependency on WASP, whose location you will need to specify
+as an environment variable when you start the filenet connector server process.
+See the "how-to-build-and-deploy.html" documentation page for details.
+
+The version of the jars this connector was tested against code from Filenet
+P8 API 4.0.0 (P8CE-4.0.0-002-Win), and later with P8 4.5.0.  The jars were re-labeled
+with the prefix "ibm-" to avoid collision with the names of other jars, since many
+of them were common with other packages such as xerces, but had been modified
+in some way.
 

Copied: incubator/lcf/trunk/connectors/jcifs/jcifs/README.txt (from r1055956, incubator/lcf/trunk/connectors/jcifs/upstream-diffs/README)
URL: http://svn.apache.org/viewvc/incubator/lcf/trunk/connectors/jcifs/jcifs/README.txt?p2=incubator/lcf/trunk/connectors/jcifs/jcifs/README.txt&p1=incubator/lcf/trunk/connectors/jcifs/upstream-diffs/README&r1=1055956&r2=1056116&rev=1056116&view=diff
==============================================================================
--- incubator/lcf/trunk/connectors/jcifs/upstream-diffs/README (original)
+++ incubator/lcf/trunk/connectors/jcifs/jcifs/README.txt Thu Jan  6 23:21:01 2011
@@ -13,7 +13,13 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-For the jcifs connector, certain changes were made to jcifs itself to work reliably with Samba systems.  This set of upstream changes is encapsulated in the following file:
+For the jcifs connector, certain changes were made to jcifs itself to work reliably
+with Samba systems.  This set of upstream changes is encapsulated in the following file:
 
 jcifs.diffs, against version 1.3.9 as downloaded from http://jcifs.samba.org.
 
+To build this connector, copy the jcifs.jar into this directory, and build the connector
+using the standard ant build.  You can read more about the process on the
+"how-to-build-and-deploy.html" documentation page.
+
+

Copied: incubator/lcf/trunk/connectors/jdbc/jdbc-drivers/README.txt (from r1055956, incubator/lcf/trunk/connectors/jdbc/upstream-diffs/README)
URL: http://svn.apache.org/viewvc/incubator/lcf/trunk/connectors/jdbc/jdbc-drivers/README.txt?p2=incubator/lcf/trunk/connectors/jdbc/jdbc-drivers/README.txt&p1=incubator/lcf/trunk/connectors/jdbc/upstream-diffs/README&r1=1055956&r2=1056116&rev=1056116&view=diff
==============================================================================
--- incubator/lcf/trunk/connectors/jdbc/upstream-diffs/README (original)
+++ incubator/lcf/trunk/connectors/jdbc/jdbc-drivers/README.txt Thu Jan  6 23:21:01 2011
@@ -13,7 +13,8 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-The jdbc connector can, in theory, work with any JDBC driver that has been added into the list it knows about.  The code as granted knows about the following:
+The jdbc connector can, in theory, work with any JDBC driver that has been
+added into the list it knows about.  The code as granted knows about the following:
 
 Mssql/Sybase (via open-source jtds)
 Postgresql (via an appropriate open-source postgresql JDBC driver)
@@ -25,5 +26,12 @@ Oracle: oracle jdbc4 jdk1.4 version 10.1
 Jtds: version 1.2.2, downloadable from SourceForge
 Postgresql: the debian postgresql driver package for postgresql 8.3.7, aka libpg-java, version 8.2-504-2.
 
-None of these required upstream changes.
+None of these required custom changes.
+
+To build this connector with Oracle support, copy the Oracle JDBC
+driver into this directory before building.  To build with Mssql/Sybase,
+copy a version of the jtds driver into this directory.  Then, build the
+connector using the normal ant build script.  Further information can be
+found on the "how-to-build-and-deploy.html" documentation page.
+
 

Copied: incubator/lcf/trunk/connectors/livelink/lapi/README.txt (from r1055956, incubator/lcf/trunk/connectors/livelink/upstream-diffs/README)
URL: http://svn.apache.org/viewvc/incubator/lcf/trunk/connectors/livelink/lapi/README.txt?p2=incubator/lcf/trunk/connectors/livelink/lapi/README.txt&p1=incubator/lcf/trunk/connectors/livelink/upstream-diffs/README&r1=1055956&r2=1056116&rev=1056116&view=diff
==============================================================================
--- incubator/lcf/trunk/connectors/livelink/upstream-diffs/README (original)
+++ incubator/lcf/trunk/connectors/livelink/lapi/README.txt Thu Jan  6 23:21:01 2011
@@ -13,5 +13,10 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-The LiveLink connector requires a client library from OpenText in order to function.  The client jar is call lapi.jar, and the version we have tested against can be found in the LAPI 9.7.1 package from OpenText.
+The LiveLink connector requires a client library from OpenText in order to build and function.
+The client jar is call lapi.jar, and the version we have tested against can be found
+in the LAPI 9.7.1 package from OpenText.  Copy that jar to this directory, and build the
+connector using the standard ant build process.  More can be found in the
+"how-to-build-and-deploy.html" documentation page.
+
 

Copied: incubator/lcf/trunk/connectors/memex/mxie-java/README.txt (from r1055956, incubator/lcf/trunk/connectors/memex/upstream-diffs/README)
URL: http://svn.apache.org/viewvc/incubator/lcf/trunk/connectors/memex/mxie-java/README.txt?p2=incubator/lcf/trunk/connectors/memex/mxie-java/README.txt&p1=incubator/lcf/trunk/connectors/memex/upstream-diffs/README&r1=1055956&r2=1056116&rev=1056116&view=diff
==============================================================================
--- incubator/lcf/trunk/connectors/memex/upstream-diffs/README (original)
+++ incubator/lcf/trunk/connectors/memex/mxie-java/README.txt Thu Jan  6 23:21:01 2011
@@ -13,5 +13,13 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-The Memex connector requires compilation against a Memex client library, usually called JavaMXIELIB.jar.  The API for Memex Patriarch changes pretty dramatically between revisions.  The revision number this connector was written against was 1.3.0.
+The Memex connector is no longer distributed at the request of Memex, who
+is now owned by SAS.  If you have the Memex connector sources and an agreement
+from Memex, note that the Memex connector requires compilation against a Memex
+client library, usually called JavaMXIELIB.jar.  Copy that jar into this directory,
+and the sources for the connector into the directory above, and the normal
+connector ant build should build the connector.
+
+The API for Memex Patriarch changes pretty dramatically between revisions.
+The revision number this connector was written against was 1.3.0.
   
\ No newline at end of file

Copied: incubator/lcf/trunk/connectors/meridio/wsdls/DMDataSet.xsd.xmldiff (from r1055956, incubator/lcf/trunk/connectors/meridio/upstream-diffs/DMDataSet.xsd.xmldiff)
URL: http://svn.apache.org/viewvc/incubator/lcf/trunk/connectors/meridio/wsdls/DMDataSet.xsd.xmldiff?p2=incubator/lcf/trunk/connectors/meridio/wsdls/DMDataSet.xsd.xmldiff&p1=incubator/lcf/trunk/connectors/meridio/upstream-diffs/DMDataSet.xsd.xmldiff&r1=1055956&r2=1056116&rev=1056116&view=diff
==============================================================================
Binary files - no diff available.

Copied: incubator/lcf/trunk/connectors/meridio/wsdls/MeridioDMWS_axis.wsdl.xmldiff (from r1055956, incubator/lcf/trunk/connectors/meridio/upstream-diffs/MeridioDMWS_axis.wsdl.xmldiff)
URL: http://svn.apache.org/viewvc/incubator/lcf/trunk/connectors/meridio/wsdls/MeridioDMWS_axis.wsdl.xmldiff?p2=incubator/lcf/trunk/connectors/meridio/wsdls/MeridioDMWS_axis.wsdl.xmldiff&p1=incubator/lcf/trunk/connectors/meridio/upstream-diffs/MeridioDMWS_axis.wsdl.xmldiff&r1=1055956&r2=1056116&rev=1056116&view=diff
==============================================================================
Binary files - no diff available.

Copied: incubator/lcf/trunk/connectors/meridio/wsdls/MeridioRMWS_axis.wsdl.xmldiff (from r1055956, incubator/lcf/trunk/connectors/meridio/upstream-diffs/MeridioRMWS_axis.wsdl.xmldiff)
URL: http://svn.apache.org/viewvc/incubator/lcf/trunk/connectors/meridio/wsdls/MeridioRMWS_axis.wsdl.xmldiff?p2=incubator/lcf/trunk/connectors/meridio/wsdls/MeridioRMWS_axis.wsdl.xmldiff&p1=incubator/lcf/trunk/connectors/meridio/upstream-diffs/MeridioRMWS_axis.wsdl.xmldiff&r1=1055956&r2=1056116&rev=1056116&view=diff
==============================================================================
Binary files - no diff available.

Copied: incubator/lcf/trunk/connectors/meridio/wsdls/README.txt (from r1055956, incubator/lcf/trunk/connectors/meridio/upstream-diffs/README)
URL: http://svn.apache.org/viewvc/incubator/lcf/trunk/connectors/meridio/wsdls/README.txt?p2=incubator/lcf/trunk/connectors/meridio/wsdls/README.txt&p1=incubator/lcf/trunk/connectors/meridio/upstream-diffs/README&r1=1055956&r2=1056116&rev=1056116&view=diff
==============================================================================
--- incubator/lcf/trunk/connectors/meridio/upstream-diffs/README (original)
+++ incubator/lcf/trunk/connectors/meridio/wsdls/README.txt Thu Jan  6 23:21:01 2011
@@ -13,15 +13,21 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-This connector requires someone obtain correct versions of the appropriate wsdls and xsds before it can be built.  This will require two utilities from Microsoft.  The first is "disco.exe", which is a web-service discovery utility.  The second is a Microsoft xml difference utility called xmldiffpatch.
+This connector requires someone obtain correct versions of the appropriate wsdls
+and xsds before it can be built.  This will require two utilities from Microsoft.  The
+first is "disco.exe", which is a web-service discovery utility.  The second is a
+Microsoft xml difference utility called xmldiffpatch.
 
-disco.exe can be found under c:\Program Files\Microsoft SDKs\Windows\V6.x\bin, after Visual Studio is installed.  The xml diff utility used is downloadable from:
+disco.exe can be found under c:\Program Files\Microsoft SDKs\Windows\V6.x\bin,
+after Visual Studio is installed.  The xml diff utility used is downloadable from:
 
 http://msdn.microsoft.com/en-us/library/aa302294.aspx
 
 Patches are meant to be applied using the xmlpatch.exe also included in the same package.
 
-The Meridio version this comparision applies to is Meridio 5.0 SR 1.  With that version of Meridio correctly installed, run the following disco commands, as modified with the correct server name, credentials, and output directory:
+The Meridio version this comparision applies to is Meridio 5.0 SR 1.  With that version
+of Meridio correctly installed, run the following disco commands, as modified with the
+correct server name, credentials, and output directory:
 
 disco /out:<output_directory> /username:<user_name> /password:<password> /domain:<domain> "http://<server_name>/DMWS/MeridioDMWS.asmx"
 disco /out:<output_directory> /username:<user_name> /password:<password> /domain:<domain> "http://<server_name>/RMWS/MeridioRMWS.asmx"

Copied: incubator/lcf/trunk/connectors/meridio/wsdls/RMClassificationDataSet.xsd.xmldiff (from r1055956, incubator/lcf/trunk/connectors/meridio/upstream-diffs/RMClassificationDataSet.xsd.xmldiff)
URL: http://svn.apache.org/viewvc/incubator/lcf/trunk/connectors/meridio/wsdls/RMClassificationDataSet.xsd.xmldiff?p2=incubator/lcf/trunk/connectors/meridio/wsdls/RMClassificationDataSet.xsd.xmldiff&p1=incubator/lcf/trunk/connectors/meridio/upstream-diffs/RMClassificationDataSet.xsd.xmldiff&r1=1055956&r2=1056116&rev=1056116&view=diff
==============================================================================
Binary files - no diff available.

Copied: incubator/lcf/trunk/connectors/meridio/wsdls/RMDataSet.xsd.xmldiff (from r1055956, incubator/lcf/trunk/connectors/meridio/upstream-diffs/RMDataSet.xsd.xmldiff)
URL: http://svn.apache.org/viewvc/incubator/lcf/trunk/connectors/meridio/wsdls/RMDataSet.xsd.xmldiff?p2=incubator/lcf/trunk/connectors/meridio/wsdls/RMDataSet.xsd.xmldiff&p1=incubator/lcf/trunk/connectors/meridio/upstream-diffs/RMDataSet.xsd.xmldiff&r1=1055956&r2=1056116&rev=1056116&view=diff
==============================================================================
Binary files - no diff available.

Copied: incubator/lcf/trunk/connectors/sharepoint/wsdls/README.txt (from r1055956, incubator/lcf/trunk/connectors/sharepoint/upstream-diffs/README)
URL: http://svn.apache.org/viewvc/incubator/lcf/trunk/connectors/sharepoint/wsdls/README.txt?p2=incubator/lcf/trunk/connectors/sharepoint/wsdls/README.txt&p1=incubator/lcf/trunk/connectors/sharepoint/upstream-diffs/README&r1=1055956&r2=1056116&rev=1056116&view=diff
==============================================================================
--- incubator/lcf/trunk/connectors/sharepoint/upstream-diffs/README (original)
+++ incubator/lcf/trunk/connectors/sharepoint/wsdls/README.txt Thu Jan  6 23:21:01 2011
@@ -36,7 +36,10 @@ disco /out:<output_directory> "http://<s
 disco /out:<output_directory> "http://<server_name>/_vti_bin/Lists.asmx"
 disco /out:<output_directory> "http://<server_name>/_vti_bin/versions.asmx"
 
-The Permissions.wsdl file should be placed in TWO places: under products/connectors/sharepoint, and also under products/connectors/sharepoint/webservice/Web References/SPPermissionsService.  All other wsdls should go just in products/connectors/sharepoint.  The Permissions.disco file also needs to be placed in products/connectors/sharepoint/webservice/Web References/SPPermissionsService.
+The Permissions.wsdl file should be placed in TWO places: under this directory,
+and also under connectors/sharepoint/webservice/Web References/SPPermissionsService.
+All other wsdls should go just in this directory.  The Permissions.disco file also
+needs to be placed in connectors/sharepoint/webservice/Web References/SPPermissionsService.