home | career | drupal | java | mac | mysql | perl | scala | uml | unix  

Commons Attributes example source code file (documenting.xml)

This example Commons Attributes source code file (documenting.xml) is included in the DevDaily.com "Java Source Code Warehouse" project. The intent of this project is to help you "Learn Java by Example" TM.

Java - Commons Attributes tags/keywords

ant, ant, apache, cdata, cdata, example, javadoc, javadocs, license, license, taglet, taglet, the, this

The Commons Attributes documenting.xml source code

<?xml version="1.0"?>
<!--
=
= Copyright 2003-2004 The Apache Software Foundation
= 
= Licensed 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>
        <author email="commons-dev@jakarta.apache.org">Jakarta Commons Development Team
        <title>Reference - Documenting with the Taglet
    </properties>
    
    <body>
        <section name="What is a Taglet?">
            
            <p>A taglet is simply put a handler for a Javadoc tag, such as @author, @since and @param.

<source> <p> The taglet is then responsible for formatting the tag in the HTML output. </p> </section> <section name="How Do I Use It?"> <p> We will go through the options below, but in short: </p> <source> <p> From top to bottom, then, are the options specific for the Commons-Attributes taglet: </p> <subsection name="-J-Dorg.apache.commons.attributes.javadoc.CATaglet.sources"> <p> Due to the way tags are used by Commons-Attributes, the Taglet must know which Java files it will run on. This is caused by the Taglet API, which requires the Taglet to specify exactly which tags it will handle. Since @@MyAttr() and @@MyOtherAttr() are considered two different tags, the taglet must first scan the source files and compile a list of all potential tag names. </p> <p> This parameter is a semi-colon (Win32) or colon (Unix) separated list of files or directories that will be used to create Javadocs. If you specify a directory, then all .java files in that directory and any subdirectories are included. </p> <p> Example: </p> <source> </subsection> <subsection name="-tagletpath"> <p> This is simply the classpath for taglets. Include the commons-attributes-compiler JAR. </p> <p> Example: </p> <source> </subsection> <subsection name="-taglet"> <p> The fully-qualified class name of the taglet. </p> <p> Example: </p> <source> </subsection> </section> <section name="Ant Usage"> <p> Ant usage is similar to command line usage. </p> <source> <p> Note the need to: </p> <ul> <li> <p> Include an additionalparam option to specify location of source files. </p> </li> <li> <p> Specify the path to the attribute compiler jar when specifying the taglet. (Javadoc is a separate JVM and does not share classpaths with Ant.) </p> </li> </ul> <p> After you've run the <a href="ant_demo.html">Ant Demo, you can also type: </p> <source> <p>To generate Javadocs for the demo.

</section> </body> </document>

Other Commons Attributes examples (source code examples)

Here is a short list of links related to this Commons Attributes documenting.xml source code file:



my book on functional programming

 

new blog posts

 

Copyright 1998-2019 Alvin Alexander, alvinalexander.com
All Rights Reserved.

A percentage of advertising revenue from
pages under the /java/jwarehouse URI on this website is
paid back to open source projects.