Return-Path: Delivered-To: apmail-ant-dev-archive@www.apache.org Received: (qmail 1724 invoked from network); 4 Sep 2006 04:23:52 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199) by minotaur.apache.org with SMTP; 4 Sep 2006 04:23:52 -0000 Received: (qmail 49795 invoked by uid 500); 4 Sep 2006 04:23:51 -0000 Delivered-To: apmail-ant-dev-archive@ant.apache.org Received: (qmail 49459 invoked by uid 500); 4 Sep 2006 04:23:50 -0000 Mailing-List: contact dev-help@ant.apache.org; run by ezmlm Precedence: bulk List-Unsubscribe: List-Help: List-Post: List-Id: "Ant Developers List" Reply-To: "Ant Developers List" Delivered-To: mailing list dev@ant.apache.org Received: (qmail 49448 invoked by uid 500); 4 Sep 2006 04:23:50 -0000 Received: (qmail 49445 invoked by uid 99); 4 Sep 2006 04:23:50 -0000 Received: from asf.osuosl.org (HELO asf.osuosl.org) (140.211.166.49) by apache.org (qpsmtpd/0.29) with ESMTP; Sun, 03 Sep 2006 21:23:50 -0700 X-ASF-Spam-Status: No, hits=-9.4 required=10.0 tests=ALL_TRUSTED,NO_REAL_NAME X-Spam-Check-By: apache.org Received-SPF: pass (asf.osuosl.org: local policy) Received: from [140.211.166.113] (HELO eris.apache.org) (140.211.166.113) by apache.org (qpsmtpd/0.29) with ESMTP; Sun, 03 Sep 2006 21:23:47 -0700 Received: by eris.apache.org (Postfix, from userid 65534) id 84A681A981D; Sun, 3 Sep 2006 21:23:27 -0700 (PDT) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r439925 - in /ant/antlibs/dotnet/trunk/docs: ilasm.html ildasm.html importtypelib.html jsharpc.html Date: Mon, 04 Sep 2006 04:23:27 -0000 To: ant-cvs@apache.org From: bodewig@apache.org X-Mailer: svnmailer-1.1.0 Message-Id: <20060904042327.84A681A981D@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org X-Spam-Rating: minotaur.apache.org 1.6.2 0/1000/N Author: bodewig Date: Sun Sep 3 21:23:26 2006 New Revision: 439925 URL: http://svn.apache.org/viewvc?view=rev&rev=439925 Log: update some docs to "plain" format Modified: ant/antlibs/dotnet/trunk/docs/ilasm.html ant/antlibs/dotnet/trunk/docs/ildasm.html ant/antlibs/dotnet/trunk/docs/importtypelib.html ant/antlibs/dotnet/trunk/docs/jsharpc.html Modified: ant/antlibs/dotnet/trunk/docs/ilasm.html URL: http://svn.apache.org/viewvc/ant/antlibs/dotnet/trunk/docs/ilasm.html?view=diff&rev=439925&r1=439924&r2=439925 ============================================================================== --- ant/antlibs/dotnet/trunk/docs/ilasm.html (original) +++ ant/antlibs/dotnet/trunk/docs/ilasm.html Sun Sep 3 21:23:26 2006 @@ -23,267 +23,183 @@ Ilasm Task - + - +

Ilasm Task

- - - - - - - - - - +

src (org.apache.tools.ant.types.FileSet)

-
- - - -
- Ilasm - Task -
Assembles .NET Intermediate Language files. - 		- - - Apache Ant - -
-
- - - - - - - - - +

-
 
- - - Description -
- Assembles .NET Intermediate Language files. ilasm.exe must be on the execute path, unless another executable or the full path to that executable is specified in the executable parameter

All parameters are optional: <il/> should suffice to produce a debug build of all *.il files. The option set is roughly compatible with the CSharp class; even though the command line options are only vaguely equivalent. [The low level commands take things like /OUT=file, csc wants /out:file ... /verbose is used some places; /quiet here in ildasm... etc.] It would be nice if someone made all the command line tools consistent (and not as brittle as the java cmdline tools)

