.\"
.\" Copyright (C) 2007 Novell, Inc (http://www.novell.com)
.\"
-
-.de Sp
+.de Sp \"
.if t .sp .5v
.if n .sp
+..
.TH CIL Linker "monolinker"
.SH NAME
Mono CIL Linker
remove all the unused methods and classes. This is done using a mark
and sweep operation on all the code that it is referenced.
.PP
-The generated output from the monolinker can be later processed by the
+The generated output from the monolinker can be later processed by the
.I mkbundle
tool to generate small native self-contained executables.
.PP
Do not confuse this with the Assembly Linker (al) which creates
-assemblies from manifests, modules and resource files.
+assemblies from manifests, modules and resource files.
.SH OPTIONS
.TP
.I "-d search_directory"
If you specify the directory `.', please ensure that you won't write over
important assemblies of yours.
.TP
+.I "-b true | false"
+Specify whether to generate debug symbols or not, default is false.
+.TP
+.I "-g true | false"
+Specify whether to generate a new guid for each linked module or reuse the
+existing one, default is true.
+.TP
.I "-l i18n_assemblies"
Specify what to do with the region specific assemblies
.Sp
.RS
.ne 8
.TP
-.I skip
+.I skip
This instructs the linker to skip them and do nothing with them.
.TP
-.I copy
+.I copy
This instructs the linker to copy them to the output directory,
.TP
-.I link
+.I link
This instructs the linker to apply the linking process and reduce
their size.
.ne
.RE
.Sp
.TP
+.I "-p action assembly"
+Specify per assembly which action to apply.
+.TP
.I "-x descriptor"
Use an XML descriptor as a source for the linker.
.Sp
<type fullname="Gazonk">
<method signature="System.Void .ctor(System.String)" />
<field signature="System.String _blah" />
+ <field name="someFieldName" />
</type>
</assembly>
</linker>
use a .info xml file as a source for the linker.
.Sp
An info file is a file produced by the tool mono-api-info. The linker will use it to
-generate an assembly that contains only what the public API defined in he info file
-needs. It will also adjust the visibility of the types that have to be present in the
-assembly, but that are not visibile from the public API.
+generate an assembly that contains only what the public API defined in the info file
+needs.
.TP
.I "-s [StepBefore:]StepFullName,StepAssembly[:StepAfter]"
.Sp
.fi
.Sp
If you compile this custom against monolinker to a Foo.dll assembly, you
-can use the
-.I -s
+can use the
+.I -s
switch as follows. To add the FooStep at the end of the pipeline:
.Sp
.nf
.fi
.Sp
This command will add the FooStep before the MarkStep
+.TP
+.I "-m CustomParam ParamValue"
+Specify a parameter for a custom step.
.SH COPYRIGHT
Copyright (C) 2007 Novell, Inc (http://www.novell.com)
.SH BUGS
-Bugs report are welcome at http://bugzilla.ximian.com
+Bugs report are welcome at http://bugzilla.xamarin.com
.PP
Product Mono Tools, Component linker.
.SH MAILING LISTS
-Mailing lists are listed at http://www.mono-project.com/Mailing_Lists
+Mailing lists are listed at http://www.mono-project.com/community/help/mailing-lists/
.SH WEB SITE
-http://www.mono-project.com/Linker
+http://www.mono-project.com/docs/tools+libraries/tools/linker/
.SH AUTHORS
The linker has been written by Jb Evain, and have been partially founded by
the Google Summer of Code.