New test.
[mono.git] / man / al.1
1 .TH "al" 1
2 .SH NAME
3 ilasm \- Mono Assembly Linker
4 .SH SYNOPSIS
5 .B al [option] [source-files]
6 .SH DESCRIPTION
7 AL is the Mono assembly linkder. 
8 .SH OPTIONS
9 .TP
10 .B @<filename>
11 Read response file for more options.
12 .TP
13 .B -algid:<id>
14 Algorithm used to hash files. The <id> must be specified in hexadecimal.
15 .TP
16 .B -base:<addr> | -baseaddress:<addr>
17 Base address for the library. THIS FEATURE ISN'T IMPLEMENTED.
18 .TP
19 .B -bugreport:<filename>
20 Create a 'Bug Report' file. THIS FEATURE ISN'T IMPLEMENTED.
21 .TP
22 .B -comp:<text> | -company:<text>
23 This inserts the company name into the assembly metadata.
24 This is equivalent to adding the [AssemblyCompany ("<text>")] attribute
25 into C# source code.
26 .TP
27 .B -config:<text> | -configuration:<text>
28 This inserts the configuration string into the assembly metadata.
29 This is equivalent to adding the [AssemblyConfiguration ("<text>")] 
30 attribute into C# source code.
31 .TP
32 .B -copy:<text> | -copyright:<text>
33 This inserts the copyright message into the assembly metadata.
34 This is equivalent to adding the [AssemblyCopyright ("<text>")] 
35 attribute into C# source code.
36 .TP
37 .B -c:<text> | -culture:<text>
38 This inserts the supported culture into the assembly metadata.
39 This is equivalent to adding the [AssemblyCulture ("<text>")] 
40 attribute into C# source code.
41 .TP
42 .B -delay | -delay+ | -delaysign | -delaysign+
43 The generated assembly will be delay signed. 
44 This is equivalent to adding the [AssemblyDelaySignAttribute (true)] 
45 attribute into C# source code.
46 .TP
47 .B -delay- | -delaysign-
48 The generated assembly will be fully signed (i.e. not delay signed).
49 This is the default option when signing (-keyfile or -keyname).
50 .TP
51 .B -descr:<text> | -description:<text>
52 This inserts a description of the assembly into the assembly metadata.
53 This is equivalent to adding the [AssemblyDescription ("<text>")] 
54 attribute into C# source code.
55 .TP
56 .B -e:<filename> | -evidence:<filename>
57 This embed into the assembly the specified file as assembly security
58 evidences.
59 .TP
60 .B -fileversion:<version>
61 Optional Win32 version. This overrides the normal assembly version.
62 .TP
63 .B -flags:<flags>
64 Assembly flags. The <flags> must be specified in hexadecimal.
65 .TP
66 .B -fullpaths
67 Display files using fully-qualified filenames.
68 .TP
69 .B -keyf:<filename> | -keyfile:<filename>
70 Strongname (sign) the output assembly using the key pair present in 
71 the specified strong name key file (snk). A full key pair is required
72 unless the delay signing option is also specified (-delay+).
73 This is equivalent to adding the [AssemblyKeyFile ("<text>")] 
74 attribute into C# source code.
75 .TP
76 .B -keyn:<text> | -keyname:<text>
77 Strongname (sign) the output assembly using the key pair present in 
78 the specified container. Delay signing isn't supported when using key
79 containers.
80 This is equivalent to adding the [AssemblyKeyName ("<text>")] 
81 attribute into C# source code.
82 .TP
83 .B -main:<method>
84 Specifies the method name of the assembly entry point.
85 .TP
86 .B -nologo
87 Suppress the startup banner and copyright message.
88 .TP
89 .B -out:<filename>
90 Output file name for the assembly manifest.
91 .TP
92 .B -prod:<text> | product:<text>
93 This inserts the product name into the assembly metadata.
94 This is equivalent to adding the [AssemblyProduct ("<text>")] 
95 attribute into C# source code.
96 .TP
97 .B -productv[ersion]:<text>
98 This inserts the product version into the assembly metadata.
99 This is equivalent to adding the [AssemblyInformationalVersion ("<text>")] 
100 attribute into C# source code.
101 .TP
102 .B -t[arget]:<target> | -target=<target>
103 Valid <target>s are:
104 .B lib | library
105 to create a library (.dll),
106 .B exe
107 to create a console executable (.exe), and
108 .B win | winexe
109 to create a Windows executable (.exe).
110 .TP
111 .B -template:<filename>
112 Specifies an assembly to get default options from.
113 .TP
114 .B -title:<text>
115 This inserts an assembly title into the assembly metadata.
116 This is equivalent to adding the [AssemblyTitle ("<text>")] 
117 attribute into C# source code.
118 .TP
119 .B -trade:<text> | -trademark:<text>
120 This inserts a trademark message into the assembly metadata.
121 This is equivalent to adding the [AssemblyTrademark ("<text>")] 
122 attribute into C# source code.
123 .TP
124 .B -v:<version> | -version:<version>
125 This inserts the assembly version into the assembly metadata. You can
126 use * to auto-generate remaining numbers.
127 This is equivalent to adding the [AssemblyVersion ("<text>")] 
128 attribute into C# source code.
129 .TP
130 .B -win32icon:<filename>
131 Use this icon for the output.
132 .TP
133 .B -win32res:<filename>
134 Specifies the Win32 resource file.
135 .TP
136 .B -? | -help
137 Display information about AL
138 .PP
139 .SH SEE ALSO
140 sn(1)
141 .SH COPYRIGHT
142 Copyright (C) 2005 Novell, Inc (http://www.novell.com)
143 .SH MAILING LISTS
144 Visit http://lists.ximian.com/mailman/listinfo/mono-devel-list for details.
145 .SH WEB SITE
146 Visit: http://www.mono-project.com for details