<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head>
<!--

/******************************************************************************
 * Copyright (c) 2004,2005 IBM Corporation and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *    IBM Corporation - initial API and implementation 
 ****************************************************************************/

-->
</head>
<body>

MSL resource implementation.  This package provides the MSL implementation of
the EMF {@link org.eclipse.emf.ecore.resource.Resource} interface, and the
resource factory responsible for creating MSL resources.

<h2>Package Specification</h2>
<p>
The {@link org.eclipse.gmf.runtime.emf.core.internal.resources.MResource} interface
is the abstract specification of an MSL resource, which extensions of the
MSL can implement to customize certain key MSL behaviours such as creating,
destroying, iterating, and managing the IDs of model elements.
</p>
<p>
Custom <code>MResource</code>s are typically created by custom implementations
of the {@link org.eclipse.gmf.runtime.emf.core.internal.resources.MResourceFactory}
interface, which must also implement the EMF
{@link org.eclipse.emf.ecore.resource.Resource.Factory Resource.Factory} interface.
<code>MResourceFactory</code> also defines an API for customization proxy resolution.
</p>
<p>
If required, custom <code>MResource</code>s should consider extending
the {@link org.eclipse.gmf.runtime.emf.core.internal.resources.LogicalResource} class
to inherit support for decomposition of resources into multiple "physical" parts.
This is typically useful only if the resource is to be persisted in files
in a version-control system.
</p>
<p>
Other classes in this package are responsible for the MSL's customization of
EMF's XMI persistence capabilities and the handling of dangling references
and other problems in serialization and deserialization.
</p>

@see org.eclipse.gmf.runtime.emf.core.util.EObjectUtil
@see org.eclipse.gmf.runtime.emf.core.util.ResourceUtil
@see org.eclipse.gmf.runtime.emf.core.util.ProxyUtil

@canBeSeenBy org.eclipse.gmf.runtime.emf.core.*

</body>
</html>