macports/macports-guide
0
0
Fork 0
mirror of https://github.com/macports/macports-guide.git synced 2026-07-12 18:18:46 -07:00
Code Issues Packages Projects Releases Wiki Activity

Revert "guide: convert from xml:id to id"

Browse Source 
This reverts commit 4a9c1024ac.
This commit is contained in:
Rainer Müller
2017-11-16 12:03:48 +01:00
parent 4a9c1024ac
commit d5badd23da
28 changed files with 195 additions and 195 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Makefile
+2 -2
View File
@@ -73,7 +73,7 @@ endif
# 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) \
's|(<h[0-9] [^>]*><a id="([^"]*)"></a>)([^<]*)(</h[0-9]>)|\1<a href="#\2">\3</a>\4|g' \
's|(<h[0-9] [^>]*><a xml:id="([^"]*)"></a>)([^<]*)(</h[0-9]>)|\1<a href="#\2">\3</a>\4|g' \
$(GUIDE_RESULT)/index.html
# Generate the chunked HTML guide with one section per file.
@@ -92,7 +92,7 @@ endif
# 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) \
's|(<h[0-9] [^>]*><a id="([^"]*)"></a>)([^<]*)(</h[0-9]>)|\1<a href="#\2">\3</a>\4|g' \
's|(<h[0-9] [^>]*><a xml:id="([^"]*)"></a>)([^<]*)(</h[0-9]>)|\1<a href="#\2">\3</a>\4|g' \
$(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.
guide/resources/tabs.xsl
+2 -2
View File
@@ -1,7 +1,7 @@
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version='1.0'>
<xsl:template name="user.header.content">
<div class="book">
<div id="tabswitch">
<div xml:id="tabswitch">
<a href="/index.html">
<xsl:if test="$chunkmode = 0">
<xsl:attribute name="class">selected</xsl:attribute>
@@ -16,6 +16,6 @@
</a>
</div>
</div>
<div id="vh-test"></div> <!-- needed for the sticky sidebar -->
<div xml:id="vh-test"></div> <!-- needed for the sticky sidebar -->
</xsl:template>
</xsl:stylesheet>
guide/xml/glossary.xml
+3 -3
View File
@@ -1,15 +1,15 @@
<?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">
<chapter id="guide-terms">
<chapter xml:id="guide-terms">
<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>
<glossary id="glossary">
<glossdiv id="terms">
<glossary xml:id="glossary">
<glossdiv xml:id="terms">
<title>MacPorts Guide Terms</title>
<glossentry>
guide/xml/installing.xml
+18 -18
View File
@@ -5,7 +5,7 @@
"http://docbook.org/xml/5.0/dtd/docbook.dtd"[
<!ENTITY macports-version "2.4.2">
]>
<chapter id="installing">
<chapter xml:id="installing">
<title>Installing MacPorts</title>
<para>This chapter shows you how to install MacPorts and its prerequisites step-by-step. Note that the section about
@@ -14,7 +14,7 @@
linkend="installing.macports.source">installing MacPorts from source</link>, and continue to the end of the
chapter.</para>
<section id="installing.xcode">
<section xml:id="installing.xcode">
<title>Install Xcode</title>
<para><link xlink:href="https://developer.apple.com/xcode/">Xcode</link> is a package provided by Apple containing
@@ -29,7 +29,7 @@
<para>Follow the instructions for your version of macOS:</para>
<section id="installing.xcode.mavericks">
<section xml:id="installing.xcode.mavericks">
<title>Install Xcode on OS X 10.9 or Later</title>
<para>Download the latest version of Xcode <link
@@ -45,7 +45,7 @@
Apple developer website</link>.</para>
</section>
<section id="installing.xcode.lion">
<section xml:id="installing.xcode.lion">
<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
@@ -53,7 +53,7 @@
get it <link xlink:href="http://itunes.apple.com/us/app/xcode/id497799835">using the Mac App
Store</link>.</para>
<section id="installing.xcode.lion.43">
<section xml:id="installing.xcode.lion.43">
<title>Xcode 4.3 and Later</title>
<para>Xcode 4.3 and later do not automatically install the command line tools, but MacPorts requires
@@ -69,7 +69,7 @@
</section>
</section>
<section id="installing.xcode.snowleopard">
<section xml:id="installing.xcode.snowleopard">
<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
@@ -111,7 +111,7 @@
</itemizedlist>
</section>
<section id="installing.xcode.other">
<section xml:id="installing.xcode.other">
<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
@@ -138,7 +138,7 @@
</section>
</section>
<section id="installing.macports">
<section xml:id="installing.macports">
<title>Install MacPorts</title>
<para>If you are using macOS, you should install MacPorts using the macOS package installer unless you do not wish
@@ -148,7 +148,7 @@
MacPorts on another OS platform, you must <link linkend="installing.macports.source">install MacPorts from
the source code</link>.</para>
<section id="installing.macports.binary">
<section xml:id="installing.macports.binary">
<title>macOS Package Install</title>
<para>The macOS package installer automatically installs MacPorts, <link linkend="installing.shell">sets the
@@ -211,7 +211,7 @@
</orderedlist>
</section>
<section id="installing.macports.source">
<section xml:id="installing.macports.source">
<title>Source Install</title>
<para>If you installed MacPorts using the package installer, skip this section. To install MacPorts from the
@@ -247,7 +247,7 @@
</orderedlist>
</section>
<section id="installing.macports.git">
<section xml:id="installing.macports.git">
<title>Git Install</title>
<para>If you installed MacPorts using the package installer, skip this section.</para>
@@ -323,7 +323,7 @@
</orderedlist>
</section>
<section id="installing.macports.source.multiple">
<section xml:id="installing.macports.source.multiple">
<title>Install Multiple MacPorts Copies</title>
<para>Occasionally a MacPorts developer may wish to install more than one MacPorts instance on the same
@@ -350,7 +350,7 @@
</section>
</section>
<section id="installing.macports.upgrade">
<section xml:id="installing.macports.upgrade">
<title>MacPorts Upgrade</title>
<para>MacPorts base upgrades are performed automatically (when a newer release is available) during a <link
@@ -360,7 +360,7 @@
code.</para>
</section>
<section id="installing.macports.uninstalling">
<section xml:id="installing.macports.uninstalling">
<title>Uninstall</title>
<para>Uninstalling MacPorts can be a drastic step, and depending on the issue you are experiencing, you may not
@@ -402,7 +402,7 @@
not all of the above paths will exist on your system. This is OK.</para>
</section>
<section id="installing.shell">
<section xml:id="installing.shell">
<title>MacPorts and the Shell</title>
<para>MacPorts requires that some environment variables be set in the shell. When MacPorts is installed using
@@ -416,7 +416,7 @@
<filename>.profile</filename>, <filename>.bash_login</filename>, <filename>.bash_profile</filename>,
<filename>.tcshrc</filename>, or <filename>.cshrc</filename>.</para>
<section id="installing.shell.postflight">
<section xml:id="installing.shell.postflight">
<title>The Postflight Script</title>
<para>The postflight script automatically sets the <varname>PATH</varname> variable, and optionally the
@@ -478,7 +478,7 @@
</itemizedlist>
</section>
<section id="installing.shell.verifyprofile">
<section xml:id="installing.shell.verifyprofile">
<title>Verify the Configuration File</title>
<para>To verify that the file containing the MacPorts variables is in effect, type <command>env</command> in
@@ -508,7 +508,7 @@
<!-- -->_=/usr/bin/env</screen>
</section>
<section id="installing.shell.editorvar">
<section xml:id="installing.shell.editorvar">
<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>
guide/xml/internals-hier.xml
+1 -1
View File
@@ -1,7 +1,7 @@
<?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">
<refentry id="porthier">
<refentry xml:id="porthier">
<refmeta>
<refentrytitle>PORTHIER</refentrytitle>
guide/xml/internals.xml
+10 -10
View File
@@ -1,14 +1,14 @@
<?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">
<chapter id="internals">
<chapter xml:id="internals">
<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>
<section id="internals.hierarchy">
<section xml:id="internals.hierarchy">
<title>File Hierarchy</title>
<xi:include href="internals-hier.xml"
@@ -18,7 +18,7 @@
<xi:include href="macports.conf.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
<section id="internals.images">
<section xml:id="internals.images">
<title>Port Images</title>
<para>MacPorts has a unique ability to allow multiple versions,
@@ -41,7 +41,7 @@
</para>
</section>
<section id="internals.apis">
<section xml:id="internals.apis">
<title>APIs and Libs</title>
<para>The MacPorts system is composed of three Tcl libraries:</para>
@@ -61,7 +61,7 @@
</listitem>
</itemizedlist>
<section id="internals.apis.ports">
<section xml:id="internals.apis.ports">
<title>Ports API</title>
<para>The code for the Port API is located in
@@ -123,7 +123,7 @@
</itemizedlist>
</section>
<section id="internals.apis.macports">
<section xml:id="internals.apis.macports">
<title>MacPorts API</title>
<para>The code for the MacPorts API is located in
@@ -274,7 +274,7 @@
</itemizedlist>
</section>
<section id="internals.apis.pextlib">
<section xml:id="internals.apis.pextlib">
<title>pextlib</title>
<para>The pextlib Tcl library provides a variety of C extensions to add
@@ -283,7 +283,7 @@
</section>
</section>
<section id="internals.registry">
<section xml:id="internals.registry">
<title>The MacPorts Registry</title>
<para>This chapter provides an overview of the MacPorts registry and its
@@ -312,7 +312,7 @@
</listitem>
</itemizedlist>
<section id="internals.registry.files">
<section xml:id="internals.registry.files">
<title>Registry Files</title>
<para>The SQLite registry used by default is located at
@@ -336,7 +336,7 @@
</para>
</section>
<section id="internals.registry.api">
<section xml:id="internals.registry.api">
<title>The Registry API</title>
<para>The MacPorts registry provides a public API in the registry1.0 Tcl
guide/xml/intro.xml
+1 -1
View File
@@ -3,7 +3,7 @@
-->
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V5.0//EN"
"http://docbook.org/xml/5.0/dtd/docbook.dtd">
<chapter id="introduction">
<chapter xml:id="introduction">
<title>Introduction</title>
<para>MacPorts is an easy to use system for compiling, installing, and managing open source software. MacPorts may
guide/xml/macports.conf.xml
+4 -4
View File
@@ -1,7 +1,7 @@
<?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">
<section id="internals.configuration-files">
<section xml:id="internals.configuration-files">
<title>Configuration Files</title>
<para>The MacPorts configuration files often do not need to be modified for the
@@ -19,7 +19,7 @@
separated by either a space or a tab. Lines beginning with '#' are comments,
empty lines are ignored.</para>
<section id="internals.configuration-files.macports-conf">
<section xml:id="internals.configuration-files.macports-conf">
<title>macports.conf</title>
<para>macports.conf is the configuration file used to bootstrap the
@@ -415,7 +415,7 @@
</variablelist>
</section>
<section id="internals.configuration-files.sources-conf">
<section xml:id="internals.configuration-files.sources-conf">
<title>sources.conf</title>
<para>This file enables rsync synchronization of the default ports tree
@@ -429,7 +429,7 @@
<replaceable>file:///path/to/localportsrepository</replaceable></para>
</section>
<section id="internals.configuration-files.variants-conf">
<section xml:id="internals.configuration-files.variants-conf">
<title>variants.conf</title>
<para>This optional file specifies any variants you'd like to be invoked
guide/xml/macros.xml
+1 -1
View File
@@ -3,7 +3,7 @@
"http://docbook.org/xml/5.0/dtd/docbook.dtd">
<!-- This section will be hidden by a xsl:template in resources/base.xsl -->
<chapter id='macros'>
<chapter xml:id='macros'>
<title>Macros</title>
<warning role='macro-outdated'><para>
guide/xml/portfile-dependencies.xml
+2 -2
View File
@@ -1,7 +1,7 @@
<?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">
<section id="reference.dependencies">
<section xml:id="reference.dependencies">
<title>Dependencies</title>
<para>Free and open source software is highly modular, and MacPorts ports
@@ -122,7 +122,7 @@
</varlistentry>
</variablelist>
<section id="reference.dependencies.types">
<section xml:id="reference.dependencies.types">
<title>Port and File Dependencies</title>
<para>There are two types of dependencies: port dependencies and file
guide/xml/portfile-keywords.xml
+2 -2
View File
@@ -1,7 +1,7 @@
<?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">
<section id="reference.keywords">
<section xml:id="reference.keywords">
<title>Global Keywords</title>
<para>MacPorts keywords are used to specify required or optional items
@@ -104,7 +104,7 @@
</listitem>
</varlistentry>
<varlistentry id="reference.keywords.maintainers">
<varlistentry xml:id="reference.keywords.maintainers">
<term>maintainers</term>
<listitem>
guide/xml/portfile-livecheck.xml
+1 -1
View File
@@ -2,7 +2,7 @@
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V5.0//EN"
"http://docbook.org/xml/5.0/dtd/docbook.dtd">
<section id="reference.livecheck">
<section xml:id="reference.livecheck">
<title>Livecheck / Distcheck</title>
<para>Options livecheck and distcheck are especially useful for port
guide/xml/portfile-phase.xml
+24 -24
View File
@@ -1,10 +1,10 @@
<?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">
<section id="reference.phases">
<section xml:id="reference.phases">
<title>Port Phases</title>
<section id="reference.phases.introduction">
<section xml:id="reference.phases.introduction">
<title>Introduction</title>
<para>The MacPorts port installation process has a number of distinct
@@ -161,7 +161,7 @@
</variablelist>
</section>
<section id="reference.phases.installation">
<section xml:id="reference.phases.installation">
<title>Installation Phase Keywords</title>
<para>MacPorts keywords are used to specify required or optional items
@@ -175,7 +175,7 @@
phases and set options for those phases, and they take effect whether or
not phase declarations have been explicitly defined in a Portfile.</para>
<section id="reference.phases.installation.list-modifiers">
<section xml:id="reference.phases.installation.list-modifiers">
<title>Keyword List Modifiers (-append, -delete, -replace, -strsed)</title>
<para>Keyword list modifiers are keywords that end in -append, -delete or
@@ -259,7 +259,7 @@
</orderedlist>
</section>
<section id="reference.phases.installation.argument-modifiers">
<section xml:id="reference.phases.installation.argument-modifiers">
<title>Keyword Argument Modifiers (.pre_args / .post_args)</title>
<para>Keywords that support pre_args and post_args are used to assemble
@@ -272,7 +272,7 @@
</section>
</section>
<section id="reference.phases.fetch">
<section xml:id="reference.phases.fetch">
<title>Fetch Phase Keywords</title>
<para>The list of keywords related to the fetch phase.</para>
@@ -516,14 +516,14 @@ distfiles file_one.tar.gz:tagone \
</varlistentry>
</variablelist>
<section id="reference.phases.fetch.advanced">
<section xml:id="reference.phases.fetch.advanced">
<title>Advanced Fetch Options</title>
<para>Some mirrors require special options for a resource to be properly
fetched.</para>
<variablelist>
<varlistentry id="reference.phases.fetch.advanced.fetch-type">
<varlistentry xml:id="reference.phases.fetch.advanced.fetch-type">
<term>fetch.type</term>
<listitem>
@@ -642,7 +642,7 @@ svn.revision 2100</programlisting>
</variablelist>
</section>
<section id="reference.phases.fetch.bzr">
<section xml:id="reference.phases.fetch.bzr">
<title>Fetch from BZR</title>
<para><link xlink:href="http://bazaar.canonical.com/en/">Bzr</link> may be used as
@@ -700,7 +700,7 @@ svn.revision 2100</programlisting>
</variablelist>
</section>
<section id="reference.phases.fetch.cvs">
<section xml:id="reference.phases.fetch.cvs">
<title>Fetch from CVS</title>
<para><link xlink:href="http://www.nongnu.org/cvs/">CVS</link> may be used as
@@ -817,7 +817,7 @@ svn.revision 2100</programlisting>
</section>
<section id="reference.phases.fetch.git">
<section xml:id="reference.phases.fetch.git">
<title>Fetch from Git</title>
<para><link xlink:href="http://git-scm.com/">Git</link> may be used as an
@@ -878,7 +878,7 @@ svn.revision 2100</programlisting>
</variablelist>
</section>
<section id="reference.phases.fetch.hg">
<section xml:id="reference.phases.fetch.hg">
<title>Fetch from Mercurial</title>
<para><link xlink:href="http://mercurial.selenic.com/">Mercurial</link> may be
@@ -939,7 +939,7 @@ svn.revision 2100</programlisting>
</variablelist>
</section>
<section id="reference.phases.fetch.svn">
<section xml:id="reference.phases.fetch.svn">
<title>Fetch from Subversion</title>
<para><link xlink:href="http://subversion.apache.org/">Subversion</link> may
@@ -1024,7 +1024,7 @@ svn.revision 2100</programlisting>
</section>
</section>
<section id="reference.phases.checksum">
<section xml:id="reference.phases.checksum">
<title>Checksum Phase Keywords</title>
<para>The list of keywords related to the checksum phase.</para>
@@ -1065,7 +1065,7 @@ svn.revision 2100</programlisting>
</variablelist>
</section>
<section id="reference.phases.extract">
<section xml:id="reference.phases.extract">
<title>Extract Phase Keywords</title>
<para>The list of keywords related to the extract phase.</para>
@@ -1370,7 +1370,7 @@ extract.post_args "| gnutar -x"</programlisting>
</variablelist>
</section>
<section id="reference.phases.patch">
<section xml:id="reference.phases.patch">
<title>Patch Phase Keywords</title>
<para>The list of keywords related to the patch phase.</para>
@@ -1497,7 +1497,7 @@ patch.post_args ???</programlisting>
</variablelist>
</section>
<section id="reference.phases.configure">
<section xml:id="reference.phases.configure">
<title>Configure Phase Keywords</title>
<para>The list of keywords related to the configure phase.</para>
@@ -1588,7 +1588,7 @@ configure.env-delete TCLROOT=${prefix}</programlisting>
</listitem>
</varlistentry>
<varlistentry id="reference.phases.configure.optflags">
<varlistentry xml:id="reference.phases.configure.optflags">
<term>configure.optflags</term>
<term>configure.optflags-append</term>
@@ -1617,7 +1617,7 @@ configure.optflags-delete -Os</programlisting>
</listitem>
</varlistentry>
<varlistentry id="reference.phases.configure.cflags">
<varlistentry xml:id="reference.phases.configure.cflags">
<term>configure.cflags</term>
<term>configure.cflags-append</term>
@@ -2339,7 +2339,7 @@ configure.post_args OPT="-D__DARWIN_UNIX03"</programlisting>
</varlistentry>
</variablelist>
<section id="reference.phases.configure.universal">
<section xml:id="reference.phases.configure.universal">
<title>Configure Universal</title>
<para>Universal keywords are used to make a port compile on OS X for
@@ -2474,7 +2474,7 @@ configure.post_args OPT="-D__DARWIN_UNIX03"</programlisting>
</variablelist>
</section>
<section id="reference.phases.configure.automake-autoconf">
<section xml:id="reference.phases.configure.automake-autoconf">
<title>Automake, Autoconf, and Autoreconf</title>
<para>The list of configure keywords available for ports that need
@@ -2664,7 +2664,7 @@ configure.post_args OPT="-D__DARWIN_UNIX03"</programlisting>
</section>
</section>
<section id="reference.phases.build">
<section xml:id="reference.phases.build">
<title>Build Phase Keywords</title>
<para>The list of keywords related to the build phase.</para>
@@ -2874,7 +2874,7 @@ build.target-delete compat</programlisting>
</variablelist>
</section>
<section id="reference.phases.test">
<section xml:id="reference.phases.test">
<title>Test Phase Keywords</title>
<para>The list of keywords related to the test phase.</para>
@@ -3012,7 +3012,7 @@ build.target-delete compat</programlisting>
</variablelist>
</section>
<section id="reference.phases.destroot">
<section xml:id="reference.phases.destroot">
<title>Destroot Phase Keywords</title>
<para>The list of keywords related to the destroot phase.</para>
guide/xml/portfile-startupitem.xml
+6 -6
View File
@@ -1,7 +1,7 @@
<?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">
<section id="reference.startupitems">
<section xml:id="reference.startupitems">
<title>StartupItems</title>
<para>A StartupItem is a MacPorts facility to run <quote>daemons,</quote> a Unix term for
@@ -28,7 +28,7 @@
in Portfiles; this prevents StartupItems from being created.</para>
</note>
<section id="reference.startupitems.attributes">
<section xml:id="reference.startupitems.attributes">
<title>StartupItem Attributes</title>
<para>The keywords in this section may be used with either
@@ -145,7 +145,7 @@
</variablelist>
</section>
<section id="reference.startupitems.executable">
<section xml:id="reference.startupitems.executable">
<title>Executable StartupItems</title>
<para>Daemons run continuously, so monitoring the health of daemon
@@ -231,7 +231,7 @@
</variablelist>
</section>
<section id="reference.startupitems.script">
<section xml:id="reference.startupitems.script">
<title>Script StartupItems</title>
<para>StartupItems of type <quote>script</quote> create a wrapper during
@@ -406,7 +406,7 @@ startupitem.restart "${prefix}/share/mysql/mysql.server restart"</programlis
</variablelist>
</section>
<section id="reference.startupitems.launchd">
<section xml:id="reference.startupitems.launchd">
<title>Loading / Unloading StartupItems into launchd</title>
<para>A port with a StartupItem places a link to a .plist file for the
@@ -425,7 +425,7 @@ startupitem.restart "${prefix}/share/mysql/mysql.server restart"</programlis
<programlisting><prompt>%%</prompt> <userinput>sudo launchctl unload -w /Library/LaunchDaemons/org.macports.mysql5.plist</userinput></programlisting>
</section>
<section id="reference.startupitems.internals">
<section xml:id="reference.startupitems.internals">
<title>StartupItem Internals</title>
<para>During port installation a MacPorts StartupItem creates a .plist
guide/xml/portfile-tcl.xml
+6 -6
View File
@@ -1,7 +1,7 @@
<?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">
<section id="reference.tcl-extensions">
<section xml:id="reference.tcl-extensions">
<title>Tcl Extensions &amp; Useful Tcl Commands</title>
<para>A MacPorts Portfile is a Tcl script, so it may contain any arbitrary
@@ -226,7 +226,7 @@
</listitem>
</varlistentry>
<varlistentry id="reference.tcl-extensions.strsed">
<varlistentry xml:id="reference.tcl-extensions.strsed">
<term>strsed</term>
<listitem>
@@ -325,8 +325,8 @@
<variablelist>
<varlistentry>
<term>adduser username [uid=<replaceable>uid</replaceable>]
[gid=<replaceable>gid</replaceable>]
<term>adduser username [uxml:id=<replaceable>uid</replaceable>]
[gxml:id=<replaceable>gid</replaceable>]
[passwd=<replaceable>passwd</replaceable>]
[realname=<replaceable>realname</replaceable>]
[home=<replaceable>home</replaceable>]
@@ -365,7 +365,7 @@
<variablelist>
<varlistentry>
<term>addgroup <replaceable>group</replaceable>
[gid=<replaceable>gid</replaceable>]
[gxml:id=<replaceable>gid</replaceable>]
[passwd=<replaceable>passwd</replaceable>]
[realname=<replaceable>realname</replaceable>]
[users=<replaceable>users</replaceable>]</term>
@@ -387,7 +387,7 @@
gid. This can be used with adduser:</para>
<programlisting>addgroup foo
adduser foo gid=[existsgroup foo]</programlisting>
adduser foo gxml:id=[existsgroup foo]</programlisting>
</listitem>
</varlistentry>
</variablelist>
guide/xml/portfile-variables.xml
+1 -1
View File
@@ -1,7 +1,7 @@
<?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">
<section id="reference.variables">
<section xml:id="reference.variables">
<title>Global Variables</title>
<para>Global variables are variables available to any Portfile. For a list
guide/xml/portfile-variants.xml
+4 -4
View File
@@ -1,7 +1,7 @@
<?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">
<section id="reference.variants">
<section xml:id="reference.variants">
<title>Variants</title>
<para>MacPorts variants are conditional modifications of port installation
@@ -11,7 +11,7 @@
selected automatically by MacPorts base according to the OS or hardware
platform (darwin, freebsd, linux, i386, powerpc, etc.).</para>
<section id="reference.variants.user-selected">
<section xml:id="reference.variants.user-selected">
<title>User-Selected Variants</title>
<para>User-selected variants are those that are defined so a user can
@@ -123,7 +123,7 @@
</variablelist>
</section>
<section id="reference.variants.descriptions">
<section xml:id="reference.variants.descriptions">
<title>User-Selected Variant Descriptions</title>
<para>User-selected variants ought to provide a description, which will be
@@ -148,7 +148,7 @@
port descriptions and long_descriptions.</para>
</section>
<section id="reference.variants.platform">
<section xml:id="reference.variants.platform">
<title>Platform Variants</title>
<para>Platform variants are either defined by default in MacPorts base, or
guide/xml/portfiledev.xml
+29 -29
View File
@@ -1,7 +1,7 @@
<?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">
<chapter id="development">
<chapter xml:id="development">
<title>Portfile Development</title>
<para>A port is a distribution of software that can be compiled and
@@ -19,7 +19,7 @@
within. The only required file in a port is the
<filename>Portfile</filename>.</para>
<section id="development.introduction">
<section xml:id="development.introduction">
<title>Portfile Introduction</title>
<para>A MacPorts Portfile is a <link
@@ -90,7 +90,7 @@
</note>
</section>
<section id="development.creating-portfile">
<section xml:id="development.creating-portfile">
<title>Creating a Portfile</title>
<para>Here we list the individual Portfile components for an application
@@ -302,7 +302,7 @@ Error: Processing of port rrdtool failed</screen>
</orderedlist>
</section>
<section id="development.examples">
<section xml:id="development.examples">
<title>Example Portfiles</title>
<para>In this section we begin by taking a look at a complete simple
@@ -314,7 +314,7 @@ Error: Processing of port rrdtool failed</screen>
linkend="development.examples.eliminate">eliminate port
phases</link>.</para>
<section id="development.examples.basic">
<section xml:id="development.examples.basic">
<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
@@ -344,7 +344,7 @@ configure.args --enable-perl-site-install \
--mandir=${prefix}/share/man</programlisting>
</section>
<section id="development.examples.augment">
<section xml:id="development.examples.augment">
<title>Augment Phases Using pre- / post-</title>
<para>To augment a port's installation phase, and not override it, you
@@ -359,7 +359,7 @@ configure.args --enable-perl-site-install \
}</programlisting>
</section>
<section id="development.examples.override">
<section xml:id="development.examples.override">
<title>Overriding Phases</title>
<para>To override the automatic MacPorts installation phase processing,
@@ -371,7 +371,7 @@ configure.args --enable-perl-site-install \
}</programlisting>
</section>
<section id="development.examples.eliminate">
<section xml:id="development.examples.eliminate">
<title>Eliminating Phases</title>
<para>To eliminate a default phase, simply define a phase with no
@@ -389,7 +389,7 @@ configure.args --enable-perl-site-install \
</note>
</section>
<section id="development.examples.startupitem">
<section xml:id="development.examples.startupitem">
<title>Creating a StartupItem</title>
<para>Startupitems may be placed in the global section of a
@@ -401,7 +401,7 @@ startupitem.executable "${prefix}/bin/nmicmpd"</programlisting>
</section>
</section>
<section id="development.variants">
<section xml:id="development.variants">
<title>Port Variants</title>
<para>Variants are a way for port authors to provide options that may be
@@ -410,7 +410,7 @@ startupitem.executable "${prefix}/bin/nmicmpd"</programlisting>
linkend="reference.variants.descriptions">carefully chosen variant
descriptions</link>.</para>
<section id="development.variants.options">
<section xml:id="development.variants.options">
<title>Example Variants</title>
<para>The most common actions for user-selected variants is to add or
@@ -472,7 +472,7 @@ variant sqlite description {Build sqlite support} {
}</programlisting>
</section>
<section id="development.variants.phase">
<section xml:id="development.variants.phase">
<title>Variant Actions in a Phase</title>
<para>If a variant requires options in addition to those provided by
@@ -494,7 +494,7 @@ variant sqlite description {Build sqlite support} {
}</programlisting>
</section>
<section id="development.variants.default">
<section xml:id="development.variants.default">
<title>Default Variants</title>
<para>Variants are used to specify actions that lie outside the core
@@ -513,7 +513,7 @@ variant sqlite description {Build sqlite support} {
</section>
</section>
<section id="development.patches">
<section xml:id="development.patches">
<title>Patch Files</title>
<para>Patch files are files created with the Unix command
@@ -521,7 +521,7 @@ variant sqlite description {Build sqlite support} {
<command>patch</command> to modify text files to fix bugs or extend
functionality.</para>
<section id="development.patches.portfile">
<section xml:id="development.patches.portfile">
<title>Creating Portfile Patches</title>
<para>If you wish to contribute modifications or fixes to a Portfile,
@@ -584,7 +584,7 @@ variant sqlite description {Build sqlite support} {
the port author to evaluate.</para>
</section>
<section id="development.patches.source">
<section xml:id="development.patches.source">
<title>Creating Source Code Patches</title>
<para>Necessary or useful patches to application source code should
@@ -696,7 +696,7 @@ variant sqlite description {Build sqlite support} {
</orderedlist>
</section>
<section id="development.patches.applying">
<section xml:id="development.patches.applying">
<title>Manually Applying Patches</title>
<para>MacPorts applies patch files automatically, but you may want to
@@ -725,7 +725,7 @@ variant sqlite description {Build sqlite support} {
</section>
</section>
<section id="development.local-repositories">
<section xml:id="development.local-repositories">
<title>Local Portfile Repositories</title>
<para>To create and test Portfiles that are not yet published in the MacPorts ports tree,
@@ -810,14 +810,14 @@ Ports failed: 0</screen>
The Best Ever Game</screen>
</section>
<section id="development.practices">
<section xml:id="development.practices">
<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>
<section id="development.practices.portstyle">
<section xml:id="development.practices.portstyle">
<title>Port Style</title>
<para>Portfiles may be thought of as a set of declarations rather than
@@ -873,25 +873,25 @@ Ports failed: 0</screen>
${destroot}${prefix}/var/cache/mrtg</programlisting>
</section>
<section id="development.practices.dont-overwrite">
<section xml:id="development.practices.dont-overwrite">
<title>Don't Overwrite Config Files</title>
<para>TODO:</para>
</section>
<section id="development.practices.install-docs">
<section xml:id="development.practices.install-docs">
<title>Install Docs and Examples</title>
<para>TODO:</para>
</section>
<section id="development.practices.provide-messages">
<section xml:id="development.practices.provide-messages">
<title>Provide User Messages</title>
<para>TODO:</para>
</section>
<section id="development.practices.use-variables">
<section xml:id="development.practices.use-variables">
<title>Use Variables</title>
<para>TODO: Set variables so changing paths may be done in one place;
@@ -900,7 +900,7 @@ Ports failed: 0</screen>
</section>
<section id="development.practices.rename-replace-port">
<section xml:id="development.practices.rename-replace-port">
<title>Renaming or replacing a port</title>
<para>If there is the need to replace a port with another port or a
@@ -916,7 +916,7 @@ Ports failed: 0</screen>
<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>
<section id="development.replaced_by">
<section xml:id="development.replaced_by">
<title>The long way</title>
<para>Skrooge's original devel port file looked like this:</para>
@@ -1087,7 +1087,7 @@ To report a bug, see &lt;http://guide.macports.org/#project.tickets&gt;</screen>
</section>
<section id="development.obsolete-portgroup">
<section xml:id="development.obsolete-portgroup">
<title>The shortcut: PortGroup obsolete</title>
<para>Using the PortGroup obsolete makes the task described in the previous subsection
@@ -1121,7 +1121,7 @@ categories kde finance
</section>
<section id="development.practices.removing-port">
<section xml:id="development.practices.removing-port">
<title>Removing a port</title>
<para>If a port has to be removed from MacPorts one should consider
@@ -1138,7 +1138,7 @@ categories kde finance
</section>
<section id="development.buildbot">
<section xml:id="development.buildbot">
<title>MacPorts' buildbot</title>
<para>The <link xlink:href="https://build.macports.org/">buildbot</link> is a port
guide/xml/portfileref.xml
+2 -2
View File
@@ -1,7 +1,7 @@
<?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">
<chapter id="reference">
<chapter xml:id="reference">
<title>Portfile Reference</title>
<para>This chapter serves as a reference for the major elements of a
@@ -32,7 +32,7 @@
<xi:include href="portfile-livecheck.xml"
xmlns:xi="http://www.w3.org/2001/XInclude" />
<section id="reference.portgroup">
<section xml:id="reference.portgroup">
<title>PortGroups</title>
<xi:include href="portgroups.xml"
guide/xml/portgroup-gnustep.xml
+4 -4
View File
@@ -1,7 +1,7 @@
<?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">
<section id="reference.portgroup.gnustep">
<section xml:id="reference.portgroup.gnustep">
<title>PortGroup gnustep</title>
@@ -11,7 +11,7 @@
values for GNUstep-based software. A minimum Portfile using the gnustep
PortGroup class need only define the fetch and the checksum phases.</para>
<section id="reference.portgroup.gnustep.portgroup-keywords">
<section xml:id="reference.portgroup.gnustep.portgroup-keywords">
<title>gnustep PortGroup Specific Keywords</title>
<para>Portfiles using the gnustep PortGroup allow for port authors to
@@ -98,7 +98,7 @@
</variablelist>
</section>
<section id="reference.portgroup.gnustep.filesystem-keywords">
<section xml:id="reference.portgroup.gnustep.filesystem-keywords">
<title>gnustep FilesystemLayout Keywords</title>
<para>PortGroup gnustep supports both the traditional gnustep file
@@ -153,7 +153,7 @@
</variablelist>
</section>
<section id="reference.portgroup.gnustep.sugar">
<section xml:id="reference.portgroup.gnustep.sugar">
<title>gnustep PortGroup Sugar</title>
<para>Portfiles using PortGroup gnustep do not need to define the

Some files were not shown because too many files have changed in this diff Show More