svn commit: r14806 - /dev/openoffice/4.1.2-patch1/binaries/Linux32/Linux32.README.txt

[ma...@apache.org]

Author: marcus
Date: Sat Aug 13 21:01:10 2016
New Revision: 14806

Log:
Updated Readme file

Modified:
    dev/openoffice/4.1.2-patch1/binaries/Linux32/Linux32.README.txt

Modified: dev/openoffice/4.1.2-patch1/binaries/Linux32/Linux32.README.txt
==============================================================================
--- dev/openoffice/4.1.2-patch1/binaries/Linux32/Linux32.README.txt (original)
+++ dev/openoffice/4.1.2-patch1/binaries/Linux32/Linux32.README.txt Sat Aug 13 21:01:10 2016
@@ -1,83 +1,102 @@
-This hotfix consists of the following files:
- * The Linux32.README file you are reading
- * A repacement file, libtl.so, that you will need to install
- * The public signature file,libtl.so.asc, of the developer providing the repalcement file.
- * LICENSE.txt file
- * NOTICE.txt file
+General
+-------
+
+This hotfix ZIP file consists of the following files:
+
+ * LICENSE.txt		- Information about the Apache License v2
+ * Linux32.README.txt	- The file you are reading
+ * NOTICE.txt		- Software notes
+ * libtl.so		- Patch file that you will need to install
+ * libtl.so.asc		- Public signature file of the developer who built the patch file
+
+You can use whatever GPG tools you have to verify the signature against the information provided in the Apache OpenOffice KEYS file:
 
-You can use whatever gpg tools you have to verify the signature against the information
-provided in the Apache OpenOffice KEYS file -- 
 https://dist.apache.org/repos/dist/release/openoffice/KEYS
 
 
-This file provides basic instructions for installing the replacment file, libtl.so, into your existing Apache OpenOffice installation. You will need to do this replacement using a console (terminal) window and will likely need to use "root" (administrator) access to your system.
 
-0. Make sure OpenOffice is not being used.
+Prerequisites
+-------------
+
+Download the hotfix ZIP file to a location on your PC where it can be used and its content extracted.
+
+Example:
+User Jane downloaded and extracted the hotfix ZIP file from her browser window and saved it in a folder called "Downloads". The full path is:
+
+/home/jane/Downloads
+
+
+
+Installation Instructions
+-------------------------
+
+This file provides basic instructions for installing the patched file "libtl.so" into your existing Apache OpenOffice installation. You will need to do this replacement using a console (terminal) window and will likely need to use "root" (administrator) access to your system.
+
+
+0.  Make sure OpenOffice is not being used.
+
+1.  Open a console window and login as root with the following command:
+
+	$ su -
 
-1.  Open a console window and login to a console window as root.
-	Command in console window: su -
+2.  Locate where Apache OpenOffice is installed on your system:
+	a) If you already know where Apache OpenOffice is located on your system, navigate
+	   to that directory. Example:
 
-2.  Locate where Apache OpenOffic is installed on your system.
-	a)If you already know where Apache OpenOffice is located on your system, navigate
- 	to that directory. Example: "cd /opt/openoffice4". 
-    	b) If you do not know where Apache OpenOffice is located on your system, you
-	can use your package manager to find this, or use the "locate" comand to find the location.
+	$ cd /opt/openoffice4
 
-	Example: "locate openoffice".
+	b) If you do not know this, you can use your package manager (e.g., RPM) to find
+	   this, or use the "locate" command. Examples:
 
-	The locate command may produce a lot of output but at some point you should see
-	the actual location on your system where Apache OpenOffice is installed. 
-	Navigate to that location.
+	$ rpm -ql openoffice-core04-4.1.2-9782.i586 | grep libtl.so
+	$ locate openoffice | grep program
 
-3.  Navigate to the "program" subdirectory of your Apache OpenOffice installation
-    area.
-	For illustration, let's assume /opt/openoffice4 is the directory location of
-	OpenOffice. Navigate to the "program" subdirectory. 
-	Command: cd /opt/openoffice4"program"
+	The commands show you the "program" sub-directory where Apache OpenOffice is
+	installed.
 
-4.  List the files in the Apache OpenOffice program subdirectory.
-	Command: "ls"
+	For illustration, let's assume "/opt/openoffice4" is the directory location of
+	OpenOffice. Navigate to the "program" sub-directory:
 
-	You should see a file called "libtl.so".
+3.  Navigate to the "program" sub-directory of your Apache OpenOffice installation:
 
-5.  Make a backup of the existing libtl.so by renaming it.
-	You can leave this renamed libtl.so where it is if you like.
-	Command: "mv libtl.so libtl.so.orig"
+	$ cd /opt/openoffice4/program
 
-6.  Save the libtl.so provided in this area to your Apache OpenOffice program folder.
+4.  List the files in the Apache OpenOffice program sub-directory:
 
-	You should download the libtl.so provided here as a non-root user. Then using
-	your root console window already open, copy it from the downloaded location to
-	the Apache OpenOffice program folder.
+	$ ls
 
-	Examples: User jane downloaded libtl.so from her browser window and saved it in 
-	a folder called "Downloads". The full path to Jane's Download area is:
-	/home/jane/Downloads.
+	You should see a file listed as "libtl.so".
 
-	Still in the root console window in the Apache OpenOffice "program" folder, 
-	use the following command:
+5.  Make a backup of the existing file by renaming it.
+	You can leave this where it is if you like:
 
-	Command: cp /home/jane/Downloads/libtl.so . 
-	the last part of this command is a dot (.)
+	$ mv libtl.so libtl.so.org
 
-7.  Verify that the libtl.so got placed in the "program" directory.
+6.  Copy the new "libtl.so" provided by this hotfix to the "program" sub-directory.
+	Use your download folder with the saved and extraced ZIP file to copy it to the
+	"program" sub-directory. Use the following command to copy the file:
 
-	Command: ls -al
+	$ cp -p /home/jane/Downloads/libtl.so .
+	(the last dot "." is an abbreviation for the current directory)
 
-	This will allow you to verify permission settings on the new file. If it is NOT
-	set as "-r--r--r-- 1 root root", go to Step 8.
+7.  Verify that the "libtl.so" got placed in the "program" sub-directory.
 
-8.  Fix ownership and permissions if needed.
-	To correct the ownership/ permission settings on the new  libtl.so, do the 
-	following still in the command window as root in /opt/openoffice4/program:
+	$ ls -al
 
-	Command: chown root:root libtl.so
-	Command: chmod 755 libtl.so
+	This will allow you to verify permission settings on the new file.
 
-9.  Start Apache OpenOffice as your normally would as a non-priviledged user.
+	Important:
+	If it is NOT listed as "-r--r--r-- 1 root root", go to Step 8.
 
+8.  Change file ownership and permissions.
+	To correct the ownership and permission settings on the new "libtl.so", execute both
+	commands still in the console window as root in the "program" sub-directory:
 
+	$ chown root:root libtl.so
+	$ chmod 444 libtl.so
 
+9.  Now the patch work is done and you can exit the console window:
 
+	$ exit
 
-	
+10. Start Apache OpenOffice as you normally would as a non-privileged user.