Display correct refresh rate & fixed reset mode with display sample

[wxWidgets.git] / docs / mac / install.txt

diff --git a/docs/mac/install.txt b/docs/mac/install.txt
index 3ce9533a50ad3394e9ee3ea5c81240d8f439ff84..850726c890e50ffeadb74b40591068b718b9a3d5 100644 (file)
--- a/docs/mac/install.txt
+++ b/docs/mac/install.txt
@@ -1,11 +1,11 @@
-Installing and compiling wxMac
-============================================================
+wxWindows 2.5 for Mac installation
+----------------------------------
 
 On MacOS X, you can download Apple's free developer tools (gcc
 and associated headers and libraries, such as the Carbon API).
 You can then use configure in a similar way to compiling
-wxWindows on Linux, (or on Windows using MinGW or Cygwin). See
-'Apple Developers Tools' below for more details on using
+wxWindows on Linux (or on Windows using MinGW or Cygwin). See
+'Apple Developer Tools' below for more details on using
 configure.
 
 To target on MacOS 8 or 9, you need to buy Metrowerks
@@ -101,29 +101,35 @@ only for CodeWarrior 5.3 related projects):
   - M5mcp2xml.applescript to convert CodeWarrior projects to xml files
   - M5build.applescript to automatically build all samples/demos projects
 
-Apple Developers Tools
-----------------------
+Apple Developer Tools
+---------------------
 
-As in all Unix projects, you need to do something like this under MacOS 10.1
-with the Apple Developers Tools installed:
+As in all Unix projects, you need to do something like this under MacOS X
+with the Apple Developer Tools installed:
 
 1) cd into the base dir
-2) mkdir build
-3) cd build
+2) mkdir osx-build
+3) cd osx-build
 4) ../configure
 5) make
 
-If you want to install the library, you need to be able to log in as "root".
-For this, "root" has to be activated in the NetInfo utility - there you will
-also have to choose a password for the "root" user. Then
+If you want to install the library into the system directories you'll need
+to do this as root.  The accepted way of running commands as root is to
+use the built-in sudo mechanism.  First of all, you must be using an
+account marked as a "Computer Administrator".  Then
 
-6) su
-7) type <PASSWORD>
-8) make install
-9) exit
+6) sudo make install
+7) type <YOUR OWN PASSWORD>
+
+Note that while using this method is okay for development, it is not
+recommended that you require endusers to install wxWindows into their
+system directories in order to use your program.  One way to avoid this
+is to configure wxWindows with --disable-shared.  Another way to avoid
+it is to make a framework for wxWindows.  Making frameworks is beyond
+the scope of this document.
 
 Note:
-You might want to configure a static library instead:
+We recommend you configure a static library instead:
 
 4) ../configure --disable-shared
 
@@ -131,6 +137,10 @@ or activate OpenGL:
 
 4) ../configure --with-opengl
 
+Note:
+It is rarely desirable to install non-Apple software into system directories.
+By configuring the library with --disable-shared and using the full path
+to wx-config with the --in-place option you can avoid installing the library.
 
 Problems with .xpm files
 ------------------------