Improved readme files.

svn changeset:3142/svn branch:trunk

diff --git a/build/package/linux-readme.txt b/build/package/linux-readme.txt
index ce4574fc707990d4a21c42596bb0cfd32cf88fa8..a92600c6ee42ac341df7c8fa91f0f94649e43753 100644 (file)
--- a/build/package/linux-readme.txt
+++ b/build/package/linux-readme.txt
@@ -1,20 +1,29 @@
-== IT Mill Toolkit <version></version> Readme ==\r
+==============================================================================\r
+IT Mill Toolkit <version></version> Readme\r
+==============================================================================\r
 \r
+-------------\r
 How to Start?\r
+-------------\r
 \r
-Open shell and execute "sh start.sh". This starts IT Mill Toolkit\r
-web application which guides your forward. \r
+Open a shell window, change to the installation directory, and execute "sh start.sh". It\r
+will start a web application at port 8888 on the local host and opens a web browser window\r
+to display the start page of IT Mill Toolkit Content Browser.\r
 \r
+The installation directory is a web application as itself and is directly importable to\r
+Eclipse IDE by selecting "File / Import / Existing Projects into Workspace" from Eclipse\r
+main menu. See the manual for detailed instructions.\r
 \r
+------------------------------------------\r
 What's Inside the IT Mill Toolkit Package?\r
+------------------------------------------\r
 \r
-You should start exploring IT Mill Toolkit through the provided web application\r
-within this package, see 'How to Start?' above. WebContent contains demos,\r
-documentation and other useful information to get started with IT Mill Toolkit.\r
+You should start exploring IT Mill Toolkit through the provided Content Browser web\r
+application within this package; see 'How to Start?' above.\r
 \r
-This directory is directly importable to Eclipse IDE using\r
-"File / Import / Existing Projects into Workspace" selection from Eclipse main\r
-menu.\r
+The WebContent directory contains the content available through the Content Browser: the\r
+IT Mill Toolkit Library, demos, documentation, and other useful information to get started\r
+with IT Mill Toolkit.\r
 \r
 Below is a list of most important locations and files:\r
 \r
@@ -25,39 +34,38 @@ COPYING
 - license file\r
 \r
 WebContent/WEB-INF/lib/itmill-toolkit-<version></version>.jar\r
-- IT Mill Toolkit library containing Java source and compiled files\r
+- IT Mill Toolkit Library containing Java source and compiled files\r
 \r
 WebContent/demo/itmill-toolkit.war\r
 - deployable demo application for your application server\r
 \r
 WebContent/doc/manual.pdf\r
-- manual in PDF format\r
+- IT Mill Toolkit Reference Manual in PDF format\r
 \r
 WebContent/doc/manual/index.html\r
-- manual in HTML format\r
+- IT Mill Toolkit Reference Manual in HTML format\r
 \r
 WebContent/doc/api/index.html\r
-- JavaDocs\r
+- IT Mill Toolkit API Documentation as JavaDoc reference\r
 \r
 WebContent/WEB-INF/src\r
-- demo source code, compiled into WebContent/WEB-INF/classes\r
+- Content Browser source code, compiled into WebContent/WEB-INF/classes\r
  \r
 WebContent/doc/example-source\r
-- example source in HTML format\r
+- example source code in HTML format\r
 \r
 WebContent/demo\r
-- files required by demos\r
+- files required by the demos\r
 \r
 IT Mill Toolkit Hosted Mode.launch\r
 IT Mill Toolkit Web Mode.launch\r
 - launch configurations for Eclipse workspace\r
 \r
 build-widgetsets.xml\r
-- builds GWT widgetsets for IT Mill Toolkit applications\r
+- builds GWT widget sets for IT Mill Toolkit applications\r
 \r
 WebContent/ITMILL\r
-- widgetsets and themes\r
+- widget sets and themes\r
 \r
 gwt\r
-- Google Web Toolkit is required for building new widgetsets\r
-\r
+- Google Web Toolkit is required for building new widget sets\r

