/*******************************************************************************
 * Copyright (c) 2000, 2009 IBM Corporation and others.
 *
 * This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License 2.0
 * which accompanies this distribution, and is available at
 * https://www.eclipse.org/legal/epl-2.0/
 *
 * SPDX-License-Identifier: EPL-2.0
 *
 * Contributors:
 *     IBM Corporation - initial API and implementation
 *******************************************************************************/
package org.eclipse.pde.core.plugin;

/**
 * This type of model is created by parsing the manifest file. If the file is
 * a workspace resource, it will be available as the underlying resource of the
 * model. The model may be read-only or editable. It will also make a reference
 * to the build.properties model when created. The reference will be of the same type
 * as the model itself: if the model is editable, it will attempt to obtain an
 * exclusive editable copy of build.properties model.
 * <p>
 * The plug-in model can be disabled. Disabling the model will not change its
 * data. Users of the model will have to decide if the disabled state if of any
 * importance to them or not.
 * <p>
 * The model is capable of notifying listeners about changes. An attempt to
 * change a read-only model will result in a CoreException.
 *
 * @noimplement This interface is not intended to be implemented by clients.
 * @noextend This interface is not intended to be extended by clients.
 */
public interface IPluginModel extends IPluginModelBase {
	/**
	 * Returns a top-level model object.
	 *
	 * @return a root model instance
	 */
	IPlugin getPlugin();
}