The task is a directory based task, so attributes like includes="*.il" and excludes="broken.il" can be used to control the files pulled in. You can also use nested <src> filesets to refer to source.

-

- +

Assembles .NET Intermediate Language files. ilasm.exe must be + on the execute path, unless another executable or the full path to + that executable is specified in the executable + parameter.

+ +

All parameters are optional: <il/> should + suffice to produce a debug build of all *.il files. The option set + is roughly compatible with the CSharp class; even though the + command line options are only vaguely equivalent. [The low level + commands take things like /OUT=file, csc wants /out:file + ... /verbose is used some places; /quiet here in ildasm... etc.] + It would be nice if someone made all the command line tools + consistent (and not as brittle as the java cmdline tools).

+ +

The task is a directory based task, so attributes like + includes="*.il" and excludes="broken.il" can be + used to control the files pulled in. You can also use nested + <src> filesets to refer to source.

- - - - - + + + + - -
 
- - - Parameters -
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + -
- Attribute - - Description - - Type - - Requirement -
- debug - - set the debug flag on or off. - - boolean - - Optional -
- destfile - - Set the name of exe/library to create. - - File -
- extraoptions - - Any extra options which are not explicitly supported by this task. - - String -
- failonerror - - If true, fails if ilasm tool fails. - - boolean -
- keyfile - - the name of a file containing a private key. - - File -
- listing - - If true, produce a listing (off by default). - - boolean -
- outputfile - - Set the output file; identical to setDestFile - - File -
- resourcefile - - name of resource file to include. - - File -
- srcdir - - Set the source directory of the files to be compiled. - - File -
- verbose - - If true, enable verbose ILASM output. +

Parameters

+ + + + + + - - + + + + + + + -
+ Attribute + + Description + + Type - boolean + + Requirement
+ debug + + set the debug flag on or off. + + boolean + + Optional +
-
+ destfile + + Set the name of exe/library to create. + + File +
- +
+ extraoptions + + Any extra options which are not explicitly supported by this task. + + String +
- - - - - + + + + + + + + + + + + + + + + - + + + + + + + + + + +
 
- - - Parameters as nested elements -
- - - - - + + + + - -
 
- - reference (org.apache.tools.ant.types.FileSet) -
- add a new reference fileset to the compilation - - - - +
+ failonerror + + If true, fails if ilasm tool fails. + + boolean +
- - - - - - + + + + - -
 
- - src (org.apache.tools.ant.types.FileSet) -
- add a new source directory to the compile - - - - +
+ keyfile + + the name of a file containing a private key. + + File +
- +
+ listing + + If true, produce a listing (off by default). + + boolean +
+ outputfile + + Set the output file; identical to setDestFile + + File +
+ resourcefile + + name of resource file to include. + + File +
+ srcdir + + Set the source directory of the files to be compiled. + + File +
+ verbose + + If true, enable verbose ILASM output. + + boolean +
- +

Parameters as nested elements

+ +

reference (org.apache.tools.ant.types.FileSet)

+ +

add a new reference fileset to the compilation

-
+

add a new source directory to the compile

Modified: ant/antlibs/dotnet/trunk/docs/ildasm.html URL: http://svn.apache.org/viewvc/ant/antlibs/dotnet/trunk/docs/ildasm.html?view=diff&rev=439925&r1=439924&r2=439925 ============================================================================== --- ant/antlibs/dotnet/trunk/docs/ildasm.html (original) +++ ant/antlibs/dotnet/trunk/docs/ildasm.html Sun Sep 3 21:23:26 2006 @@ -23,317 +23,285 @@ Ildasm Task - + - +

Ildasm Task

- - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - + + + + + + + + + + + -
- - - -
- Ildasm - Task -
Task to take a .NET or Mono -generated managed executable and turn it into ILASM assembly code. - 		- - - Apache Ant - -
-
- - - - - - - - - +

