Mac installer: update ReadMe file for BOINC 6.13.x

svn path=/trunk/boinc/; revision=24516

checkin_notes

@@ -8020,7 +8020,10 @@ David  2 Nov 2011
         credit.cpp
 
 Charlie 3 Nov 2011
-    - api: Restore list checkin of 31 October 2011.
+    - api: Restore lost checkin of 31 October 2011.
+    - Mac installer: update ReadMe file for BOINC 6.13.x.
 
     api/
         boinc_opencl.cpp
+    mac_installer/
+        ReadMe.rtf

mac_installer/ReadMe.rtf

@@ -1,17 +1,17 @@
-{\rtf1\ansi\ansicpg1252\cocoartf1038\cocoasubrtf360
+{\rtf1\ansi\ansicpg1252\cocoartf1138\cocoasubrtf230
 {\fonttbl\f0\fswiss\fcharset0 Helvetica;}
 {\colortbl;\red255\green255\blue255;\red2\green87\blue173;}
 \margl1440\margr1440\vieww9000\viewh9000\viewkind0
 \pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\qc
 
 \f0\b\fs28 \cf0 Macintosh BOINCManager Version <VER_NUM> Release Notes\
-\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural
+\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640
 
 \b0\fs24 \cf0 \
 \pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\qc
 \cf0 http://boinc.berkeley.edu/\
 \
-\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural
+\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640
 
 \b \cf0 Installing BOINC may take several minutes; please be patient.
 \b0 \
@@ -20,29 +20,33 @@
 \b Dual GPU Macbook Pros:
 \b0  Some newer Macbook Pros have dual graphics processors, one that is more powerful and another that is more energy-efficient, and they switch between them automatically.  This can cause your screensaver to flash on and off frequently, and can prevent BOINC from detecting the more powerful GPU which is needed to process some applications.  You can force selection either {\field{\*\fldinst{HYPERLINK "http://support.apple.com/kb/HT4110"}}{\fldrslt \cf2 permanently}} or temporarily using a {\field{\*\fldinst{HYPERLINK "http://codykrieger.com/gfxCardStatus/"}}{\fldrslt \cf2 third-party utility}}. But be aware that forcing the use of the NVIDIA GPU may cause faster battery drain; this of course is not an issue when running on AC power.\
 \
-\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural\pardirnatural
+\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640
+
+\b \cf0 Upgrade warning 1: 
+\b0 There have been changes to BOINC's internal file formats.   When you upgrade from version 6.12.x, BOINC will automatically upgrade its files.  However, if for any reason you wish to downgrade again to a version earlier than 6.13.x, you will lose any unreported work.  The project servers will send you the tasks again, but they will be restarted from the beginning.  If you think you might need to revert to an older version of BOINC, you should back up your BOINC Data folder before upgrading.\
+\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640
+\cf0 \
+\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural
 \cf0 If you are upgrading from a version earlier than 6.8.0, you may see a message "Failed to convert file BOINC Manager Preferences to Unicode."  This is due to our addition of full Unicode support to the BOINC Manager.  If you get this message, you may need to readjust your column widths and other BOINC Manager view options, but no other problems will result.  When  you quit BOINC Manager, these settings will be saved in the new Unicode format.\
-\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural
+\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640
 \cf0 \
 Due to new restrictions imposed by OS 10.6 Snow Leopard, there has been a change in BOINC's security implementation.  Non-administrative users can no longer run BOINC Manager unless they are added to group boinc_master.  As of BOINC 6.8.29 / BOINC 6.10.5, the BOINC installer asks whether or not you wish to allow this.\
 \
 For more options, please see the BOINC Macintosh administrator tools at:\
-\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural
+\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640
 {\field{\*\fldinst{HYPERLINK "http://boinc.berkeley.edu/wiki/Tools_for_Mac_OS_X"}}{\fldrslt \cf0 http://boinc.berkeley.edu/wiki/Tools_for_Mac_OS_X}}\
 \
-BOINC on the Mac now supports processing with your graphics card, or GPU.  Please see {\field{\*\fldinst{HYPERLINK "http://boinc.berkeley.edu/gpu.php"}}{\fldrslt http://boinc.berkeley.edu/gpu.php}} for more information.   If you have a CUDA-capable NVIDIA GPU, you will need to download and install the CUDA driver and libraries for your system from {\field{\*\fldinst{HYPERLINK "http://www.nvidia.com/object/mac-driver-archive.html"}}{\fldrslt http://www.nvidia.com/object/mac-driver-archive.html}}.\
+BOINC on the Mac now supports processing with your graphics card, or GPU.  Please see {\field{\*\fldinst{HYPERLINK "http://boinc.berkeley.edu/gpu.php"}}{\fldrslt http://boinc.berkeley.edu/gpu.php}} for more information.   If you have a CUDA-capable NVIDIA GPU and you wish to run CUDA applicationa, you will need to download and install the CUDA driver and libraries for your system from {\field{\*\fldinst{HYPERLINK "http://www.nvidia.com/object/mac-driver-archive.html"}}{\fldrslt http://www.nvidia.com/object/mac-driver-archive.html}}.  BOINC 6.13.x also supports openCL applications on NVIDIA and ATI / AMD graphics processors.  OpenCL support is standard as part of Mac OS 10.6 and OS 10.7.\
 \
-Starting with version 5.5.4, BOINC features new, stricter security measures.  See the 
+Starting with version 5.5.4, BOINC has featured new, stricter security measures.  See the 
 \b Security
 \b0  section below for important information.\
 \
-This is a 
-\b universal binary
-\b0  which will run natively on both Intel and PowerPC Macs.  BOINCManager requires Macintosh OS X version 10.3.9 or greater.  \
+This version of BOINC no longer supports PowerPC Macs; it runs natively on Intel Macs and requires Macintosh OS X version 10.4 or greater.  if you wish to run on a PowerPC Mac, please install BOINC 6.12.x.  \
 \
-\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural
+\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640
 
-\b \cf0 Upgrade warning: You may lose unreported results
+\b \cf0 Upgrade warning 2: You may lose unreported results
 \b0  if you are running on an 
 \b Intel Mac
 \b0  and upgrading from a version of BOINC earlier than 5.3.21 on an Intel Mac, or if you are transferring BOINC Data from a PowerPC Mac to an Intel Mac, or from an Intel Mac to a PowerPC Mac.  To prevent this, open BOINC Manager's window, select the 
@@ -64,15 +68,11 @@ Note: on some versions of the Mac OS, you may not be able to exit the BOINC scre
 
 \b Security:\
 \
-\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural\pardirnatural
+\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural
 
-\b0 \cf0 Version 5.5.4 of BOINC Manager for the Macintosh features new, stricter security measures.  This additional security helps protect your computer data from potential theft or accidental or malicious damage by limiting BOINC projects' access to your  system and data.  \
-\
-If you experience problems with this software, you can re-install a version of BOINC prior to  5.5.4; this will automatically revert ownership and permissions to the earlier  implementation.\
-\
-Once we have tested this security implementation on the Mac, we plan to extend it to other computer platforms, including Linux and Windows.\
+\b0 \cf0 Since version 5.5.4 of BOINC Manager for the Macintosh has featured new, stricter security measures.  This additional security helps protect your computer data from potential theft or accidental or malicious damage by limiting BOINC projects' access to your  system and data.  \
 \
-\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural
+\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640
 \cf0 The installer sets special permission for the BOINCManager and Client, which allows them to write to the shared BOINC Data regardless of which user is logged in.  If you 
 \b copy
 \b0  BOINCManager or the BOINC core client without using the installer, it will not run properly.  \
@@ -83,7 +83,7 @@ However, you can safely
 \b /Applications
 \b0  folder.\
 \
-\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural\pardirnatural
+\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural
 \cf0 BOINC verifies that ownership and permissions are set properly each time it is launched.  It will tell you to re-install BOINC if there is a problem.\
 \
 The new safeguards use the basic security protections built into UNIX (the base underlying Mac OS X): permissions and ownership.\
@@ -106,20 +106,17 @@ Starting with version 5.5.4 of the BOINC Manager for the Macintosh, the BOINC in
 \b boinc_project
 \b0  (unless they were created by a previous installation of BOINC.)\
 \
-The installer automatically gives administrators (users who are members of the "admin" group) membership in the two new groups, so that they can easily manipulate BOINC files.  Non-admin users are denied access to these files and to he BOINC Manager, protecting BOINC and its projects files.  This is particularly useful where many people have access to the computer, as in a school computer lab.\
+The installer automatically gives administrators (users who are members of the "admin" group) membership in the two new groups, so that they can easily manipulate BOINC files.  The installer asks you if you would like non-admin users to be able to run the BOINC Manager and to have access to these files.  This is particularly useful where many people have access to the computer, as in a school computer lab.\
 \
 BOINC projects are given permission to access only project files, protecting your computer in the event someone downloads bad software from a bogus project, or in the unlikely case that a legitimate project's server is infiltrated by a cracker.\
 \
-The BOINC Manager also blocks non-admin users' access to certain functions, such as Attach, Detach, Reset Project.  BOINC permits a non-admin user to override this restriction by entering an administrator user name and password.\
-\
 For technical details of the implementation, please see {\field{\*\fldinst{HYPERLINK "http://boinc.berkeley.edu/trac/wiki/SandboxUser"}}{\fldrslt http://boinc.berkeley.edu/trac/wiki/SandboxUser}} and {\field{\*\fldinst{HYPERLINK "http://boinc.berkeley.edu/sandbox.php"}}{\fldrslt http://boinc.berkeley.edu/sandbox.php}}\
 \
-As of Version 5.5.4, the installer now sets BOINCManager as a Login item for 
+The installer sets BOINCManager as a Login item for 
 \b all
-\b0  users, not just the user who ran the installer.  You can add or remove Login Items by using the Accounts Pane in the System Preferences (accessible from the Apple menu).  (These items are called "Login Items" in OS 10.4 or "Startup Items" in OS 10.3.)\
-\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural
-\cf0 \
-\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural
+\b0  authorized users, not just the user who ran the installer.  You can add or remove Login Items by using the Accounts Pane in the System Preferences (accessible from the Apple menu).  \
+\
+\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640
 
 \b \cf0 Other useful information:
 \b0 \
@@ -138,7 +135,7 @@ The installer places two items onto your hard drive: BOINCManager.app in your
 \
 The installer creates the BOINC Data folder in your 
 \b /Library/Application Support
-\b0  folder.  If you have previously been running BOINC in a different folder, copy your data into this folder.  \
+\b0  folder.  If you have previously been running BOINC in a different folder, copy your data into this folder before running the installer.  \
 \
 All users who log in on the same Macintosh will share one set of BOINC data, ensuring that work units are processed in the most timely manner.  \
 \
@@ -148,7 +145,7 @@ You can move (
 \b /Applications
 \b0  folder.\
 \
-\pard\pardeftab720\ql\qnatural
+\pard\pardeftab720
 \cf0 To completely remove (
 \b uninstall
 \b0 ) BOINC from your Macintosh, run the