2007-04-23 21:28:38 +00:00

48 lines
1.8 KiB
XML

<?xml version="1.0"?>
<!--
/*
* 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.
*/
-->
<document>
<properties>
<title>Maven Javadoc Plug-in</title>
<author email="jason@zenplex.com">Jason van Zyl</author>
</properties>
<body>
<section name="Maven Javadoc Plug-in">
<p>
Generates documentation for the Java code in the project using the
standard <a href="http://java.sun.com/j2se/javadoc/">Javadoc</a> tool.
The default settings will suit many projects, and simply entering
<code>maven javadoc</code> will create the standard documentation.
</p>
<p>
The Javadoc plug-in provides a number of <a href="goals.html">goals</a>.
The main goal generates the Javadoc, while a number of subsidiary goals
distribute the results as a jar file.
</p>
<p>
The standard settings for the plug-in are suitable for many uses.
A full range of <a href="properties.html">properties</a> is also
provided for further customisation.
</p>
</section>
</body>
</document>