Skip to content
Permalink
Browse files

Shorten section IDs, thereby shortening urls within the guide. Thanks…

… to simonr for the

patches.

git-svn-id: https://svn.macports.org/repository/macports/trunk/doc@28261 d073be05-634f-4543-b044-5fe20cf6d1d6
  • Loading branch information
Mark Duling
Mark Duling committed Aug 26, 2007
1 parent 59451b9 commit fb1d722eb57bd1aeea37a49adb32aed320e93d65
@@ -1,17 +1,16 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
<chapter id="installing-macports">
<chapter id="installing">
<title>Installing MacPorts</title>

<para>This chapter show you how to install MacPorts and its prerequistes
step-by-step. Note that sections 1 through 3 are Mac OS X specific. If you
wish to install MacPorts on FreeBSD, first make sure you have gcc and X11
installed, and then begin with section <link
linkend="installing-macports.install.macports.source">Install MacPorts -
Source</link>.</para>
linkend="installing.source">Install MacPorts - Source</link>.</para>

<section id="installing-macports.install.xcode.tools">
<section id="installing.xcode">
<title>Install Xcode Tools</title>

<para>To install Xcode Tools and the X11 SDK, follow these steps.</para>
@@ -45,7 +44,7 @@
</note>
</section>

<section id="installing-macports.install.x11">
<section id="installing.x11">
<title>Install X11</title>

<para>On OS X 10.4, Apple's X Window System (X11) is an optional install
@@ -82,7 +81,7 @@
<filename>/Library/Receipts/</filename>.</para>
</note>

<section>
<section id="installing.x11.settings">
<title>Optional X11 Settings</title>