diff --git a/build/package/mac-readme.txt b/build/package/mac-readme.txt
index d96a123ab0d79b6d1e72047f8c7051b3371ee748..210bf8c86617a5ac25e6242eec6e477ff0dd696a 100644 (file)
--- a/build/package/mac-readme.txt
+++ b/build/package/mac-readme.txt
@@ -1,22 +1,32 @@
-== IT Mill Toolkit <version></version> Readme ==\r
+==============================================================================\r
+IT Mill Toolkit <version></version> Readme\r
+==============================================================================\r
 \r
+-------------\r
 How to Start?\r
+-------------\r
 \r
-Just double-click Start IT Mill Toolkit icon. This starts IT Mill Toolkit\r
-web application which guides your forward. If for some reason start icon\r
-fails in your environment, another option is to open shell and execute\r
-"sh start.sh".\r
+Just double-click Start IT Mill Toolkit icon. It will start a web application at port 8888\r
+on the local host and opens a web browser window to display the start page of IT Mill\r
+Toolkit Content Browser.\r
 \r
+If the start icon fails in your environment for some reason, another option is to open a\r
+shell window, change to the installation directory, and execute "sh start.sh".\r
 \r
+The installation directory is a web application as itself and is directly importable to\r
+Eclipse IDE by selecting "File / Import / Existing Projects into Workspace" from Eclipse\r
+main menu. See the manual for detailed instructions.\r
+\r
+------------------------------------------\r
 What's Inside the IT Mill Toolkit Package?\r
+------------------------------------------\r
 \r
-You should start exploring IT Mill Toolkit through the provided web application\r
-within this package, see 'How to Start?' above. WebContent contains demos,\r
-documentation and other useful information to get started with IT Mill Toolkit.\r
+You should start exploring IT Mill Toolkit through the provided Content Browser web\r
+application within this package; see 'How to Start?' above.\r
 \r
-This directory is directly importable to Eclipse IDE using\r
-"File / Import / Existing Projects into Workspace" selection from Eclipse main\r
-menu.\r
+The WebContent directory contains the content available through the Content Browser: the\r
+IT Mill Toolkit Library, demos, documentation, and other useful information to get started\r
+with IT Mill Toolkit.\r
 \r
 Below is a list of most important locations and files:\r
 \r
@@ -27,39 +37,38 @@ COPYING
 - license file\r
 \r
 WebContent/WEB-INF/lib/itmill-toolkit-<version></version>.jar\r
-- IT Mill Toolkit library containing Java source and compiled files\r
+- IT Mill Toolkit Library containing Java source and compiled files\r
 \r
 WebContent/demo/itmill-toolkit.war\r
 - deployable demo application for your application server\r
 \r
 WebContent/doc/manual.pdf\r
-- manual in PDF format\r
+- IT Mill Toolkit Reference Manual in PDF format\r
 \r
 WebContent/doc/manual/index.html\r
-- manual in HTML format\r
+- IT Mill Toolkit Reference Manual in HTML format\r
 \r
 WebContent/doc/api/index.html\r
-- JavaDocs\r
+- IT Mill Toolkit API Documentation as JavaDoc reference\r
 \r
 WebContent/WEB-INF/src\r
-- demo source code, compiled into WebContent/WEB-INF/classes\r
+- Content Browser source code, compiled into WebContent/WEB-INF/classes\r
  \r
 WebContent/doc/example-source\r
-- example source in HTML format\r
+- example source code in HTML format\r
 \r
 WebContent/demo\r
-- files required by demos\r
+- files required by the demos\r
 \r
 IT Mill Toolkit Hosted Mode.launch\r
 IT Mill Toolkit Web Mode.launch\r
 - launch configurations for Eclipse workspace\r
 \r
 build-widgetsets.xml\r
-- builds GWT widgetsets for IT Mill Toolkit applications\r
+- builds GWT widget sets for IT Mill Toolkit applications\r
 \r
 WebContent/ITMILL\r
-- widgetsets and themes\r
+- widget sets and themes\r
 \r
 gwt\r
