You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@openoffice.apache.org by or...@apache.org on 2016/08/16 02:08:19 UTC
svn commit: r14833 -
/dev/openoffice/4.1.2-patch1/binaries/Windows/README-4.1.2-patch1-apply-Windows.txt
Author: orcmid
Date: Tue Aug 16 02:08:18 2016
New Revision: 14833
Log:
Replace README under the old name with a notice that the material is renamed and where to find it for 0.2.0 BETA of the 4.1.2-patch for Windows
Modified:
dev/openoffice/4.1.2-patch1/binaries/Windows/README-4.1.2-patch1-apply-Windows.txt
Modified: dev/openoffice/4.1.2-patch1/binaries/Windows/README-4.1.2-patch1-apply-Windows.txt
==============================================================================
--- dev/openoffice/4.1.2-patch1/binaries/Windows/README-4.1.2-patch1-apply-Windows.txt [UTF-8] (original)
+++ dev/openoffice/4.1.2-patch1/binaries/Windows/README-4.1.2-patch1-apply-Windows.txt [UTF-8] Tue Aug 16 02:08:18 2016
@@ -3,358 +3,32 @@ Hash: SHA256
-README-4.1.2-patch1-apply-Windows.txt 0.1.0 UTF-8 2016-08-11
+README-4.1.2-patch1-apply-Windows.txt 0.2.0 UTF-8 2016-08-15
- APPLYING MANUAL HOTFIX FOR APACHE OPENOFFICE ON WINDOWS
- =======================================================
-
- 0.1.0 BETA TEST INSTRUCTIONS. NOT FOR GENERAL DISTRIBUTION
-
- This material is for developer and quality-assurance review,
- testing, and revision. When completed, general-distribution
- materials will be downloadable from internet location
- <https://archive.apache.org/dist/openoffice/4.1.2-patch1/>
-
-
- The archive file apache-openoffice-4.1.2-patch1-apply-Win_x86.zip
- contains files for applying a fix to Apache OpenOffice 4.1.2
- on Microsoft Windows. The fix eliminates a security vulnerability
- identified as CVE-2016-1513. The latest details about that
- vulnerability and its mitigation can be found on the web at page
- <http://www.openoffice.org/security/cves/CVE-2016-1513.html>.
-
- If you are not comfortable with this procedure, please consult a
- knowledgeable family member or acquaintance that is able to assist
- you. If you did not setup the Windows PC yourself, see if someone
- who is expert in maintaining PCs can be of assistance.
-
- CONTENT
- A. Prerequisites
- B. Preliminaries
- C. Procedure
- D. Confirmation
- E. Removing the Patch
- Acknowledgment
- Appendix: Manual Patch Application
-
-
-A. PREREQUISITES
-
- * Ability to access and navigate the file system of your computer.
-
- * Ability to identify files by their full names and to check sizes,
- date stamps, and other properties.
-
- * Extracting the contents of a Zip package into a folder from which
- the Zipped contents can be reviewed and used.
-
- * Downloading apache-openoffice-4.1.2-patch1-apply-Win_x86.zip to a
- location on your Windows PC where it can be used and its content
- extracted.
-
- * OPTIONAL: Confirming correctness of downloads by verifying the
- hash-check (.md5 and .sha256) files.
-
- * OPTIONAL: Confirming correctness and authenticity of the downloads
- by verifying the digital-signature (.asc) files using PGP software
- and the public KEYS file obtained by you from internet location
- <https://archive.apache.org/dist/openoffice/>.
-
- * OPTIONAL: Disconnecting and reconnecting your computer from the
- Internet and any other network while performing the patch procedure.
-
-
-B. PRELIMINARIES
-
- * Read through the entire procedure so you can anticipate what each
- step leads up to and what actions will be required.
-
- * Open Apache OpenOffice and confirm that you are using Apache
- OpenOffice 4.1.2. The version is found in the Help menu "About
- OpenOffice" dialog.
-
- * Verify that a number of Apache OpenOffice documents that are
- Important to you open correctly without having made any changes to
- the software yet. For any problem documents, close them without
- saving. Those problems exist without the patch and should be
- reported separately.
-
- * When you have completed that work, verify that the Apache OpenOffice
- Quickstarter is not operating. Click on the OpenOffice Tools menu
- "Options ..." selection. On the Options dialog sidebar, under
- OpenOffice, select the Memory entry. On that panel, remove any check
- at "Load OpenOffice during system start-up" under "OpenOffice
- Quickstarter." Click OK on the Options dialog.
-
- Note: Quickstarter is generally not needed on modern Windows PCs.
- Future maintenance of OpenOffice is easier if you no longer use
- Quickstarter.
-
- * Exit OpenOffice and restart your Windows PC.
-
-
-C. PROCEDURE
-
- 1. If you have not already done so, download the Zip archive
- apache-openoffice-4.1.2-patch1-apply-Win_x86.zip from the internet,
- using the web browser of your choice. The Downloads folder of your
- user account on Windows is fine to use. Whatever folder you download
- to should be empty first.
-
- 2. If the download succeeds without problems, the .zip file is available
- To use. For additional authentication, verify the digital signature
- and/or the hash checks if you have the software needed for that.
-
- 3. As an additional precaution you can now disconnect your computer
- from the Internet and any other networks. If you do so, remember to
- re-establish your connection when the following steps are completed
- or suspended.
-
- 4. Open the folder where you downloaded the zip archive.
-
- 5. Right click on the .zip file's file name to see the context menu for
- that file.
-
- 6. Click "Extract all ..." on the context menu.
-
- 7. Use the folder name that is proposed by the extraction dialog and
- complete the extraction.
-
- 8. If there is no damage to the .zip file, you will have a folder
- named apache-openoffice-4.1.2-patch1-apply-Win_x86 in the
- same place as the downloaded .zip file. It will have these
- contents:
-
- README-4.1.2-patch1-apply-Windows.txt
- The version of this procedure that applies for that
- package.
-
- LICENSE.txt
- The Apache License Version 2.0 under which the .zip and
- its content are licensed.
-
- NOTICE.txt
- A notice about the origin of the content.
-
- APPLY-4.1.2-patch1-Windows.bat
- The Windows batch-file script to run for installing
- the patch.
-
- REVERT-4.1.2-patch1-Windows.bat
- The Windows batch-file script to run to back out
- the patch if necessary.
-
- tl.dll.new
- The patched tl.dll library file to be installed in the
- Apache OpenOffice 4.1.2 software. The properties on this
- file identify it as having 620,544 bytes and having been
- modified on Tuesday, July 5, 2016, 18:08:28. The creation
- date can be different, even more recent.
-
- tl.dll.new.asc
- A digital signature provided by the developer of tl.dll.new
- that can be used to verify the authenticity and origin
- of tl.dll.new using suitable software for that purpose.
- The properties on this file identify it as having 819 bytes
- modified on Thursday, July 14, 2016.
-
- tl.dll.old
- The original tl.dll library, without the patch, from the
- official Apache OpenOffice 4.1.2 distribution. This file
- is included as a backup and for use, if needed, as part
- of reverting the patch. The properties of this file
- identify it as having 620,032 bytes and having been
- modified on Wednesday, October 21, 2015, 15:49:50. The
- creation date can be different, even more recent.
-
- tl.dll.old.asc
- A digital signature provided by the developer who extracted
- this file from the setup files of Apache OpenOffice 4.1.2
- for Windows as affirmation of its authenticity. The
- properties on this file identify it as having 484 bytes
- modified on Thursday, August 11, 2016, 10:57
-
- [Note: If you have other utilities that you use for Zip and unZip of
- .zip files, the remainder of this procedure assumes you have
- extracted the .zip content into a folder with the same name and
- content as described above.]
-
- 9. APPLYING THE PATCH AUTOMATICALLY.
- Double-click the file APPLY-4.1.2-patch1-Windows.bat. The automated
- procedure will open a window in which progress is reported.
-
- [Note: If using the automatic procedure is ineffective for some
- reason, it is possible to accomplish the same result manually.
- See the Appendix at the end of this document.]
-
-10. PROVIDING ADMINISTRATIVE PERMISSIONS
- Step (9) may proceed to completion without interruption. If not,
- there will be an explanation for any difficulty. If the procedure
- reports ADMINISTRATIVE PRIVILEGE REQUIRED, you will need to provide
- it.
- a. Right click on the APPLY-4.1.2-patch1-Windows.bat in the File
- Explorer. If there is a "Run as Administrator" action in the
- context menu that appears, click that.
-
- b. If, instead, there is an "Open As ..." option, click that and
- choose the administrator account for which you know the
- password.
-
- c. On Windows XP, there are no such options by default. The
- best solution is to perform this entire procedure within an
- administrator account. Installation of Apache OpenOffice
- required administrative permission. If you did not perform
- the installation, consult whoever did.
-
-
-D. CONFIRMATION
-
- On success in applying the patch, it is important to satisfy yourself
- that Apache OpenOffice is functioning properly.
-
- * Start Apache OpenOffice. There should be no visible difference and
- the program should operate normally.
-
- * Verify the documents that were successfully opened in the
- PRELIMINARIES step at the top of this procedure. They should open
- the same as before. There should be no discernible difference in
- operation.
-
- * If any document that succeeded before now opens incorrectly or fails
- to open, please report that case to the project via the
- dev@openoffice.apache.org public mailing list. DO NOT save any
- incorrectly-opened/failed documents. Close them if necessary and
- leave them alone. Please report the situation on the public
- mailing list users@openoffice.apache.org and await further
- instructions.
-
- NOTE: If you reinstall Apache OpenOffice 4.1.2, the patch will not
- be preserved and you will need to re-apply it. If you install a
- later version of Apache OpenOffice, the patch will be unnecessary.
-
-
-E. REMOVING THE PATCH
-
- If there are any problems with known-good documents, you can restore
- the original "tl.dll". The patch can be removed any time that you
- are concerned that some problem is related to having installed the
- patch or to verify that the problem does not depend on the patch
- being included or not.
-
- To remove the patch automatically, close OpenOffice and, in the folder
- where the APPLY file is found. Double-click on the file
- REVERT-4.1.2-patch1-Windows.bat.
-
- The automated REVERT procedure operates much the same as the APPLY
- procedure in steps (9-10) in section C, above.
-
-
-ACKNOWLEDGMENT
-
- The development, testing, and documentation of 4.1.2-patch1 was
- accomplished with the contribution of the following individuals.
-
- William L. Anderson
- Ariel Constenla-Haile
- Dennis E. Hamilton
- Damjan Jovanovic
- Marcus Lange
- Don Lewis
- Pedro Lino
- Carl Marcum
- Keith N. McKenna
- Andrea Pescetti
- Kay Schenk
- Patricia Shanahan
+ THIS MATERIAL HAS BEEN RENAMED
+ ==============================
+
+ The 0.2.0 BETA README has been renamed to
-APPENDIX. MANUAL PATCH APPLICATION
-
-A1. ADDITIONAL PREREQUISITES
-
- * Confidence accessing technical features of the Windows operating
- system and modifying software files that are part of the system.
-
- * Renaming files; copying files from one location to another in
- operating-system locations.
-
- * Understanding how to locate the computer folder where the Apache
- OpenOffice software is installed for operation.
-
- * Enabling administrative privileges for carrying out operations that
- require such permissions.
-
-A2. MANUAL PROCEDURE
-
- This procedure can be substituted starting in place of step (9) for the
- automated procedure. These are equivalent steps to those accomplished
- automatically.
+ README-4.1.2-patch1-Windows.txt
+
+ The .zip file and related .asc, .md5, .sha1, and .sha256 files
+ are renamed with the base
- 9. IMPORTANT. At any time in the following steps (10-17), there may be
- notification that you must be an administrator to perform an
- action or to continue.
- * If there is a button by which you can give administrator
- permission, do so.
- * If you are required to provide an administrator password and
- you know it, provide it.
- * Otherwise, you may need to upgrade your user account to be
- be an administrator, returning to this step after having done
- that. Remember to restore your user account to its previous non-
- administrator function when you complete or need to suspend
- this procedure.
-
-10. Find the folder on your operating-system drive where OpenOffice
- is installed, usually on the (C:) drive. OpenOffice will be in the
- "Program Files (x86)" folder if there is one. Open it. Otherwise,
- OpenOffice will be in the "Program Files" folder. Open that then.
-
-11. Scroll through the folder opened in step (10) until you find the
- folder "OpenOffice 4" there.
-
-12. Within the "OpenOffice 4" folder, find and open the "program" folder.
-
-13. In the "OpenOffice 4\program" folder, locate the file named "tl.dll".
- Right-click on the filename and select "Properties". In the tl.dll
- Properties dialog, General panel, the size will be 620,032 bytes.
-
-14. Rename the "tl.dll" file to "tl.dll.old". You will be able to
- restore it if you choose to remove the patch later.
-
-15. Now arrange to have the "OpenOffice 4" folder and the folder
- "apache-openoffice-4.1.2-patch1-apply-Win_x86" both open, so that
- the title bar of the first is not covered by the second. If the
- folders overlap, the folder the Zip was extracted into should be on
- top.
-
-16. With the mouse hovering over tl.dll.new in the patch1 folder
- and the keyboard Ctrl key held down, click and hold the mouse
- button down and drag the tll.dll.new file to the title bar
- of the "OpenOffice 4\program\" folder. Release the mouse button
- and then the Ctrl key. There will now be a copy of tl.dll.new
- in the "OpenOffice 4" program folder.
-
-17. In the program folder, rename "tl.dll.new" to "tl.dll".
+ apache-openoffice-4.1.2-patch1-Win_x86.zip
+
+Please access this material at
-18. The procedure is completed. You may close the programs folder and
- the patch1 folder.
-
-19. Manual removal of the patch is straightforward.
+<https://dist.apache.org/repos/dist/dev/openoffice/4.1.2-patch1/binaries/Windows>.
- * In the OpenOffice program folder, find the tl.dll file that is
- the 4.1.2-patch1 version and delete it.
-
- * Rename the tl.dll.old file back to tl.dll.
-
-
- *** end of README-4.1.2-patch1-apply-Windows.txt ***
-
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2
-iQEcBAEBCAAGBQJXrUECAAoJEPluif/UVmKKtWwIAKybxUb1E4/jIMrawTj3oJ28
-6EFV4NfQdWF6NeQzCpInyDPPtxabXMr7Y2v/JjxWAmX5jGHJY7tk2XX0JU0rVebJ
-3gmWT32h26BKS1ems2HMggFN7tf4B8siM7lSgvcTfLqploQZRwDuxzLkQAveXsnj
-4z94YTzM+goCw8uYYH4lx34q375fPCVB6CV/yszKymJRcFxMU6DfUCp9Ck0EiQAd
-8BMqqNnGbcmIBaxmFO9OaIyLeQGKAMA3ePx12hly4bQFkgRLhsI2sgFtR9Z2+aaV
-/XQ+AiGHiLIvmw+ET01y72rnvQDBhVe/44Fe6u5EnQLAcibs9B/4H8QahkmOVEU=
-=xD1X
+iQEcBAEBCAAGBQJXsnUXAAoJEPluif/UVmKK0x8H/R5KSft4X02qyjseMvwSHV9K
+DyjAUDVg4eA9yM+UWiIqhLmFh0/27UyxaaFi5eTUPh+dSuPDxGVl79hy7yGBhQq4
+CwT1GfnecqfbsUMug6JXi7PSRj1+/wOdWtwmPB+AYNCmgPTKjnVTq/d2pIvLCdCw
+/4CoHDucV1tTW9R3L8vY/4l2SgAfuVzzBQYSbJmL9LijvKKWEcY/mWgdKb0N2wFC
+sdzZc5jY7ga6wNadMkD2CNnAxcIfCSQXucxNq69TClKfal8QBHo1lwieyGzF6iE1
+x1TBK3xXCPYLvMDxThf3yv1z9oRMjKFQse0jlSRXoDDfAy/DlFEXMidHmVDeC30=
+=3asu
-----END PGP SIGNATURE-----