Description

-
 
- - - Description -
- Task to take a .NET or Mono -generated managed executable and turn it into ILASM assembly code. Useful when converting imported typelibs into assembler before patching and recompiling, as one has to do when doing advanced typelib work.

As well as generating the named output file, the ildasm program will also generate resource files Icons.resources Message.resources and a .res file whose filename stub is derived from the source in ways to obscure to determine. There is no way to control whether or not these files are created, or where they are created (they are created in the current directory; their names come from inside the executable and may be those used by the original developer). This task creates the resources in the directory specified by resourceDir if set, else in the same directory as the destFile.

This task requires the .NET SDK installed and ildasm on the path. To disassemble using alternate CLR systems, set the executable attribute to the name/path of the alternate implementation -one that must support all the classic ildasm commands.

Dependency logic: the task executes the command if the output file is missing or older than the source file. It does not take into account changes in the options of the task, or timestamp differences in resource files. When the underlying ildasm executable fails for some reason, it leaves the .il file in place with some error message. To prevent this from confusing the dependency logic, the file specified by the dest attribute is always deleted after an unsuccessful build. -

- +

Task to take a .NET or Mono -generated managed executable and + turn it into ILASM assembly code. Useful when converting imported + typelibs into assembler before patching and recompiling, as one + has to do when doing advanced typelib work.

+ +

As well as generating the named output file, the ildasm + program will also generate resource files + Icons.resources Message.resources and a + .res file whose filename stub is derived from the source in ways + to obscure to determine. There is no way to control whether or not + these files are created, or where they are created (they are + created in the current directory; their names come from inside the + executable and may be those used by the original developer). This + task creates the resources in the directory specified by + resourceDir if set, else in the same directory as the + destFile.

+ +

This task requires the .NET SDK installed and ildasm on the + path. To disassemble using alternate CLR systems, set the + executable attribute to the name/path of the alternate + implementation -one that must support all the classic ildasm + commands.

+ +

Dependency logic: the task executes the command if the output + file is missing or older than the source file. It does not take + into account changes in the options of the task, or timestamp + differences in resource files. When the underlying ildasm + executable fails for some reason, it leaves the .il file in place + with some error message. To prevent this from confusing the + dependency logic, the file specified by the dest + attribute is always deleted after an unsuccessful build.

+ +

Parameters

- - - - - + + + + - -
 
- - - Parameters -
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + -
- Attribute - - Description - - Type - - Requirement -
- assembler - - enable (default) or disable assembly language in the output - - boolean - - Optional -
- bytes - - enable or disable (default) the original bytes as comments - - boolean -
- destfile - - the output file (required) - - File -
- encoding - - Select the output encoding: ascii, utf8 or unicode - - "ascii", "utf8", "unicode" -
- executable - - override the name of the executable (normally ildasm) or set its full path. Do not set a relative path, as the ugly hacks needed to create resource files in the dest directory force us to change to this directory before running the application. i.e use <property location> to create an absolute path from a relative one before setting this value. - - String -
- header - - include header information; default false. - - boolean -
- item - - name a single item to decode; a class or a method e.g item="Myclass::method" or item="namespace1::namespace2::Myclass:method(void(int32)) - - String -
- linenumbers - - include line number information; default=false - - boolean -
- metadata - - include metadata information - - boolean -
- progressbar - - show a graphical progress bar in a window during the process; off by default - - boolean -
- quoteallnames - - quote all names. - - boolean -
- rawexceptionhandling - - enable raw exception handling (default = false) - - boolean -
- resourcedir - - Set the name of the directory for resources to be created. We cannot control their names, but we can say where they get created. If not set, the directory of the dest file is used - - File -
- showsource - - include the source as comments (default=false) - - boolean -
- sourcefile - - the file to disassemble -required - - File -
- srcfile - - alternate name for sourceFile - - File -
- visibility - - visibility options: one or more of the following, with + signs to concatenate them: 
 pub : Public pri : Private fam : Family asm : Assembly faa : Family and Assembly foa : Family or Assembly psc : Private Scope
