/*
 * Copyright (c) 2003, 2021, Oracle and/or its affiliates. All rights reserved.
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
 *
 * This code is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License version 2 only, as
 * published by the Free Software Foundation.  Oracle designates this
 * particular file as subject to the "Classpath" exception as provided
 * by Oracle in the LICENSE file that accompanied this code.
 *
 * This code is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
 * version 2 for more details (a copy is included in the LICENSE file that
 * accompanied this code).
 *
 * You should have received a copy of the GNU General Public License version
 * 2 along with this work; if not, write to the Free Software Foundation,
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
 *
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
 * or visit www.oracle.com if you need additional information or have any
 * questions.
 */

package jdk.javadoc.internal.doclets.toolkit;

import javax.lang.model.element.ExecutableElement;

The interface for writing constructor output.
 
This is NOT part of any supported API.
 If you write code that depends on this, you do so at your own risk.
 This code and its internal interfaces are subject to change or
 deletion without notice.
/**
 * The interface for writing constructor output.
 *
 *  <p><b>This is NOT part of any supported API.
 *  If you write code that depends on this, you do so at your own risk.
 *  This code and its internal interfaces are subject to change or
 *  deletion without notice.</b>
 */

public interface ConstructorWriter extends MemberWriter {

    
Get the constructor details tree header.
Params:
memberDetailsTree – the content tree representing member details
Returns:
content tree for the constructor details header/**
     * Get the constructor details tree header.
     *
     * @param memberDetailsTree the content tree representing member details
     * @return content tree for the constructor details header
     */
    Content getConstructorDetailsTreeHeader(Content memberDetailsTree);

    
Get the constructor documentation tree header.
Params:
constructor – the constructor being documented
Returns:
content tree for the constructor documentation header/**
     * Get the constructor documentation tree header.
     *
     * @param constructor the constructor being documented
     * @return content tree for the constructor documentation header
     */
    Content getConstructorDocTreeHeader(ExecutableElement constructor);

    
Get the signature for the given constructor.
Params:
constructor – the constructor being documented
Returns:
content tree for the constructor signature/**
     * Get the signature for the given constructor.
     *
     * @param constructor the constructor being documented
     * @return content tree for the constructor signature
     */
    Content getSignature(ExecutableElement constructor);

    
Add the deprecated output for the given constructor.
Params:
constructor – the constructor being documented
constructorDocTree – content tree to which the deprecated information will be added/**
     * Add the deprecated output for the given constructor.
     *
     * @param constructor the constructor being documented
     * @param constructorDocTree content tree to which the deprecated information will be added
     */
    void addDeprecated(ExecutableElement constructor, Content constructorDocTree);

    
Add the preview output for the given member.
Params:
member – the member being documented
annotationDocTree – content tree to which the preview information will be added/**
     * Add the preview output for the given member.
     *
     * @param member the member being documented
     * @param annotationDocTree content tree to which the preview information will be added
     */
    void addPreview(ExecutableElement member, Content contentTree);

    
Add the comments for the given constructor.
Params:
constructor – the constructor being documented
constructorDocTree – the content tree to which the comments will be added/**
     * Add the comments for the given constructor.
     *
     * @param constructor the constructor being documented
     * @param constructorDocTree the content tree to which the comments will be added
     */
    void addComments(ExecutableElement constructor, Content constructorDocTree);

    
Add the tags for the given constructor.
Params:
constructor – the constructor being documented
constructorDocTree – the content tree to which the tags will be added/**
     * Add the tags for the given constructor.
     *
     * @param constructor the constructor being documented
     * @param constructorDocTree the content tree to which the tags will be added
     */
    void addTags(ExecutableElement constructor, Content constructorDocTree);

    
Get the constructor details tree.
memberDetailsTreeHeader the content tree representing member details header
Params:
memberDetailsTree – the content tree representing member details
Returns:
content tree for the constructor details/**
     * Get the constructor details tree.
     *
     * memberDetailsTreeHeader the content tree representing member details header
     * @param memberDetailsTree the content tree representing member details
     * @return content tree for the constructor details
     */
    Content getConstructorDetails(Content memberDetailsTreeHeader, Content memberDetailsTree);

    
Let the writer know whether a non public constructor was found.
Params:
foundNonPubConstructor – true if we found a non public constructor./**
     * Let the writer know whether a non public constructor was found.
     *
     * @param foundNonPubConstructor true if we found a non public constructor.
     */
    void setFoundNonPubConstructor(boolean foundNonPubConstructor);

    
Gets the member header tree.
Returns:
a content tree for the member header/**
     * Gets the member header tree.
     *
     * @return a content tree for the member header
     */
    Content getMemberTreeHeader();
}