From 683d490074d93baa8a47db7ec43b7bd31145a12a Mon Sep 17 00:00:00 2001 From: Mark Donszelmann Date: Thu, 5 Nov 2009 23:00:15 +0100 Subject: Tar file expanded and committed --- site/antdocs/CCTask.html | 633 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 633 insertions(+) create mode 100644 site/antdocs/CCTask.html (limited to 'site/antdocs/CCTask.html') diff --git a/site/antdocs/CCTask.html b/site/antdocs/CCTask.html new file mode 100644 index 0000000..cd35b53 --- /dev/null +++ b/site/antdocs/CCTask.html @@ -0,0 +1,633 @@ + + + + + + + + + + + + + + + cpptasks: Compile tasks for Apache Ant - cc + + + + + + + +
+ +
+
+
+

+cc

+

+Description

+Compile and link task. + +

+ This task can compile various source languages and produce executables, + shared libraries (aka DLL's) and static libraries. Compiler adaptors are + currently available for several C/C++ compilers, FORTRAN, MIDL and Windows + Resource files. +

+

+ Copyright (c) 2001-2008, The Ant-Contrib project. +

+

+ Licensed under the Apache Software License 2.0, + http://www.apache.org/licenses/LICENSE-2.0. +

+

+ For use with Apache Ant 1.5 or later. This software is not a product of the + of the Apache Software Foundation and no endorsement is implied. +

+

+ THIS SOFTWARE IS PROVIDED 'AS-IS', See + http://www.apache.org/licenses/LICENSE-2.0 for additional disclaimers. +

+ + + To use: +
  1. + Place cpptasks.jar into Ant's classpath by placing it in Ant's lib + directory, adding it to the CLASSPATH environment variable or by using the + -lib command line option. +
    2. +
  2. + Add type and task definitions to the build file: +
    • + Ant 1.6 or later: +
      • Add xmlns:cpptasks="antlib:net.sf.antcontrib.cpptasks" to + <project> element. +
        • +
      • + Add <cpptasks:cc/>, <cpptasks:compiler/> and + <cpptasks:linker/> elements to the project. +
        • +
      +
      • +
    • + Ant 1.5 or later: +
      • Add <taskdef resource="cpptasks.tasks"/> and + <typedef resource="cpptasks.types"/> to body of <project> + element. +
        • +
      • + Add <cc/>, <compiler/> and <linker/> elements to the + project. +
        • +
      +
      • +
    +
    3. +
  3. + Set the path and environment variables to be able to run compiler from + command line. +
    4. +
  4. + Build the project. +
    5. +
+
+

+parameters

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Attribute +Description +Type +
classnameSets the default compiler adapter. Use the "name" attribute when the + compiler is a supported compiler.String
datasetSets the dataset for OS/390 builds.String
debugEnables or disables generation of debug info.boolean
dependencydepthDeprecated. + + Controls the depth of the dependency evaluation. Used to do a quick + check of changes before a full build. + + Any negative value which will perform full dependency checking. Positive + values will truncate dependency checking. A value of 0 will cause only + those files that changed to be recompiled, a value of 1 which cause + files that changed or that explicitly include a file that changed to be + recompiled. + + Any non-negative value will cause a BuildException to be thrown before + attempting a link or completing the task.int
descriptionString
exceptionsEnables generation of exception handling codeboolean
failonerrorIndicates whether the build will continue + even if there are compilation errors; defaults to true.boolean
incrementalEnables or disables incremental linking.boolean
libtoolSet use of libtool. + + If set to true, the "libtool " will be prepended to the command line for + compatible processorsboolean
linkSets the output file type. Supported values "executable", "shared", and + "static". Deprecated, specify outtype instead.OutputTypeEnum +
locationLocation
multithreadedEnables or disables generation of multithreaded codeboolean
nameSets type of the default compiler and linker. + + Supported compilers + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
gcc (default)GCC C++ compiler
g++GCC C++ compiler
c++GCC C++ compiler
g77GNU FORTRAN compiler
msvcMicrosoft Visual C++
bccBorland C++ Compiler
msrcMicrosoft Resource Compiler
brcBorland Resource Compiler
dfCompaq Visual Fortran Compiler
midlMicrosoft MIDL Compiler
iclIntel C++ compiler for Windows (IA-32)
eclIntel C++ compiler for Windows (IA-64)
iccIntel C++ compiler for Linux (IA-32)
eccIntel C++ compiler for Linux (IA-64)
CCSun ONE C++ compiler
aCCHP aC++ C++ Compiler
os390OS390 C Compiler
os400Icc Compiler
sunc89Sun C89 C Compiler
xlCVisualAge C Compiler
uicQt user interface compiler (creates .h, .cpp and moc_*.cpp files).
mocQt meta-object compiler
xpidlMozilla xpidl compiler (creates .h and .xpt files).
wclOpenWatcom C/C++ compiler
wflOpenWatcom FORTRAN compiler
+		CompilerEnum +
newenvironmentDo not propagate old environment when new environment variables are + specified.boolean
objdirSets the destination directory for object files. + + Generally this should be a property expression that evaluates to + distinct debug and release object file directories.File
optimizeSets optimization.OptimizationEnum +
outfileSets the output file name. If not specified, the task will only compile + files and not attempt to link. If an extension is not specified, the + task may use a system appropriate extension and prefix, for example, + outfile="example" may result in "libexample.so" being created.File
outputfilepropertySpecifies the name of a property to set with the physical filename that + is produced by the linkerString
outtypeSets the output file type. Supported values "executable", "shared", and + "static".OutputTypeEnum +
owningtargetTarget
projectsonlyboolean
rebuildIf set to true, all files will be rebuilt.boolean
relentlessIf set to true, compilation errors will not stop the task until all + files have been attempted.boolean
rttiEnables run-time type information.boolean
runtimeSets the type of runtime library, possible values "dynamic", "static".RuntimeType +
subsystemSets the nature of the subsystem under which that the program will + execute. + + Supported subsystems + + + + + + + + +
guiGraphical User Interface
consoleCommand Line Console
otherOther
+		SubsystemEnum +
tasknameString
tasktypeString
warningsEnumerated attribute with the values "none", "severe", "default", + "production", "diagnostic", and "aserror".WarningLevelEnum +
+
+

+parameters as nested elements

+
compiler +
+
Adds a compiler definition or reference.
+
compilerarg +
+
Adds a compiler command-line arg. Argument will be inherited by all + nested compiler elements that do not have inherit="false".
+
defineset +
+
Adds a defineset. Will be inherited by all compiler elements that do not + have inherit="false".
+
distributer +
+
Adds a distributer definition or reference (Non-functional prototype).
+
env +
+
Add an environment variable to the launched process.
+
fileset +
+
Adds a source file set. + + Files in these filesets will be auctioned to the available compiler + configurations, with the default compiler implied by the cc element + bidding last. If no compiler is interested in the file, it will be + passed to the linker. + + To have a file be processed by a particular compiler configuration, add + a fileset to the corresponding compiler element.
+
includepath +
+
Adds an include path. + + Include paths will be inherited by nested compiler elements that do not + have inherit="false".
+
libset +
+
Adds a library set. + + Library sets will be inherited by all linker elements that do not have + inherit="false".
+
linker +
+
Adds a linker definition. The first linker that is not disqualified by + its "if" and "unless" attributes will perform the link. If no child + linker element is active, the linker implied by the cc elements name or + classname attribute will be used.
+
linkerarg +
+
Adds a linker command-line arg. Argument will be inherited by all nested + linker elements that do not have inherit="false".
+
precompile +
+
Specifies precompilation prototype file and exclusions. Inherited by all + compilers that do not have inherit="false".
+
project +
+
Specifies the generation of IDE project file. Experimental.
+
sysincludepath +
+
Adds a system include path. Locations and timestamps of files located + using the system include paths are not used in dependency analysis. + + + Standard include locations should not be specified. The compiler + adapters should recognized the settings from the appropriate environment + variables or configuration files. + + System include paths will be inherited by nested compiler elements that + do not have inherit="false".
+
syslibset +
+
Adds a system library set. Timestamps and locations of system library + sets are not used in dependency analysis. + + Essential libraries (such as C Runtime libraries) should not be + specified since the task will attempt to identify the correct libraries + based on the multithread, debug and runtime attributes. + + System library sets will be inherited by all linker elements that do not + have inherit="false".
+
target +
+
Adds a target definition or reference (Non-functional prototype).
+
versioninfo +
+
Adds desriptive version information to be included in the + generated file. The first active version info block will + be used.
+
+
+
+ +
+
+
+
+
+ + + -- cgit v1.2.3