<para>To launch X11 applications directly from an X11 window (instead of
@@ -118,15 +117,14 @@
</section>
</section>

<section id="installing-macports.install.macports.binary">
<section id="installing.binary">
<title>Install MacPorts - Binary</title>

<para>If you wish to install MacPorts to a path other than
<filename>/opt/local</filename> do not install the MacPorts binary —skip
this section and <link
linkend="installing-macports.install.macports.source">install MacPorts
from the source code</link>. The MacPorts binary installer will only
install to <filename>/opt/local</filename>.</para>
this section and <link linkend="installing.source">install MacPorts from
the source code</link>. The MacPorts binary installer will only install to
<filename>/opt/local</filename>.</para>

<orderedlist>
<listitem>
@@ -145,14 +143,13 @@
</orderedlist>

<note>
<para>A MacPorts <link
linkend="installing-macports.selfupdate">selfupdate</link> operation
will automatically update to the latest release if the binary .dmg image
is behind the latest released tarball.</para>
<para>A MacPorts <link linkend="installing.selfupdate">selfupdate</link>
operation will automatically update to the latest release if the binary
.dmg image is behind the latest released tarball.</para>
</note>
</section>

<section id="installing-macports.install.macports.source">
<section id="installing.source">
<title>Install MacPorts - Source</title>

<para>If you installed MacPorts using the binary installer, skip this
@@ -180,14 +177,13 @@
</orderedlist>

<note>
<para>A MacPorts <link
linkend="installing-macports.selfupdate">selfupdate</link> operation
will automatically update to the latest release if the binary .dmg image
is behind the latest released tarball.</para>
<para>A MacPorts <link linkend="installing.selfupdate">selfupdate</link>
operation will automatically update to the latest release if the binary
.dmg image is behind the latest released tarball.</para>
</note>
</section>

<section id="installing-macports.set.bash.shell">
<section id="installing.shell">
<title>Set the Bash Shell</title>

<para>The MacPorts binary installer places a <filename>.profile</filename>
@@ -244,13 +240,12 @@ _=/usr/bin/env</screen>
</note>
</section>

<section id="installing-macports.selfupdate">
<section id="installing.selfupdate">
<title>MacPorts Selfupdate</title>

<para>You must always do a selfupdate after a new MacPorts install, and
you should also do it frequently thereafter. See <link
linkend="using-macports.port.command.selfupdate">selfupdate</link> —one of
several <link linkend="using-macports.port.command">port
commands</link>.</para>
linkend="using.port.selfupdate">selfupdate</link> —one of several <link
linkend="using.port">port commands</link>.</para>
</section>
</chapter>
@@ -1,13 +1,13 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
<chapter id="macports-internals">
<chapter id="internals">
<title>MacPorts Internals</title>

<para>This chapter contains information to help gain a better understanding
of MacPorts or learn how to configure it for non-default operation.</para>

<section id="macports-internals.macports.file.hierarchy">
<section id="internals.hierarchy">
<title>MacPorts File Hierarchy</title>

<para>MacPorts port authors install files according to guidelines that
@@ -240,38 +240,38 @@
</variablelist>
</section>

<section id="macports-internals.configuration.files">
<section id="internals.configuration-files">
<title>Configuration Files</title>

<para>The MacPorts configuration files do not need to be modified for the
general end user. They contain options that may be of use to advanced
users and port developers. All the MacPorts configuration files are
located in <filename>/opt/local/etc/macports</filename>.</para>

<section id="macports-internals.configuration.files.sources.conf">
<section id="internals.configuration-files.sources-conf">
<title>sources.conf</title>

<para><filename>sources.conf</filename> is where the location(s) are set
to scan for MacPorts Portfiles. This file is commonly modified to add a
local Portfile repository.</para>
</section>

<section id="macports-internals.configuration.files.macports.conf">
<section id="internals.configuration-files.macports-conf">
<title>macports.conf</title>

<para><filename>macports.conf</filename> contains advanced MacPorts
configuration options. See the file comments for instructions.</para>
</section>

<section id="macports-internals.configuration.files.variants.conf">
<section id="internals.configuration-files.variants-conf">
<title>variants.conf</title>

<para><filename>variants.conf</filename> is used to specify variants to
be used for all ports where they exist.</para>
</section>
</section>

<section id="macports-internals.port.images">
<section id="internals.images">
<title>Port Images</title>

<para>MacPorts has a unique ability to allow for multiple versions,
@@ -297,15 +297,15 @@
</note>
</section>

<section id="macports-internals.macports.apis">
<section id="internals.apis">
<title>MacPorts APIs</title>

<para>MacPorts contains two application programming interfaces (APIs),
written in Tcl: The Ports API and the MacPorts (mport*) API. The former is
an internal API used for individual Portfiles. The latter is a high-level
API used by client applications such as the MacPorts port utility.</para>

<section id="macports-internals.macports.apis.ports">
<section id="internals.apis.ports">
<title>Ports API</title>

<para>The code for the Port API is located in
@@ -349,7 +349,7 @@
</itemizedlist>
</section>

<section id="macports-internals.macports.apis.macports">
<section id="internals.apis.macports">
<title>MacPorts API</title>

<para>The code for the MacPorts API is located in
@@ -492,7 +492,7 @@
</section>
</section>

<section id="macports-internals.macports.registry">
<section id="internals.registry">
<title>The MacPorts Registry</title>

<para>This chapter provides an overview of the MacPorts registry and its
@@ -521,7 +521,7 @@
</listitem>
</itemizedlist>

<section id="macports-internals.macports.registry.registry.files">
<section id="internals.registry.files">
<title>Registry Files</title>

<para>The flat file registry (MacPorts default registry) files are
@@ -542,7 +542,7 @@
</itemizedlist>
</section>

<section id="macports-internals.macports.registry.registry.api">
<section id="internals.registry.api">
<title>The Registry API</title>

<para>The MacPorts Registry provides a public API in the registry1.0 Tcl
@@ -45,7 +45,7 @@
portable so it can work on other Unix-like systems, especially those
descended from the Berkeley Software Distribution (BSD).</para>

<section>
<section id="introduction.conventions">
<title>Document Conventions</title>

<para>The MacPorts Guide uses some notational conventions to distinguish

0 comments on commit fb1d722

Please sign in to comment.
You can’t perform that action at this time.