001: /*
002: * Copyright 2003 Sun Microsystems, Inc. All Rights Reserved.
003: * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
004: *
005: * This code is free software; you can redistribute it and/or modify it
006: * under the terms of the GNU General Public License version 2 only, as
007: * published by the Free Software Foundation. Sun designates this
008: * particular file as subject to the "Classpath" exception as provided
009: * by Sun in the LICENSE file that accompanied this code.
010: *
011: * This code is distributed in the hope that it will be useful, but WITHOUT
012: * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
013: * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
014: * version 2 for more details (a copy is included in the LICENSE file that
015: * accompanied this code).
016: *
017: * You should have received a copy of the GNU General Public License version
018: * 2 along with this work; if not, write to the Free Software Foundation,
019: * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
020: *
021: * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
022: * CA 95054 USA or visit www.sun.com if you need additional information or
023: * have any questions.
024: */
025:
026: package com.sun.tools.doclets.internal.toolkit;
027:
028: import java.io.*;
029: import com.sun.javadoc.*;
030:
031: /**
032: * The interface for writing constructor output.
033: *
034: * This code is not part of an API.
035: * It is implementation that is subject to change.
036: * Do not use it as an API
037: *
038: * @author Jamie Ho
039: * @since 1.5
040: */
041:
042: public interface ConstructorWriter {
043:
044: /**
045: * Write the header for the constructor documentation.
046: *
047: * @param classDoc the class that the constructors belong to.
048: * @param header the header to write.
049: */
050: public void writeHeader(ClassDoc classDoc, String header);
051:
052: /**
053: * Write the constructor header for the given constructor.
054: *
055: * @param constructor the constructor being documented.
056: * @param isFirst the flag to indicate whether or not the constructor is the
057: * first to be documented.
058: */
059: public void writeConstructorHeader(ConstructorDoc constructor,
060: boolean isFirst);
061:
062: /**
063: * Write the signature for the given constructor.
064: *
065: * @param constructor the constructor being documented.
066: */
067: public void writeSignature(ConstructorDoc constructor);
068:
069: /**
070: * Write the deprecated output for the given constructor.
071: *
072: * @param constructor the constructor being documented.
073: */
074: public void writeDeprecated(ConstructorDoc constructor);
075:
076: /**
077: * Write the comments for the given constructor.
078: *
079: * @param constructor the constructor being documented.
080: */
081: public void writeComments(ConstructorDoc constructor);
082:
083: /**
084: * Write the tag output for the given constructor.
085: *
086: * @param constructor the constructor being documented.
087: */
088: public void writeTags(ConstructorDoc constructor);
089:
090: /**
091: * Write the constructor footer.
092: */
093: public void writeConstructorFooter();
094:
095: /**
096: * Write the footer for the constructor documentation.
097: *
098: * @param classDoc the class that the constructors belong to.
099: */
100: public void writeFooter(ClassDoc classDoc);
101:
102: /**
103: * Let the writer know whether a non public constructor was found.
104: *
105: * @param foundNonPubConstructor true if we found a non public constructor.
106: */
107: public void setFoundNonPubConstructor(boolean foundNonPubConstructor);
108:
109: /**
110: * Close the writer.
111: */
112: public void close() throws IOException;
113: }
|