Revision
81658
Author
jmr@macports.org
Date
2011-08-03 06:51:32 -0700 (Wed, 03 Aug 2011)

Log Message

guide: update Port Images section

Modified Paths

Diff

Modified: trunk/doc-new/guide/xml/internals.xml (81657 => 81658)


--- 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">