e.g. visibility="pub+pri". Family means protected in C#; + + + - - + + + + + + + + + -
+ Attribute - String + + Description
+ Type + + Requirement +
+ assembler + + enable (default) or disable assembly language in the output + + boolean + + Optional +
-
+ bytes + + enable or disable (default) the original bytes as comments + + boolean +
- +
+ destfile + + the output file (required) + + File +
- + + + + + - + + + + + - + + + + - + + + + + -
 
+ encoding + + Select the output encoding: ascii, utf8 or unicode + + "ascii", "utf8", "unicode" +
- - - Parameters as nested elements -
+ executable + + override the name of the executable (normally ildasm) or set + its full path. Do not set a relative path, as the ugly hacks + needed to create resource files in the dest directory force + us to change to this directory before running the + application. i.e use <property location> to create an + absolute path from a relative one before setting this value. + + String +
+
+ header + + include header information; default false. + + boolean +
+ item + + name a single item to decode; a class or a method e.g + item="Myclass::method" or + item="namespace1::namespace2::Myclass:method(void(int32)) + + String +
- +
+ linenumbers + + include line number information; default=false + + boolean +
+ metadata + + include metadata information + + boolean +
+ progressbar + + show a graphical progress bar in a window during the + process; off by default + + boolean +
+ quoteallnames + + quote all names. + + boolean +
+ rawexceptionhandling + + enable raw exception handling (default = false) + + boolean +
+ resourcedir + + Set the name of the directory for resources to be + created. We cannot control their names, but we can say where + they get created. If not set, the directory of the dest file + is used + + File +
+ showsource + + include the source as comments (default=false) + + boolean +
+ sourcefile + + the file to disassemble -required + + File +
+ + + srcfile + + + alternate name for sourceFile + + + File + + + + + + visibility + + + visibility options: one or more of the following, with + + signs to concatenate them: 
 pub : Public pri : Private
+          fam : Family asm : Assembly faa : Family and Assembly foa :
+          Family or Assembly psc : Private Scope
+ e.g. visibility="pub+pri". Family means + protected in C#; + + + String + + + Modified: ant/antlibs/dotnet/trunk/docs/importtypelib.html URL: http://svn.apache.org/viewvc/ant/antlibs/dotnet/trunk/docs/importtypelib.html?view=diff&rev=439925&r1=439924&r2=439925 ============================================================================== --- ant/antlibs/dotnet/trunk/docs/importtypelib.html (original) +++ ant/antlibs/dotnet/trunk/docs/importtypelib.html Sun Sep 3 21:23:26 2006 @@ -23,185 +23,119 @@ Importtypelib Task - + - +

Importtypelib Task

- - - - - - - -
- - - -
- Importtypelib - Task -
Import a COM type library into the .NET framework. - 		- - - Apache Ant - -
-
- - - - - - - - - +

Description

-
 
- - - Description -
- Import a COM type library into the .NET framework.

This task is a wrapper to .NET's tlbimport; it imports a tlb file to a NET assembly by generating a binary assembly (.dll) that contains all the binding metadata. It uses date timestamps to minimise rebuilds.

Example 

 <importtypelib srcfile="xerces.tlb" destfile="xerces.dll" namespace="Apache.Xerces"/>
-
- +

Import a COM type library into the .NET framework.

+ +

This task is a wrapper to .NET's tlbimport; it imports a tlb + file to a NET assembly by generating a binary assembly (.dll) that + contains all the binding metadata. It uses date timestamps to + minimise rebuilds.

+ +

Parameters

- - - - - - - +

Examples

-
 
