<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head><meta http-equiv="content-type" content="text/html; charset=utf-8" /><style type="text/css"><!--
#msg dl { border: 1px #006 solid; background: #369; padding: 6px; color: #fff; }
#msg dt { float: left; width: 6em; font-weight: bold; }
#msg dt:after { content:':';}
#msg dl, #msg dt, #msg ul, #msg li, #header, #footer { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt;  }
#msg dl a { font-weight: bold}
#msg dl a:link    { color:#fc3; }
#msg dl a:active  { color:#ff0; }
#msg dl a:visited { color:#cc6; }
h3 { font-family: verdana,arial,helvetica,sans-serif; font-size: 10pt; font-weight: bold; }
#msg pre, #msg p { overflow: auto; background: #ffc; border: 1px #fc0 solid; padding: 6px; }
#msg ul { overflow: auto; }
#header, #footer { color: #fff; background: #636; border: 1px #300 solid; padding: 6px; }
#patch { width: 100%; }
#patch h4 {font-family: verdana,arial,helvetica,sans-serif;font-size:10pt;padding:8px;background:#369;color:#fff;margin:0;}
#patch .propset h4, #patch .binary h4 {margin:0;}
#patch pre {padding:0;line-height:1.2em;margin:0;}
#patch .diff {width:100%;background:#eee;padding: 0 0 10px 0;overflow:auto;}
#patch .propset .diff, #patch .binary .diff  {padding:10px 0;}
#patch span {display:block;padding:0 10px;}
#patch .modfile, #patch .addfile, #patch .delfile, #patch .propset, #patch .binary, #patch .copfile {border:1px solid #ccc;margin:10px 0;}
#patch ins {background:#dfd;text-decoration:none;display:block;padding:0 10px;}
#patch del {background:#fdd;text-decoration:none;display:block;padding:0 10px;}
#patch .lines, .info {color:#888;background:#fff;}
--></style>
<title>[31985] trunk/doc-new/guide/xml/installing.xml</title>
</head>
<body>

<div id="msg">
<dl>
<dt>Revision</dt> <dd><a href="http://trac.macosforge.org/projects/macports/changeset/31985">31985</a></dd>
<dt>Author</dt> <dd>boeyms@macports.org</dd>
<dt>Date</dt> <dd>2007-12-12 21:14:47 -0800 (Wed, 12 Dec 2007)</dd>
</dl>

<h3>Log Message</h3>
<pre>doc-new/guide/xml/installing.xml: Add details on binary installer's behaviour.

At the request of jmpp, this commit fleshes out what the binary installer does,
particularly after installing MacPorts (i.e. the new postflight tweaking of
environment variables and auto-updating).  The details are placed in a &quot;For
advanced users&quot; section so that ordinary users can skip them.</pre>

<h3>Modified Paths</h3>
<ul>
<li><a href="#trunkdocnewguidexmlinstallingxml">trunk/doc-new/guide/xml/installing.xml</a></li>
</ul>