-- Google Web Toolkit is required for building new widgetsets\r
-\r
+- Google Web Toolkit is required for building new widget sets\r

diff --git a/build/package/windows-readme.txt b/build/package/windows-readme.txt
index 3250ba4813d4b60012ee4610ed9a3d5b4cafbf8f..023727a6f29911b3c924f38e921e930e9c93f18e 100644 (file)
--- a/build/package/windows-readme.txt
+++ b/build/package/windows-readme.txt
@@ -1,20 +1,29 @@
-== IT Mill Toolkit <version></version> Readme ==\r
+==============================================================================\r
+IT Mill Toolkit <version></version> Readme\r
+==============================================================================\r
 \r
+-------------\r
 How to Start?\r
+-------------\r
 \r
-Just double-click start.bat icon. This starts IT Mill Toolkit web application\r
-which guides your forward.\r
+Just double-click start.bat icon. It will start a web application at port 8888 on the\r
+local host and opens a web browser window to display the start page of IT Mill Toolkit\r
+Content Browser.\r
 \r
+The installation directory is a web application as itself and is directly importable to\r
+Eclipse IDE by selecting "File / Import / Existing Projects into Workspace" from Eclipse\r
+main menu. See the manual for detailed instructions.\r
 \r
+------------------------------------------\r
 What's Inside the IT Mill Toolkit Package?\r
+------------------------------------------\r
 \r
-You should start exploring IT Mill Toolkit through the provided web application\r
-within this package, see 'How to Start?' above. WebContent contains demos,\r
-documentation and other useful information to get started with IT Mill Toolkit.\r
+You should start exploring IT Mill Toolkit through the provided Content Browser web\r
+application within this package; see 'How to Start?' above.\r
 \r
-This directory is directly importable to Eclipse IDE using\r
-"File / Import / Existing Projects into Workspace" selection from Eclipse main\r
-menu.\r
+The WebContent directory contains the content available through the Content Browser: the\r
+IT Mill Toolkit Library, demos, documentation, and other useful information to get started\r
+with IT Mill Toolkit.\r
 \r
 Below is a list of most important locations and files:\r
 \r
@@ -25,39 +34,38 @@ COPYING
 - license file\r
 \r
 WebContent/WEB-INF/lib/itmill-toolkit-<version></version>.jar\r
-- IT Mill Toolkit library containing Java source and compiled files\r
+- IT Mill Toolkit Library containing Java source and compiled files\r
 \r
 WebContent/demo/itmill-toolkit.war\r
 - deployable demo application for your application server\r
 \r
 WebContent/doc/manual.pdf\r
-- manual in PDF format\r
+- IT Mill Toolkit Reference Manual in PDF format\r
 \r
 WebContent/doc/manual/index.html\r
-- manual in HTML format\r
+- IT Mill Toolkit Reference Manual in HTML format\r
 \r
 WebContent/doc/api/index.html\r
-- JavaDocs\r
+- IT Mill Toolkit API Documentation as JavaDoc reference\r
 \r
 WebContent/WEB-INF/src\r
-- demo source code, compiled into WebContent/WEB-INF/classes\r
+- Content Browser source code, compiled into WebContent/WEB-INF/classes\r
  \r
 WebContent/doc/example-source\r
-- example source in HTML format\r
+- example source code in HTML format\r
 \r
 WebContent/demo\r
-- files required by demos\r
+- files required by the demos\r
 \r
 IT Mill Toolkit Hosted Mode.launch\r
 IT Mill Toolkit Web Mode.launch\r
 - launch configurations for Eclipse workspace\r
 \r
 build-widgetsets.xml\r
-- builds GWT widgetsets for IT Mill Toolkit applications\r
+- builds GWT widget sets for IT Mill Toolkit applications\r
 \r
 WebContent/ITMILL\r
-- widgetsets and themes\r
+- widget sets and themes\r
 \r
 gwt\r
-- Google Web Toolkit is required for building new widgetsets\r
-\r
+- Google Web Toolkit is required for building new widget sets\r