source: trunk/base/doc/port-dmg.1.txt @ 123889

Last change on this file since 123889 was 123889, checked in by cal@…, 5 years ago

base: document port cd, distfiles, dmg, mdmg, pkg, mpkg, echo, exit, quit, gohome, info; #44530

  • Property svn:eol-style set to native
  • Property svn:keywords set to Id
File size: 2.1 KB
Line 
1// vim: set et sw=4 ts=8 ft=asciidoc tw=80:
2port-dmg(1)
3===========
4$Id: port-dmg.1.txt 123889 2014-08-15 20:06:28Z cal@macports.org $
5
6NAME
7----
8port-dmg, port-mdmg, port-pkg, port-mpkg - Create binary archives of a port, and
9optionally its dependencies.
10
11SYNOPSIS
12--------
13[cmdsynopsis]
14*port* [*-vdqysbckpotf*] [*-D* 'portdir'] *dmg*
15     [['portname' | 'pseudo-portname' | 'port-expressions' | 'port-url']]
16
17[cmdsynopsis]
18*port* [*-vdqysbckpotf*] [*-D* 'portdir'] *mdmg*
19     [['portname' | 'pseudo-portname' | 'port-expressions' | 'port-url']]
20
21[cmdsynopsis]
22*port* [*-vdqysbckpotf*] [*-D* 'portdir'] *pkg*
23     [['portname' | 'pseudo-portname' | 'port-expressions' | 'port-url']]
24
25[cmdsynopsis]
26*port* [*-vdqysbckpotf*] [*-D* 'portdir'] *mpkg*
27     [['portname' | 'pseudo-portname' | 'port-expressions' | 'port-url']]
28
29DESCRIPTION
30-----------
31These commands create OS X-native binary archives of a given port. Depending on
32the command, either a .dmg disk image file, or a .pkg installer package is
33created.
34
35*port dmg* creates an OS X disk image. *port pkg* wraps the same files in an OS
36X installer package. In most cases you probably want to package a port and all
37its library and runtime dependencies in a single package suitable for binary
38redistribution. You can use a metapackage to do this. Create one using *port
39mdmg* or *port mpkg*.
40
41All packages are placed in a port's work directory, which can be located using
42man:port-work[1].
43
44[WARNING]
45====
46If you want to create installer packages using MacPorts for redistribution, make
47sure you do not use a standard installation of MacPorts in '/opt/local'. If you
48do that, your installer package will conflict on systems that *do* have MacPorts
49installed.
50
51Instead, follow guide:installing.macports.source.multiple[Section 2.2.4 of the
52MacPorts Guide] and choose a prefix specific to the software you are trying to
53package, e.g., '/opt/logrotate' for 'logrotate'. Then use this custom MacPorts
54installation to build your package.
55====
56
57include::global-flags.txt[]
58
59SEE ALSO
60--------
61man:port[1], man:port-work[1], guide:installing.macports.source.multiple[Section
622.2.4 of the MacPorts Guide]
63
64AUTHORS
65-------
66 (C) 2014 The MacPorts Project
67 Clemens Lang <cal@macports.org>
Note: See TracBrowser for help on using the repository browser.