2006-12-11 Miguel de Icaza <miguel@novell.com>
[mono-project.git] / man / macpack.1
blobe39b080cce1245f37774efb1517dc6e4657bda6c
1 ..\" 
2 .\" macpack manual page.
3 .\" (C) 2004 Geoff Norton
4 .\" Author:
5 .\"   Geoff Norton (gnorton@customerdna.com)
6 .\"
7 .de Sp \" Vertical space (when we can't use .PP)
8 .if t .sp .5v
9 .if n .sp
11 .TH macpack "Mono 1.0"
12 .SH NAME
13 macpack \- Macintosh OS X Packager for managed gui assemblies
14 .SH SYNOPSIS
15 .PP
16 .B macpack [options] assembly
17 .SH DESCRIPTION
18 \fImacpack\fP is a tool used to package managed assemblies (like
19 System.Windows.Forms or Cocoa#) that require gui availability for deployment
20 on Mac OS X.
21 .PP
22 macpack will prepare a OS X compatible bundle from the provided assembly 
23 and resources.  The bundle will include the specified assembly as well
24 as any of the provided resources (specified with the -resource: switch).
25 .PP
26 Developers can specify the kind of application to produce using the
27 -mode: argument.  This controls how the environment in the Mono class
28 libraries is setup.
29 .PP
30 .SH OPTIONS
31 .I "-a assembly"
32 .Sp
33 This option tells macpack where the managed assembly that you
34 want to bundle resides.  This option is also used to point to the shell
35 script to launch in the case of a X11/Gtk# application.
36 .Sp
37 This is the same as just passing the assembly as an argument. 
38 .Sp
39 .I "-m [winforms,x11,console,cocoa]"
41 .I "-mode:[winforms,x11,console,cocoa]"
42 .Sp
43 A value indicating the kind of application: WinForms is a Winforms
44 application running on Quartz;  X11 is an application that requires
45 the X11 server to run;  console is a non-graphical application;  cocoa
46 is an application based on Cocoa#
47 .Sp
48 .I "-n NAME"
50 .I "-appname:NAME"
51 .Sp
52 This option specifies the application name of the emitted bundle.
53 This is what you will see in Finder.
54 .Sp
55 .I "-o DIRECTORY"
57 .I "-output:DIRECTORY"
58 .Sp
59 This option specifies the path to output the generated Application.
60 .Sp
61 .I "-r RESOURCE"
62 or 
63 .I "-resource:RESOURCE"
64 .Sp
65 This option can be specified multiple times.  It will place a copy of each resource
66 into the bundles resources directory.  Alternatively, you can use a
67 comma separated list of resources.
68 .fi
69 .SH AUTHOR
70 Geoff Norton
71 .SH WEB SITE
72 Visit: http://www.mono-project.com for details