Added and improved READMEs for modules whihc used to be in libs-extern

27 files changed, 66 insertions, 26 deletions

diff --git a/afms/README b/afms/README
new file mode 100644
index 000000000000..5bfbbbb19a4a
--- /dev/null
+++ b/afms/README
@@ -0,0 +1 @@
+External library.
diff --git a/apple_remote/README b/apple_remote/README
new file mode 100644
index 000000000000..8705e88c54e1
--- /dev/null
+++ b/apple_remote/README
@@ -0,0 +1 @@
+Adds support for the Apple Remote (a remote control) to control Impress.
diff --git a/beanshell/README b/beanshell/README
new file mode 100644
index 000000000000..0b03fd35ad58
--- /dev/null
+++ b/beanshell/README
@@ -0,0 +1,4 @@
+Java interpreter from [http://www.beanshell.org/] with some patches.
+
+So you can write java in command shell; interactive java good for prototyping/macros.
+
diff --git a/cppunit/README b/cppunit/README
new file mode 100644
index 000000000000..f71c260e6839
--- /dev/null
+++ b/cppunit/README
@@ -0,0 +1,3 @@
+C++ port of the JUnit framework for unit testing.
+
+From [http://sourceforge.net/projects/cppunit/]
diff --git a/epm/README b/epm/README
new file mode 100644
index 000000000000..c3ec2986e7d4
--- /dev/null
+++ b/epm/README
@@ -0,0 +1,3 @@
+Enhanced Package Manager, From [http://freshmeat.net/projects/epm]
+
+Nasty hack for packaging, not useful, but default build uses, every linux packager disables this.
diff --git a/hsqldb/README b/hsqldb/README
new file mode 100644
index 000000000000..8e43980bc99a
--- /dev/null
+++ b/hsqldb/README
@@ -0,0 +1,5 @@
+Java database engine from [http://hsqldb.org/].
+
+Default database format for OpenOffice.org.
+Also used in LibreOffice but shall be replaced as default by SQLite.
+
diff --git a/hyphen/README b/hyphen/README
new file mode 100644
index 000000000000..327b5b6e8954
--- /dev/null
+++ b/hyphen/README
@@ -0,0 +1 @@
+Hyphenator library from [http://hunspell.sourceforge.net]
diff --git a/icc/README b/icc/README
index 672371d411ad..0c1a7301226e 100644
--- a/icc/README
+++ b/icc/README
@@ -1,15 +1,16 @@
-Date: 2008-01-11
+Library used to build the sRGB profile for PDF/A-1a export with patches.
 
 This project is used to generate the ICC color
 profile needed in module vcl in order to export
 to PDF/A-1a.
-It's composed of a small application, which lurks in:
 
-icc/source/create_sRGB_profile
+It's composed of a small application, which lurks in:
+[git:icc/source/create_sRGB_profile]
 
 That application links to a support library
 (icc/download/SampleICC-1.3.2), build at OOo
 build time.
+
 Finally, the application is run at OOo build time to
 generate the only file delivered to solver:
 sRGB-IEC61966-2.1.hxx.
@@ -17,23 +18,20 @@ sRGB-IEC61966-2.1.hxx.
 If you need to change the data into the ICC profile,
 please change the create_sRGB_profile.
 
-The library was downloaded from:
-http://sampleicc.sourceforge.net
-on 2007-08-23.
+The library was downloaded from [http://sampleicc.sourceforge.net] on 2007-08-23.
 
 For information on ICC profiles, you may want to visit:
-http://www.color.org
+[http://www.color.org]
 
-Notes for porters
-=================
-the endianess and other platform specific configuration
+== Notes for porters ==
+
+Ehe endianess and other platform specific configuration
 are in:
 
-<build>/misc/build/SampleICC-1.3.2/IccProfLib/IccProfLibConf.h
+icc/<build>/misc/build/SampleICC-1.3.2/IccProfLib/IccProfLibConf.h
 
 The patchs:
 SampleICC-1.3.2.patch tweaks the build to use the endianness
 detected in sal.
 
 beppec56@openoffice.org
-
diff --git a/libwpd/README b/libwpd/README
new file mode 100644
index 000000000000..2cc9c8a18b8b
--- /dev/null
+++ b/libwpd/README
@@ -0,0 +1 @@
+From [http://libwpd.sourceforge.net/]. Not modified. WordPerfect filter - SAX api - emits callbacks when things happen. 
diff --git a/libwpg/README b/libwpg/README
new file mode 100644
index 000000000000..19a154dd4d44
--- /dev/null
+++ b/libwpg/README
@@ -0,0 +1 @@
+From [http://libwpg.sourceforge.net/]. WordPerfect graphics filter. 
diff --git a/libwps/README b/libwps/README
new file mode 100644
index 000000000000..3ce52187d520
--- /dev/null
+++ b/libwps/README
@@ -0,0 +1 @@
+Microsoft Works file word processor format import library from [http://libwps.sourceforge.net/].
diff --git a/libxmlsec/readme.txt b/libxmlsec/README
index 55c6976f51f3..2484bf2300e4 100644
--- a/libxmlsec/readme.txt
+++ b/libxmlsec/README
@@ -1,3 +1,5 @@
+XML signing, etc. From [http://www.aleksey.com/xmlsec/]. Heavily patched.
+
 The XML Security library has been modified, so that there is NO verification of
 the certificate during sign or verification operation. On Windows this was done
 in the function xmlSecMSCryptoX509StoreVerify (file src/mscrypto/x509vfy.c) and
diff --git a/lpsolve/README b/lpsolve/README
new file mode 100644
index 000000000000..3ef9db3e1cdd
--- /dev/null
+++ b/lpsolve/README
@@ -0,0 +1 @@
+A mixed Integer Linear Programming (MILP) solver from [http://lpsolve.sourceforge.net/].
diff --git a/lucene/README b/lucene/README
new file mode 100644
index 000000000000..3948ffcbb70f
--- /dev/null
+++ b/lucene/README
@@ -0,0 +1 @@
+From [http://lucene.apache.org/]. (CH: What of it is used for what ???)
diff --git a/mdds/README b/mdds/README
new file mode 100644
index 000000000000..22478ada4247
--- /dev/null
+++ b/mdds/README
@@ -0,0 +1 @@
+Multi-dimensional data structure (mdds) library, available from [http://code.google.com/p/multidimalgorithm/].
diff --git a/mysqlcppconn/README b/mysqlcppconn/README
new file mode 100644
index 000000000000..fb6207857a4c
--- /dev/null
+++ b/mysqlcppconn/README
@@ -0,0 +1 @@
+From [http://forge.mysql.com/wiki/Connector_C%2B%2B]
diff --git a/mythes/README b/mythes/README
new file mode 100644
index 000000000000..8a1792ee05b3
--- /dev/null
+++ b/mythes/README
@@ -0,0 +1 @@
+Library for handling thesaurus files from [http://hunspell.sourceforge.net].
diff --git a/np_sdk/README b/np_sdk/README
new file mode 100644
index 000000000000..da63135a8f86
--- /dev/null
+++ b/np_sdk/README
@@ -0,0 +1 @@
+Netscape Plugin SDK. Header to build Mozilla plugins.
diff --git a/openssl/README b/openssl/README
new file mode 100644
index 000000000000..399bdd56fded
--- /dev/null
+++ b/openssl/README
@@ -0,0 +1,7 @@
+Open Source toolkit implementing SSL and TLS.
+
+From [http://www.openssl.org/].
+
+SSL = Secure Sockets Layer (SSL v2/v3) protocol.
+TLS = Transport Layer Security (TLS v1) protocol.
+
diff --git a/redland/README b/redland/README
index 87299ebf1fd4..6ea6f953ca2c 100644
--- a/redland/README
+++ b/redland/README
@@ -1,14 +1,11 @@
-Redland RDF library (librdf)
+Redland RDF library (librdf) from [http://librdf.org/]
 
-Module: external/redland
+== License ==
+[git:redland/LICENSE.txt]
+Triple-licensed: LGPL v2+/GPL v2+/Apache v2
+Note that Sun distributes this software only under LGPL v2
 
-Upstream URL: http://librdf.org/
-
-License: Triple-licensed: LGPL v2+/GPL v2+/Apache v2
-         Note that Sun distributes this software only under LGPL v2
-         (see LICENSE.txt)
-
-Description:
+== Description ==
 This module contains the third-party Redland RDF / librdf library, which
 is needed to support data in RDF (Resource Description Framework) format.
 It consists of 3 parts:
@@ -19,9 +16,10 @@ It consists of 3 parts:
 
 Libraries: libraptor, librasqal, librdf
 
-Patches:
+== Patches ==
 There are several patches, most of which contain only hacks to get it to
 build with OOo build system.
+
 There used to be also 3 patches here that fix bugs in redland and ought to be
 of general interest:
 - redland-1.0.8.patch.free_null:
@@ -32,6 +30,7 @@ of general interest:
 - redland-1.0.8.patch.storage_hashes_list_duplicates:
   hashes, list storage: if contexts are enabled, then it is possible to add
                         duplicate statements
+
 Attempts to upstream these patches failed for reasons upstream kept to
 themselves.  Now these patches are replaced with workarounds in unoxml.
 Note to future maintainers: work around redland bugs in client code.
diff --git a/rhino/README b/rhino/README
index ae212c9174f7..83e4135d0b89 100644
--- a/rhino/README
+++ b/rhino/README
@@ -1,6 +1,8 @@
-The Scripting Framework makes use of the Rhino (http://www.mozilla.org/rhino/)
+JavaScript engine/interpreter written in Java, used to provide JavaScript extensions.
+
+The Scripting Framework makes use of the Rhino ([http://www.mozilla.org/rhino/])
 JavaScript interpreter, available under the Mozilla Public License
-(http://www.mozilla.org/MPL/MPL-1.1.html).
+([http://www.mozilla.org/MPL/MPL-1.1.html]).
 
 In addition, to support the debugging of scripts contained in OpenOffice.org
 documents, we have modified the Java source file Main.java.
diff --git a/sane/README b/sane/README
new file mode 100644
index 000000000000..eda976da10ba
--- /dev/null
+++ b/sane/README
@@ -0,0 +1 @@
+Scanner library from [http://www.sane-project.org/]
diff --git a/twain/README b/twain/README
new file mode 100644
index 000000000000..5d45a5009e98
--- /dev/null
+++ b/twain/README
@@ -0,0 +1 @@
+Windows scanner support.
diff --git a/unixODBC/README b/unixODBC/README
new file mode 100644
index 000000000000..5f01f07ccb48
--- /dev/null
+++ b/unixODBC/README
@@ -0,0 +1 @@
+Library and API with which to access Data Sources from [http://www.unixodbc.org/]
diff --git a/vigra/README b/vigra/README
new file mode 100644
index 000000000000..165bae487bc6
--- /dev/null
+++ b/vigra/README
@@ -0,0 +1 @@
+Computer vision library in C++ from [http://hci.iwr.uni-heidelberg.de/vigra/].
diff --git a/x11_extensions/README b/x11_extensions/README
new file mode 100644
index 000000000000..5f342067ddd4
--- /dev/null
+++ b/x11_extensions/README
@@ -0,0 +1 @@
+Headers for XRender support
diff --git a/xsltml/README b/xsltml/README
index b991b220dad4..ab22e5e59edc 100755
--- a/xsltml/README
+++ b/xsltml/README
@@ -1,4 +1,4 @@
-Date: 2009-02-19
+XSLT MathML Library from [http://xsltml.sourceforge.net/].
 
 This project is used in the Wiki filter that is installed
 with the WikiPublisher extension. The extension is built
@@ -9,6 +9,6 @@ related files that are used by the filter to transform
 embedded formula objects into media wiki format.
 
 The archive was downloaded from:
-http://xsltml.sourceforge.net
+[http://xsltml.sourceforge.net]
 on 2009-02-16.