</div>
<div id="patch">
<h3>Diff</h3>
<a id="trunkdocnewguidexmlinstallingxml"></a>
<div class="modfile"><h4>Modified: trunk/doc-new/guide/xml/installing.xml (31984 => 31985)</h4>
<pre class="diff"><span>
<span class="info">--- trunk/doc-new/guide/xml/installing.xml        2007-12-13 04:46:15 UTC (rev 31984)
+++ trunk/doc-new/guide/xml/installing.xml        2007-12-13 05:14:47 UTC (rev 31985)
</span><span class="lines">@@ -168,7 +168,78 @@
</span><span class="cx">         &lt;/listitem&gt;
</span><span class="cx"> 
</span><span class="cx">         &lt;listitem&gt;
</span><del>-          &lt;para&gt;Perform the default “easy” install.&lt;/para&gt;
</del><ins>+          &lt;para&gt;Perform the default “easy” install.  As of MacPorts 1.6,
+            this will install MacPorts, set up a MacPorts-compatible shell
+            environment and, if you have a network connection, update the
+            MacPorts core and ports tree.&lt;/para&gt;
+          &lt;note id=&quot;installing.binary.postflight.details&quot;&gt;
+            &lt;title&gt;For advanced users: details of the postflight script&lt;/title&gt;
+            &lt;para&gt;
+              The &quot;postflight&quot; script bundled with our &quot;pkg&quot; installer is
+              run by Apple's Installer.app after MacPorts is installed, in order
+              to setup a MacPorts compatible shell environment:
+              &lt;orderedlist&gt;
+                &lt;listitem&gt;
+                  &lt;para&gt;The &quot;/opt/local/bin&quot; &amp;amp; &quot;/opt/local/sbin&quot; paths are
+                    added to the PATH variable if not already there, in order to
+                    find MacPorts installed programs.&lt;/para&gt;
+                &lt;/listitem&gt;
+
+                &lt;listitem&gt;
+                  &lt;para&gt;The &quot;/opt/local/share/man&quot; path is added to the MANPATH
+                    variable if and only if:
+                    &lt;itemizedlist&gt;
+                      &lt;listitem&gt;
+                        &lt;para&gt;if already exists;&lt;/para&gt;
+                      &lt;/listitem&gt;
+                      &lt;listitem&gt;
+                        &lt;para&gt;its content is not empty;&lt;/para&gt;
+                      &lt;/listitem&gt;
+                      &lt;listitem&gt;
+                        &lt;para&gt;the MacPorts path is not already there;&lt;/para&gt;
+                      &lt;/listitem&gt;
+                      &lt;listitem&gt;
+                        &lt;para&gt;its content does not contain empty components, such
+                          as &quot;/usr/share/man:&quot;, &quot;:/usr/share/man&quot; or
+                          &quot;/usr/share/man::/usr/X11R6/man&quot;.&lt;/para&gt;
+                      &lt;/listitem&gt;
+                    &lt;/itemizedlist&gt;
+                    In all of these cases, helper tools such as 'manpath(1)' or
+                    'path_helper(8)' (Leopard only) setup the MANPATH directly in
+                    coordination with the 'man(1)' command, so we avoid
+                    interfering with that.
+                  &lt;/para&gt;
+                &lt;/listitem&gt;
+
+                &lt;listitem&gt;
+                  &lt;para&gt;The &lt;envar&gt;DISPLAY&lt;/envar&gt; environment variable is set
+                    to &quot;:0&quot; if and only if:
+                    &lt;itemizedlist&gt;
+                      &lt;listitem&gt;
+                        &lt;para&gt;
+                          It's a Tiger or earlier platform, since on Leopard
+                          connections to the X11 server are handled in a much
+                          cleaner fashion by the 'launchd(8)' daemon directly;
+                        &lt;/para&gt;
+                      &lt;/listitem&gt;
+                      &lt;listitem&gt;
+                        &lt;para&gt;
+                          a &lt;envar&gt;DISPLAY&lt;/envar&gt; environment variable doesn't
+                          already exist.
+                        &lt;/para&gt;
+                      &lt;/listitem&gt;
+                    &lt;/itemizedlist&gt;
+                  &lt;/para&gt;
+                &lt;/listitem&gt;
+              &lt;/orderedlist&gt;
+            &lt;/para&gt;
+
+            &lt;para&gt;Once all that is done, the script runs the 'selfupdate'
+              action of the 'port(1)' command to synchronize the MacPorts
+              installation with the project's rsync server, updating the
+              ports tree to its latest revision and MacPorts itself to the
+              latest point release if available.&lt;/para&gt;
+           &lt;/note&gt;
</ins><span class="cx">         &lt;/listitem&gt;
</span><span class="cx">       &lt;/orderedlist&gt;
</span><span class="cx"> 
</span></span></pre>
</div>
</div>

</body>
</html>