X-Git-Url: http://wien.tomnetworks.com/gitweb/?a=blobdiff_plain;f=man%2Fmkbundle.1;h=8a738a56f8384e332e678ccc94640c1dbf102d19;hb=8fdae0685f9ba54ff85d01a7106a6dcbdd82e894;hp=95861e0aeab8e58ebbaaf64c8758ffe813b0f818;hpb=2ad252a24f496771c0b4e14563426dbeb26b9b6c;p=mono.git diff --git a/man/mkbundle.1 b/man/mkbundle.1 index 95861e0aeab..8a738a56f83 100644 --- a/man/mkbundle.1 +++ b/man/mkbundle.1 @@ -8,7 +8,7 @@ .if t .sp .5v .if n .sp .. -.TH mkbundle "mkbundle 1.0" +.TH Mono "mkbundle" .SH NAME mkbundle, mkbundle2 \- Creates a bundled executable. .SH SYNOPSIS @@ -24,7 +24,8 @@ dependencies referenced, use the "--deps" command line option. There are two modes of operation, one uses an existing Mono binary or a server-hosted list of binaries and is enabled when you use either the -.B --cross +.B --cross, +.B --sdk or the .B --runtime command line options. @@ -119,10 +120,19 @@ are using (1.0 or 2.0) When passed, DIR will be set for the MONO_CFG_DIR environment variable .TP .I "--cross target" -Creates a bundle for the specified target platform. The target -must be a directory in ~/.mono/targets/ that contains a "mono" -binary. You can fetch various targets using the --fetch-target -command line option. +Use this to request mkbundle generate a cross-compiled binary. It +Creates a bundle for the specified target platform. The target must +be a directory in ~/.mono/targets/ that contains an SDK installation +as produced by the mono-package-runtime tool. You can get a list of +the precompiled versions of the runtime using --list-targets and you +can fetch a specific target using the --fetch-target command line +option. +.Sp +This flag is mutually exclusive with +.I --sdk +which is used to specify an absolute path to resolve the Mono runtime +from and the --runtime option which is used to manually construct the +cross-platform package. .TP .I "--deps" This option will bundle all of the referenced assemblies for the @@ -159,10 +169,16 @@ flag to bundle all available encodings. Or you can use a comma delimited list of the workds CJK, MidWest, Other, Rare and West to specificy which encoding assemblies to distribute. .TP -.TP .I "-L path" Adds the `path' do the search list for assemblies. The rules are the same as for the compiler -lib: or -L flags. +.TP +.I "--library [LIB,]PATH" +Embeds the dynamic library file pointed to by `PATH' and optionally +give it the name `LIB' into the bundled executable. This is used to +ship native library dependencies that are unpacked at startup and +loaded from the runtime. +.TP .I "--lists-targets" Lists all of the available local cross compilation targets available as precompiled binaries on the Mono distribution server. @@ -197,7 +213,26 @@ executed. Additionally, users of your binary can still configure their own options by setting the .I MONO_ENV_OPTIONS -environment variable. +environment variable. +.TP +.I "--sdk SDK_PATH" +Use this flag to specify a path from which mkbundle will resolve the +Mono SDK from. The SDK path should be the prefix path that you used +to configure a Mono installation. And would typically contain files +lik +.I SDK_PATH/bin/mono +, +.I SDK_PATH/lib/mono/4.5 +and so on. +.Sp +When this flag is specified, +.I mkbundle +will resolve the runtime, the framework libraries, unmanaged resources +and configuration files from the files located in this directory. +.Sp +This flag is mutually exlusive with +.I --cross +. .TP .I "--target-server SERVER" By default the mkbundle tool will download from a Mono server the