/* $Id: Definition.java,v 1.6 2005/12/09 18:22:05 m31 Exp $
 *
 * This file is part of the project "Hilbert II" - http://www.qedeq.org
 *
 * Copyright 2000-2005,  Michael Meyling <mime@qedeq.org>.
 *
 * "Hilbert II" is free software; you can redistribute
 * it and/or modify it under the terms of the GNU General Public
 * License as published by the Free Software Foundation; either
 * version 2 of the License, or (at your option) any later version.
 *
 * This program 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 for more details.
 */

package org.qedeq.kernel.base.module;


/**
 * Definition of operator. This might be a predicate or function constant. For example the
 * predicate "x is a set" could be defined in MK with the formulaOrTerm "\exists y: x \in y".
 * <p>
 * There must also be the possibility to define basic predicate constants like "x is element
 * of y".
 *
 * @version $Revision: 1.6 $
 * @author  Michael Meyling
 */
public interface Definition extends NodeType {

    /**
     * Get definition type. For example: this a predicate definition, a function definition.
     *
     * @return  Definition type.
     */
    public String getType();

    /**
     * Get number of arguments for the defined object. Carries information about the argument
     * number the defined object needs.
     *
     * @return  Argument number.
     */
    public String getArgumentNumber();

    /**
     * Get LaTeX output for definition. The replaceable arguments must are marked as "#1",
     * "#2" and so on. For example "\mathfrak{M}(#1)"
     *
     * @return  LaTeX pattern for definition type setting.
     */
    public String getLatexPattern();

    /**
     * Get variable list of definition arguments.
     *
     * @return  List of formulas or subject variables to be replaced in the LaTeX pattern.
     *          Could be <code>null</code>.
     */
    public VariableList getVariableList();

    /**
     * Get formula or term that defines the object. Could be <code>null</code>.
     *
     * @return  Defining formula or term.
     */
    public FormulaOrTerm getFormulaOrTerm();

    /**
     * Get description. Only necessary if formula is not self-explanatory.
     *
     * @return  Description.
     */
    public LatexList getDescription();

}