- - - Parameters -
- - - - - +
- Attribute - - Description + + + - - - - + + - - - - + - - - - - - - + + + - - - - - - + + + - - - - - - + + + - - - - - - + + + - - - - - - + + + - - - - - -
+ Attribute - Type + + Description - Requirement + + Type
+ Requirement +
- destfile +
+ destfile - name the output file. required + + name the output file. required - File + + File - Optional + + Optional
- extraoptions +
+ extraoptions - set any extra options that are not yet supported by this task. + + set any extra options that are not yet supported by this task. - String + + String
- namespace +
+ namespace - what namespace is the typelib to be in. required + + what namespace is the typelib to be in. required - String + + String
- srcfile +
+ srcfile - what is the source .tlb file? required. + + what is the source .tlb file? required. - File + + File
- unsafe +
+ unsafe - do you want unsafe code. + + do you want unsafe code. - boolean + + boolean
- usesysarray +
+ usesysarray - set this to map a COM SafeArray to the System.Array class + + set this to map a COM SafeArray to the System.Array class - boolean + + boolean
-
- - - - - - - - - - -
 
- - - Parameters as nested elements -
- -
- - -
+ 
+<importtypelib srcfile="xerces.tlb" destfile="xerces.dll"
+    namespace="Apache.Xerces"/>
+
Modified: ant/antlibs/dotnet/trunk/docs/jsharpc.html URL: http://svn.apache.org/viewvc/ant/antlibs/dotnet/trunk/docs/jsharpc.html?view=diff&rev=439925&r1=439924&r2=439925 ============================================================================== --- ant/antlibs/dotnet/trunk/docs/jsharpc.html (original) +++ ant/antlibs/dotnet/trunk/docs/jsharpc.html Sun Sep 3 21:23:26 2006 @@ -23,433 +23,323 @@ Jsharpc Task - + - +

Jsharpc Task

- - - - - - - - - - +

src (org.apache.tools.ant.types.FileSet)

-
- - - -
- Jsharpc - Task -
Compile J# source down to a managed .NET application.

