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

Merge from trunk

Browse Source 
git-svn-id: https://svn.macports.org/repository/macports/branches/gsoc14-interactive/base@124236 d073be05-634f-4543-b044-5fe20cf6d1d6
This commit is contained in:
Shashwat Pandey
2014-08-21 17:47:06 +00:00
parent b1779441ce 1f70bbe416
commit 94782cb806
80 changed files with 3951 additions and 509 deletions
Download Patch File Download Diff File Expand all files Collapse all files
ChangeLog
+4
View File
@@ -4,6 +4,10 @@
###
Release 2.4 (unreleased)
- Fix bugs in trace mode that caused it to (1) not ignore /usr/local as
it should and (2) fail with certain lengths of $prefix.
(cal in r124145, r124146)
- Display notes for installed or updated ports at the end of the
installation to prevent them from getting lost in the scrolling output.
(#24507, cal in r118304, patch by snc)
doc/Makefile.in
+31 -7
View File
@@ -8,8 +8,9 @@ ifeq ($(SELFUPDATING),1)
ASCIIDOC=
XSLTPROC=
else
ASCIIDOC= $(wildcard ${prefix}/bin/asciidoc)
XSLTPROC= $(wildcard ${prefix}/bin/xsltproc)
ASCIIDOC= $(wildcard ${prefix}/bin/asciidoc)
XSLTPROC= $(wildcard ${prefix}/bin/xsltproc)
DOCBOOK_XSL= $(wildcard ${prefix}/share/xsl/docbook-xsl/manpages/docbook.xsl)
endif
ASCIIDOCFLAGS= -f asciidoc.conf -a manversion=${MACPORTS_VERSION}
@@ -30,16 +31,39 @@ MAN1= \
port-dependents.1 \
port-deps.1 \
port-destroot.1 \
port-dir.1 \
port-distcheck.1 \
port-distfiles.1 \
port-dmg.1 \
port-doctor.1 \
port-echo.1 \
port-edit.1 \
port-exit.1 \
port-extract.1 \
port-fetch.1 \
port-file.1 \
port-gohome.1 \
port-help.1 \
port-info.1 \
port-install.1 \
port-installed.1 \
port-lint.1 \
port-list.1 \
port-livecheck.1 \
port-location.1 \
port-mdmg.1 \
port-mpkg.1 \
port-patch.1 \
port-pkg.1 \
port-quit.1 \
port-rdependents.1 \
port-rdeps.1 \
port-reclaim.1 \
port-rev-upgrade.1 \
port-selfupdate.1 \
port-uninstall.1 \
port-url.1 \
port-work.1 \
port.1 \
MAN5= macports.conf.5
@@ -105,7 +129,7 @@ distclean: clean
ln -sf $(shell basename $$(awk '{print $$2}' < $<)).html $@
# Define these rules only if both asciidoc and xsltproc are available
ifneq ($(and $(ASCIIDOC),$(XSLTPROC)),)
ifneq ($(and $(ASCIIDOC),$(XSLTPROC),$(DOCBOOK_XSL)),)
%: %.xml manpage.xsl
$(XSLTPROC) $(XSLTFLAGS) manpage.xsl $<
@@ -117,13 +141,13 @@ ifneq ($(and $(ASCIIDOC),$(XSLTPROC)),)
else
man: ${MAN} ${MAN:%=%.gz}
@echo "* Warning: Using pre-generated man pages only."
@echo "* asciidoc and xsltproc are required to generate man pages from source."
@echo "* asciidoc, xsltproc (port libxslt) and docbook-xsl are required to generate man pages from source."
%.xml %.html: | %.txt
@echo "* In order to modify and generate output from these source files,"
@echo "* please install asciidoc and xsltproc or use"
@echo "* $(MAKE) ASCIIDOC=.../bin/asciidoc XSLTPROC=../bin/xsltproc"
@echo "* with appropriate paths."
@echo "* please install asciidoc and xsltproc (port libxslt) and docbook-xsl or use"
@echo "* $(MAKE) ASCIIDOC=.../bin/asciidoc XSLTPROC=../bin/xsltproc DOCBOOK_XSL=nonempty"
@echo "* with appropriate paths for asciidoc and xsltproc."
@exit 1
endif
doc/asciidoc.conf
+8 -2
View File
@@ -4,6 +4,7 @@ mansource=MacPorts
manmanual=MacPorts Manual
guideurl=http://guide.macports.org/
wikiurl=https://trac.macports.org/wiki/
sourceurl=https://trac.macports.org/browser/
## man: macro
#
@@ -18,6 +19,7 @@ wikiurl=https://trac.macports.org/wiki/
(?su)[\\]?(?P<name>man):(?P<target>\S*?)\[(?P<attrlist>.*?)\]=
(?su)[\\]?(?P<name>guide):(?P<target>\S*?)\[(?P<attrlist>.*?)\]=
(?su)[\\]?(?P<name>wiki):(?P<target>\S*?)\[(?P<attrlist>.*?)\]=
(?su)[\\]?(?P<name>source):(?P<target>\S*?)\[(?P<attrlist>.*?)\]=
# man: and guide: for docbook
ifdef::backend-docbook[]
@@ -26,9 +28,11 @@ ifdef::backend-docbook[]
<refentrytitle>{target}</refentrytitle>{0?<manvolnum>{0}</manvolnum>}
</citerefentry>
[guide-inlinemacro]
<ulink url="{guideurl}#{target}">{0={guideurl}{target}}</ulink>
<ulink url="{guideurl}#{target}">{0={guideurl}#{target}}</ulink>
[wiki-inlinemacro]
<ulink url="{wikiurl}{target}">{0={target}}</ulink>
[source-inlinemacro]
<ulink url="{sourceurl}{target}">{0={target}}</ulink>
endif::backend-docbook[]
# man: and guide: for xhtml11
@@ -36,9 +40,11 @@ ifdef::backend-xhtml11[]
[man-inlinemacro]
<a href="{target}{0?.{0}}.html">{target}{0?({0})}</a>
[guide-inlinemacro]
<a href="{guideurl}#{target}">{0={guideurl}{target}}</a>
<a href="{guideurl}#{target}">{0={guideurl}#{target}}</a>
[wiki-inlinemacro]
<a href="{wikiurl}{target}">{0={target}}</a>
[source-inlinemacro]
<a href="{sourceurl}{target}">{0={target}}</a>
endif::backend-xhtml11[]
[paradef-default]
doc/port-activate.1
+2 -2
View File
@@ -1,5 +1,5 @@
'\" t
.TH "PORT\-ACTIVATE" "1" "2014\-08\-03" "MacPorts 2\&.3\&.99" "MacPorts Manual"
.TH "PORT\-ACTIVATE" "1" "2014\-08\-16" "MacPorts 2\&.3\&.99" "MacPorts Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
@@ -51,7 +51,7 @@ More information on this topic can be found in the \m[blue]\fBThe MacPorts Guide
To check the current status of a specific port, use \fB\fBport-installed\fR(1)\fR\&.
.SH "OPTIONS"
.PP
\-\-no\-exec
\fB\-\-no\-exec\fR
.RS 4
Do not execute any stored pre\- or post\-uninstall procedures\&.
.RE
doc/port-activate.1.txt
+2 -2
View File
@@ -1,6 +1,6 @@
// vim: set et sw=4 ts=8 ft=asciidoc tw=80:
port-activate(1)
===============
================
$Id$
NAME
@@ -38,7 +38,7 @@ include::archives.txt[]
OPTIONS
-------
--no-exec::
*--no-exec*::
Do not execute any stored pre- or post-uninstall procedures.
doc/port-archivefetch.1
+2 -2
View File
@@ -1,5 +1,5 @@
'\" t
.TH "PORT\-ARCHIVEFETCH" "1" "2014\-08\-04" "MacPorts 2\&.3\&.99" "MacPorts Manual"
.TH "PORT\-ARCHIVEFETCH" "1" "2014\-08\-16" "MacPorts 2\&.3\&.99" "MacPorts Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
@@ -46,7 +46,7 @@ To check the current status of a specific port, use \fB\fBport-installed\fR(1)\f
.sp
Please see the section \fBGLOBAL OPTIONS\fR in the \fBport\fR(1) man page for a description of global port options\&.
.PP
\-p
\fB\-p\fR
.RS 4
Proceed even if a port fails to fetch\&. This is useful if you are trying to download all available binary images for a number of ports, e\&.g\&., if you want to install them later without a network connection\&.
.RE
doc/port-archivefetch.1.txt
+1 -1
View File
@@ -32,7 +32,7 @@ include::archives.txt[]
include::global-flags.txt[]
-p::
*-p*::
Proceed even if a port fails to fetch. This is useful if you are trying to
download all available binary images for a number of ports, e.g., if you
want to install them later without a network connection.
doc/port-cd.1
+7 -3
View File
@@ -1,5 +1,5 @@
'\" t
.TH "PORT\-CD" "1" "2014\-08\-06" "MacPorts 2\&.3\&.99" "MacPorts Manual"
.TH "PORT\-CD" "1" "2014\-08\-15" "MacPorts 2\&.3\&.99" "MacPorts Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
@@ -25,12 +25,16 @@ port-cd \- Change the current working directory in interactive mode\&.
.sp
To be used only in interactive mode:
.sp
\fBcd\fR [\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]
.nf
\fBcd\fR
[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]
.fi
.SH "DESCRIPTION"
.sp
\fBcd\fR can be used in interactive mode of \fBport\fR (see \fBport-interactive\fR(7)) to change the current working directory to the directory that contains a given port\&. The second parameter is not optional, as it usually is with \fBcd\fR in your shell\&.
.SH "BUGS"
.sp
Note that \fBport cd\fR can be used from the command line, but is a no\-op\&.
\fBport cd\fR can be used from the command line, but is a no\-op\&.
.SH "SEE ALSO"
.sp
\fBport\fR(1), \fBport-interactive\fR(7)
doc/port-cd.1.txt
+4 -1
View File
@@ -11,6 +11,7 @@ SYNOPSIS
--------
To be used only in interactive mode:
[cmdsynopsis]
*cd*
['portname' | 'pseudo-portname' | 'port-expressions' | 'port-url']
@@ -21,7 +22,9 @@ change the current working directory to the directory that contains a given
port. The second parameter is not optional, as it usually is with *cd* in your
shell.
Note that *port cd* can be used from the command line, but is a no-op.
BUGS
----
*port cd* can be used from the command line, but is a no-op.
SEE ALSO
--------
doc/port-contents.1
+11 -11
View File
@@ -1,5 +1,5 @@
'\" t
.TH "PORT\-CONTENTS" "1" "2014\-08\-03" "MacPorts 2\&.3\&.99" "MacPorts Manual"
.TH "PORT\-CONTENTS" "1" "2014\-08\-16" "MacPorts 2\&.3\&.99" "MacPorts Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
@@ -45,14 +45,14 @@ port \-q contents asciidoc | grep \-E \*(Aq/s?bin/\*(Aq
.\}
.SH "OPTIONS"
.PP
\-\-size
\fB\-\-size\fR
.RS 4
Enable printing a human\-readable representation of the files\*(Aq sizes\&. The size output can be adjusted using the
\fB\-\-units \fR\fB\fIunit\fR\fR
flag\&.
.RE
.PP
\-\-units \fIunit\fR
\fB\-\-units \fR\fB\fIunit\fR\fR
.RS 4
Used in conjunction with
\fB\-\-size\fR
@@ -60,37 +60,37 @@ to choose the unit in which the size is given\&. Valid values for
\fIunit\fR
are
.PP
B
\fBB\fR
.RS 4
List sizes in bytes\&.
.RE
.PP
K, Ki, or KiB
\fBK\fR, \fBKi\fR, \fBKiB\fR
.RS 4
List sizes in KiB, i\&.e\&., 1024 bytes\&.
.RE
.PP
Mi, or MiB
\fBMi\fR, \fBMiB\fR
.RS 4
List sizes in MiB, i\&.e\&., 1024 * 1024 bytes\&.
.RE
.PP
Gi, or GiB
\fBGi\fR, \fBGiB\fR
.RS 4
List sizes in GiB, i\&.e\&., 1024 * 1024 * 1024 bytes\&.
.RE
.PP
k, or kB
\fBk\fR, \fBkB\fR
.RS 4
List sizes in kB, i\&.e\&., 1000 bytes\&.
.RE
.PP
M, or MB
\fBM\fR, \fBMB\fR
.RS 4
List sizes in MB, i\&.e\&., 1000 * 1000 bytes\&.
.RE
.PP
G, or GB
\fBG\fR, \fBGB\fR
.RS 4
List sizes in GB, i\&.e\&., 1000 * 1000 * 1000 bytes\&.
.RE
@@ -99,7 +99,7 @@ List sizes in GB, i\&.e\&., 1000 * 1000 * 1000 bytes\&.
.sp
Please see the section \fBGLOBAL OPTIONS\fR in the \fBport\fR(1) man page for a description of global port options\&.
.PP
\-q
\fB\-q\fR
.RS 4
Do not print the header line\&.
.RE
doc/port-contents.1.txt
+10 -10
View File
@@ -29,39 +29,39 @@ port -q contents asciidoc | grep -E '/s?bin/'
OPTIONS
-------
--size::
*--size*::
Enable printing a human-readable representation of the files' sizes. The
size output can be adjusted using the *--units 'unit'* flag.
--units 'unit'::
*--units 'unit'*::
Used in conjunction with *--size* to choose the unit in which the size is
given. Valid values for 'unit' are
B:::
*B*:::
List sizes in bytes.
K, Ki, or KiB:::
*K*, *Ki*, *KiB*:::
List sizes in KiB, i.e., 1024 bytes.
Mi, or MiB:::
*Mi*, *MiB*:::
List sizes in MiB, i.e., 1024 * 1024 bytes.
Gi, or GiB:::
*Gi*, *GiB*:::
List sizes in GiB, i.e., 1024 * 1024 * 1024 bytes.
k, or kB:::
*k*, *kB*:::
List sizes in kB, i.e., 1000 bytes.
M, or MB:::
*M*, *MB*:::
List sizes in MB, i.e., 1000 * 1000 bytes.
G, or GB:::
*G*, *GB*:::
List sizes in GB, i.e., 1000 * 1000 * 1000 bytes.
include::global-flags.txt[]
-q::
*-q*::
Do not print the header line.
doc/port-dependents.1
+10 -3
View File
@@ -1,5 +1,5 @@
'\" t
.TH "PORT\-DEPENDENTS" "1" "2014\-08\-12" "MacPorts 2\&.3\&.99" "MacPorts Manual"
.TH "PORT\-DEPENDENTS" "1" "2014\-08\-16" "MacPorts 2\&.3\&.99" "MacPorts Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
@@ -20,13 +20,18 @@
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
port-dependents \- List ports that depend on a given (installed) port
port-dependents, port-rdependents \- List ports that depend on a given (installed) port
.SH "SYNOPSIS"
.sp
.nf
\fBport\fR [\fB\-D\fR \fIportdir\fR] \fBdependents\fR
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.fi
.sp
.nf
\fBport\fR [\fB\-D\fR \fIportdir\fR] \fBrdependents\fR
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.fi
.SH "DESCRIPTION"
.sp
\fBport dependents\fR reports which ports depend upon a given (installed) port, if any\&. Note that \fBdependents\fR does not work for ports that are not installed on your system\&. It uses the database of installed ports that MacPorts keeps internally, which records the dependency relations at installation time\&. \fBport dependents\fR prints this information\&.
@@ -45,7 +50,9 @@ port echo depends:<portname>
.sp
This command will, however, not cover dependencies that are only present in non\-default variants\&. For more information about pseudo\-portname selectors, see \fBport\fR(1)\&.
.sp
The dependency relations printed by \fBport dependents\fR are the same that are used to determine if a port can be safely uninstalled\&. Ports that still have dependents installed cannot be uninstalled without either the \fB\-\-follow\-dependents\fR or the \fB\-f\fR flag\&. See \fBport-uninstall\fR(1) for more details\&.
\fBport rdependents\fR will print a tree of installed ports that depend on the given port\&.
.sp
The dependency relations printed by \fBport dependents\fR and \fBport rdependents\fR are the same that are used to determine if a port can be safely uninstalled\&. Ports that still have dependents installed cannot be uninstalled without either the \fB\-\-follow\-dependents\fR or the \fB\-f\fR flag\&. See \fBport-uninstall\fR(1) for more details\&.
.SH "DEPENDENCY RELATIONS"
.sp
Do not confuse \fIdependents\fR and \fIdependencies\fR (or, shortened, \fIdeps\fR)\&. Refer to the following example to understand the difference:
doc/port-dependents.1.txt
+12 -4
View File
@@ -5,7 +5,8 @@ $Id$
NAME
----
port-dependents - List ports that depend on a given (installed) port
port-dependents, port-rdependents - List ports that depend on a given
(installed) port
SYNOPSIS
--------
@@ -13,6 +14,10 @@ SYNOPSIS
*port* [*-D* 'portdir'] *dependents*
[['portname' | 'pseudo-portname' | 'port-expressions' | 'port-url']]
[cmdsynopsis]
*port* [*-D* 'portdir'] *rdependents*
[['portname' | 'pseudo-portname' | 'port-expressions' | 'port-url']]
DESCRIPTION
-----------
*port dependents* reports which ports depend upon a given (installed) port, if
@@ -33,9 +38,12 @@ This command will, however, not cover dependencies that are only present in
non-default variants. For more information about pseudo-portname selectors, see
man:port[1].
The dependency relations printed by *port dependents* are the same that are used
to determine if a port can be safely uninstalled. Ports that still have
dependents installed cannot be uninstalled without either the
*port rdependents* will print a tree of installed ports that depend on the given
port.
The dependency relations printed by *port dependents* and *port rdependents* are
the same that are used to determine if a port can be safely uninstalled. Ports
that still have dependents installed cannot be uninstalled without either the
*--follow-dependents* or the *-f* flag. See man:port-uninstall[1] for more
details.
doc/port-dir.1
+90
View File
@@ -0,0 +1,90 @@
'\" t
.TH "PORT\-DIR" "1" "2014\-08\-16" "MacPorts 2\&.3\&.99" "MacPorts Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
port-dir, port-url, port-file, port-location, port-work \- Print paths for certain properties of a port
.SH "SYNOPSIS"
.sp
.nf
\fBport\fR [\fB\-D\fR \fIportdir\fR] \fBdir\fR
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.fi
.sp
.nf
\fBport\fR [\fB\-D\fR \fIportdir\fR] \fBurl\fR
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.fi
.sp
.nf
\fBport\fR [\fB\-D\fR \fIportdir\fR] \fBfile\fR
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.fi
.sp
.nf
\fBport\fR [\fB\-q\fR] [\fB\-D\fR \fIportdir\fR] \fBlocation\fR
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.fi
.sp
.nf
\fBport\fR [\fB\-D\fR \fIportdir\fR] \fBwork\fR
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.fi
.SH "DESCRIPTION"
.sp
These commands print a path for each given port\&. The meaning of the path differs by the command given:
.sp
\fBport dir\fR prints the directory that contains the \fIPortfile\fR for the given port expression\&. This can be quite handy in your shell, if you want to locate a \fIPortfile\fR:
.sp
.if n \{\
.RS 4
.\}
.nf
cd $(port dir <portname>)
.fi
.if n \{\
.RE
.\}
.sp
\fBport url\fR prints a unique URL for the given port expression\&. This command mostly exists for historical reasons and isn\(cqt of much use nowadays\&.
.sp
\fBport file\fR prints the path of the \fIPortfile\fR for the given port expression\&. This can be useful to locate a port\(cqs definition\&. Note that you can always get this by using \fBport dir\fR and appending \fIPortfile\fR\&. You could use \fBport file\fR in a shell to edit a Portfile, but note that you can also use \fBport-edit\fR(1) to achieve the same\&.
.sp
\fBport location\fR only works for installed ports and prints the location of the archive MacPorts internally uses to be able to deactivate and activate a port\&. See \fBport-activate\fR(1) for more details on that\&. This command might be useful for you if you want to setup a local binary mirror of MacPorts packages that are not available from our official infrastructure due to licensing reasons\&.
.sp
\fBport work\fR prints the path to the so\-called \fIwork\fR directory, i\&.e\&., the directory used by MacPorts to build a port\&. No output is generated if no build directory exists, e\&.g\&., because there is no unfinished build in progress for the given port\&. Work directories are deleted after successful installation or using \fBport-clean\fR(1)\&.
.SH "GLOBAL OPTIONS"
.sp
Please see the section \fBGLOBAL OPTIONS\fR in the \fBport\fR(1) man page for a description of global port options\&.
.SH "SEE ALSO"
.sp
\fBport\fR(1), \fBport-edit\fR(1), \fBport-activate\fR(1), \fBport-clean\fR(1)
.SH "AUTHORS"
.sp
.if n \{\
.RS 4
.\}
.nf
(C) 2014 The MacPorts Project
Clemens Lang <cal@macports\&.org>
.fi
.if n \{\
.RE
.\}
doc/port-dir.1.txt
+76
View File
@@ -0,0 +1,76 @@
// vim: set et sw=4 ts=8 ft=asciidoc tw=80:
port-dir(1)
===========
$Id$
NAME
----
port-dir, port-url, port-file, port-location, port-work - Print paths for
certain properties of a port
SYNOPSIS
--------
[cmdsynopsis]
*port* [*-D* 'portdir'] *dir*
[['portname' | 'pseudo-portname' | 'port-expressions' | 'port-url']]
[cmdsynopsis]
*port* [*-D* 'portdir'] *url*
[['portname' | 'pseudo-portname' | 'port-expressions' | 'port-url']]
[cmdsynopsis]
*port* [*-D* 'portdir'] *file*
[['portname' | 'pseudo-portname' | 'port-expressions' | 'port-url']]
[cmdsynopsis]
*port* [*-q*] [*-D* 'portdir'] *location*
[['portname' | 'pseudo-portname' | 'port-expressions' | 'port-url']]
[cmdsynopsis]
*port* [*-D* 'portdir'] *work*
[['portname' | 'pseudo-portname' | 'port-expressions' | 'port-url']]
DESCRIPTION
-----------
These commands print a path for each given port. The meaning of the path
differs by the command given:
*port dir* prints the directory that contains the 'Portfile' for the given port
expression. This can be quite handy in your shell, if you want to locate
a 'Portfile':
----
cd $(port dir <portname>)
----
*port url* prints a unique URL for the given port expression. This command
mostly exists for historical reasons and isn't of much use nowadays.
*port file* prints the path of the 'Portfile' for the given port expression.
This can be useful to locate a port's definition. Note that you can always get
this by using *port dir* and appending 'Portfile'. You could use *port file* in
a shell to edit a Portfile, but note that you can also use man:port-edit[1] to
achieve the same.
*port location* only works for installed ports and prints the location of the
archive MacPorts internally uses to be able to deactivate and activate a port.
See man:port-activate[1] for more details on that. This command might be useful
for you if you want to setup a local binary mirror of MacPorts packages that are
not available from our official infrastructure due to licensing reasons.
*port work* prints the path to the so-called 'work' directory, i.e., the
directory used by MacPorts to build a port. No output is generated if no build
directory exists, e.g., because there is no unfinished build in progress for the
given port. Work directories are deleted after successful installation or using
man:port-clean[1].
include::global-flags.txt[]
SEE ALSO
--------
man:port[1], man:port-edit[1], man:port-activate[1], man:port-clean[1]
AUTHORS
-------
(C) 2014 The MacPorts Project
Clemens Lang <cal@macports.org>
doc/port-distcheck.1
+63
View File
@@ -0,0 +1,63 @@
'\" t
.TH "PORT\-DEPS" "1" "2014\-08\-16" "MacPorts 2\&.3\&.99" "MacPorts Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
port-distcheck \- Check if a port can be fetched from all of its mirrors
.SH "SYNOPSIS"
.sp
.nf
\fBport\fR [\fB\-qvdy\fR] [\fB\-D\fR \fIportdir\fR] \fBdistcheck\fR
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.fi
.SH "DESCRIPTION"
.sp
\fBport distcheck\fR downloads all source files for a given port from all available mirrors (including MacPorts\*(Aq mirror infrastructure) and checks that the modification date of the file on the mirror is not more recent than the modification date of the \fIPortfile\fR\&.
.sp
Distcheck can be switched to verify the file size of the downloaded files instead by setting the \fIdistcheck\&.type\fR option to \fIfilesize\fR in the \fIPortfile\fR for the tested port\&.
.SH "BUGS"
.sp
\fBport distcheck\fR should not rely on timestamps or file sizes but use the checksums available in the \fIPortfile\fR to verify the integrity of the files on the mirrors instead\&. See \fBport-checksum\fR(1)\&.
.sp
Meanwhile, you can use \m[blue]\fBport\-checkmirrors\fR\m[]\&\s-2\u[1]\d\s+2 from contrib to do that\&.
.SH "GLOBAL OPTIONS"
.sp
Please see the section \fBGLOBAL OPTIONS\fR in the \fBport\fR(1) man page for a description of global port options\&.
.SH "SEE ALSO"
.sp
\fBport\fR(1), \fBport-checksum\fR(1)
.SH "AUTHORS"
.sp
.if n \{\
.RS 4
.\}
.nf
(C) 2014 The MacPorts Project
Clemens Lang <cal@macports\&.org>
.fi
.if n \{\
.RE
.\}
.SH "EXTERNAL REFERENCES"
.IP " 1." 4
port-checkmirrors
.RS 4
\%https://trac.macports.org/browser/contrib/port-checkmirrors
.RE
doc/port-distcheck.1.txt
+45
View File
@@ -0,0 +1,45 @@
// vim: set et sw=4 ts=8 ft=asciidoc tw=80:
port-deps(1)
============
$Id$
NAME
----
port-distcheck - Check if a port can be fetched from all of its mirrors
SYNOPSIS
--------
[cmdsynopsis]
*port* [*-qvdy*] [*-D* 'portdir'] *distcheck*
[['portname' | 'pseudo-portname' | 'port-expressions' | 'port-url']]
DESCRIPTION
-----------
*port distcheck* downloads all source files for a given port from all available
mirrors (including MacPorts' mirror infrastructure) and checks that the
modification date of the file on the mirror is not more recent than the
modification date of the 'Portfile'.
Distcheck can be switched to verify the file size of the downloaded files
instead by setting the 'distcheck.type' option to 'filesize' in the 'Portfile'
for the tested port.
BUGS
----
*port distcheck* should not rely on timestamps or file sizes but use the
checksums available in the 'Portfile' to verify the integrity of the files on
the mirrors instead. See man:port-checksum[1].
Meanwhile, you can use source:contrib/port-checkmirrors[port-checkmirrors] from
contrib to do that.
include::global-flags.txt[]
SEE ALSO
--------
man:port[1], man:port-checksum[1]
AUTHORS
-------
(C) 2014 The MacPorts Project
Clemens Lang <cal@macports.org>
doc/port-distfiles.1
+49
View File
@@ -0,0 +1,49 @@
'\" t
.TH "PORT\-DISTFILES" "1" "2014\-08\-15" "MacPorts 2\&.3\&.99" "MacPorts Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
port-distfiles \- Print a list of distribution files for a port
.SH "SYNOPSIS"
.sp
.nf
\fBport\fR [\fB\-qvd\fR] [\fB\-D\fR \fIportdir\fR] \fBdistfiles\fR
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.fi
.SH "DESCRIPTION"
.sp
Print a list of source archives required to build the given port along with the checksums for the file and a list of mirrors\&. If you want to verify that all mirrors actually serve the same file see \fBport-distcheck\fR(1)\&.
.sp
To delete the distfiles once they have been downloaded, use \fBport clean \-\-dist\fR\&. See \fBport-clean\fR(1) for more information regarding the \fBclean\fR command\&.
.SH "SEE ALSO"
.sp
\fBport\fR(1), \fBport-distcheck\fR(1), \fBport-clean\fR(1)
.SH "AUTHORS"
.sp
.if n \{\
.RS 4
.\}
.nf
(C) 2014 The MacPorts Project
Clemens Lang <cal@macports\&.org>
.fi
.if n \{\
.RE
.\}
doc/port-distfiles.1.txt
+32
View File
@@ -0,0 +1,32 @@
// vim: set et sw=4 ts=8 ft=asciidoc tw=80:
port-distfiles(1)
=================
$Id$
NAME
----
port-distfiles - Print a list of distribution files for a port
SYNOPSIS
--------
[cmdsynopsis]
*port* [*-qvd*] [*-D* 'portdir'] *distfiles*
[['portname' | 'pseudo-portname' | 'port-expressions' | 'port-url']]
DESCRIPTION
-----------
Print a list of source archives required to build the given port along with the
checksums for the file and a list of mirrors. If you want to verify that all
mirrors actually serve the same file see man:port-distcheck[1].
To delete the distfiles once they have been downloaded, use *port clean --dist*.
See man:port-clean[1] for more information regarding the *clean* command.
SEE ALSO
--------
man:port[1], man:port-distcheck[1], man:port-clean[1]
AUTHORS
-------
(C) 2014 The MacPorts Project
Clemens Lang <cal@macports.org>
doc/port-dmg.1
+95
View File
@@ -0,0 +1,95 @@
'\" t
.TH "PORT\-DMG" "1" "2014\-08\-16" "MacPorts 2\&.3\&.99" "MacPorts Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
port-dmg, port-mdmg, port-pkg, port-mpkg \- Create binary archives of a port, and optionally its dependencies\&.
.SH "SYNOPSIS"
.sp
.nf
\fBport\fR [\fB\-vdqysbckpotf\fR] [\fB\-D\fR \fIportdir\fR] \fBdmg\fR
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.fi
.sp
.nf
\fBport\fR [\fB\-vdqysbckpotf\fR] [\fB\-D\fR \fIportdir\fR] \fBmdmg\fR
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.fi
.sp
.nf
\fBport\fR [\fB\-vdqysbckpotf\fR] [\fB\-D\fR \fIportdir\fR] \fBpkg\fR
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.fi
.sp
.nf
\fBport\fR [\fB\-vdqysbckpotf\fR] [\fB\-D\fR \fIportdir\fR] \fBmpkg\fR
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.fi
.SH "DESCRIPTION"
.sp
These commands create OS X\-native binary archives of a given port\&. Depending on the command, one of a \&.dmg disk image file, a \&.pkg, or \&.mpkg installer package is created\&.
.sp
\fBport pkg\fR creates an OS X installer package that installs all files that belong to a given port\&. \fBport dmg\fR wraps this installer package in a disk image\&. In most cases you probably want to package a port and all its library and runtime dependencies in a single package suitable for binary distribution\&. \fBport pkg\fR and \fBport dmg\fR don\(cqt do that, so those are only useful if you are going to take care of the dependencies separately\&. \fBport mpkg\fR creates an \&.mpkg installer image that contains installer packages for each of the dependencies and is suitable for standalone redistribution\&. \fBport mdmg\fR wraps this \&.mpkg package in a disk image\&.
.sp
On OS X 10\&.6 and later, the generated installer packages are in \(lqflat\(rq format, such that wrapping them in a disk image is no longer necessary for online redistribution\&. Prior to OS X 10\&.6, generated installer packages could not be used for online distribution without a wrapping disk image\&.
.sp
All packages are placed in a port\(cqs work directory, which can be located using \fBport-work\fR(1)\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBWarning\fR
.ps -1
.br
.sp
If you want to create installer packages using MacPorts for redistribution, make sure you do not use a standard installation of MacPorts in \fI/opt/local\fR\&. If you do that, your installer package will conflict on systems that \fBdo\fR have MacPorts installed\&.
.sp
Instead, follow \m[blue]\fBSection 2\&.2\&.4 of the MacPorts Guide\fR\m[]\&\s-2\u[1]\d\s+2 and choose a prefix specific to the software you are trying to package, e\&.g\&., \fI/opt/logrotate\fR for \fIlogrotate\fR\&. Then use this custom MacPorts installation to build your package\&.
.sp .5v
.RE
.SH "GLOBAL OPTIONS"
.sp
Please see the section \fBGLOBAL OPTIONS\fR in the \fBport\fR(1) man page for a description of global port options\&.
.SH "SEE ALSO"
.sp
\fBport\fR(1), \fBport-work\fR(1), \m[blue]\fBSection 2\&.2\&.4 of the MacPorts Guide\fR\m[]\&\s-2\u[1]\d\s+2
.SH "AUTHORS"
.sp
.if n \{\
.RS 4
.\}
.nf
(C) 2014 The MacPorts Project
Clemens Lang <cal@macports\&.org>
.fi
.if n \{\
.RE
.\}
.SH "EXTERNAL REFERENCES"
.IP " 1." 4
Section 2.2.4 of the MacPorts Guide
.RS 4
\%http://guide.macports.org/#installing.macports.source.multiple
.RE

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