From d5badd23dacf34d8ec7f54b8b17f30d720fb25eb Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Rainer=20M=C3=BCller?= Date: Thu, 16 Nov 2017 12:03:48 +0100 Subject: [PATCH] Revert "guide: convert from xml:id to id" This reverts commit 4a9c1024acf48077e84dd8ae6a5d1b13c145c35a. --- 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(-) diff --git a/Makefile b/Makefile index 2cab679..dc0410e 100644 --- a/Makefile +++ b/Makefile @@ -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|(]*>)([^<]*)()|\1\3\4|g' \ + 's|(]*>)([^<]*)()|\1\3\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|(]*>)([^<]*)()|\1\3\4|g' \ + 's|(]*>)([^<]*)()|\1\3\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. diff --git a/guide/resources/tabs.xsl b/guide/resources/tabs.xsl index 4da2d73..c10e446 100644 --- a/guide/resources/tabs.xsl +++ b/guide/resources/tabs.xsl @@ -1,7 +1,7 @@
- -
+
diff --git a/guide/xml/glossary.xml b/guide/xml/glossary.xml index a0345eb..0c63537 100644 --- a/guide/xml/glossary.xml +++ b/guide/xml/glossary.xml @@ -1,15 +1,15 @@ - + MacPorts Guide Glossary 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. - - + + MacPorts Guide Terms diff --git a/guide/xml/installing.xml b/guide/xml/installing.xml index 2b3b56c..ada4f96 100644 --- a/guide/xml/installing.xml +++ b/guide/xml/installing.xml @@ -5,7 +5,7 @@ "http://docbook.org/xml/5.0/dtd/docbook.dtd"[ ]> - + Installing MacPorts 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, and continue to the end of the chapter. -
+
Install Xcode Xcode is a package provided by Apple containing @@ -29,7 +29,7 @@ Follow the instructions for your version of macOS: -
+
Install Xcode on OS X 10.9 or Later Download the latest version of Xcode .
-
+
Install Xcode on OS X 10.7 Lion or OS X 10.8 Mountain Lion Download the latest version of Xcode using the Mac App Store. -
+
Xcode 4.3 and Later Xcode 4.3 and later do not automatically install the command line tools, but MacPorts requires @@ -69,7 +69,7 @@
-
+
Install Xcode on Mac OS X 10.6 Snow Leopard 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 @@
-
+
Install Xcode on Older Releases of Mac OS X 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 @@
-
+
Install MacPorts 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 install MacPorts from the source code. -
+
macOS Package Install The macOS package installer automatically installs MacPorts, sets the @@ -211,7 +211,7 @@
-
+
Source Install If you installed MacPorts using the package installer, skip this section. To install MacPorts from the @@ -247,7 +247,7 @@
-
+
Git Install If you installed MacPorts using the package installer, skip this section. @@ -323,7 +323,7 @@
-
+
Install Multiple MacPorts Copies Occasionally a MacPorts developer may wish to install more than one MacPorts instance on the same @@ -350,7 +350,7 @@
-
+
MacPorts Upgrade MacPorts base upgrades are performed automatically (when a newer release is available) during a
-
+
Uninstall 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.
-
+
MacPorts and the Shell MacPorts requires that some environment variables be set in the shell. When MacPorts is installed using @@ -416,7 +416,7 @@ .profile, .bash_login, .bash_profile, .tcshrc, or .cshrc. -
+
The Postflight Script The postflight script automatically sets the PATH variable, and optionally the @@ -478,7 +478,7 @@
-
+
Verify the Configuration File To verify that the file containing the MacPorts variables is in effect, type env in @@ -508,7 +508,7 @@ _=/usr/bin/env
-
+
Optional Editor Variables You can set an environment variable in order to use your favorite text editor with the port edit diff --git a/guide/xml/internals-hier.xml b/guide/xml/internals-hier.xml index c295ba8..d52b579 100644 --- a/guide/xml/internals-hier.xml +++ b/guide/xml/internals-hier.xml @@ -1,7 +1,7 @@ - + PORTHIER diff --git a/guide/xml/internals.xml b/guide/xml/internals.xml index e5b7135..13be48a 100644 --- a/guide/xml/internals.xml +++ b/guide/xml/internals.xml @@ -1,14 +1,14 @@ - + MacPorts Internals This chapter contains information about the MacPorts file layout, configuration files, a few fundamental port installation concepts, and the MacPorts APIs. -
+
File Hierarchy -
+
Port Images MacPorts has a unique ability to allow multiple versions, @@ -41,7 +41,7 @@
-
+
APIs and Libs The MacPorts system is composed of three Tcl libraries: @@ -61,7 +61,7 @@ -
+
Ports API The code for the Port API is located in @@ -123,7 +123,7 @@
-
+
MacPorts API The code for the MacPorts API is located in @@ -274,7 +274,7 @@
-
+
pextlib The pextlib Tcl library provides a variety of C extensions to add @@ -283,7 +283,7 @@
-
+
The MacPorts Registry This chapter provides an overview of the MacPorts registry and its @@ -312,7 +312,7 @@ -
+
Registry Files The SQLite registry used by default is located at @@ -336,7 +336,7 @@
-
+
The Registry API The MacPorts registry provides a public API in the registry1.0 Tcl diff --git a/guide/xml/intro.xml b/guide/xml/intro.xml index 34dcd0d..d62d0e3 100644 --- a/guide/xml/intro.xml +++ b/guide/xml/intro.xml @@ -3,7 +3,7 @@ --> - + Introduction MacPorts is an easy to use system for compiling, installing, and managing open source software. MacPorts may diff --git a/guide/xml/macports.conf.xml b/guide/xml/macports.conf.xml index 660cad7..d42ec07 100644 --- a/guide/xml/macports.conf.xml +++ b/guide/xml/macports.conf.xml @@ -1,7 +1,7 @@ -
+
Configuration Files 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. -
+
macports.conf macports.conf is the configuration file used to bootstrap the @@ -415,7 +415,7 @@
-
+
sources.conf This file enables rsync synchronization of the default ports tree @@ -429,7 +429,7 @@ file:///path/to/localportsrepository
-
+
variants.conf This optional file specifies any variants you'd like to be invoked diff --git a/guide/xml/macros.xml b/guide/xml/macros.xml index 45b27ac..3f94328 100644 --- a/guide/xml/macros.xml +++ b/guide/xml/macros.xml @@ -3,7 +3,7 @@ "http://docbook.org/xml/5.0/dtd/docbook.dtd"> - + Macros diff --git a/guide/xml/portfile-dependencies.xml b/guide/xml/portfile-dependencies.xml index 301bd69..641f13c 100644 --- a/guide/xml/portfile-dependencies.xml +++ b/guide/xml/portfile-dependencies.xml @@ -1,7 +1,7 @@ -
+
Dependencies Free and open source software is highly modular, and MacPorts ports @@ -122,7 +122,7 @@ -
+
Port and File Dependencies There are two types of dependencies: port dependencies and file diff --git a/guide/xml/portfile-keywords.xml b/guide/xml/portfile-keywords.xml index 105a6ac..56e7284 100644 --- a/guide/xml/portfile-keywords.xml +++ b/guide/xml/portfile-keywords.xml @@ -1,7 +1,7 @@ -
+
Global Keywords MacPorts keywords are used to specify required or optional items @@ -104,7 +104,7 @@ - + maintainers diff --git a/guide/xml/portfile-livecheck.xml b/guide/xml/portfile-livecheck.xml index 07e9e0a..b350d9d 100644 --- a/guide/xml/portfile-livecheck.xml +++ b/guide/xml/portfile-livecheck.xml @@ -2,7 +2,7 @@ -
+
Livecheck / Distcheck Options livecheck and distcheck are especially useful for port diff --git a/guide/xml/portfile-phase.xml b/guide/xml/portfile-phase.xml index 40ef3a6..f21e774 100644 --- a/guide/xml/portfile-phase.xml +++ b/guide/xml/portfile-phase.xml @@ -1,10 +1,10 @@ -
+
Port Phases -
+
Introduction The MacPorts port installation process has a number of distinct @@ -161,7 +161,7 @@
-
+
Installation Phase Keywords 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. -
+
Keyword List Modifiers (-append, -delete, -replace, -strsed) Keyword list modifiers are keywords that end in -append, -delete or @@ -259,7 +259,7 @@
-
+
Keyword Argument Modifiers (.pre_args / .post_args) Keywords that support pre_args and post_args are used to assemble @@ -272,7 +272,7 @@
-
+
Fetch Phase Keywords The list of keywords related to the fetch phase. @@ -516,14 +516,14 @@ distfiles file_one.tar.gz:tagone \ -
+
Advanced Fetch Options Some mirrors require special options for a resource to be properly fetched. - + fetch.type @@ -642,7 +642,7 @@ svn.revision 2100
-
+
Fetch from BZR Bzr may be used as @@ -700,7 +700,7 @@ svn.revision 2100
-
+
Fetch from CVS CVS may be used as @@ -817,7 +817,7 @@ svn.revision 2100
-
+
Fetch from Git Git may be used as an @@ -878,7 +878,7 @@ svn.revision 2100
-
+
Fetch from Mercurial Mercurial may be @@ -939,7 +939,7 @@ svn.revision 2100
-
+
Fetch from Subversion Subversion may @@ -1024,7 +1024,7 @@ svn.revision 2100
-
+
Checksum Phase Keywords The list of keywords related to the checksum phase. @@ -1065,7 +1065,7 @@ svn.revision 2100
-
+
Extract Phase Keywords The list of keywords related to the extract phase. @@ -1370,7 +1370,7 @@ extract.post_args "| gnutar -x"
-
+
Patch Phase Keywords The list of keywords related to the patch phase. @@ -1497,7 +1497,7 @@ patch.post_args ???
-
+
Configure Phase Keywords The list of keywords related to the configure phase. @@ -1588,7 +1588,7 @@ configure.env-delete TCLROOT=${prefix} - + configure.optflags configure.optflags-append @@ -1617,7 +1617,7 @@ configure.optflags-delete -Os - + configure.cflags configure.cflags-append @@ -2339,7 +2339,7 @@ configure.post_args OPT="-D__DARWIN_UNIX03" -
+
Configure Universal Universal keywords are used to make a port compile on OS X for @@ -2474,7 +2474,7 @@ configure.post_args OPT="-D__DARWIN_UNIX03"
-
+
Automake, Autoconf, and Autoreconf The list of configure keywords available for ports that need @@ -2664,7 +2664,7 @@ configure.post_args OPT="-D__DARWIN_UNIX03"
-
+
Build Phase Keywords The list of keywords related to the build phase. @@ -2874,7 +2874,7 @@ build.target-delete compat
-
+
Test Phase Keywords The list of keywords related to the test phase. @@ -3012,7 +3012,7 @@ build.target-delete compat
-
+
Destroot Phase Keywords The list of keywords related to the destroot phase. diff --git a/guide/xml/portfile-startupitem.xml b/guide/xml/portfile-startupitem.xml index 0e7fe8d..ad98e10 100644 --- a/guide/xml/portfile-startupitem.xml +++ b/guide/xml/portfile-startupitem.xml @@ -1,7 +1,7 @@ -
+
StartupItems A StartupItem is a MacPorts facility to run daemons, a Unix term for @@ -28,7 +28,7 @@ in Portfiles; this prevents StartupItems from being created. -
+
StartupItem Attributes The keywords in this section may be used with either @@ -145,7 +145,7 @@
-
+
Executable StartupItems Daemons run continuously, so monitoring the health of daemon @@ -231,7 +231,7 @@
-
+
Script StartupItems StartupItems of type script create a wrapper during @@ -406,7 +406,7 @@ startupitem.restart "${prefix}/share/mysql/mysql.server restart"
-
+
Loading / Unloading StartupItems into launchd 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"%% sudo launchctl unload -w /Library/LaunchDaemons/org.macports.mysql5.plist
-
+
StartupItem Internals During port installation a MacPorts StartupItem creates a .plist diff --git a/guide/xml/portfile-tcl.xml b/guide/xml/portfile-tcl.xml index b5a9dad..859e38f 100644 --- a/guide/xml/portfile-tcl.xml +++ b/guide/xml/portfile-tcl.xml @@ -1,7 +1,7 @@ -
+
Tcl Extensions & Useful Tcl Commands A MacPorts Portfile is a Tcl script, so it may contain any arbitrary @@ -226,7 +226,7 @@ - + strsed @@ -325,8 +325,8 @@ - adduser username [uid=uid] - [gid=gid] + adduser username [uxml:id=uid] + [gxml:id=gid] [passwd=passwd] [realname=realname] [home=home] @@ -365,7 +365,7 @@ addgroup group - [gid=gid] + [gxml:id=gid] [passwd=passwd] [realname=realname] [users=users] @@ -387,7 +387,7 @@ gid. This can be used with adduser: addgroup foo -adduser foo gid=[existsgroup foo] +adduser foo gxml:id=[existsgroup foo] diff --git a/guide/xml/portfile-variables.xml b/guide/xml/portfile-variables.xml index 6125de1..67cee8c 100644 --- a/guide/xml/portfile-variables.xml +++ b/guide/xml/portfile-variables.xml @@ -1,7 +1,7 @@ -
+
Global Variables Global variables are variables available to any Portfile. For a list diff --git a/guide/xml/portfile-variants.xml b/guide/xml/portfile-variants.xml index 17c7785..74a260f 100644 --- a/guide/xml/portfile-variants.xml +++ b/guide/xml/portfile-variants.xml @@ -1,7 +1,7 @@ -
+
Variants 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.). -
+
User-Selected Variants User-selected variants are those that are defined so a user can @@ -123,7 +123,7 @@
-
+
User-Selected Variant Descriptions User-selected variants ought to provide a description, which will be @@ -148,7 +148,7 @@ port descriptions and long_descriptions.
-
+
Platform Variants Platform variants are either defined by default in MacPorts base, or diff --git a/guide/xml/portfiledev.xml b/guide/xml/portfiledev.xml index 4126c75..878743e 100644 --- a/guide/xml/portfiledev.xml +++ b/guide/xml/portfiledev.xml @@ -1,7 +1,7 @@ - + Portfile Development 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 Portfile. -
+
Portfile Introduction A MacPorts Portfile is a
-
+
Creating a Portfile Here we list the individual Portfile components for an application @@ -302,7 +302,7 @@ Error: Processing of port rrdtool failed
-
+
Example Portfiles In this section we begin by taking a look at a complete simple @@ -314,7 +314,7 @@ Error: Processing of port rrdtool failed linkend="development.examples.eliminate">eliminate port phases. -
+
A Basic Portfile # -*- 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
-
+
Augment Phases Using pre- / post- To augment a port's installation phase, and not override it, you @@ -359,7 +359,7 @@ configure.args --enable-perl-site-install \ }
-
+
Overriding Phases To override the automatic MacPorts installation phase processing, @@ -371,7 +371,7 @@ configure.args --enable-perl-site-install \ }
-
+
Eliminating Phases To eliminate a default phase, simply define a phase with no @@ -389,7 +389,7 @@ configure.args --enable-perl-site-install \
-
+
Creating a StartupItem Startupitems may be placed in the global section of a @@ -401,7 +401,7 @@ startupitem.executable "${prefix}/bin/nmicmpd"
-
+
Port Variants Variants are a way for port authors to provide options that may be @@ -410,7 +410,7 @@ startupitem.executable "${prefix}/bin/nmicmpd" linkend="reference.variants.descriptions">carefully chosen variant descriptions. -
+
Example Variants The most common actions for user-selected variants is to add or @@ -472,7 +472,7 @@ variant sqlite description {Build sqlite support} { }
-
+
Variant Actions in a Phase If a variant requires options in addition to those provided by @@ -494,7 +494,7 @@ variant sqlite description {Build sqlite support} { }
-
+
Default Variants Variants are used to specify actions that lie outside the core @@ -513,7 +513,7 @@ variant sqlite description {Build sqlite support} {
-
+
Patch Files Patch files are files created with the Unix command @@ -521,7 +521,7 @@ variant sqlite description {Build sqlite support} { patch to modify text files to fix bugs or extend functionality. -
+
Creating Portfile Patches 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.
-
+
Creating Source Code Patches Necessary or useful patches to application source code should @@ -696,7 +696,7 @@ variant sqlite description {Build sqlite support} {
-
+
Manually Applying Patches MacPorts applies patch files automatically, but you may want to @@ -725,7 +725,7 @@ variant sqlite description {Build sqlite support} {
-
+
Local Portfile Repositories To create and test Portfiles that are not yet published in the MacPorts ports tree, @@ -810,14 +810,14 @@ Ports failed: 0 The Best Ever Game
-
+
Portfile Best Practices This section contains practical guidelines for creating Portfiles that install smoothly and provide consistency between ports. The following sections are on the TODO list. -
+
Port Style Portfiles may be thought of as a set of declarations rather than @@ -873,25 +873,25 @@ Ports failed: 0 ${destroot}${prefix}/var/cache/mrtg
-
+
Don't Overwrite Config Files TODO:
-
+
Install Docs and Examples TODO:
-
+
Provide User Messages TODO:
-
+
Use Variables TODO: Set variables so changing paths may be done in one place; @@ -900,7 +900,7 @@ Ports failed: 0
-
+
Renaming or replacing a port If there is the need to replace a port with another port or a @@ -916,7 +916,7 @@ Ports failed: 0 At the end of this section the use of the obsolete PortGroup is suggested as an even shorter approach to the below described workflow. -
+
The long way Skrooge's original devel port file looked like this: @@ -1087,7 +1087,7 @@ To report a bug, see <http://guide.macports.org/#project.tickets>
-
+
The shortcut: PortGroup obsolete Using the PortGroup obsolete makes the task described in the previous subsection @@ -1121,7 +1121,7 @@ categories kde finance
-
+
Removing a port If a port has to be removed from MacPorts one should consider @@ -1138,7 +1138,7 @@ categories kde finance
-
+
MacPorts' buildbot The buildbot is a port diff --git a/guide/xml/portfileref.xml b/guide/xml/portfileref.xml index 7ab539b..4f9a255 100644 --- a/guide/xml/portfileref.xml +++ b/guide/xml/portfileref.xml @@ -1,7 +1,7 @@ - + Portfile Reference This chapter serves as a reference for the major elements of a @@ -32,7 +32,7 @@ -
+
PortGroups -
+
PortGroup gnustep @@ -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. -
+
gnustep PortGroup Specific Keywords Portfiles using the gnustep PortGroup allow for port authors to @@ -98,7 +98,7 @@
-
+
gnustep FilesystemLayout Keywords PortGroup gnustep supports both the traditional gnustep file @@ -153,7 +153,7 @@
-
+
gnustep PortGroup Sugar Portfiles using PortGroup gnustep do not need to define the diff --git a/guide/xml/portgroup-haskell.xml b/guide/xml/portgroup-haskell.xml index c55328f..ec850d4 100644 --- a/guide/xml/portgroup-haskell.xml +++ b/guide/xml/portgroup-haskell.xml @@ -1,13 +1,13 @@ -
+
PortGroup haskell PortGroup haskell simplifies the addition of Haskell packages. -
+
haskell PortGroup Specific Keywords Portfiles using the haskell PortGroup allow for port authors to set @@ -40,7 +40,7 @@
-
+
haskell PortGroup Sugar Portfiles using PortGroup haskell do not need to define the diff --git a/guide/xml/portgroup-perl.xml b/guide/xml/portgroup-perl.xml index a052c7d..67343db 100644 --- a/guide/xml/portgroup-perl.xml +++ b/guide/xml/portgroup-perl.xml @@ -1,14 +1,14 @@ -
+
PortGroup perl5 PortGroup perl5 allows for efficient porting of perl modules and other perl open source software. -
+
perl5 PortGroup Specific Keywords Portfiles using the perl5 PortGroup allow for port authors to set @@ -59,7 +59,7 @@
-
+
perl5 PortGroup Sugar Portfiles using PortGroup perl5 do not need to define the @@ -100,7 +100,7 @@
-
+
perl5 PortGroup Specific Variables When the perl5 PortGroup is declared within a Portfile, the diff --git a/guide/xml/portgroup-python.xml b/guide/xml/portgroup-python.xml index 5be44e2..1af0898 100644 --- a/guide/xml/portgroup-python.xml +++ b/guide/xml/portgroup-python.xml @@ -1,7 +1,7 @@ -
+
PortGroup python @@ -16,7 +16,7 @@ -
+
python PortGroup Specific Keywords Portfiles using the python PortGroup allow for port authors to @@ -139,7 +139,7 @@
-
+
python PortGroup Specific Variables When the python PortGroup is declared within a Portfile, the @@ -221,7 +221,7 @@
-
+
python PortGroup Sugar Portfiles using PortGroup python do not need to define the diff --git a/guide/xml/portgroup-ruby.xml b/guide/xml/portgroup-ruby.xml index 5bedb3e..6017e5c 100644 --- a/guide/xml/portgroup-ruby.xml +++ b/guide/xml/portgroup-ruby.xml @@ -1,14 +1,14 @@ -
+
PortGroup ruby PortGroup ruby allows for efficient porting of ruby-based open source software. -
+
ruby PortGroup Specific Variables When the ruby PortGroup is declared within a Portfile, the diff --git a/guide/xml/portgroup-xcode.xml b/guide/xml/portgroup-xcode.xml index 99c4a20..5f3b57b 100644 --- a/guide/xml/portgroup-xcode.xml +++ b/guide/xml/portgroup-xcode.xml @@ -1,7 +1,7 @@ -
+
PortGroup xcode PortGroup xcode allows for efficient porting of @@ -13,7 +13,7 @@ tolerate Xcode version updates because the PortGroup is tested against all supported OS X and Xcode versions. -
+
xcode PortGroup Specific Keywords Portfiles using PortGroup xcode allow for port authors @@ -236,7 +236,7 @@
-
+
xcode PortGroup Sugar Portfiles using the xcode PortGroup do not need to define the @@ -269,7 +269,7 @@
-
+
Portfile-Phase Keywords Affecting the xcode PortGroup The following Portfile phase keywords affect the xcode PortGroup in diff --git a/guide/xml/portgroups.xml b/guide/xml/portgroups.xml index bb818e0..b35eb23 100644 --- a/guide/xml/portgroups.xml +++ b/guide/xml/portgroups.xml @@ -1,7 +1,7 @@ -
+
PortGroup Introduction diff --git a/guide/xml/project.xml b/guide/xml/project.xml index 20db00f..af9f61b 100644 --- a/guide/xml/project.xml +++ b/guide/xml/project.xml @@ -1,10 +1,10 @@ - + MacPorts Project -
+
Using Trac for Tickets The MacPorts Project uses a system called GitHub account in order to login to Trac to create tickets. -
+
Before Filing a New Ticket @@ -78,7 +78,7 @@
-
+
Creating Trac Tickets Once you are logged into Trac, you may click
-
+
Trac Ticket Guidelines This is a short overview of the guidelines for Trac tickets. Please @@ -491,7 +491,7 @@
-
+
Contributing to MacPorts You may contribute new ports and enhancements of any kind to already @@ -503,7 +503,7 @@ -
+
New Ports Ports are contributed by following these steps. See the
-
+
Port Enhancements Enhancements to existing ports may comprise new functionality for @@ -626,7 +626,7 @@
-
+
Becoming a Port Maintainer MacPorts is always looking for people that want to take care of @@ -871,7 +871,7 @@ To use the current port, you must be in a port's directory.
-
+
Port Update Policies Port maintainers normally are given commit privileges to the @@ -882,7 +882,7 @@ To use the current port, you must be in a port's directory. port it is a good practice to inform a port's maintainer. See details below. -
+
Non-Maintainer Port Updates If you have a port update or bugfix for a port you do not @@ -943,7 +943,7 @@ To use the current port, you must be in a port's directory.
-
+
Port Abandonment A port may be considered abandoned if any of the following apply: @@ -995,10 +995,10 @@ To use the current port, you must be in a port's directory.
-
+
Updating Documentation -
+
Updating the Guide @@ -1007,7 +1007,7 @@ To use the current port, you must be in a port's directory. encouraged to submit a pull request following the steps outlined below. -
+
Preparing Changes @@ -1025,7 +1025,7 @@ To use the current port, you must be in a port's directory.
-
+
Proposing a Change For each change you want to make: @@ -1068,7 +1068,7 @@ To use the current port, you must be in a port's directory.
-
+
MacPorts Membership A requirement for a person to become a MacPorts committer is to @@ -1127,7 +1127,7 @@ To use the current port, you must be in a port's directory.
-
+
The PortMgr Team The MacPorts PortMgr team is the steering group for The MacPorts diff --git a/guide/xml/using.xml b/guide/xml/using.xml index fdbd9ca..09ba53e 100644 --- a/guide/xml/using.xml +++ b/guide/xml/using.xml @@ -6,20 +6,20 @@ ]> - + Using MacPorts This chapter describes using port, port variants, common tasks and port binaries. -
+
The port Command port is the main utility used to interact with MacPorts. It is used to update Portfiles and the MacPorts infrastructure, and install and manage ports. -
+
port help The action shows some brief information about the specified action, or if no @@ -37,7 +37,7 @@ Upgrade MacPorts itself and run the sync target MacPorts.
-
+
port selfupdate The action should be used regularly to update the local ports tree with @@ -92,7 +92,7 @@ Upgrade MacPorts itself and run the sync target
-
+
port sync The action performs a subset of . It synchronizes the @@ -103,7 +103,7 @@ Upgrade MacPorts itself and run the sync target does not accept any switches.
-
+
port diagnose The action checks for common issues in the user's environment and reports all @@ -125,7 +125,7 @@ Upgrade MacPorts itself and run the sync target
-
+
port reclaim The action attempts to reclaim space by uninstalling inactive ports, and @@ -138,7 +138,7 @@ Upgrade MacPorts itself and run the sync target
-
+
port list The action lists the currently available version of the specified ports, or if @@ -163,7 +163,7 @@ Upgrade MacPorts itself and run the sync target
-
+
port search The action allows finding ports by partial matches of the name or description. @@ -361,7 +361,7 @@ Found 11 ports.
-
+
port info The action is used to get information about a port: name, version, description, @@ -387,7 +387,7 @@ License: BSD Maintainers: cal@macports.org
-
+
port deps The action lists the dependencies of a port. Dependencies are the packages are @@ -431,7 +431,7 @@ Maintainers: cal@macports.org
-
+
port variants The action allows you to check what variations of a port are available @@ -464,7 +464,7 @@ apache2 has the variants: variants.conf.
-
+
port install The action is used to install a port. Once you determined the name of a port @@ -542,7 +542,7 @@ apache2 has the variants:
-
+
port clean The action deletes intermediate files created by MacPorts while installing @@ -600,7 +600,7 @@ apache2 has the variants:
-
+
port uninstall The action will remove an installed port. It is one of the actions you will @@ -665,7 +665,7 @@ Error: port uninstall failed: Please uninstall the ports that depend on libcomer
-
+
port contents The action displays a list of all files that have been installed by a given @@ -753,7 +753,7 @@ Port xorg-renderproto contains:
-
+
port installed The action displays the installed versions and variants of the specified @@ -791,7 +791,7 @@ The following ports are currently installed: libsdl @1.2.15_3-x11 (active) platform='darwin 13' archs='x86_64'
-
+
port outdated The action checks your installed ports against the current ports tree to see @@ -818,7 +818,7 @@ p5.16-ipc-run 0.910.0_1 < 0.920.0_0 version number. If it isn't, more details will be given.
-
+
port upgrade The action upgrades installed ports and their dependencies to the latest @@ -899,7 +899,7 @@ p5.16-ipc-run 0.910.0_1 < 0.920.0_0
-
+
port dependents The action reports what ports depend upon a given (installed) port, if @@ -933,7 +933,7 @@ wireshark depends on openssl This command will, however, not cover dependencies that are only present in non-default variants.
-
+
port livecheck The action checks to see if the application corresponding to a given port @@ -953,7 +953,7 @@ wireshark depends on openssl
-
+
port lint The lint action checks if the Portfile conforms to the MacPorts standards @@ -992,7 +992,7 @@ Warning: no license set
-
+
Port Variants Variants are a way for port authors to provide options for a port that may be chosen at installation. @@ -1026,7 +1026,7 @@ apache2 has the variants: linkend="internals.configuration-files.variants-conf" /> for more information on variants.conf. -
+
Invoking Variants A variant can only be selected when a port is installed. After you have determined what variants @@ -1061,7 +1061,7 @@ apache2 has the variants: later, the same variants will be used, unless you manually specify different variants.
-
+
Negating Default Variants A Portfile can specify a default set of variants that will be used when you do @@ -1076,7 +1076,7 @@ apache2 has the variants:
-
+
Common Tasks This section lists common operations you may want to perform when managing a MacPorts installation. These @@ -1088,7 +1088,7 @@ apache2 has the variants: Mind the sudo for some of the subsequent examples, which is necessary if you have a default MacPorts installation. -
+
Updating Your Ports Tree The local ports tree is a collection of files that contain information on which packages are available @@ -1108,7 +1108,7 @@ apache2 has the variants: port upgrade outdated
-
+
Show Ports Which Need Updating To see what's new after running , you can use port @@ -1131,7 +1131,7 @@ apache2 has the variants: p5.16-ipc-run 0.910.0_1 < 0.920.0_0
-
+
Upgrading Outdated Ports To upgrade all your installed and outdated ports, run @@ -1166,7 +1166,7 @@ apache2 has the variants: avoiding the update of the dependency defeats the purpose of the reinstallation.
-
+
Removing Inactive Version(s) of Upgraded Port(s) By default, upgrading ports in MacPorts does not remove the older versions. This is a safety measure @@ -1228,7 +1228,7 @@ apache2 has the variants: $ sudo port uninstall inactive and not portname
-
+
Finding Ports Depending on a Certain Port If you want to find all ports that depend on a given other port, you can use @@ -1263,7 +1263,7 @@ apache2 has the variants: gnupg2 @2.0.25_0 (active)
-
+
Finding Leaves After a while of using MacPorts, installing and uninstalling ports, packages that have been @@ -1303,7 +1303,7 @@ apache2 has the variants: $ sudo port_cutleaves
-
+
Keep Your Installation Lean by Defining Leaves as Requested Ports Well, before we come to the procedure of defining your requested ports, let's have a look at a typical @@ -1454,13 +1454,13 @@ apache2 has the variants:
-
+
Port Binaries 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. -
+
Binary Archives Binary archives can only be used on a target system running MacPorts. They allow MacPorts utilities to @@ -1518,7 +1518,7 @@ apache2 has the variants: , and .
-
+
Binary Packages Binary packages are standalone binary installers that are precompiled; they do not require MacPorts on