For historical reasons the pattern **/*.java is preset as includes list and you can not override it with an explicit includes attribute. Use nested <src> elements instead of the basedir attribute if you need more control.

 - 		- - - Apache Ant - -
-
- - - - - - - - - +

Description

-
 
- - - Description -
- Compile J# source down to a managed .NET application.

J# is not Java. But it is the language closest to Java in the .NET framework. This task compiles jsharp source (.java files), and generates a .NET managed exe or dll.

-

- +

Compile J# source down to a managed .NET application.

+ +

J# is not Java. But it is the language closest to Java in the + .NET framework. This task compiles jsharp source (.java files), + and generates a .NET managed exe or dll.

+ +

Parameters

- - - - - + + + + - -
 
- - - Parameters -
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + -
- Attribute - - Description - - Type - - Requirement -
- additionalmodules - note that your version of vjc may not support this option. - - Semicolon separated list of modules to refer to. - - String - - Optional -
- baseaddress - - - - String -
- debug - - set the debug flag on or off. - - boolean -
- destdir - - Set the destination directory of files to be compiled. - - File -
- destfile - - Set the name of exe/library to create. - - File -
- executable - - set the name of the program, overriding the defaults. Can be used to set the full path to a program, or to switch to an alternate implementation of the command, such as the Mono or Rotor versions -provided they use the same command line arguments as the .NET framework edition - - String -
- extraoptions - - Any extra options which are not explicitly supported by this task. - - String -
- failonerror - - If true, fail on compilation errors. - - boolean -
- includedefaultreferences - - If true, automatically includes the common assemblies in dotnet, and tells the compiler to link in mscore.dll. set the automatic reference inclusion flag on or off this flag controls the /nostdlib option in CSC - - boolean -
- mainclass - - Sets the name of main class for executables. - - String -
- optimize - - If true, enables optimization flag. - - boolean -
- purejava - - do we want pure java (default, true) or corrupted J#? - - boolean -
- referencefiles - - Path of references to include. Wildcards should work. - - Path -
- references - - Semicolon separated list of DLLs to refer to. - - String -
- securescoping - - Make package scoped code visible to the current assembly only (default: false) .NET does not have package scoping. Instead it has assembly, private and public. By default, package content is public to all. - - boolean -
- srcdir - - Set the source directory of the files to be compiled. - - File -
- targettype - - set the target type to one of exe|library|module|winexe - - "exe", "library", "module", "winexe" -
- utf8output - - If true, require all compiler output to be in UTF8 format. - - boolean -
- warnlevel - - Level of warning currently between 1 and 4 with 4 being the strictest. - - int -
- win32icon - - Set the filename of icon to include. - - File -
- win32res - - Sets the filename of a win32 resource (.RES) file to include. This is not a .NET resource, but what Windows is used to. + + + - - + + + + + + + + + -
+ Attribute - File + + Description
+ Type + + Requirement +
+ additionalmodules + + Semicolon separated list of modules to refer to - note that + your version of vjc may not support this option. + + String + + Optional +
-
+ baseaddress + + + + String +
- +
+ debug + + set the debug flag on or off. + + boolean +
- - - - - + + + + - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
 
- - - Parameters as nested elements -
- - - - - + + + + - -
 
- - define (org.apache.tools.ant.taskdefs.optional.dotnet.DotnetDefine) -
- add a define to the list of definitions - - - - +
+ destdir + + Set the destination directory of files to be compiled. + + File +
- - - - - - + + + + - -
 
- - reference (org.apache.tools.ant.types.FileSet) -
- add a new reference fileset to the compilation - - - - +
+ destfile + + Set the name of exe/library to create. + + File +
- - - - - - + + + + - -
 
- - resource (org.apache.tools.ant.taskdefs.optional.dotnet.DotnetResource) -
- link or embed a resource - - - - +
+ executable + + set the name of the program, overriding the defaults. Can be + used to set the full path to a program, or to switch to an + alternate implementation of the command, such as the Mono or + Rotor versions -provided they use the same command line + arguments as the .NET framework edition + + String +
- - - - - - + + + + - -
 
- - src (org.apache.tools.ant.types.FileSet) -
- add a new source directory to the compile - - - - +
+ extraoptions + + Any extra options which are not explicitly supported by this task. + + String +
- +
+ failonerror + + If true, fail on compilation errors. + + boolean +
+ includedefaultreferences + + If true, automatically includes the common assemblies in + dotnet, and tells the compiler to link in mscore.dll. set + the automatic reference inclusion flag on or off this flag + controls the /nostdlib option in CSC + + boolean +
+ mainclass + + Sets the name of main class for executables. + + String +
+ optimize + + If true, enables optimization flag. + + boolean +
+ purejava + + do we want pure java (default, true) or corrupted J#? + + boolean +
+ referencefiles + + Path of references to include. Wildcards should work. + + Path +
+ references + + Semicolon separated list of DLLs to refer to. + + String +
+ securescoping + + Make package scoped code visible to the current assembly + only (default: false) .NET does not have package + scoping. Instead it has assembly, private and public. By + default, package content is public to all. + + boolean +
+ srcdir + + Set the source directory of the files to be compiled. + + File +
+ targettype + + set the target type to one of exe|library|module|winexe + + "exe", "library", "module", "winexe" +
+ utf8output + + If true, require all compiler output to be in UTF8 format. + + boolean +
+ warnlevel + + Level of warning currently between 1 and 4 with 4 being the + strictest. + + int +
+ win32icon + + Set the filename of icon to include. + + File +
+ win32res + + Sets the filename of a win32 resource (.RES) file to + include. This is not a .NET resource, but what Windows is + used to. + + File +
- +

Parameters as nested elements + +

define (org.apache.ant.dotnet.compile.DotnetDefine)

+ +

add a define to the list of definitions

+ +

reference (org.apache.tools.ant.types.FileSet)

+ +

add a new reference fileset to the compilation

+ +

resource (org.apache.ant.dotnet.compile.DotnetResource)

+ +

link or embed a resource

-
+

add a new source directory to the compile

--------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org For additional commands, e-mail: dev-help@ant.apache.org