OpenPKG CVS Repository http://cvs.openpkg.org/ ____________________________________________________________________________
Server: cvs.openpkg.org Name: Ralf S. Engelschall Root: /v/openpkg/cvs Email: r...@openpkg.org Module: openpkg-src Date: 16-May-2009 09:05:27 Branch: HEAD Handle: 2009051608052600 Added files: openpkg-src/ant ant.1 build.xml.5 Modified files: openpkg-src/ant ant.spec Log: add manpages Summary: Revision Changes Path 1.1 +73 -0 openpkg-src/ant/ant.1 1.63 +12 -2 openpkg-src/ant/ant.spec 1.1 +166 -0 openpkg-src/ant/build.xml.5 ____________________________________________________________________________ patch -p0 <<'@@ .' Index: openpkg-src/ant/ant.1 ============================================================================ $ cvs diff -u -r0 -r1.1 ant.1 --- /dev/null 2009-05-16 09:05:26 +0200 +++ ant.1 2009-05-16 09:05:26 +0200 @@ -0,0 +1,73 @@ +.TH ant 1 "April 2001" "Debian/GNU Linux" +.SH NAME + +ant - a Java based make tool. + +.SH SYNOPSIS + +.B ant +[\fIOPTION\fR]... [\fITARGET [\fITARGET2\fR] [\fITARGET3\fR] ...\fR]\fR] + +.SH DESCRIPTION + +Like +.B make +.B ant +is a tool by which projects can be build. But unlike it, +.B ant +is based on Java which means it will run on every platform +for which a Java Virtual Machine is available. This makes it a great +tool for building Java software. + +By default it takes information from +.B build.xml +which describes the targets. + +.TP +\fB\-help\fR +print help on the command line options +.TP +\fB\-projecthelp\fR +gives information on possible targets for this project +.TP +\fB\-version\fR +returns the version number +.B ant +.TP +\fB\-quiet\fR +be extra quiet +.TP +\fB\-verbose\fR +be extra verbose +.TP +\fB\-debug\fR +print debugging information +.TP +\fB\-emacs\fR +produce logging information without adornments +.TP +\fB\-logfile\fR <\fIfile\fR> +use the given file to output log to +.TP +\fB\-logger\fR <\fIclassname\fR> +use the given class to perform loggin +.TP +\fB\-listener\fR <\fIclassname\fR> +add an instance of the given class as a project listener +.TP +\fB\-buildfile\fR <\fIfile\fR> +use the given buildfile instead of the default +.B build.xml +file. This is the +.B ant +equivalent of +.B Makefile +.TP +\fB\-D\fR<\fIproperty\fR>=<\fIvalue\Fr> +use value for the given property + +.SH SEE ALSO +.BR make (1) + +.SH AUTHOR +This manpage is written by Egon Willighagen <eg...@sci.kun.nl> @@ . patch -p0 <<'@@ .' Index: openpkg-src/ant/ant.spec ============================================================================ $ cvs diff -u -r1.62 -r1.63 ant.spec --- openpkg-src/ant/ant.spec 18 Apr 2009 13:08:26 -0000 1.62 +++ openpkg-src/ant/ant.spec 16 May 2009 07:05:26 -0000 1.63 @@ -38,7 +38,7 @@ Group: Building License: Apache Software License Version: %{V_ant} -Release: 20090331 +Release: 20090516 # package options %option with_docs no @@ -50,6 +50,8 @@ Source3: http://switch.dl.sourceforge.net/junit/junit%{V_junit}.zip Source4: ant.conf Source5: rc.ant +Source6: ant.1 +Source7: build.xml.5 # build information Prefix: %{l_prefix} @@ -105,7 +107,9 @@ $RPM_BUILD_ROOT%{l_prefix}/bin \ $RPM_BUILD_ROOT%{l_prefix}/etc/ant \ $RPM_BUILD_ROOT%{l_prefix}/etc/rc.d \ - $RPM_BUILD_ROOT%{l_prefix}/libexec/ant/lib + $RPM_BUILD_ROOT%{l_prefix}/libexec/ant/lib \ + $RPM_BUILD_ROOT%{l_prefix}/man/man1 \ + $RPM_BUILD_ROOT%{l_prefix}/man/man5 %{l_shtool} install -c -m 755 \ -e 's;/etc/ant.conf;%{l_prefix}/etc/ant/ant.conf;' \ -e 's;^\(ANT_LIB="\)[^"]*\("\);\1%{l_prefix}/libexec/ant/lib\2;' \ @@ -138,6 +142,12 @@ %{l_shtool} install -c -m 644 \ %{SOURCE maven-ant-tasks-%{V_maven}.jar} \ $RPM_BUILD_ROOT%{l_prefix}/libexec/ant/lib/maven-ant-task.jar + %{l_shtool} install -c -m 644 \ + %{SOURCE ant.1} \ + $RPM_BUILD_ROOT%{l_prefix}/man/man1/ + %{l_shtool} install -c -m 644 \ + %{SOURCE build.xml.5} \ + $RPM_BUILD_ROOT%{l_prefix}/man/man5/ %if "%{with_docs}" == "yes" rm docs/LICENSE* mv docs $RPM_BUILD_ROOT%{l_prefix}/libexec/ant/ @@ . patch -p0 <<'@@ .' Index: openpkg-src/ant/build.xml.5 ============================================================================ $ cvs diff -u -r0 -r1.1 build.xml.5 --- /dev/null 2009-05-16 09:05:26 +0200 +++ build.xml.5 2009-05-16 09:05:27 +0200 @@ -0,0 +1,166 @@ +.TH build.xml 5 "April 2001" "Debian/GNU Linux" +.SH NAME + +build.xml - configuration file used by ant to build projects + +.SH DESCRIPTION + +The file +.B build.xml +is the default configuration file used by +.B ant +to determine target to build for a specific project. It can be +considered the ant equivalent of Makefile.. + +The format of +.B ant +is XML and for each project a seperate file is constructed. +The buildfile consists of one or more tasks. An example is +given below. + +<project default="compile"> + + <target name="compile"> + <javac srcdir="src"> + </target> + +</project> + +This example has one target and it is defaulted. The target itself +consists of one task +.B javac +which compiles the files in the \fIsrc\fR directory. + +.SH TARGETS + +Targets can depend on other targets. These dependencies are given by +the \fIdepends\fR attribute of the <\fItarget\fR> element. + +.SH TASKS + +A task is a piece of code that is executed. +.B Ant +recognizes built-in task, optional tasks, but one can also write new +tasks. + +.B Built-in tasks + +The built-in tasks are: \fIAnt\fR, \fIAntCall\fR, \fIAntStructure\fR, +\fIApply\fR, \fIAvailable\fR, \fIChmod\fR, \fICopy\fR, \fICvs\fR, +\fIDelete\fR, \fIDeltree\fR, \fIEcho\fR, \fIExec\fR, \fIExecOn\fR, +\fIFail\fR, \fIFilter\fR, \fIFixCRLF\fR, \fIGenKey\fR, \fIGet\fR, +\fIGUnzip\fR, \fIGZip\fR, \fIJar\fR, \fIJava\fR, \fIJavac\fR, +\fIJavadoc/Javadoc2\fR, \fIMail\fR, \fIMkdir\fR, \fIMove\fR, \fIPatch\fR, +\fIProperty\fR, \fIReplace\fR, \fIRmic\fR, \fISignJar\fR, \fISql\fR, +\fIStyle\fR, \fITar\fR, \fITaskdef\fR, \fITouch\fR, \fITStamp\fR, \fIUnjar\fR, +\fIUntar\fR, \fIUnwar\fR, \fIUnzip\fR, \fIUptodate\fR, \fIWar\fR, +\fIZip\fR + +.TP +\fBJava\fR +Executes a Java class within the running (Ant) VM or forks another VM if +specified. Below are some of the attibutes to the <\fIjava\fR> element: + +.B classname +(required) the Java class to execute + +.B fork +if enabled triggers the class execution in another VM (disabled by default) + +.B jvm +the command used to invoke the Java Virtual Machine, default is +\fIjava\fR. The command is resolved by java.lang.Runtime.exec(). +Ignored if fork is disabled. + +Other arguments are \fIclasspath\fR, \fIclasspathref\fR, \fImaxmemory\fR, +\fIfailonerror\fR, \fIdir\fR and \fIoutput\fR. + +.TP +\fBJavac\fR +Compiles a source tree within the running (Ant) VM. + +.B srcdir +(required) location of the java files + +.B destdir +location to store the class files + +.B debug +indicates whether source should be compiled +with debug information; defaults to off + +.B optimize +indicates whether source should be compiled +with optimization; defaults to off + +.B target +generate class files for specific VM version +(e.g., 1.1 or 1.2). + +.B includes +comma-separated list of patterns of files that +must be included; all files are included when omitted + +.B excludes +comma-separated list of patterns of files that +must be excluded; no files (except default +excludes) are excluded when omitted. + +.B defaultexcludes +indicates whether default excludes should be +used (yes | no); default excludes are used +when omitted. + +Other arguments are \fIincludesfile\fR, \fIexcludesfile\fR, +\fIclasspath\fR, \fIbootclasspath\fR, \fIclasspathref\fR, +\fIbootclasspathref\fR, \fIextdirs\fR, \fIencoding\fR, +\fIdeprecation\fR, \fIverbose\fR, \fIincludeAntRuntime\fR, +\fIincludeJavaRuntime\fR and \fIfailonerror\fR. + +.SH Properties + +A project can have a set of properties, which consist of a name value +combination. Within tasks they can be used by placing them between +"${" and "}", as in "${builddir}/classes". + +.B Built-in Properties + +Ant provides access to all system properties as if they had been defined +using a <\fIproperty\fR> task. For example, ${os.name} expands to the name of +the operating system. + +.TP +\fBbasedir\fR +the absolute path of the project's basedir (as set +with the basedir attribute of <project>). +.TP +\fBant.file\fR +the absolute path of the buildfile. +.TP +\fBant.project.name\fR +the name of the project that is currently executing; +it is set in the name attribute of <project>. +.TP +\fBant.java.version\fR +the JVM version Ant detected; currently it can hold +the values "1.1", "1.2" and "1.3". + +.SH Classpath + +The classpath can be set by using the <\fIclasspath\fR> +element: + +<classpath> + <pathelement path="${classpath}"/> + <pathelement location="lib/helper.jar"/> + <fileset dir="lib"> + <include name="**/*.jar"/> + </fileset> +</classpath> + +.SH SEE ALSO +.BR ant (1) + +.SH AUTHOR +This manpage is made by Egon Willighagen <eg...@sci.kun.nl> +and based on the Ant Manual <\fIhttp://jakarta.apache.org/ant/manual/\fR>. @@ . ______________________________________________________________________ OpenPKG http://openpkg.org CVS Repository Commit List openpkg-cvs@openpkg.org