<pre style='margin:0'>
Rainer Müller (raimue) pushed a commit to branch master
in repository macports-guide.
</pre>
<p><a href="https://github.com/macports/macports-guide/commit/4a9c1024acf48077e84dd8ae6a5d1b13c145c35a">https://github.com/macports/macports-guide/commit/4a9c1024acf48077e84dd8ae6a5d1b13c145c35a</a></p>
<pre style="white-space: pre; background: #F8F8F8">The following commit(s) were added to refs/heads/master by this push:
<span style='display:block; white-space:pre;color:#404040;'> new 4a9c102 guide: convert from xml:id to id
</span>4a9c102 is described below
<span style='display:block; white-space:pre;color:#808000;'>commit 4a9c1024acf48077e84dd8ae6a5d1b13c145c35a
</span>Author: Eitan Adler <lists@eitanadler.com>
AuthorDate: Wed Nov 15 21:45:39 2017 -0800
<span style='display:block; white-space:pre;color:#404040;'> guide: convert from xml:id to id
</span><span style='display:block; white-space:pre;color:#404040;'>
</span><span style='display:block; white-space:pre;color:#404040;'> Closes: https://github.com/macports/macports-guide/pull/11
</span>---
Makefile | 4 +--
guide/resources/tabs.xsl | 4 +--
guide/xml/glossary.xml | 6 ++--
guide/xml/installing.xml | 36 +++++++++----------
guide/xml/internals-hier.xml | 2 +-
guide/xml/internals.xml | 20 +++++------
guide/xml/intro.xml | 2 +-
guide/xml/macports.conf.xml | 8 ++---
guide/xml/macros.xml | 2 +-
guide/xml/portfile-dependencies.xml | 4 +--
guide/xml/portfile-keywords.xml | 4 +--
guide/xml/portfile-livecheck.xml | 2 +-
guide/xml/portfile-phase.xml | 48 ++++++++++++-------------
guide/xml/portfile-startupitem.xml | 12 +++----
guide/xml/portfile-tcl.xml | 12 +++----
guide/xml/portfile-variables.xml | 2 +-
guide/xml/portfile-variants.xml | 8 ++---
guide/xml/portfiledev.xml | 58 +++++++++++++++---------------
guide/xml/portfileref.xml | 4 +--
guide/xml/portgroup-gnustep.xml | 8 ++---
guide/xml/portgroup-haskell.xml | 6 ++--
guide/xml/portgroup-perl.xml | 8 ++---
guide/xml/portgroup-python.xml | 8 ++---
guide/xml/portgroup-ruby.xml | 4 +--
guide/xml/portgroup-xcode.xml | 8 ++---
guide/xml/portgroups.xml | 2 +-
guide/xml/project.xml | 36 +++++++++----------
guide/xml/using.xml | 72 ++++++++++++++++++-------------------
28 files changed, 195 insertions(+), 195 deletions(-)
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/Makefile b/Makefile
</span><span style='display:block; white-space:pre;color:#808080;'>index dc0410e..2cab679 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/Makefile
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/Makefile
</span><span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -73,7 +73,7 @@ endif
</span> # Convert all sections (h1-h9) to a link so it's easy to link to them.
# If someone knows a better way to do this please change it.
$(REINPLACE) \
<span style='display:block; white-space:pre;background:#ffe0e0;'>- 's|(<h[0-9] [^>]*><a xml:id="([^"]*)"></a>)([^<]*)(</h[0-9]>)|\1<a href="#\2">\3</a>\4|g' \
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ 's|(<h[0-9] [^>]*><a id="([^"]*)"></a>)([^<]*)(</h[0-9]>)|\1<a href="#\2">\3</a>\4|g' \
</span> $(GUIDE_RESULT)/index.html
# Generate the chunked HTML guide with one section per file.
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -92,7 +92,7 @@ endif
</span> # Convert all sections (h1-h9) to a link so it's easy to link to them.
# If someone knows a better way to do this please change it.
$(REINPLACE) \
<span style='display:block; white-space:pre;background:#ffe0e0;'>- 's|(<h[0-9] [^>]*><a xml:id="([^"]*)"></a>)([^<]*)(</h[0-9]>)|\1<a href="#\2">\3</a>\4|g' \
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ 's|(<h[0-9] [^>]*><a id="([^"]*)"></a>)([^<]*)(</h[0-9]>)|\1<a href="#\2">\3</a>\4|g' \
</span> $(GUIDE_RESULT_CHUNK)/*.html
# Add the table of contents to every junked HTML file.
# If someone knows a better way to do this please change it.
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/guide/resources/tabs.xsl b/guide/resources/tabs.xsl
</span><span style='display:block; white-space:pre;color:#808080;'>index c10e446..4da2d73 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/guide/resources/tabs.xsl
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/guide/resources/tabs.xsl
</span><span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1,7 +1,7 @@
</span> <xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version='1.0'>
<xsl:template name="user.header.content">
<div class="book">
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <div xml:id="tabswitch">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <div id="tabswitch">
</span> <a href="/index.html">
<xsl:if test="$chunkmode = 0">
<xsl:attribute name="class">selected</xsl:attribute>
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -16,6 +16,6 @@
</span> </a>
</div>
</div>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <div xml:id="vh-test"></div> <!-- needed for the sticky sidebar -->
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <div id="vh-test"></div> <!-- needed for the sticky sidebar -->
</span> </xsl:template>
</xsl:stylesheet>
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/guide/xml/glossary.xml b/guide/xml/glossary.xml
</span><span style='display:block; white-space:pre;color:#808080;'>index 0c63537..a0345eb 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/guide/xml/glossary.xml
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/guide/xml/glossary.xml
</span><span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1,15 +1,15 @@
</span> <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V5.0//EN"
"http://docbook.org/xml/5.0/dtd/docbook.dtd">
<span style='display:block; white-space:pre;background:#ffe0e0;'>-<chapter xml:id="guide-terms">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+<chapter id="guide-terms">
</span> <title>MacPorts Guide Glossary</title>
<para>This section defines a number of words which may be new to
the reader. These are all defined in the context of Macports
instead of as general purpose definition.</para>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <glossary xml:id="glossary">
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- <glossdiv xml:id="terms">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <glossary id="glossary">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <glossdiv id="terms">
</span> <title>MacPorts Guide Terms</title>
<glossentry>
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/guide/xml/installing.xml b/guide/xml/installing.xml
</span><span style='display:block; white-space:pre;color:#808080;'>index ada4f96..2b3b56c 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/guide/xml/installing.xml
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/guide/xml/installing.xml
</span><span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -5,7 +5,7 @@
</span> "http://docbook.org/xml/5.0/dtd/docbook.dtd"[
<!ENTITY macports-version "2.4.2">
]>
<span style='display:block; white-space:pre;background:#ffe0e0;'>-<chapter xml:id="installing">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+<chapter id="installing">
</span> <title>Installing MacPorts</title>
<para>This chapter shows you how to install MacPorts and its prerequisites step-by-step. Note that the section about
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -14,7 +14,7 @@
</span> linkend="installing.macports.source">installing MacPorts from source</link>, and continue to the end of the
chapter.</para>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="installing.xcode">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="installing.xcode">
</span> <title>Install Xcode</title>
<para><link xlink:href="https://developer.apple.com/xcode/">Xcode</link> is a package provided by Apple containing
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -29,7 +29,7 @@
</span>
<para>Follow the instructions for your version of macOS:</para>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="installing.xcode.mavericks">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="installing.xcode.mavericks">
</span> <title>Install Xcode on OS X 10.9 or Later</title>
<para>Download the latest version of Xcode <link
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -45,7 +45,7 @@
</span> Apple developer website</link>.</para>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="installing.xcode.lion">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="installing.xcode.lion">
</span> <title>Install Xcode on OS X 10.7 Lion or OS X 10.8 Mountain Lion</title>
<para>Download the latest version of Xcode <link
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -53,7 +53,7 @@
</span> get it <link xlink:href="http://itunes.apple.com/us/app/xcode/id497799835">using the Mac App
Store</link>.</para>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="installing.xcode.lion.43">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="installing.xcode.lion.43">
</span> <title>Xcode 4.3 and Later</title>
<para>Xcode 4.3 and later do not automatically install the command line tools, but MacPorts requires
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -69,7 +69,7 @@
</span> </section>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="installing.xcode.snowleopard">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="installing.xcode.snowleopard">
</span> <title>Install Xcode on Mac OS X 10.6 Snow Leopard</title>
<para>If you are using Mac OS X 10.6, there are two branches of Xcode which could be considered to be the
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -111,7 +111,7 @@
</span> </itemizedlist>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="installing.xcode.other">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="installing.xcode.other">
</span> <title>Install Xcode on Older Releases of Mac OS X</title>
<para>If you have an earlier release of Mac OS X, you may download the latest version of Xcode for OS X 10.5
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -138,7 +138,7 @@
</span> </section>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="installing.macports">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="installing.macports">
</span> <title>Install MacPorts</title>
<para>If you are using macOS, you should install MacPorts using the macOS package installer unless you do not wish
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -148,7 +148,7 @@
</span> MacPorts on another OS platform, you must <link linkend="installing.macports.source">install MacPorts from
the source code</link>.</para>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="installing.macports.binary">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="installing.macports.binary">
</span> <title>macOS Package Install</title>
<para>The macOS package installer automatically installs MacPorts, <link linkend="installing.shell">sets the
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -211,7 +211,7 @@
</span> </orderedlist>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="installing.macports.source">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="installing.macports.source">
</span> <title>Source Install</title>
<para>If you installed MacPorts using the package installer, skip this section. To install MacPorts from the
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -247,7 +247,7 @@
</span> </orderedlist>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="installing.macports.git">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="installing.macports.git">
</span> <title>Git Install</title>
<para>If you installed MacPorts using the package installer, skip this section.</para>
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -323,7 +323,7 @@
</span> </orderedlist>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="installing.macports.source.multiple">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="installing.macports.source.multiple">
</span> <title>Install Multiple MacPorts Copies</title>
<para>Occasionally a MacPorts developer may wish to install more than one MacPorts instance on the same
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -350,7 +350,7 @@
</span> </section>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="installing.macports.upgrade">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="installing.macports.upgrade">
</span> <title>MacPorts Upgrade</title>
<para>MacPorts base upgrades are performed automatically (when a newer release is available) during a <link
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -360,7 +360,7 @@
</span> code.</para>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="installing.macports.uninstalling">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="installing.macports.uninstalling">
</span> <title>Uninstall</title>
<para>Uninstalling MacPorts can be a drastic step, and depending on the issue you are experiencing, you may not
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -402,7 +402,7 @@
</span> not all of the above paths will exist on your system. This is OK.</para>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="installing.shell">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="installing.shell">
</span> <title>MacPorts and the Shell</title>
<para>MacPorts requires that some environment variables be set in the shell. When MacPorts is installed using
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -416,7 +416,7 @@
</span> <filename>.profile</filename>, <filename>.bash_login</filename>, <filename>.bash_profile</filename>,
<filename>.tcshrc</filename>, or <filename>.cshrc</filename>.</para>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="installing.shell.postflight">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="installing.shell.postflight">
</span> <title>The Postflight Script</title>
<para>The postflight script automatically sets the <varname>PATH</varname> variable, and optionally the
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -478,7 +478,7 @@
</span> </itemizedlist>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="installing.shell.verifyprofile">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="installing.shell.verifyprofile">
</span> <title>Verify the Configuration File</title>
<para>To verify that the file containing the MacPorts variables is in effect, type <command>env</command> in
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -508,7 +508,7 @@
</span> <!-- -->_=/usr/bin/env</screen>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="installing.shell.editorvar">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="installing.shell.editorvar">
</span> <title>Optional Editor Variables</title>
<para>You can set an environment variable in order to use your favorite text editor with the <command>port edit</command>
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/guide/xml/internals-hier.xml b/guide/xml/internals-hier.xml
</span><span style='display:block; white-space:pre;color:#808080;'>index d52b579..c295ba8 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/guide/xml/internals-hier.xml
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/guide/xml/internals-hier.xml
</span><span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1,7 +1,7 @@
</span> <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V5.0//EN"
"http://docbook.org/xml/5.0/dtd/docbook.dtd">
<span style='display:block; white-space:pre;background:#ffe0e0;'>-<refentry xml:id="porthier">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+<refentry id="porthier">
</span> <refmeta>
<refentrytitle>PORTHIER</refentrytitle>
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/guide/xml/internals.xml b/guide/xml/internals.xml
</span><span style='display:block; white-space:pre;color:#808080;'>index 13be48a..e5b7135 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/guide/xml/internals.xml
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/guide/xml/internals.xml
</span><span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1,14 +1,14 @@
</span> <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V5.0//EN"
"http://docbook.org/xml/5.0/dtd/docbook.dtd">
<span style='display:block; white-space:pre;background:#ffe0e0;'>-<chapter xml:id="internals">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+<chapter id="internals">
</span> <title>MacPorts Internals</title>
<para>This chapter contains information about the MacPorts file layout,
configuration files, a few fundamental port installation concepts, and the
MacPorts APIs.</para>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="internals.hierarchy">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="internals.hierarchy">
</span> <title>File Hierarchy</title>
<xi:include href="internals-hier.xml"
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -18,7 +18,7 @@
</span> <xi:include href="macports.conf.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="internals.images">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="internals.images">
</span> <title>Port Images</title>
<para>MacPorts has a unique ability to allow multiple versions,
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -41,7 +41,7 @@
</span> </para>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="internals.apis">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="internals.apis">
</span> <title>APIs and Libs</title>
<para>The MacPorts system is composed of three Tcl libraries:</para>
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -61,7 +61,7 @@
</span> </listitem>
</itemizedlist>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="internals.apis.ports">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="internals.apis.ports">
</span> <title>Ports API</title>
<para>The code for the Port API is located in
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -123,7 +123,7 @@
</span> </itemizedlist>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="internals.apis.macports">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="internals.apis.macports">
</span> <title>MacPorts API</title>
<para>The code for the MacPorts API is located in
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -274,7 +274,7 @@
</span> </itemizedlist>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="internals.apis.pextlib">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="internals.apis.pextlib">
</span> <title>pextlib</title>
<para>The pextlib Tcl library provides a variety of C extensions to add
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -283,7 +283,7 @@
</span> </section>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="internals.registry">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="internals.registry">
</span> <title>The MacPorts Registry</title>
<para>This chapter provides an overview of the MacPorts registry and its
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -312,7 +312,7 @@
</span> </listitem>
</itemizedlist>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="internals.registry.files">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="internals.registry.files">
</span> <title>Registry Files</title>
<para>The SQLite registry used by default is located at
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -336,7 +336,7 @@
</span> </para>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="internals.registry.api">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="internals.registry.api">
</span> <title>The Registry API</title>
<para>The MacPorts registry provides a public API in the registry1.0 Tcl
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/guide/xml/intro.xml b/guide/xml/intro.xml
</span><span style='display:block; white-space:pre;color:#808080;'>index d62d0e3..34dcd0d 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/guide/xml/intro.xml
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/guide/xml/intro.xml
</span><span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -3,7 +3,7 @@
</span> -->
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V5.0//EN"
"http://docbook.org/xml/5.0/dtd/docbook.dtd">
<span style='display:block; white-space:pre;background:#ffe0e0;'>-<chapter xml:id="introduction">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+<chapter id="introduction">
</span> <title>Introduction</title>
<para>MacPorts is an easy to use system for compiling, installing, and managing open source software. MacPorts may
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/guide/xml/macports.conf.xml b/guide/xml/macports.conf.xml
</span><span style='display:block; white-space:pre;color:#808080;'>index d42ec07..660cad7 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/guide/xml/macports.conf.xml
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/guide/xml/macports.conf.xml
</span><span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1,7 +1,7 @@
</span> <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V5.0//EN"
"http://docbook.org/xml/5.0/dtd/docbook.dtd">
<span style='display:block; white-space:pre;background:#ffe0e0;'>-<section xml:id="internals.configuration-files">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+<section id="internals.configuration-files">
</span> <title>Configuration Files</title>
<para>The MacPorts configuration files often do not need to be modified for the
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,7 +19,7 @@
</span> separated by either a space or a tab. Lines beginning with '#' are comments,
empty lines are ignored.</para>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="internals.configuration-files.macports-conf">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="internals.configuration-files.macports-conf">
</span> <title>macports.conf</title>
<para>macports.conf is the configuration file used to bootstrap the
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -415,7 +415,7 @@
</span> </variablelist>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="internals.configuration-files.sources-conf">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="internals.configuration-files.sources-conf">
</span> <title>sources.conf</title>
<para>This file enables rsync synchronization of the default ports tree
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -429,7 +429,7 @@
</span> <replaceable>file:///path/to/localportsrepository</replaceable></para>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="internals.configuration-files.variants-conf">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="internals.configuration-files.variants-conf">
</span> <title>variants.conf</title>
<para>This optional file specifies any variants you'd like to be invoked
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/guide/xml/macros.xml b/guide/xml/macros.xml
</span><span style='display:block; white-space:pre;color:#808080;'>index 3f94328..45b27ac 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/guide/xml/macros.xml
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/guide/xml/macros.xml
</span><span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -3,7 +3,7 @@
</span> "http://docbook.org/xml/5.0/dtd/docbook.dtd">
<!-- This section will be hidden by a xsl:template in resources/base.xsl -->
<span style='display:block; white-space:pre;background:#ffe0e0;'>-<chapter xml:id='macros'>
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+<chapter id='macros'>
</span> <title>Macros</title>
<warning role='macro-outdated'><para>
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/guide/xml/portfile-dependencies.xml b/guide/xml/portfile-dependencies.xml
</span><span style='display:block; white-space:pre;color:#808080;'>index 641f13c..301bd69 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/guide/xml/portfile-dependencies.xml
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/guide/xml/portfile-dependencies.xml
</span><span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1,7 +1,7 @@
</span> <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V5.0//EN"
"http://docbook.org/xml/5.0/dtd/docbook.dtd">
<span style='display:block; white-space:pre;background:#ffe0e0;'>-<section xml:id="reference.dependencies">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+<section id="reference.dependencies">
</span> <title>Dependencies</title>
<para>Free and open source software is highly modular, and MacPorts ports
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -122,7 +122,7 @@
</span> </varlistentry>
</variablelist>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="reference.dependencies.types">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="reference.dependencies.types">
</span> <title>Port and File Dependencies</title>
<para>There are two types of dependencies: port dependencies and file
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/guide/xml/portfile-keywords.xml b/guide/xml/portfile-keywords.xml
</span><span style='display:block; white-space:pre;color:#808080;'>index 56e7284..105a6ac 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/guide/xml/portfile-keywords.xml
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/guide/xml/portfile-keywords.xml
</span><span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1,7 +1,7 @@
</span> <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V5.0//EN"
"http://docbook.org/xml/5.0/dtd/docbook.dtd">
<span style='display:block; white-space:pre;background:#ffe0e0;'>-<section xml:id="reference.keywords">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+<section id="reference.keywords">
</span> <title>Global Keywords</title>
<para>MacPorts keywords are used to specify required or optional items
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -104,7 +104,7 @@
</span> </listitem>
</varlistentry>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <varlistentry xml:id="reference.keywords.maintainers">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <varlistentry id="reference.keywords.maintainers">
</span> <term>maintainers</term>
<listitem>
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/guide/xml/portfile-livecheck.xml b/guide/xml/portfile-livecheck.xml
</span><span style='display:block; white-space:pre;color:#808080;'>index b350d9d..07e9e0a 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/guide/xml/portfile-livecheck.xml
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/guide/xml/portfile-livecheck.xml
</span><span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -2,7 +2,7 @@
</span> <!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V5.0//EN"
"http://docbook.org/xml/5.0/dtd/docbook.dtd">
<span style='display:block; white-space:pre;background:#ffe0e0;'>-<section xml:id="reference.livecheck">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+<section id="reference.livecheck">
</span> <title>Livecheck / Distcheck</title>
<para>Options livecheck and distcheck are especially useful for port
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/guide/xml/portfile-phase.xml b/guide/xml/portfile-phase.xml
</span><span style='display:block; white-space:pre;color:#808080;'>index f21e774..40ef3a6 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/guide/xml/portfile-phase.xml
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/guide/xml/portfile-phase.xml
</span><span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1,10 +1,10 @@
</span> <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V5.0//EN"
"http://docbook.org/xml/5.0/dtd/docbook.dtd">
<span style='display:block; white-space:pre;background:#ffe0e0;'>-<section xml:id="reference.phases">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+<section id="reference.phases">
</span> <title>Port Phases</title>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="reference.phases.introduction">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="reference.phases.introduction">
</span> <title>Introduction</title>
<para>The MacPorts port installation process has a number of distinct
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -161,7 +161,7 @@
</span> </variablelist>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="reference.phases.installation">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="reference.phases.installation">
</span> <title>Installation Phase Keywords</title>
<para>MacPorts keywords are used to specify required or optional items
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -175,7 +175,7 @@
</span> phases and set options for those phases, and they take effect whether or
not phase declarations have been explicitly defined in a Portfile.</para>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="reference.phases.installation.list-modifiers">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="reference.phases.installation.list-modifiers">
</span> <title>Keyword List Modifiers (-append, -delete, -replace, -strsed)</title>
<para>Keyword list modifiers are keywords that end in -append, -delete or
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -259,7 +259,7 @@
</span> </orderedlist>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="reference.phases.installation.argument-modifiers">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="reference.phases.installation.argument-modifiers">
</span> <title>Keyword Argument Modifiers (.pre_args / .post_args)</title>
<para>Keywords that support pre_args and post_args are used to assemble
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -272,7 +272,7 @@
</span> </section>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="reference.phases.fetch">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="reference.phases.fetch">
</span> <title>Fetch Phase Keywords</title>
<para>The list of keywords related to the fetch phase.</para>
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -516,14 +516,14 @@ distfiles file_one.tar.gz:tagone \
</span> </varlistentry>
</variablelist>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="reference.phases.fetch.advanced">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="reference.phases.fetch.advanced">
</span> <title>Advanced Fetch Options</title>
<para>Some mirrors require special options for a resource to be properly
fetched.</para>
<variablelist>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <varlistentry xml:id="reference.phases.fetch.advanced.fetch-type">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <varlistentry id="reference.phases.fetch.advanced.fetch-type">
</span> <term>fetch.type</term>
<listitem>
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -642,7 +642,7 @@ svn.revision 2100</programlisting>
</span> </variablelist>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="reference.phases.fetch.bzr">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="reference.phases.fetch.bzr">
</span> <title>Fetch from BZR</title>
<para><link xlink:href="http://bazaar.canonical.com/en/">Bzr</link> may be used as
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -700,7 +700,7 @@ svn.revision 2100</programlisting>
</span> </variablelist>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="reference.phases.fetch.cvs">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="reference.phases.fetch.cvs">
</span> <title>Fetch from CVS</title>
<para><link xlink:href="http://www.nongnu.org/cvs/">CVS</link> may be used as
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -817,7 +817,7 @@ svn.revision 2100</programlisting>
</span> </section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="reference.phases.fetch.git">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="reference.phases.fetch.git">
</span> <title>Fetch from Git</title>
<para><link xlink:href="http://git-scm.com/">Git</link> may be used as an
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -878,7 +878,7 @@ svn.revision 2100</programlisting>
</span> </variablelist>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="reference.phases.fetch.hg">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="reference.phases.fetch.hg">
</span> <title>Fetch from Mercurial</title>
<para><link xlink:href="http://mercurial.selenic.com/">Mercurial</link> may be
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -939,7 +939,7 @@ svn.revision 2100</programlisting>
</span> </variablelist>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="reference.phases.fetch.svn">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="reference.phases.fetch.svn">
</span> <title>Fetch from Subversion</title>
<para><link xlink:href="http://subversion.apache.org/">Subversion</link> may
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1024,7 +1024,7 @@ svn.revision 2100</programlisting>
</span> </section>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="reference.phases.checksum">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="reference.phases.checksum">
</span> <title>Checksum Phase Keywords</title>
<para>The list of keywords related to the checksum phase.</para>
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1065,7 +1065,7 @@ svn.revision 2100</programlisting>
</span> </variablelist>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="reference.phases.extract">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="reference.phases.extract">
</span> <title>Extract Phase Keywords</title>
<para>The list of keywords related to the extract phase.</para>
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1370,7 +1370,7 @@ extract.post_args "| gnutar -x"</programlisting>
</span> </variablelist>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="reference.phases.patch">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="reference.phases.patch">
</span> <title>Patch Phase Keywords</title>
<para>The list of keywords related to the patch phase.</para>
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1497,7 +1497,7 @@ patch.post_args ???</programlisting>
</span> </variablelist>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="reference.phases.configure">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="reference.phases.configure">
</span> <title>Configure Phase Keywords</title>
<para>The list of keywords related to the configure phase.</para>
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1588,7 +1588,7 @@ configure.env-delete TCLROOT=${prefix}</programlisting>
</span> </listitem>
</varlistentry>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <varlistentry xml:id="reference.phases.configure.optflags">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <varlistentry id="reference.phases.configure.optflags">
</span> <term>configure.optflags</term>
<term>configure.optflags-append</term>
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1617,7 +1617,7 @@ configure.optflags-delete -Os</programlisting>
</span> </listitem>
</varlistentry>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <varlistentry xml:id="reference.phases.configure.cflags">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <varlistentry id="reference.phases.configure.cflags">
</span> <term>configure.cflags</term>
<term>configure.cflags-append</term>
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -2339,7 +2339,7 @@ configure.post_args OPT="-D__DARWIN_UNIX03"</programlisting>
</span> </varlistentry>
</variablelist>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="reference.phases.configure.universal">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="reference.phases.configure.universal">
</span> <title>Configure Universal</title>
<para>Universal keywords are used to make a port compile on OS X for
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -2474,7 +2474,7 @@ configure.post_args OPT="-D__DARWIN_UNIX03"</programlisting>
</span> </variablelist>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="reference.phases.configure.automake-autoconf">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="reference.phases.configure.automake-autoconf">
</span> <title>Automake, Autoconf, and Autoreconf</title>
<para>The list of configure keywords available for ports that need
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -2664,7 +2664,7 @@ configure.post_args OPT="-D__DARWIN_UNIX03"</programlisting>
</span> </section>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="reference.phases.build">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="reference.phases.build">
</span> <title>Build Phase Keywords</title>
<para>The list of keywords related to the build phase.</para>
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -2874,7 +2874,7 @@ build.target-delete compat</programlisting>
</span> </variablelist>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="reference.phases.test">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="reference.phases.test">
</span> <title>Test Phase Keywords</title>
<para>The list of keywords related to the test phase.</para>
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -3012,7 +3012,7 @@ build.target-delete compat</programlisting>
</span> </variablelist>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="reference.phases.destroot">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="reference.phases.destroot">
</span> <title>Destroot Phase Keywords</title>
<para>The list of keywords related to the destroot phase.</para>
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/guide/xml/portfile-startupitem.xml b/guide/xml/portfile-startupitem.xml
</span><span style='display:block; white-space:pre;color:#808080;'>index ad98e10..0e7fe8d 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/guide/xml/portfile-startupitem.xml
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/guide/xml/portfile-startupitem.xml
</span><span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1,7 +1,7 @@
</span> <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V5.0//EN"
"http://docbook.org/xml/5.0/dtd/docbook.dtd">
<span style='display:block; white-space:pre;background:#ffe0e0;'>-<section xml:id="reference.startupitems">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+<section id="reference.startupitems">
</span> <title>StartupItems</title>
<para>A StartupItem is a MacPorts facility to run <quote>daemons,</quote> a Unix term for
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -28,7 +28,7 @@
</span> in Portfiles; this prevents StartupItems from being created.</para>
</note>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="reference.startupitems.attributes">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="reference.startupitems.attributes">
</span> <title>StartupItem Attributes</title>
<para>The keywords in this section may be used with either
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -145,7 +145,7 @@
</span> </variablelist>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="reference.startupitems.executable">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="reference.startupitems.executable">
</span> <title>Executable StartupItems</title>
<para>Daemons run continuously, so monitoring the health of daemon
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -231,7 +231,7 @@
</span> </variablelist>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="reference.startupitems.script">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="reference.startupitems.script">
</span> <title>Script StartupItems</title>
<para>StartupItems of type <quote>script</quote> create a wrapper during
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -406,7 +406,7 @@ startupitem.restart "${prefix}/share/mysql/mysql.server restart"</programlis
</span> </variablelist>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="reference.startupitems.launchd">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="reference.startupitems.launchd">
</span> <title>Loading / Unloading StartupItems into launchd</title>
<para>A port with a StartupItem places a link to a .plist file for the
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -425,7 +425,7 @@ startupitem.restart "${prefix}/share/mysql/mysql.server restart"</programlis
</span> <programlisting><prompt>%%</prompt> <userinput>sudo launchctl unload -w /Library/LaunchDaemons/org.macports.mysql5.plist</userinput></programlisting>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="reference.startupitems.internals">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="reference.startupitems.internals">
</span> <title>StartupItem Internals</title>
<para>During port installation a MacPorts StartupItem creates a .plist
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/guide/xml/portfile-tcl.xml b/guide/xml/portfile-tcl.xml
</span><span style='display:block; white-space:pre;color:#808080;'>index 859e38f..b5a9dad 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/guide/xml/portfile-tcl.xml
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/guide/xml/portfile-tcl.xml
</span><span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1,7 +1,7 @@
</span> <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V5.0//EN"
"http://docbook.org/xml/5.0/dtd/docbook.dtd">
<span style='display:block; white-space:pre;background:#ffe0e0;'>-<section xml:id="reference.tcl-extensions">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+<section id="reference.tcl-extensions">
</span> <title>Tcl Extensions & Useful Tcl Commands</title>
<para>A MacPorts Portfile is a Tcl script, so it may contain any arbitrary
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -226,7 +226,7 @@
</span> </listitem>
</varlistentry>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <varlistentry xml:id="reference.tcl-extensions.strsed">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <varlistentry id="reference.tcl-extensions.strsed">
</span> <term>strsed</term>
<listitem>
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -325,8 +325,8 @@
</span>
<variablelist>
<varlistentry>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <term>adduser username [uxml:id=<replaceable>uid</replaceable>]
</span><span style='display:block; white-space:pre;background:#ffe0e0;'>- [gxml:id=<replaceable>gid</replaceable>]
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <term>adduser username [uid=<replaceable>uid</replaceable>]
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ [gid=<replaceable>gid</replaceable>]
</span> [passwd=<replaceable>passwd</replaceable>]
[realname=<replaceable>realname</replaceable>]
[home=<replaceable>home</replaceable>]
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -365,7 +365,7 @@
</span> <variablelist>
<varlistentry>
<term>addgroup <replaceable>group</replaceable>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- [gxml:id=<replaceable>gid</replaceable>]
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ [gid=<replaceable>gid</replaceable>]
</span> [passwd=<replaceable>passwd</replaceable>]
[realname=<replaceable>realname</replaceable>]
[users=<replaceable>users</replaceable>]</term>
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -387,7 +387,7 @@
</span> gid. This can be used with adduser:</para>
<programlisting>addgroup foo
<span style='display:block; white-space:pre;background:#ffe0e0;'>-adduser foo gxml:id=[existsgroup foo]</programlisting>
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+adduser foo gid=[existsgroup foo]</programlisting>
</span> </listitem>
</varlistentry>
</variablelist>
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/guide/xml/portfile-variables.xml b/guide/xml/portfile-variables.xml
</span><span style='display:block; white-space:pre;color:#808080;'>index 67cee8c..6125de1 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/guide/xml/portfile-variables.xml
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/guide/xml/portfile-variables.xml
</span><span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1,7 +1,7 @@
</span> <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V5.0//EN"
"http://docbook.org/xml/5.0/dtd/docbook.dtd">
<span style='display:block; white-space:pre;background:#ffe0e0;'>-<section xml:id="reference.variables">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+<section id="reference.variables">
</span> <title>Global Variables</title>
<para>Global variables are variables available to any Portfile. For a list
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/guide/xml/portfile-variants.xml b/guide/xml/portfile-variants.xml
</span><span style='display:block; white-space:pre;color:#808080;'>index 74a260f..17c7785 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/guide/xml/portfile-variants.xml
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/guide/xml/portfile-variants.xml
</span><span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1,7 +1,7 @@
</span> <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V5.0//EN"
"http://docbook.org/xml/5.0/dtd/docbook.dtd">
<span style='display:block; white-space:pre;background:#ffe0e0;'>-<section xml:id="reference.variants">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+<section id="reference.variants">
</span> <title>Variants</title>
<para>MacPorts variants are conditional modifications of port installation
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -11,7 +11,7 @@
</span> selected automatically by MacPorts base according to the OS or hardware
platform (darwin, freebsd, linux, i386, powerpc, etc.).</para>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="reference.variants.user-selected">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="reference.variants.user-selected">
</span> <title>User-Selected Variants</title>
<para>User-selected variants are those that are defined so a user can
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -123,7 +123,7 @@
</span> </variablelist>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="reference.variants.descriptions">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="reference.variants.descriptions">
</span> <title>User-Selected Variant Descriptions</title>
<para>User-selected variants ought to provide a description, which will be
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -148,7 +148,7 @@
</span> port descriptions and long_descriptions.</para>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="reference.variants.platform">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="reference.variants.platform">
</span> <title>Platform Variants</title>
<para>Platform variants are either defined by default in MacPorts base, or
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/guide/xml/portfiledev.xml b/guide/xml/portfiledev.xml
</span><span style='display:block; white-space:pre;color:#808080;'>index 878743e..4126c75 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/guide/xml/portfiledev.xml
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/guide/xml/portfiledev.xml
</span><span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1,7 +1,7 @@
</span> <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V5.0//EN"
"http://docbook.org/xml/5.0/dtd/docbook.dtd">
<span style='display:block; white-space:pre;background:#ffe0e0;'>-<chapter xml:id="development">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+<chapter id="development">
</span> <title>Portfile Development</title>
<para>A port is a distribution of software that can be compiled and
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -19,7 +19,7 @@
</span> within. The only required file in a port is the
<filename>Portfile</filename>.</para>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="development.introduction">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="development.introduction">
</span> <title>Portfile Introduction</title>
<para>A MacPorts Portfile is a <link
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -90,7 +90,7 @@
</span> </note>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="development.creating-portfile">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="development.creating-portfile">
</span> <title>Creating a Portfile</title>
<para>Here we list the individual Portfile components for an application
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -302,7 +302,7 @@ Error: Processing of port rrdtool failed</screen>
</span> </orderedlist>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="development.examples">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="development.examples">
</span> <title>Example Portfiles</title>
<para>In this section we begin by taking a look at a complete simple
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -314,7 +314,7 @@ Error: Processing of port rrdtool failed</screen>
</span> linkend="development.examples.eliminate">eliminate port
phases</link>.</para>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="development.examples.basic">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="development.examples.basic">
</span> <title>A Basic Portfile</title>
<programlisting># -*- coding: utf-8; mode: tcl; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- vim:fenc=utf-8:ft=tcl:et:sw=4:ts=4:sts=4
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -344,7 +344,7 @@ configure.args --enable-perl-site-install \
</span> --mandir=${prefix}/share/man</programlisting>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="development.examples.augment">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="development.examples.augment">
</span> <title>Augment Phases Using pre- / post-</title>
<para>To augment a port's installation phase, and not override it, you
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -359,7 +359,7 @@ configure.args --enable-perl-site-install \
</span> }</programlisting>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="development.examples.override">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="development.examples.override">
</span> <title>Overriding Phases</title>
<para>To override the automatic MacPorts installation phase processing,
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -371,7 +371,7 @@ configure.args --enable-perl-site-install \
</span> }</programlisting>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="development.examples.eliminate">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="development.examples.eliminate">
</span> <title>Eliminating Phases</title>
<para>To eliminate a default phase, simply define a phase with no
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -389,7 +389,7 @@ configure.args --enable-perl-site-install \
</span> </note>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="development.examples.startupitem">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="development.examples.startupitem">
</span> <title>Creating a StartupItem</title>
<para>Startupitems may be placed in the global section of a
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -401,7 +401,7 @@ startupitem.executable "${prefix}/bin/nmicmpd"</programlisting>
</span> </section>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="development.variants">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="development.variants">
</span> <title>Port Variants</title>
<para>Variants are a way for port authors to provide options that may be
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -410,7 +410,7 @@ startupitem.executable "${prefix}/bin/nmicmpd"</programlisting>
</span> linkend="reference.variants.descriptions">carefully chosen variant
descriptions</link>.</para>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="development.variants.options">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="development.variants.options">
</span> <title>Example Variants</title>
<para>The most common actions for user-selected variants is to add or
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -472,7 +472,7 @@ variant sqlite description {Build sqlite support} {
</span> }</programlisting>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="development.variants.phase">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="development.variants.phase">
</span> <title>Variant Actions in a Phase</title>
<para>If a variant requires options in addition to those provided by
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -494,7 +494,7 @@ variant sqlite description {Build sqlite support} {
</span> }</programlisting>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="development.variants.default">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="development.variants.default">
</span> <title>Default Variants</title>
<para>Variants are used to specify actions that lie outside the core
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -513,7 +513,7 @@ variant sqlite description {Build sqlite support} {
</span> </section>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="development.patches">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="development.patches">
</span> <title>Patch Files</title>
<para>Patch files are files created with the Unix command
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -521,7 +521,7 @@ variant sqlite description {Build sqlite support} {
</span> <command>patch</command> to modify text files to fix bugs or extend
functionality.</para>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="development.patches.portfile">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="development.patches.portfile">
</span> <title>Creating Portfile Patches</title>
<para>If you wish to contribute modifications or fixes to a Portfile,
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -584,7 +584,7 @@ variant sqlite description {Build sqlite support} {
</span> the port author to evaluate.</para>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="development.patches.source">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="development.patches.source">
</span> <title>Creating Source Code Patches</title>
<para>Necessary or useful patches to application source code should
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -696,7 +696,7 @@ variant sqlite description {Build sqlite support} {
</span> </orderedlist>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="development.patches.applying">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="development.patches.applying">
</span> <title>Manually Applying Patches</title>
<para>MacPorts applies patch files automatically, but you may want to
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -725,7 +725,7 @@ variant sqlite description {Build sqlite support} {
</span> </section>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="development.local-repositories">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="development.local-repositories">
</span> <title>Local Portfile Repositories</title>
<para>To create and test Portfiles that are not yet published in the MacPorts ports tree,
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -810,14 +810,14 @@ Ports failed: 0</screen>
</span> The Best Ever Game</screen>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="development.practices">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="development.practices">
</span> <title>Portfile Best Practices</title>
<para>This section contains practical guidelines for creating Portfiles
that install smoothly and provide consistency between ports. The following
sections are on the TODO list.</para>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="development.practices.portstyle">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="development.practices.portstyle">
</span> <title>Port Style</title>
<para>Portfiles may be thought of as a set of declarations rather than
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -873,25 +873,25 @@ Ports failed: 0</screen>
</span> ${destroot}${prefix}/var/cache/mrtg</programlisting>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="development.practices.dont-overwrite">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="development.practices.dont-overwrite">
</span> <title>Don't Overwrite Config Files</title>
<para>TODO:</para>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="development.practices.install-docs">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="development.practices.install-docs">
</span> <title>Install Docs and Examples</title>
<para>TODO:</para>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="development.practices.provide-messages">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="development.practices.provide-messages">
</span> <title>Provide User Messages</title>
<para>TODO:</para>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="development.practices.use-variables">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="development.practices.use-variables">
</span> <title>Use Variables</title>
<para>TODO: Set variables so changing paths may be done in one place;
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -900,7 +900,7 @@ Ports failed: 0</screen>
</span> </section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="development.practices.rename-replace-port">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="development.practices.rename-replace-port">
</span> <title>Renaming or replacing a port</title>
<para>If there is the need to replace a port with another port or a
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -916,7 +916,7 @@ Ports failed: 0</screen>
</span> <para>At the end of this section the use of the obsolete PortGroup is suggested
as an even shorter approach to the below described workflow.</para>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="development.replaced_by">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="development.replaced_by">
</span> <title>The long way</title>
<para>Skrooge's original devel port file looked like this:</para>
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1087,7 +1087,7 @@ To report a bug, see <http://guide.macports.org/#project.tickets></screen>
</span>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="development.obsolete-portgroup">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="development.obsolete-portgroup">
</span> <title>The shortcut: PortGroup obsolete</title>
<para>Using the PortGroup obsolete makes the task described in the previous subsection
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1121,7 +1121,7 @@ categories kde finance
</span>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="development.practices.removing-port">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="development.practices.removing-port">
</span> <title>Removing a port</title>
<para>If a port has to be removed from MacPorts one should consider
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1138,7 +1138,7 @@ categories kde finance
</span>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="development.buildbot">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="development.buildbot">
</span> <title>MacPorts' buildbot</title>
<para>The <link xlink:href="https://build.macports.org/">buildbot</link> is a port
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/guide/xml/portfileref.xml b/guide/xml/portfileref.xml
</span><span style='display:block; white-space:pre;color:#808080;'>index 4f9a255..7ab539b 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/guide/xml/portfileref.xml
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/guide/xml/portfileref.xml
</span><span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1,7 +1,7 @@
</span> <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V5.0//EN"
"http://docbook.org/xml/5.0/dtd/docbook.dtd">
<span style='display:block; white-space:pre;background:#ffe0e0;'>-<chapter xml:id="reference">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+<chapter id="reference">
</span> <title>Portfile Reference</title>
<para>This chapter serves as a reference for the major elements of a
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -32,7 +32,7 @@
</span> <xi:include href="portfile-livecheck.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="reference.portgroup">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="reference.portgroup">
</span> <title>PortGroups</title>
<xi:include href="portgroups.xml"
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/guide/xml/portgroup-gnustep.xml b/guide/xml/portgroup-gnustep.xml
</span><span style='display:block; white-space:pre;color:#808080;'>index 2527d68..c86a163 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/guide/xml/portgroup-gnustep.xml
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/guide/xml/portgroup-gnustep.xml
</span><span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1,7 +1,7 @@
</span> <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V5.0//EN"
"http://docbook.org/xml/5.0/dtd/docbook.dtd">
<span style='display:block; white-space:pre;background:#ffe0e0;'>-<section xml:id="reference.portgroup.gnustep">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+<section id="reference.portgroup.gnustep">
</span>
<title>PortGroup gnustep</title>
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -11,7 +11,7 @@
</span> values for GNUstep-based software. A minimum Portfile using the gnustep
PortGroup class need only define the fetch and the checksum phases.</para>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="reference.portgroup.gnustep.portgroup-keywords">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="reference.portgroup.gnustep.portgroup-keywords">
</span> <title>gnustep PortGroup Specific Keywords</title>
<para>Portfiles using the gnustep PortGroup allow for port authors to
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -98,7 +98,7 @@
</span> </variablelist>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="reference.portgroup.gnustep.filesystem-keywords">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="reference.portgroup.gnustep.filesystem-keywords">
</span> <title>gnustep FilesystemLayout Keywords</title>
<para>PortGroup gnustep supports both the traditional gnustep file
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -153,7 +153,7 @@
</span> </variablelist>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="reference.portgroup.gnustep.sugar">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="reference.portgroup.gnustep.sugar">
</span> <title>gnustep PortGroup Sugar</title>
<para>Portfiles using PortGroup gnustep do not need to define the
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/guide/xml/portgroup-haskell.xml b/guide/xml/portgroup-haskell.xml
</span><span style='display:block; white-space:pre;color:#808080;'>index ec850d4..c55328f 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/guide/xml/portgroup-haskell.xml
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/guide/xml/portgroup-haskell.xml
</span><span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1,13 +1,13 @@
</span> <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V5.0//EN"
"http://docbook.org/xml/5.0/dtd/docbook.dtd">
<span style='display:block; white-space:pre;background:#ffe0e0;'>-<section xml:id="reference.portgroup.haskell">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+<section id="reference.portgroup.haskell">
</span>
<title>PortGroup haskell</title>
<para>PortGroup haskell simplifies the addition of Haskell packages.</para>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="reference.portgroup.haskell.keywords">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="reference.portgroup.haskell.keywords">
</span> <title>haskell PortGroup Specific Keywords</title>
<para>Portfiles using the haskell PortGroup allow for port authors to set
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -40,7 +40,7 @@
</span> </variablelist>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="reference.portgroup.haskell.sugar">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="reference.portgroup.haskell.sugar">
</span> <title>haskell PortGroup Sugar</title>
<para>Portfiles using PortGroup haskell do not need to define the
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/guide/xml/portgroup-perl.xml b/guide/xml/portgroup-perl.xml
</span><span style='display:block; white-space:pre;color:#808080;'>index 67343db..a052c7d 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/guide/xml/portgroup-perl.xml
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/guide/xml/portgroup-perl.xml
</span><span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1,14 +1,14 @@
</span> <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V5.0//EN"
"http://docbook.org/xml/5.0/dtd/docbook.dtd">
<span style='display:block; white-space:pre;background:#ffe0e0;'>-<section xml:id="reference.portgroup.perl">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+<section id="reference.portgroup.perl">
</span>
<title>PortGroup perl5</title>
<para>PortGroup perl5 allows for efficient porting of perl modules and
other perl open source software.</para>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="reference.portgroup.perl.keywords">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="reference.portgroup.perl.keywords">
</span> <title>perl5 PortGroup Specific Keywords</title>
<para>Portfiles using the perl5 PortGroup allow for port authors to set
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -59,7 +59,7 @@
</span> </variablelist>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="reference.portgroup.perl.sugar">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="reference.portgroup.perl.sugar">
</span> <title>perl5 PortGroup Sugar</title>
<para>Portfiles using PortGroup perl5 do not need to define the
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -100,7 +100,7 @@
</span> </variablelist>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="reference.portgroup.perl.variables">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="reference.portgroup.perl.variables">
</span> <title>perl5 PortGroup Specific Variables</title>
<para>When the perl5 PortGroup is declared within a Portfile, the
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/guide/xml/portgroup-python.xml b/guide/xml/portgroup-python.xml
</span><span style='display:block; white-space:pre;color:#808080;'>index 1af0898..5be44e2 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/guide/xml/portgroup-python.xml
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/guide/xml/portgroup-python.xml
</span><span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1,7 +1,7 @@
</span> <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V5.0//EN"
"http://docbook.org/xml/5.0/dtd/docbook.dtd">
<span style='display:block; white-space:pre;background:#ffe0e0;'>-<section xml:id="reference.portgroup.python">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+<section id="reference.portgroup.python">
</span>
<title>PortGroup python</title>
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -16,7 +16,7 @@
</span> </para>
</note>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="reference.portgroup.python.keywords">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="reference.portgroup.python.keywords">
</span> <title>python PortGroup Specific Keywords</title>
<para>Portfiles using the python PortGroup allow for port authors to
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -139,7 +139,7 @@
</span> </variablelist>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="reference.portgroup.python.variables">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="reference.portgroup.python.variables">
</span> <title>python PortGroup Specific Variables</title>
<para>When the python PortGroup is declared within a Portfile, the
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -221,7 +221,7 @@
</span> </variablelist>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="reference.portgroup.python.sugar">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="reference.portgroup.python.sugar">
</span> <title>python PortGroup Sugar</title>
<para>Portfiles using PortGroup python do not need to define the
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/guide/xml/portgroup-ruby.xml b/guide/xml/portgroup-ruby.xml
</span><span style='display:block; white-space:pre;color:#808080;'>index 6017e5c..5bedb3e 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/guide/xml/portgroup-ruby.xml
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/guide/xml/portgroup-ruby.xml
</span><span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1,14 +1,14 @@
</span> <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V5.0//EN"
"http://docbook.org/xml/5.0/dtd/docbook.dtd">
<span style='display:block; white-space:pre;background:#ffe0e0;'>-<section xml:id="reference.portgroup.ruby">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+<section id="reference.portgroup.ruby">
</span>
<title>PortGroup ruby</title>
<para>PortGroup ruby allows for efficient porting of ruby-based open
source software.</para>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="reference.portgroup.ruby.variables">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="reference.portgroup.ruby.variables">
</span> <title>ruby PortGroup Specific Variables</title>
<para>When the ruby PortGroup is declared within a Portfile, the
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/guide/xml/portgroup-xcode.xml b/guide/xml/portgroup-xcode.xml
</span><span style='display:block; white-space:pre;color:#808080;'>index 5f3b57b..99c4a20 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/guide/xml/portgroup-xcode.xml
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/guide/xml/portgroup-xcode.xml
</span><span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1,7 +1,7 @@
</span> <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V5.0//EN"
"http://docbook.org/xml/5.0/dtd/docbook.dtd">
<span style='display:block; white-space:pre;background:#ffe0e0;'>-<section xml:id="reference.portgroup.xcode">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+<section id="reference.portgroup.xcode">
</span> <title>PortGroup xcode</title>
<para><code>PortGroup xcode</code> allows for efficient porting of
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -13,7 +13,7 @@
</span> tolerate Xcode version updates because the PortGroup is tested against all
supported OS X and Xcode versions.</para>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="reference.portgroup.xcode.keywords">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="reference.portgroup.xcode.keywords">
</span> <title>xcode PortGroup Specific Keywords</title>
<para>Portfiles using <code>PortGroup xcode</code> allow for port authors
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -236,7 +236,7 @@
</span> </variablelist>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="reference.portgroup.xcode.sugar">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="reference.portgroup.xcode.sugar">
</span> <title>xcode PortGroup Sugar</title>
<para>Portfiles using the xcode PortGroup do not need to define the
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -269,7 +269,7 @@
</span> </variablelist>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="reference.portgroup.xcode.phase-keywords">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="reference.portgroup.xcode.phase-keywords">
</span> <title>Portfile-Phase Keywords Affecting the xcode PortGroup</title>
<para>The following Portfile phase keywords affect the xcode PortGroup in
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/guide/xml/portgroups.xml b/guide/xml/portgroups.xml
</span><span style='display:block; white-space:pre;color:#808080;'>index b35eb23..bb818e0 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/guide/xml/portgroups.xml
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/guide/xml/portgroups.xml
</span><span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1,7 +1,7 @@
</span> <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V5.0//EN"
"http://docbook.org/xml/5.0/dtd/docbook.dtd">
<span style='display:block; white-space:pre;background:#ffe0e0;'>-<section xml:id="reference.portgroup.intro">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+<section id="reference.portgroup.intro">
</span>
<title>PortGroup Introduction</title>
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/guide/xml/project.xml b/guide/xml/project.xml
</span><span style='display:block; white-space:pre;color:#808080;'>index af9f61b..20db00f 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/guide/xml/project.xml
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/guide/xml/project.xml
</span><span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1,10 +1,10 @@
</span> <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V5.0//EN"
"http://docbook.org/xml/5.0/dtd/docbook.dtd">
<span style='display:block; white-space:pre;background:#ffe0e0;'>-<chapter xml:id="project">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+<chapter id="project">
</span> <title>MacPorts Project</title>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="project.tickets">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="project.tickets">
</span> <title>Using Trac for Tickets</title>
<para>The MacPorts Project uses a system called <link
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -14,7 +14,7 @@
</span> xlink:href="https://github.com/join">GitHub account</link> in order to login to
<link xlink:href="https://trac.macports.org/">Trac</link> to create tickets.</para>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="project.tickets.prerequisites">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="project.tickets.prerequisites">
</span> <title>Before Filing a New Ticket</title>
<itemizedlist>
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -78,7 +78,7 @@
</span> </itemizedlist>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="project.tickets.creating">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="project.tickets.creating">
</span> <title>Creating Trac Tickets</title>
<para>Once you are logged into Trac, you may click <link
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -105,7 +105,7 @@
</span> </screenshot>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="project.tickets.guidelines">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="project.tickets.guidelines">
</span> <title>Trac Ticket Guidelines</title>
<para>This is a short overview of the guidelines for Trac tickets. Please
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -491,7 +491,7 @@
</span> </section>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="project.contributing">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="project.contributing">
</span> <title>Contributing to MacPorts</title>
<para>You may contribute new ports and enhancements of any kind to already
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -503,7 +503,7 @@
</span> <!-- Should we have similar sections about committing to base sources and
documentation, or alternatively add this to the following? -->
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="project.contributing.new">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="project.contributing.new">
</span> <title>New Ports</title>
<para>Ports are contributed by following these steps. See the <link
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -553,7 +553,7 @@
</span> </orderedlist>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="project.contributing.updates">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="project.contributing.updates">
</span> <title>Port Enhancements</title>
<para>Enhancements to existing ports may comprise new functionality for
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -626,7 +626,7 @@
</span> </orderedlist>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="project.contributing.maintaining">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="project.contributing.maintaining">
</span> <title>Becoming a Port Maintainer</title>
<para>MacPorts is always looking for people that want to take care of
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -871,7 +871,7 @@ To use the current port, you must be in a port's directory.</screen>
</span> </section>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="project.update-policies">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="project.update-policies">
</span> <title>Port Update Policies</title>
<para>Port maintainers normally are given commit privileges to the
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -882,7 +882,7 @@ To use the current port, you must be in a port's directory.</screen>
</span> port it is a good practice to inform a port's maintainer. See details
below.</para>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="project.update-policies.nonmaintainer">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="project.update-policies.nonmaintainer">
</span> <title>Non-Maintainer Port Updates</title>
<para>If you have a port update or bugfix for a port you do not
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -943,7 +943,7 @@ To use the current port, you must be in a port's directory.</screen>
</span> </itemizedlist>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="project.update-policies.abandonment">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="project.update-policies.abandonment">
</span> <title>Port Abandonment</title>
<para>A port may be considered abandoned if any of the following apply:</para>
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -995,10 +995,10 @@ To use the current port, you must be in a port's directory.</screen>
</span> </section>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="project.docs">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="project.docs">
</span> <title>Updating Documentation</title>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="project.docs.guide">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="project.docs.guide">
</span> <title>Updating the Guide</title>
<para>
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1007,7 +1007,7 @@ To use the current port, you must be in a port's directory.</screen>
</span> encouraged to submit a pull request following the steps outlined below.
</para>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="project.docs.guide.one-time">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="project.docs.guide.one-time">
</span> <title>Preparing Changes</title>
<procedure>
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1025,7 +1025,7 @@ To use the current port, you must be in a port's directory.</screen>
</span> </procedure>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="project.docs.guide.each-time">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="project.docs.guide.each-time">
</span> <title>Proposing a Change</title>
<para>For each change you want to make:</para>
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1068,7 +1068,7 @@ To use the current port, you must be in a port's directory.</screen>
</span> </section>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="project.membership">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="project.membership">
</span> <title>MacPorts Membership</title>
<para>A requirement for a person to become a MacPorts committer is to
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1127,7 +1127,7 @@ To use the current port, you must be in a port's directory.</screen>
</span>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="project.portmgr">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="project.portmgr">
</span> <title>The PortMgr Team</title>
<para>The MacPorts PortMgr team is the steering group for The MacPorts
<span style='display:block; white-space:pre;color:#808080;'>diff --git a/guide/xml/using.xml b/guide/xml/using.xml
</span><span style='display:block; white-space:pre;color:#808080;'>index 09ba53e..fdbd9ca 100644
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>--- a/guide/xml/using.xml
</span><span style='display:block; white-space:pre;background:#e0e0ff;'>+++ b/guide/xml/using.xml
</span><span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -6,20 +6,20 @@
</span> <!ENTITY macports-prev-version "2.4.1">
<!ENTITY macports-version "2.4.2">
]>
<span style='display:block; white-space:pre;background:#ffe0e0;'>-<chapter xml:id="using">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+<chapter id="using">
</span> <title>Using MacPorts</title>
<para>This chapter describes using <command>port</command>, port variants, common tasks and port
binaries.</para>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="using.port">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="using.port">
</span> <title>The port Command</title>
<para><command>port</command> is the main utility used to interact with MacPorts. It is
used to update <filename>Portfile</filename>s and the MacPorts infrastructure, and install and manage
ports.</para>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="using.port.help">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="using.port.help">
</span> <title>port help</title>
<para>The <option>help</option> action shows some brief information about the specified action, or if no
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -37,7 +37,7 @@ Upgrade MacPorts itself and run the sync target
</span> MacPorts.</screen>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="using.port.selfupdate">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="using.port.selfupdate">
</span> <title>port selfupdate</title>
<para>The <option>selfupdate</option> action should be used regularly to update the local ports tree with
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -92,7 +92,7 @@ Upgrade MacPorts itself and run the sync target
</span> </variablelist>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="using.port.sync">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="using.port.sync">
</span> <title>port sync</title>
<para>The <option>sync</option> action performs a subset of <option>selfupdate</option>. It synchronizes the
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -103,7 +103,7 @@ Upgrade MacPorts itself and run the sync target
</span> <para><option>sync</option> does not accept any switches.</para>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="using.port.diagnose">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="using.port.diagnose">
</span> <title>port diagnose</title>
<para>The <option>diagnose</option> action checks for common issues in the user's environment and reports all
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -125,7 +125,7 @@ Upgrade MacPorts itself and run the sync target
</span> </note>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="using.port.reclaim">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="using.port.reclaim">
</span> <title>port reclaim</title>
<para>The <option>reclaim</option> action attempts to reclaim space by uninstalling inactive ports, and
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -138,7 +138,7 @@ Upgrade MacPorts itself and run the sync target
</span> </note>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="using.port.list">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="using.port.list">
</span> <title>port list</title>
<para>The <option>list</option> action lists the currently available version of the specified ports, or if
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -163,7 +163,7 @@ Upgrade MacPorts itself and run the sync target
</span> </note>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="using.port.search">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="using.port.search">
</span> <title>port search</title>
<para>The <option>search</option> action allows finding ports by partial matches of the name or description.
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -361,7 +361,7 @@ Found 11 ports.</screen>
</span> </variablelist>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="using.port.info">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="using.port.info">
</span> <title>port info</title>
<para>The <option>info</option> action is used to get information about a port: name, version, description,
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -387,7 +387,7 @@ License: BSD
</span> Maintainers: cal@macports.org</screen>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="using.port.deps">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="using.port.deps">
</span> <title>port deps</title>
<para>The <option>deps</option> action lists the dependencies of a port. Dependencies are the packages are
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -431,7 +431,7 @@ Maintainers: cal@macports.org</screen>
</span>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="using.port.variants">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="using.port.variants">
</span> <title>port variants</title>
<para>The <option>variants</option> action allows you to check what variations of a port are available
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -464,7 +464,7 @@ apache2 has the variants:
</span> <filename>variants.conf</filename>.</para>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="using.port.install">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="using.port.install">
</span> <title>port install</title>
<para>The action <option>install</option> is used to install a port. Once you determined the name of a port
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -542,7 +542,7 @@ apache2 has the variants:
</span> </variablelist>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="using.port.clean">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="using.port.clean">
</span> <title>port clean</title>
<para>The action <option>clean</option> deletes intermediate files created by MacPorts while installing
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -600,7 +600,7 @@ apache2 has the variants:
</span> </variablelist>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="using.port.uninstall">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="using.port.uninstall">
</span> <title>port uninstall</title>
<para>The <option>uninstall</option> action will remove an installed port. It is one of the actions you will
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -665,7 +665,7 @@ Error: port uninstall failed: Please uninstall the ports that depend on libcomer
</span> </variablelist>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="using.port.contents">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="using.port.contents">
</span> <title>port contents</title>
<para>The <option>contents</option> action displays a list of all files that have been installed by a given
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -753,7 +753,7 @@ Port xorg-renderproto contains:
</span> </variablelist>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="using.port.installed">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="using.port.installed">
</span> <title>port installed</title>
<para>The <option>installed</option> action displays the installed versions and variants of the specified
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -791,7 +791,7 @@ The following ports are currently installed:
</span> libsdl @1.2.15_3-x11 (active) platform='darwin 13' archs='x86_64'</screen>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="using.port.outdated">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="using.port.outdated">
</span> <title>port outdated</title>
<para>The <option>outdated</option> action checks your installed ports against the current ports tree to see
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -818,7 +818,7 @@ p5.16-ipc-run 0.910.0_1 < 0.920.0_0</screen>
</span> version number. If it isn't, more details will be given.</para>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="using.port.upgrade">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="using.port.upgrade">
</span> <title>port upgrade</title>
<para>The <option>upgrade</option> action upgrades installed ports and their dependencies to the latest
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -899,7 +899,7 @@ p5.16-ipc-run 0.910.0_1 < 0.920.0_0</screen>
</span> </variablelist>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="using.port.dependents">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="using.port.dependents">
</span> <title>port dependents</title>
<para>The <option>dependents</option> action reports what ports depend upon a given (installed) port, if
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -933,7 +933,7 @@ wireshark depends on openssl</screen>
</span> <para>This command will, however, not cover dependencies that are only present in non-default variants.</para>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="using.port.livecheck">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="using.port.livecheck">
</span> <title>port livecheck</title>
<para>The <option>livecheck</option> action checks to see if the application corresponding to a given port
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -953,7 +953,7 @@ wireshark depends on openssl</screen>
</span> </note>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="using.port.lint">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="using.port.lint">
</span> <title>port lint</title>
<para>The lint action checks if the <filename>Portfile</filename> conforms to the MacPorts standards
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -992,7 +992,7 @@ Warning: no license set
</span> </section>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="using.variants">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="using.variants">
</span> <title>Port Variants</title>
<para>Variants are a way for port authors to provide options for a port that may be chosen at installation.
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1026,7 +1026,7 @@ apache2 has the variants:
</span> linkend="internals.configuration-files.variants-conf" /> for more information on
<filename>variants.conf</filename>.</para>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="using.variants.invoking">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="using.variants.invoking">
</span> <title>Invoking Variants</title>
<para>A variant can only be selected when a port is installed. After you have determined what variants
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1061,7 +1061,7 @@ apache2 has the variants:
</span> later, the same variants will be used, unless you manually specify different variants.</para>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="using.variants.negating">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="using.variants.negating">
</span> <title>Negating Default Variants</title>
<para>A <filename>Portfile</filename> can specify a default set of variants that will be used when you do
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1076,7 +1076,7 @@ apache2 has the variants:
</span> </section>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="using.common-tasks">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="using.common-tasks">
</span> <title>Common Tasks</title>
<para>This section lists common operations you may want to perform when managing a MacPorts installation. These
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1088,7 +1088,7 @@ apache2 has the variants:
</span> <para>Mind the <quote>sudo</quote> for some of the subsequent examples, which is necessary if you have a default
MacPorts installation.</para>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="using.common-tasks.updating">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="using.common-tasks.updating">
</span> <title>Updating Your Ports Tree</title>
<para>The local ports tree is a collection of files that contain information on which packages are available
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1108,7 +1108,7 @@ apache2 has the variants:
</span> <!-- --> port upgrade outdated</screen>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="using.common-tasks.showports">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="using.common-tasks.showports">
</span> <title>Show Ports Which Need Updating</title>
<para>To see what's new after running <option>selfupdate</option>, you can use <command>port
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1131,7 +1131,7 @@ apache2 has the variants:
</span> <!-- -->p5.16-ipc-run 0.910.0_1 < 0.920.0_0</screen>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="using.common-tasks.upgrading">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="using.common-tasks.upgrading">
</span> <title>Upgrading Outdated Ports</title>
<para>To upgrade all your installed and outdated ports, run</para>
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1166,7 +1166,7 @@ apache2 has the variants:
</span> avoiding the update of the dependency defeats the purpose of the reinstallation.</para>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="using.common-tasks.removeinactive">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="using.common-tasks.removeinactive">
</span> <title>Removing Inactive Version(s) of Upgraded Port(s)</title>
<para>By default, upgrading ports in MacPorts does not remove the older versions. This is a safety measure
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1228,7 +1228,7 @@ apache2 has the variants:
</span> <programlisting><prompt>$ </prompt><userinput>sudo port uninstall inactive and not <replaceable>portname</replaceable></userinput></programlisting>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="using.common-tasks.finddepending">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="using.common-tasks.finddepending">
</span> <title>Finding Ports Depending on a Certain Port</title>
<para>If you want to find all ports that depend on a given other port, you can use</para>
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1263,7 +1263,7 @@ apache2 has the variants:
</span> <!-- --> gnupg2 @2.0.25_0 (active)</screen>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="using.common-tasks.findleaves">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="using.common-tasks.findleaves">
</span> <title>Finding Leaves</title>
<para>After a while of using MacPorts, installing and uninstalling ports, packages that have been
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1303,7 +1303,7 @@ apache2 has the variants:
</span> <programlisting><prompt>$ </prompt><userinput>sudo port_cutleaves</userinput></programlisting>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="using.common-tasks.keeplean">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="using.common-tasks.keeplean">
</span> <title>Keep Your Installation Lean by Defining Leaves as Requested Ports</title>
<para>Well, before we come to the procedure of defining your requested ports, let's have a look at a typical
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1454,13 +1454,13 @@ apache2 has the variants:
</span> </section>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="using.binaries">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="using.binaries">
</span> <title>Port Binaries</title>
<para>MacPorts can pre-compile ports into binaries so applications need not be compiled when installing on
a target system. MacPorts supports two types of binaries: archives and packages.</para>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="using.binaries.archives">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="using.binaries.archives">
</span> <title>Binary Archives</title>
<para>Binary archives can only be used on a target system running MacPorts. They allow MacPorts utilities to
<span style='display:block; white-space:pre;background:#e0e0e0;'>@@ -1518,7 +1518,7 @@ apache2 has the variants:
</span> <option>cpgz</option>, and <option>cpio</option>.</para>
</section>
<span style='display:block; white-space:pre;background:#ffe0e0;'>- <section xml:id="using.binaries.binary-packages">
</span><span style='display:block; white-space:pre;background:#e0ffe0;'>+ <section id="using.binaries.binary-packages">
</span> <title>Binary Packages</title>
<para>Binary packages are standalone binary installers that are precompiled; they do not require MacPorts on
</pre><pre style='margin:0'>
</pre>