package-info.java revision 3233:b5d08bc0d224
150276Speter/* 2184989Srafan * Copyright (c) 2003, 2015, Oracle and/or its affiliates. All rights reserved. 350276Speter * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 450276Speter * 550276Speter * This code is free software; you can redistribute it and/or modify it 650276Speter * under the terms of the GNU General Public License version 2 only, as 750276Speter * published by the Free Software Foundation. Oracle designates this 850276Speter * particular file as subject to the "Classpath" exception as provided 950276Speter * by Oracle in the LICENSE file that accompanied this code. 1050276Speter * 1150276Speter * This code is distributed in the hope that it will be useful, but WITHOUT 1250276Speter * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 1350276Speter * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 1450276Speter * version 2 for more details (a copy is included in the LICENSE file that 1550276Speter * accompanied this code). 1650276Speter * 1750276Speter * You should have received a copy of the GNU General Public License version 1850276Speter * 2 along with this work; if not, write to the Free Software Foundation, 1950276Speter * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 2050276Speter * 2150276Speter * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA 2250276Speter * or visit www.oracle.com if you need additional information or have any 2350276Speter * questions. 2450276Speter */ 2550276Speter 2650276Speter/** 2750276Speter This package has classes used to generate Javadoc tag documentation. 2850276Speter Doclets no longer have to implement its own version of standard tags 2950276Speter such as @param and @throws. This is the single, doclet 3050276Speter implementation of each standard tag that is shared by all 3150276Speter doclets. Each doclet must have a taglet writer that takes a taglet 32184989Srafan as input and writes doclet-dependent output. The taglet itself will 3350276Speter do the tag processing. For example, suppose we are outputing 3450276Speter @throws tags. The taglet would: 3550276Speter <ul> 3650276Speter <li> Retrieve the list of throws tags to be documented. 3750276Speter <li> Replace {@inheritDoc} with the appropriate documentation. 3850276Speter <li> Add throws documentation for exceptions that are declared in 3950276Speter the signature of the method but 4050276Speter not documented with the throws tags. 4150276Speter </ul> 4266963Speter After doing the steps above, the taglet would pass the information to 4350276Speter the taglet writer for writing. The taglets are essentially builders for 4450276Speter tags. 4566963Speter 4650276Speter <p><b>This is NOT part of any supported API. 47184989Srafan If you write code that depends on this, you do so at your own risk. 4850276Speter This code and its internal interfaces are subject to change or 4950276Speter deletion without notice.</b> 5050276Speter*/ 5162449Speter 5262449Speterpackage jdk.javadoc.internal.doclets.toolkit.taglets; 53166124Srafan