[81658] trunk/doc-new/guide/xml/internals.xml

[jmr at macports.org]

Revision: 81658
          http://trac.macports.org/changeset/81658
Author:   jmr at macports.org
Date:     2011-08-03 06:51:32 -0700 (Wed, 03 Aug 2011)
Log Message:
-----------
guide: update Port Images section

Modified Paths:
--------------
    trunk/doc-new/guide/xml/internals.xml

Modified: trunk/doc-new/guide/xml/internals.xml
===================================================================
--- trunk/doc-new/guide/xml/internals.xml	2011-08-03 13:34:55 UTC (rev 81657)
+++ trunk/doc-new/guide/xml/internals.xml	2011-08-03 13:51:32 UTC (rev 81658)
@@ -21,27 +21,24 @@
   <section id="internals.images">
     <title>Port Images</title>
 
-    <para>MacPorts has a unique ability to allow for multiple versions,
-    revisions, and variants of the same port installed at the same time, so
+    <para>MacPorts has a unique ability to allow multiple versions,
+    revisions, and variants of the same port to be installed at the same time, so
     you may test new port versions without uninstalling a previous working
     version.</para>
 
     <para>This capability derives from the fact that a MacPorts port by
     default is not installed into its final or "activated" location, but
     rather to an intermediate location that is only made available to other
-    ports and end-users after an activation phase that makes hard links of all
-    its files in <varname>${prefix}</varname> that point to the port's files
-    in the image repository. Therefore deactivating a port image to install a
-    different version only removes the hard links in
-    <varname>${prefix}</varname> pointing to the previous port version's image
+    ports and end-users after an activation phase that extracts all
+    its files from the image repository. Deactivating a port
+    only removes the files from their activated
+    locations (usually under <varname>${prefix}</varname>)
     —the deactivated port's image is not disturbed.</para>
 
-    <note>
-      <para>MacPorts image mode may be turned off in favor of direct mode by
-      setting the portinstalltype variable in the
-      <filename>macports.conf</filename> file "direct". But unless you know
-      what you're doing, don't change it.</para>
-    </note>
+    <para>The location of an installed port's image can be seen
+    by running:
+    <programlisting><prompt>%%</prompt> <userinput>port location PORTNAME</userinput></programlisting>
+    </para>
   </section>
 
   <section id="internals.apis">
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.macosforge.org/pipermail/macports-changes/attachments/20110803/5ec4de61/attachment.html>