ant-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From k...@apache.org
Subject svn commit: r540965 - /ant/sandbox/antlibs/debian/trunk/docs/index.html
Date Wed, 23 May 2007 14:47:51 GMT
Author: kevj
Date: Wed May 23 07:47:50 2007
New Revision: 540965

URL: http://svn.apache.org/viewvc?view=rev&rev=540965
Log:
-skeleton docs

Added:
    ant/sandbox/antlibs/debian/trunk/docs/index.html

Added: ant/sandbox/antlibs/debian/trunk/docs/index.html
URL: http://svn.apache.org/viewvc/ant/sandbox/antlibs/debian/trunk/docs/index.html?view=auto&rev=540965
==============================================================================
--- ant/sandbox/antlibs/debian/trunk/docs/index.html (added)
+++ ant/sandbox/antlibs/debian/trunk/docs/index.html Wed May 23 07:47:50 2007
@@ -0,0 +1,132 @@
+<!--
+   Licensed to the Apache Software Foundation (ASF) under one or more
+   contributor license agreements.  See the NOTICE file distributed with
+   this work for additional information regarding copyright ownership.
+   The ASF licenses this file to You under the Apache License, Version 2.0
+   (the "License"); you may not use this file except in compliance with
+   the License.  You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+-->
+<html>
+  <head>
+    <meta http-equiv="Content-Language" content="en-us"></meta>
+    <link rel="stylesheet" type="text/css" href="style.css">
+    <title>Debian Ant Library</title>
+  </head>
+
+  <body>
+    <h2>Introduction</h2>
+
+    <p>This library provides support for building/installing/maintaining
+    Debian packages.
+    </p>
+
+    <h2>Requirements</h2>
+
+    <p>
+    <ul>
+      <li>Ant 1.7.0+</li>
+      <li>Debian based GNU/Linux distribution, dpkg installed</li>
+      <li>super user rights</li>
+    </ul>
+    </p>
+
+    <h2>Sandbox...</h2>
+
+    <p>The source code for this library lives in the
+    sandbox of Ant's SVN - <a
+    href="http://svn.apache.org/viewvc/ant/sandbox/antlibs/debian/trunk/">http://svn.apache.org/viewvc/ant/sandbox/antlibs/debian/trunk/</a>.</p>
+
+    <h2>Installation</h2>
+
+    <p>If you are building this from sources, run the antlib target
+    and you'll get a file <code>ant-debian-[version].jar</code>.</p>
+
+    <p>There are several ways to use the tasks:</p>
+
+    <ul>
+      <li>The traditional way:
+        <pre>
+          &lt;taskdef 
+            resource="org/apache/ant/antunit/antlib.xml"&gt;
+            &lt;classpath&gt;
+              &lt;pathelement location="YOUR-PATH-TO/ant-debian=[version].jar"/&gt;
+            &lt;/classpath&gt;
+          &lt;/taskdef&gt;
+        </pre>
+
+        With this you can use the tasks like plain Ant tasks, they'll
+        live in the default namespace.  I.e. if you can run
+        &lt;exec&gt; without any namespace prefix, you can do so for
+        &lt;debian&gt; as well.
+      </li>
+
+      <li>Similar, but assigning a namespace URI
+        <pre>
+          &lt;taskdef 
+            uri="antlib:org.apache.ant.debian"
+            resource="org/apache/ant/debian/antlib.xml"&gt;
+            &lt;classpath&gt;
+              &lt;pathelement location="YOUR-PATH-TO/ant-debian-[version].jar"/&gt;
+            &lt;/classpath&gt;
+          &lt;/taskdef&gt;
+        </pre>
+
+        This puts the tasks into a separate namespace, different from Ant's
+        namespace.  You would use the tasks like
+
+        <pre>
+          &lt;project
+            xmlns:deb="antlib:org.apache.ant.debian"
+            xmlns="antlib:org.apache.tools.ant"&gt;
+            ...
+            &lt;deb:dpkg packageName="${package}" dir="${src.dir}"/&gt;
+        </pre>
+
+        or a variation thereof.
+      </li>
+
+      <li>Using Ant's autodiscovery.  Place <code>ant-debian-[version].jar</code>
+      into a directory and use <code>ant -lib
+      DIR-CONTAINING-THE-JAR</code> or copy it into
+      <code>ANT_HOME/lib</code> - and then in your build file, simply
+      declare the namespace on the <code>project</code> tag:
+
+        <pre>
+          &lt;project
+            xmlns:deb="antlib:org.apache.ant.debian"
+            xmlns="antlib:org.apache.tools.ant"&gt;
+        </pre>
+
+        And all tasks of this library will automatically be available
+        in the <code>au</code> namespace without any
+        <code>taskdef</code>.
+      </li>
+    </ul>
+
+    <h2>Tasks and Types</h2>
+
+    <ul>
+      <li><a href="control.html">control</a> - TODO.</li>
+
+      <li><a href="dpkg.html">dpkg</a> - TODO.</li>
+
+      <li><a href="install.html">install</a> - TODO.</li>
+
+      <li><a href="checksum.html">checksum</a> - TODO.</li>
+
+      <li><a href="verify.html">verify</a> - TODO.</li>
+      
+      <li><a href="status.html">status</a> - TODO.</li>
+    </ul>
+
+    <hr/>
+  </body>
+</html>
\ No newline at end of file



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


Mime
View raw message