[Libreoffice-commits] .: idlc/README solenv/README unodevtools/README

[Michael Meeks]

 idlc/README        |    6 +++++-
 solenv/README      |   48 ++++++++++++++++++++++++++++++++++++++++++++++++
 unodevtools/README |    6 ++++++
 3 files changed, 59 insertions(+), 1 deletion(-)

New commits:
commit 534b3a9b2e828401ff69500a54f894e1cad4a78d
Author: Michael Meeks <michael.meeks at suse.com>
Date:   Tue Mar 6 11:07:48 2012 +0000

    idle code documentation improvement

diff --git a/idlc/README b/idlc/README
index 877702a..1b4c1f7 100644
--- a/idlc/README
+++ b/idlc/README
@@ -1,2 +1,6 @@
-Contains the IDL compiler.
+Contains the C++ IDL compiler: idlcpp
 
+This compiler generates C++ headers - .hpp and .hdl files that provide
+the UNO C++ binding. That compilation is done primarily in the offapi
+and udkapi directories.
+2
diff --git a/solenv/README b/solenv/README
new file mode 100644
index 0000000..904c610
--- /dev/null
+++ b/solenv/README
@@ -0,0 +1,48 @@
+Tools and makefile fragments necessary for compilation
+
+This module contains many tools and makefile configuration pieces,
+critical for building LibreOffice:
+
+bin/
+	contains lots of tools used during the build:
+
+	build.pl
+		the top-level wrapper perl-script, from the dmake
+		days - we're incrementally removing this in favour
+		of gnumake
+
+	deliver.pl
+		copies files from old-style dmake packages into the
+		top-level 'solver' directory
+
+	concat-deps*
+		these aggregate, and remove duplicates from module
+		dependencies, to accelerate build times.
+
+	make_installer.pl
+		this script executes the compiled instructions from
+		the scp2/ module to create an installer, and/or to
+		do a local install for the smoketest.
+
+	linkoo
+		creates a forest of symlinks inside an install such
+		that a developer can re-compile in the source tree,
+		and re-run without re-installing (on Unix at least)
+
+gbuild/
+	the (shiny new) gnumake build makefile fragments we are
+	migrating the codebase to use.
+
+gdb/
+	lots of nice python helpers to make debugging -much- easier
+	that (eg.) print UCS2 strings as UTF-8 on the console to
+	help with debugging.
+
+inc/
+	old / increasingly obsolete dmake setup and includes, we are
+	trying to entirely rid ourselves of this
+
+src/
+	useful standard / re-usable component map files for components
+	which shouldn't export anything more than a few registration
+	symbols.
\ No newline at end of file
diff --git a/unodevtools/README b/unodevtools/README
new file mode 100644
index 0000000..f53328e
--- /dev/null
+++ b/unodevtools/README
@@ -0,0 +1,6 @@
+Helper tools for external UNO component developers
+
+This module contains some tools for people writing UNO components. In
+particular it will auto-generate skeletons for implementing UNO
+interfaces - that declare all the relevant methods leaving the code to
+be filled in. This can be done for C++ or Java.
\ No newline at end of file