Changeset 38633 for trunk/doc-new


Ignore:
Timestamp:
Jul 26, 2008, 7:13:12 AM (11 years ago)
Author:
markd@…
Message:

Minor cleanup to MacPorts and the Shell section.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/doc-new/guide/xml/installing.xml

    r38327 r38633  
    99  Tools) are Mac OS X specific. If you wish to install MacPorts on another
    1010  platform, first make sure you have X11 and gcc installed, and then begin at
    11   section 3.2 by performing a <ulink url="installing.macports.source">MacPorts install
    12   from source code</ulink> and proceed to the end of the chapter.</para>
     11  section 3.2 by performing a <ulink url="installing.macports.source">MacPorts
     12  install from source code</ulink> and proceed to the end of the
     13  chapter.</para>
    1314
    1415  <section id="installing.x11">
     
    142143    <filename>/opt/local/</filename>, the default MacPorts location, or if you
    143144    wish to install a pre-release version of MacPorts base. However, if you
    144     wish to <link linkend="installing.macports.source.multiple">install multiple copies
    145     of MacPorts</link> or install MacPorts on another OS platform, you must
    146     <link linkend="installing.macports.source">install MacPorts from the source
    147     code</link>.</para>
     145    wish to <link linkend="installing.macports.source.multiple">install
     146    multiple copies of MacPorts</link> or install MacPorts on another OS
     147    platform, you must <link linkend="installing.macports.source">install
     148    MacPorts from the source code</link>.</para>
    148149
    149150    <note>
     
    245246      a copy of MacPorts that was installed from source to the newer release
    246247      of the source code, simply repeat the <link
    247       linkend="installing.macports.source">source install</link> with the newer version
    248       of the MacPorts source code.</para>
     248      linkend="installing.macports.source">source install</link> with the
     249      newer version of the MacPorts source code.</para>
    249250    </section>
    250251
     
    274275    <title>MacPorts and the Shell</title>
    275276
    276     <para>MacPorts requires changes to the shell environment. If MacPorts was
    277     installed using the Mac OS X package installer, a
    278     <quote>postflight</quote> script was run after installation that places a
    279     <filename>.profile</filename> file in the home directory, which contains
    280     the environmental variables required for MacPorts. If a current
    281     <filename>.profile</filename> file exists at installation time it is
    282     renamed to <quote>mpsaved_$timestamp</quote>.</para>
     277    <para>MacPorts requires that some environmental variables be set in the
     278    shell. When MacPorts is installed using the Mac OS X package installer, a
     279    <quote>postflight</quote> script is run after installation that places a
     280    <filename>.profile</filename> file in the home directory containing the
     281    required variables. If a current <filename>.profile</filename> file exists
     282    at installation time it is renamed to
     283    <quote>mpsaved_$timestamp</quote>.</para>
    283284
    284285    <note>
     
    292293    <para>The postflight script automatically copies a
    293294    <filename>.profile</filename> containing variables according to the rules
    294     described below. Those <link linkend="installing.macports.source">installing
    295     MacPorts from source code</link> must modify their environment manually
    296     using the rules below as a guide.</para>
     295    described below. Those <link
     296    linkend="installing.macports.source">installing MacPorts from source
     297    code</link> must modify their environment manually using the rules below
     298    as a guide.</para>
    297299
    298300    <note>
     
    303305    <itemizedlist>
    304306      <listitem>
    305         <para>A <varname>PATH</varname> variable is set as shown regardless of
    306         platform or environment that appends the MacPorts file paths in front
    307         of the default file paths so MacPorts libraries will take precedence
     307        <para>A <varname>PATH</varname> variable is set by the postflight
     308        script that appends the MacPorts executable paths to the front of the
     309        default path as shown below so MacPorts libraries will take precedence
    308310        over vendor-supplied libraries for ported software at runtime.</para>
    309311
     
    324326
    325327      <listitem>
    326         <para>A <varname>MANPATH</varname> variable is set as shown only if a
    327         <varname>MANPATH</varname> variable was already set in a previous
    328         <filename>.profile</filename> that does not include the value
    329         <filename>${prefix}/share/man,</filename> nor any empty values.
    330         Otherwise, it is omitted.</para>
     328        <para>Optional: If prior to MacPorts installation, a
     329        <varname>MANPATH</varname> variable exists in a current
     330        <filename>.profile</filename> file that does not include the value
     331        <filename>${prefix}/share/man,</filename> nor any empty values, the
     332        postflight script sets a <varname>MANPATH</varname> variable as shown
     333        below. Otherwise, the manpath variable is omitted.</para>
    331334
    332335        <programlisting>export MANPATH=/opt/local/share/man:$MANPATH</programlisting>
     
    345348
    346349      <listitem>
    347         <para>A <varname>DISPLAY</varname> variable for X11 application
    348         support is set as shown only for Mac OS X versions 10.4 (Tiger) and
    349         earlier if a <varname>DISPLAY</varname> variable is not already set in
    350         a <filename>.profile</filename> active at installation time. A
    351         <varname>DISPLAY</varname> variable is never set for Mac OS X 10.5
    352         (Leopard) or higher.</para>
     350        <para>Optional: To support X11 applications for Mac OS X versions
     351        earlier than 10.5 (Leopard), if a<filename> .profile</filename> file
     352        exists at time of MacPorts installation without a
     353        <varname>DISPLAY</varname> variable, the postflight script sets a
     354        <varname>DISPLAY</varname> variable as shown below. The
     355        <varname>DISPLAY</varname> variable is not needed for Mac OS X 10.5 or
     356        higher.</para>
    353357
    354358        <programlisting>export DISPLAY=:0.0</programlisting>
Note: See TracChangeset for help on using the changeset viewer.