Changes between Version 2 and Version 3 of InstallingMacPorts

Timestamp:

10/08/06 20:46:25 (7 years ago)

Author:

markd@…

Comment:

--

InstallingMacPorts

@@ -2 +2 @@
  1. Download the latest verson of Xcode Tools from [http://connect.apple.com/ Apple's developer site] —do not install an older version from the OS X 10.4 install disk or some ports may fail to install.
  2. Run the binary installer and perform an "easy install" —the default install also copies the X11SDK required by X11.
-
-= Install the MacPorts Binary =
- 1. Download the latest MacPorts .dmg disk image you find in the [http://svn.macosforge.org/repository/macports/downloads/ MacPorts download area]
- 2. Run the binary installer
- 3. Perform an “easy” install
 
 = Install XWindows (X11) =
@@ -15 +10 @@
  4. Drag the /Applications/Utilities/X11 icon to your dock —you must open X11 before launching an X11 application
 
-'''NOTES:'''
+'''Notes:'''
  * XWindows (X11) is required for many MacPorts apps and it is highly recommended that you install it even if you don't plan to run X11 apps immediately.
  * The X11SDK is also required to run X11 software, but it is installed by default during the Xcode Tools install above.  Look in /Library/Receipts if you wish to verify that X11 and/or X11SDK were installed.
@@ -23 +18 @@
 == Requirements for the MacPorts' shell environment ==
 
-The MacPorts binary installer places a .profile file in your home directory (view files preceded by a dot with  'ls -a').  The contents of this ~/.profile file adds the MacPorts paths in front of the standard Unix paths for the default BASH shell.  This is done so that if you have utilities or libraries from both MacPorts and OS X's standard install, the MacPorts libraries will be run instead of the ones provided by Apple.  The ~/.profile path statement is:
+The MacPorts binary installer places a .profile file in your home directory (view files preceded by a dot with  'ls -a').  The contents of this ~/.profile file adds the MacPorts paths in front of the standard Unix paths for the default BASH shell.  This is done so that if you have utilities or libraries from both MacPorts and OS X's standard install, the MacPorts libraries will be run instead of the ones provided by Apple.
 
 '''{{{export PATH=/opt/local/bin:/opt/local/sbin:$PATH}}}'''
 
-You'll need to add this variable to your ~/.profile to be able to run X11 applications:
+You'll need to add this variable to your ~/.profile to run X11 applications:
 
 '''{{{export DISPLAY=:0.0}}}'''
 
-'''IMPORTANT NOTES:'''
+So a basic ~./profile file will look like this:
+
+{{{
+export PATH=/opt/local/bin:/opt/local/sbin:$PATH
+export DISPLAY=:0.0
+}}}
+
+'''Important Notes:'''
 
  * To understand why MacPorts libraries are often installed when Apple has provided one, see section "Why is MacPorts using its own libraries?" in the [wiki:FAQ].
@@ -39 +41 @@
     * ~/.bash_profile
 
-== Options for the MacPorts' shell environment ==
+== Options for the MacPorts' shell and X11 environment ==
 
-To launch X11 apps directly from an X11 window (instead of a terminal window), you need to add the MacPorts paths to X11's .xinitrc.  An easy way to do that is to add this statement to the file /etc/X11/xinit/xinitrc:
+To set a default editor for use with the port command (e. g. 'port ed mysql5'), add a variable EDITOR with the path of your favorite editor to the ~./profile file.
+
+'''{{{export EDITOR=/usr/bin/pico}}}'''
+
+A sample ~/.profile with optional EDITOR variable set:
+{{{
+export PATH=/opt/local/bin:/opt/local/sbin:$PATH
+export DISPLAY=:0.0
+export EDITOR=/usr/bin/pico
+}}}
+
+
+To launch X11 apps directly from an X11 window (instead of a terminal window), you need to add the MacPorts paths to X11's .xinitrc.  An easy way to do that is to add this statement to the file /etc/X11/xinit/xinitrc at the top:
 
 '''{{{source ~/.profile}}}'''
 
-To set a default editor for use with the port command (e. g. 'port ed mysql5'), set the EDITOR variable to the path of your favorite editor.
+Sample xinitrc snippet:
+{{{
+#!/bin/sh
+# $Id: xinitrc,v 1.1.1.1 2005/02/24 22:35:39 akosut Exp $
 
-'''{{{export EDITOR=/usr/bin/pico}}}'''
+source ~/.profile
+
+}}}
+= Install the MacPorts Binary =
+ 1. Download the latest MacPorts .dmg disk image you find in the [http://svn.macosforge.org/repository/macports/downloads/ MacPorts download area]
+ 2. Run the binary installer
+ 3. Perform an “easy” install
+
+= Download the latest MacPorts portfiles =
+ 1. Open a terminal window
+ 2. Execute the MacPorts selfupdate command
+
+{{{
+port selfupdate
+}}}
+or for verbose output:
+{{{
+port -vd selfupdate
+}}}
+
+'''Note:''' The selfupdate command also updates the MacPorts program to the latest point release since the binary installer was created.