FDPManifest.xsd has been changed to FarManifest.xsd

git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@695 6f19259b-4bc3-4df7-8a09-765794883524

2 files changed, 236 insertions, 376 deletions

diff --git a/Tools/XMLSchema/FDPManifest.xsd b/Tools/XMLSchema/FDPManifest.xsd
deleted file mode 100644
index 7730742..0000000
--- a/Tools/XMLSchema/FDPManifest.xsd
+++ /dev/null
@@ -1,376 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>

-<!--

-Filename: SurfaceArea.xsd

-

-Copyright (c) 2006, Intel Corp.

-All rights reserved. This program and the accompanying materials

-are licensed and made available under the terms and conditions of the BSD License

-which may be found at http://opensource.org/licenses/bsd-license.php

-

-THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,

-WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.

-

--->

-<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified"

-    targetNamespace="http://www.TianoCore.org/2006/Edk2.0"

-    xmlns="http://www.TianoCore.org/2006/Edk2.0">

-    <xs:annotation>

-        <xs:documentation xml:lang="en"> This schema defines FDP Manifest </xs:documentation>

-    </xs:annotation>

-    <!--<xs:include schemaLocation="http://nwlxweb02.jf.intel.com/2006/Edk2.0/FrameworkHeaders.xsd"/>-->

-    <xs:include schemaLocation="FrameworkDataElements.xsd"/>

-    <xs:element name="FrameworkDevPkgManifest">

-        <xs:annotation>

-            <xs:documentation xml:lang="en">At the top level of the Manifest we have four sections:

-                Header, Private, Public and Contents.</xs:documentation>

-        </xs:annotation>

-        <xs:complexType>

-            <xs:sequence>

-                <xs:element minOccurs="1" maxOccurs="1" ref="Header"/>

-                <xs:element minOccurs="0" maxOccurs="1" ref="Private"/>

-                <xs:element minOccurs="0" maxOccurs="1" ref="Public"/>

-                <xs:element minOccurs="1" maxOccurs="1" ref="Contents"/>

-            </xs:sequence>

-        </xs:complexType>

-    </xs:element>

-    <xs:element name="Header">

-        <xs:annotation>

-            <xs:documentation xml:lang="en"> The Header contains some three elements that can

-                uniquely identify this package (PackageName, Guid, Version) as well as several

-                fields that identify the licensing and compyright status of the contents of the

-                package. The rest of the fields are there to idenify who created the package and

-                when it was made. The buid fields are here to identify when the package was created,

-                not when the package was compiled. </xs:documentation>

-        </xs:annotation>

-        <xs:complexType>

-            <xs:sequence>

-                <xs:element minOccurs="1" maxOccurs="1" ref="PackageName"/>

-                <xs:element minOccurs="1" maxOccurs="1" ref="Guid"/>

-                <xs:element minOccurs="1" maxOccurs="1" ref="Version"/>

-                <xs:element minOccurs="0" maxOccurs="1" ref="Copyright"/>

-                <xs:element minOccurs="1" maxOccurs="1" ref="License"/>

-                <xs:element minOccurs="1" maxOccurs="1" name="PackageType" type="PackageType"/>

-                <xs:element minOccurs="1" maxOccurs="1" ref="Description"/>

-                <xs:element minOccurs="1" maxOccurs="1" ref="Created"/>

-                <xs:element minOccurs="0" maxOccurs="1" ref="Creator"/>

-                <xs:element minOccurs="0" maxOccurs="1" ref="Vendor"/>

-                <xs:element minOccurs="0" maxOccurs="unbounded" ref="Updated"/>

-                <xs:element minOccurs="0" maxOccurs="unbounded" ref="Modifier"/>

-                <xs:element minOccurs="0" maxOccurs="unbounded" ref="DefaultInstallDir"/>

-                <xs:element minOccurs="0" maxOccurs="1" ref="BuildNumber"/>

-                <xs:element minOccurs="0" maxOccurs="unbounded" ref="BuildTarget"/>

-                <xs:element minOccurs="0" maxOccurs="1" ref="BuildSystem"/>

-                <xs:element minOccurs="0" maxOccurs="1" ref="BuildType"/>

-                <xs:element minOccurs="0" maxOccurs="1" ref="ReleaseType"/>

-            </xs:sequence>

-        </xs:complexType>

-    </xs:element>

-    <xs:element name="BuildNumber" type="xs:integer">

-        <xs:annotation>

-            <xs:documentation> The Build number is an integer that is meant to represent the exact

-                build of the package. </xs:documentation>

-        </xs:annotation>

-    </xs:element>

-    <xs:element name="Type">

-        <xs:annotation>

-            <xs:documentation> In the Type field we can record what kinds of modules are contained

-                in the package. The possibilities are source, binary and mixed (both source and

-                binary.) </xs:documentation>

-        </xs:annotation>

-        <xs:complexType>

-            <xs:attributeGroup ref="attlist.Type"/>

-        </xs:complexType>

-    </xs:element>

-    <xs:attributeGroup name="attlist.Type">

-        <xs:attribute name="Value" use="required">

-            <xs:simpleType>

-                <xs:restriction base="xs:token">

-                    <xs:enumeration value="Source"/>

-                    <xs:enumeration value="Binary"/>

-                    <xs:enumeration value="Mixed"/>

-                </xs:restriction>

-            </xs:simpleType>

-        </xs:attribute>

-    </xs:attributeGroup>

-    <xs:attributeGroup name="attlist.Guid">

-        <xs:attribute name="Value" use="required" type="xs:NMTOKEN"/>

-    </xs:attributeGroup>

-    <xs:element name="BuildTarget" type="SupportedArchitectures">

-        <xs:annotation>

-            <xs:documentation> The build target is used to record what target architecture the

-                modules within this package were compiled for. </xs:documentation>

-        </xs:annotation>

-    </xs:element>

-    <xs:element name="Creator">

-        <xs:annotation>

-            <xs:documentation> In the creator field, we can record the name, user id, and email

-                address of the person who created this package. </xs:documentation>

-        </xs:annotation>

-        <xs:complexType>

-            <xs:attributeGroup ref="attlist.Creator"/>

-        </xs:complexType>

-    </xs:element>

-    <xs:attributeGroup name="attlist.Creator">

-        <xs:attribute name="Name" use="required"/>

-        <xs:attribute name="UserId"/>

-        <xs:attribute name="Email"/>

-    </xs:attributeGroup>

-    <xs:element name="Modifier">

-        <xs:annotation>

-            <xs:documentation> In the Modifier field, we can record the name, user id, and email

-                address of the person who changed/updated or modified this package.

-            </xs:documentation>

-        </xs:annotation>

-        <xs:complexType>

-            <xs:attributeGroup ref="attlist.Modifier"/>

-        </xs:complexType>

-    </xs:element>

-    <xs:attributeGroup name="attlist.Modifier">

-        <xs:attribute name="Name" use="required"/>

-        <xs:attribute name="UserId"/>

-        <xs:attribute name="Email"/>

-    </xs:attributeGroup>

-    <xs:element name="Vendor" type="xs:token">

-        <xs:annotation>

-            <xs:documentation> The name of the company, organization or individual that created or

-                distributes the package. </xs:documentation>

-        </xs:annotation>

-    </xs:element>

-    <xs:element name="BuildSystem">

-        <xs:annotation>

-            <xs:documentation>This is the place to record the name and DNS name of the computer on

-                which the package was created.</xs:documentation>

-        </xs:annotation>

-        <xs:complexType>

-            <xs:attributeGroup ref="attlist.BuildSystem"/>

-        </xs:complexType>

-    </xs:element>

-    <xs:attributeGroup name="attlist.BuildSystem">

-        <xs:attribute name="Name" use="required"/>

-        <xs:attribute name="NetAddr"/>

-    </xs:attributeGroup>

-    <xs:element name="BuildType">

-        <xs:annotation>

-            <xs:documentation> The package may be Debug or Production. </xs:documentation>

-        </xs:annotation>

-        <xs:simpleType>

-            <xs:restriction base="xs:token">

-                <xs:enumeration value="Debug"/>

-                <xs:enumeration value="Production"/>

-            </xs:restriction>

-        </xs:simpleType>

-    </xs:element>

-    <xs:element name="ReleaseType">

-        <xs:annotation>

-            <xs:documentation> We may identify the quality level of the package here.

-            </xs:documentation>

-        </xs:annotation>

-        <xs:simpleType>

-            <xs:restriction base="xs:token">

-                <xs:enumeration value="Developer Build"/>

-                <xs:enumeration value="Experimental Release"/>

-                <xs:enumeration value="Alpha Release"/>

-                <xs:enumeration value="Beta Release"/>

-                <xs:enumeration value="Release Canidate"/>

-                <xs:enumeration value="Official Release"/>

-                <xs:enumeration value="Patch Release"/>

-                <xs:enumeration value="Integration Build Release"/>

-            </xs:restriction>

-        </xs:simpleType>

-    </xs:element>

-    <xs:element name="DefaultInstallDir">

-        <xs:annotation>

-            <xs:documentation> This is the directory, relative to the root of the workspace, where

-                the package will be installed by default. </xs:documentation>

-        </xs:annotation>

-        <xs:complexType>

-            <xs:attributeGroup ref="attlist.DefaultInstallDir"/>

-        </xs:complexType>

-    </xs:element>

-    <xs:attributeGroup name="attlist.DefaultInstallDir">

-        <xs:attribute name="Name" use="required"/>

-    </xs:attributeGroup>

-    <xs:element name="Dependencies">

-        <xs:annotation>

-            <xs:documentation> We can track the pakages that this package provides (these are the

-                packages contained in this pacakge.) We also record which packages are required by

-                this package. </xs:documentation>

-        </xs:annotation>

-        <xs:complexType>

-            <xs:sequence>

-                <xs:element minOccurs="0" ref="Requires"/>

-                <xs:element minOccurs="0" ref="Provides"/>

-            </xs:sequence>

-        </xs:complexType>

-    </xs:element>

-    <xs:element name="Requires">

-        <xs:annotation>

-            <xs:documentation> This is a list of the packages that this package requires to be

-                installed in the workspace for package to function and/or build correctly. In the

-                case of source packages, these are the necessary dependencies for successful

-                build-time operation of the package. For binary packages these dependencies are

-                necessary for successful runtime operation.</xs:documentation>

-        </xs:annotation>

-        <xs:complexType mixed="true">

-            <xs:choice minOccurs="0" maxOccurs="unbounded">

-                <xs:element name="Package">

-                    <xs:annotation>

-                        <xs:documentation xml:lang="en">This tag is used in the Framework Package

-                            Database File to track individual package information. The Path is a

-                            relative path to the SPD File.</xs:documentation>

-                    </xs:annotation>

-                    <xs:complexType>

-                        <xs:sequence maxOccurs="unbounded">

-                            <xs:element minOccurs="0" maxOccurs="1" ref="PackageName"/>

-                            <xs:element minOccurs="1" maxOccurs="1" ref="Guid"/>

-                            <xs:element minOccurs="1" maxOccurs="1" ref="Version"/>

-                            <xs:element minOccurs="1" maxOccurs="1" ref="Path"/>

-                            <xs:element minOccurs="1" maxOccurs="1" ref="InstalledDate"/>

-                        </xs:sequence>

-                        <xs:attributeGroup ref="PackageAttributes"/>

-                    </xs:complexType>

-                </xs:element>

-                <xs:element ref="Includes"/>

-                <xs:element name="Library">

-                    <xs:complexType>

-                        <xs:simpleContent>

-                            <xs:extension base="xs:NCName">

-                                <xs:attributeGroup ref="LibraryAttributes"/>

-                            </xs:extension>

-                        </xs:simpleContent>

-                    </xs:complexType>

-                </xs:element>

-                <xs:element name="Protocol">

-                    <xs:complexType>

-                        <xs:simpleContent>

-                            <xs:extension base="C_Name">

-                                <xs:attributeGroup ref="ProtocolAttributes"/>

-                            </xs:extension>

-                        </xs:simpleContent>

-                    </xs:complexType>

-                </xs:element>

-                <xs:element ref="Guid"/>

-                <xs:element ref="File"/>

-            </xs:choice>

-        </xs:complexType>

-    </xs:element>

-    <xs:element name="Provides">

-        <xs:annotation>

-            <xs:documentation>The list of dependencies that the package fulfills.</xs:documentation>

-        </xs:annotation>

-        <xs:complexType>

-            <xs:choice minOccurs="0" maxOccurs="unbounded">

-                <xs:element name="Package">

-                    <xs:annotation>

-                        <xs:documentation xml:lang="en">This tag is used in the Framework Package

-                            Database File to track individual package information. The Path is a

-                            relative path to the SPD File.</xs:documentation>

-                    </xs:annotation>

-                    <xs:complexType>

-                        <xs:sequence maxOccurs="unbounded">

-                            <xs:element minOccurs="0" maxOccurs="1" ref="PackageName"/>

-                            <xs:element minOccurs="1" maxOccurs="1" ref="Guid"/>

-                            <xs:element minOccurs="1" maxOccurs="1" ref="Version"/>

-                            <xs:element minOccurs="1" maxOccurs="1" ref="Path"/>

-                            <xs:element minOccurs="1" maxOccurs="1" ref="InstalledDate"/>

-                        </xs:sequence>

-                        <xs:attributeGroup ref="PackageAttributes"/>

-                    </xs:complexType>

-                </xs:element>

-                <xs:element ref="Includes"/>

-                <xs:element name="Library">

-                    <xs:annotation><xs:documentation>

-                        A library. It can be provided by or required by this or other packages.

-                    </xs:documentation></xs:annotation>

-                    <xs:complexType>

-                        <xs:simpleContent>

-                            <xs:extension base="xs:NCName">

-                                <xs:attributeGroup ref="LibraryAttributes"/>

-                            </xs:extension>

-                        </xs:simpleContent>

-                    </xs:complexType>

-                </xs:element>

-                <xs:element name="Protocol">

-                    <xs:annotation>

-                        <xs:documentation>

-                        A protocol. It can be provided by or required by this or other packages.

-                    </xs:documentation>

-                    </xs:annotation>

-                    <xs:complexType>

-                        <xs:simpleContent>

-                            <xs:extension base="C_Name">

-                                <xs:attributeGroup ref="ProtocolAttributes"/>

-                            </xs:extension>

-                        </xs:simpleContent>

-                    </xs:complexType>

-                </xs:element>

-                <xs:element ref="Guid"/>

-                <xs:element ref="File"/>

-            </xs:choice>

-        </xs:complexType>

-    </xs:element>

-    <xs:attributeGroup name="attlist.Library">

-        <xs:attribute name="Name" use="required"/>

-    </xs:attributeGroup>

-    <xs:attributeGroup name="attlist.Protocol">

-        <xs:attribute name="Name" use="required"/>

-        <xs:attribute name="Guid" use="required" type="xs:NMTOKEN"/>

-    </xs:attributeGroup>

-    <xs:element name="Private">

-        <xs:annotation>

-            <xs:documentation> The Private section is a place where the files are listed that should

-                not be seen by the users of this package. </xs:documentation>

-        </xs:annotation>

-        <xs:complexType mixed="true">

-            <xs:sequence>

-                <xs:element minOccurs="0" maxOccurs="unbounded" ref="File"/>

-            </xs:sequence>

-        </xs:complexType>

-    </xs:element>

-    <xs:element name="Public">

-        <xs:annotation>

-            <xs:documentation> The Public section is a list of files that are meant to be seen by

-                the users of the package. </xs:documentation>

-        </xs:annotation>

-        <xs:complexType mixed="true">

-            <xs:sequence>

-                <xs:element minOccurs="0" maxOccurs="unbounded" ref="File"/>

-            </xs:sequence>

-        </xs:complexType>

-    </xs:element>

-    <xs:element name="Contents">

-        <xs:annotation>

-            <xs:documentation>This is a list of all the files within this package. Each file is

-                identified by its path relative to the workspace root.</xs:documentation>

-        </xs:annotation>

-        <xs:complexType>

-            <xs:sequence>

-                <xs:element maxOccurs="unbounded" ref="File"/>

-            </xs:sequence>

-        </xs:complexType>

-    </xs:element>

-    <xs:element name="File">

-        <xs:annotation>

-            <xs:documentation xml:lang="en">Specify a filename including the path</xs:documentation>

-        </xs:annotation>

-        <xs:complexType>

-            <xs:simpleContent>

-                <xs:extension base="xs:normalizedString">

-                    <xs:attributeGroup ref="attlist.File"/>

-                </xs:extension>

-            </xs:simpleContent>

-        </xs:complexType>

-    </xs:element>

-    <xs:attributeGroup name="attlist.File">

-        <xs:attribute name="Type"/>

-        <xs:attribute name="Desc"/>

-        <xs:attribute name="Size" type="xs:NMTOKEN"/>

-        <xs:attribute name="CDate" type="xs:NMTOKEN"/>

-        <xs:attribute name="CTime" type="xs:NMTOKEN"/>

-        <xs:attribute name="MDate" type="xs:NMTOKEN"/>

-        <xs:attribute name="MTime" type="xs:NMTOKEN"/>

-        <xs:attribute name="ADate" type="xs:NMTOKEN"/>

-        <xs:attribute name="ATime" type="xs:NMTOKEN"/>

-        <xs:attribute name="Checksum" type="xs:NMTOKEN"/>

-    </xs:attributeGroup>

-</xs:schema>

diff --git a/Tools/XMLSchema/FarManifest.xsd b/Tools/XMLSchema/FarManifest.xsd
new file mode 100644
index 0000000..c148084
--- /dev/null
+++ b/Tools/XMLSchema/FarManifest.xsd
@@ -0,0 +1,236 @@
+<?xml version="1.0" encoding="UTF-8"?>

+<!--

+Filename: FarManifest.xsd

+

+Copyright (c) 2006, Intel Corp.

+All rights reserved. This program and the accompanying materials

+are licensed and made available under the terms and conditions of the BSD License

+which may be found at http://opensource.org/licenses/bsd-license.php

+

+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,

+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.

+

+-->

+<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" targetNamespace="http://www.TianoCore.org/2006/Edk2.0" xmlns="http://www.TianoCore.org/2006/Edk2.0">

+  <xs:include schemaLocation="FrameworkHeaders.xsd"/>  

+  <xs:annotation>

+    <xs:documentation xml:lang="en">

+      The Framework Archive File Format is defined as a Java Archive file, with a special xml file called FrameworkArchiveManifest.xml at the top of the archive. The FrameworkArchiveManifest.xml must be an instance of this schema.

+    </xs:documentation>

+  </xs:annotation>

+  <xs:element name="FrameworkArchiveManifest">

+    <xs:annotation>

+      <xs:documentation xml:lang="en">

+        This schema defines the Framework Archive Manifest. 

+      </xs:documentation>

+    </xs:annotation>

+    <xs:complexType>

+      <xs:sequence>

+        <xs:element minOccurs="1" maxOccurs="1" ref="FarHeader"/>

+        <xs:element minOccurs="0" maxOccurs="1" ref="FarPackageList">   

+          <xs:annotation>

+            <xs:documentation>

+              The list of packages in this FAR.

+            </xs:documentation>

+          </xs:annotation>

+        </xs:element>

+        <xs:element minOccurs="0" maxOccurs="1" ref="FarPlatformList">          

+          <xs:annotation>

+            <xs:documentation>

+              The list of platforms in this FAR.

+            </xs:documentation>

+          </xs:annotation>

+        </xs:element>

+        <xs:element minOccurs="0" maxOccurs="1" ref="Contents">   

+          <xs:annotation>

+            <xs:documentation>

+              Extra contents that are not part of any Package or Platform. These file paths are WORKSPACE relative.  If a file exists in the workspace at this location, then the user should be asked whether to overwrite.  When the user removes the far, these should be removed also, unless they have been modified (per md5sum).

+            </xs:documentation>

+          </xs:annotation>

+        </xs:element>

+        <xs:element minOccurs="0" maxOccurs="unbounded" ref="UserExtensions"/>

+      </xs:sequence>

+    </xs:complexType>

+  </xs:element>

+  <xs:element name="FarPackageList">

+    <xs:complexType>

+      <xs:sequence>

+        <xs:element minOccurs="1" maxOccurs="unbounded" ref="FarPackage"/>

+      </xs:sequence>

+    </xs:complexType>

+  </xs:element>

+  <xs:element name="FarPackage">

+    <xs:complexType>

+      <xs:sequence>

+        <xs:element ref="FarFilename">

+          <xs:annotation>

+            <xs:documentation>

+              This is the name of the .spd or .psa file that describes the package. It must exist in the directory identified by DefaultPath.

+            </xs:documentation>

+          </xs:annotation>

+        </xs:element>

+        <xs:element ref="GuidValue"></xs:element>

+        <xs:element ref="Version"></xs:element>

+        <xs:element ref="DefaultPath">

+          <xs:annotation>

+            <xs:documentation>

+              This is the default installation location within the workspace. This also serves as the location within the far itself of the package root. The Contents of the pacakage will be found there. The user may choose some other location within the workspace to install the package, as long as it does not overlap a package that is already installed.

+            </xs:documentation>

+          </xs:annotation>

+        </xs:element>

+        <xs:element minOccurs="0" maxOccurs="1" ref="FarPackageList">

+          <xs:annotation>

+            <xs:documentation>

+              This list of packages is relative to the package root of the package that they are contained in. If the platform that these are bound to is intstalled in some directory other than the default, then these platforms should be stored relative to that.

+            </xs:documentation>

+          </xs:annotation>

+        </xs:element>

+        <xs:element ref="Contents">

+          <xs:annotation>

+            <xs:documentation>

+              This is the list of files that belong to the package. They are specified by relative path from the root of the pacakge.                            

+            </xs:documentation>

+          </xs:annotation>

+        </xs:element>

+        <xs:element minOccurs="0" maxOccurs="unbounded" ref="UserExtensions"></xs:element>

+      </xs:sequence>

+    </xs:complexType>

+  </xs:element>

+  <xs:element name="FarPlatform">

+    <xs:annotation>

+      <xs:documentation>

+        Platforms are treated separately from packages. A platform is listed in the far if, and only if, it is not part of some package.

+      </xs:documentation>

+    </xs:annotation>

+    <xs:complexType>

+      <xs:sequence>

+        <xs:element ref="FarFilename">

+          <xs:annotation>

+            <xs:documentation>

+              This is the relative path to the .fpd file that describes the platform.

+            </xs:documentation>

+          </xs:annotation>

+        </xs:element>

+        <xs:element ref="GuidValue"></xs:element>

+        <xs:element ref="Version"></xs:element>

+        <xs:element minOccurs="0" maxOccurs="unbounded" ref="UserExtensions"></xs:element>

+      </xs:sequence>

+    </xs:complexType>

+  </xs:element>

+  <xs:element name="DefaultPath" type="PathAndFilename"/>

+  <xs:element name="FarPlatformList">

+    <xs:complexType>

+      <xs:sequence>

+        <xs:element maxOccurs="unbounded" ref="FarPlatform">

+        </xs:element>

+      </xs:sequence>

+    </xs:complexType>

+  </xs:element>

+  <xs:element name="FarFilename" type="DbPathAndFilename">

+    <xs:annotation>

+      <xs:documentation>

+        The FarFilename is used to build up the Contents list. It has an md5sum attribute for keeping track of whether the file is changed after it is installed. The Md5sum can also be used to check the integrity of a far before it is installed into the workspace.

+      </xs:documentation>

+    </xs:annotation>

+  </xs:element>

+  <xs:element name="GuidValue" type="GuidType">

+    <xs:annotation>

+      <xs:documentation>

+        The purpose of this element is to allow Guids to be assigned to or used by other elements in the schema.

+      </xs:documentation>

+    </xs:annotation>

+  </xs:element>

+  <xs:element name="Contents">

+    <xs:annotation>

+      <xs:documentation>

+        This tag allows us to specify a tree of files all having a common root. All the files specified are relative to that common root.

+      </xs:documentation>

+    </xs:annotation>

+    <xs:complexType>

+      <xs:sequence>

+        <xs:element maxOccurs="unbounded" ref="FarFilename"/>

+      </xs:sequence>

+    </xs:complexType>

+  </xs:element>

+  <xs:annotation>

+    <xs:documentation xml:lang="en">

+      Definitions and rules for creating, installing, updating and removing fars within the workspace.

+    </xs:documentation>

+    <xs:documentation>

+      1.  A module m is said to depend upon a package p, iff there exists a tuple (PackageGuid, PackageVerion) in the set m->PackageDependencies for which p->Guid==PackageGuid, and if PackageVersion is not empty, then p->Version is == PackageVersion.

+    </xs:documentation>

+    <xs:documentation>

+      2.  A far f is said to depend on a far g, iff there is a module in a package in f that depends on a package in g.

+    </xs:documentation>

+    <xs:documentation>

+      3.  A far f is said to depend on a package p, iff there is a module m contained in f that depends on p.

+    </xs:documentation>

+    <xs:documentation>

+      3.1 A platform q is said to depend on a package p, iff p, or some module m contained in p, is necessary to build q.

+    </xs:documentation>

+    <xs:documentation>

+      4.  A far f may be installed into the workspace w, iff for each module m in f, m’s dependencies are met by the packages in w.

+    </xs:documentation>

+    <xs:documentation>

+      a. (If the dependencies are not met, then no part of far f will be installed. It is not legal to partially install a far into the workspace.)

+    </xs:documentation>

+    <xs:documentation>

+      5.  A far f may be removed from the workspace w, iff for each module m in w, and for each package p in f, m does not depend on p.

+    </xs:documentation>

+    <xs:documentation>

+      a. (If there is some dependency on f, then no part of f may be uninstalled from w. It is not legal to partially uninstall a far from the workspace.)

+    </xs:documentation>

+    <xs:documentation>

+      6.  When installing a far f into workspace w, for each package p in f, allow the user to install in p's default location, or choose a new location l (which must be unoccupied) within the workspace. Record this location l in the database. Each package p in f will be recorded in the database, associated with the GUID of f, as well as the actual install location l. (So we will know which far each package belongs to.)

+    </xs:documentation>

+    <xs:documentation>

+      7.  When installing a far f into workspace w, if there exists a package p in w, and p is in f, then the user must be prompted to choose a location that does not collide with the location of p in workspace w. We will end up with two instances of p in w at two distinct locations.

+    </xs:documentation>

+    <xs:documentation>

+      8.  A far f may replace a far g in the workspace w, iff for each module m contained in w, if m depends on a package p, and p is only contained in g, then there must exist a package q in f, such that m depends on q. The net effect is that g is removed and f is installed, in one operation. The normal rules for installing f still apply--the dependencies of the modules of f must be satisfied. After the replacement, it must be the case that all the modules dependencies in the workspace are satisfied. Note that it is possible to backrev a package in this way. 

+    </xs:documentation>

+    <xs:documentation>

+          (If we find that the replace is not permitted, then the user may install f and keep g. Next, he could _port_ every module m in w that depends on g, to f and eventually remove g.)

+    </xs:documentation>

+    <xs:documentation>

+      9.  A special case of the above rule is that a far f may be reinstalled into the workspace. (This would allow the user to get a fresh copy, or change the location in the workspace where one or more of the packages of f are installed.)

+    </xs:documentation>

+    <xs:documentation>

+      10. When a far f is removed from the workspace w, for each package p in f, we will remove p from w.

+    </xs:documentation>

+    <xs:documentation>

+      11. If a package p belongs to a far f, then it is not legal to remove p from the workspace w unless f is removed from w.

+    </xs:documentation>

+    <xs:documentation>

+      11.1 If a platform p belongs to a far f, then it is not legal to remove p from the workspace w unless f is removed from w.

+    </xs:documentation>

+    <xs:documentation>

+      12. A package p may be removed from the workspace, provided there does not exist a far f that contains p. (Newly created packages will not exist within a far, and thus may be removed from the workspace directly.)

+    </xs:documentation>

+    <xs:documentation>

+      13. When a far f is removed from the workspace, the user has two options:

+    </xs:documentation>

+    <xs:documentation>

+      a. Keep all the files in the workspace tree.

+    </xs:documentation>

+    <xs:documentation>

+      b. Remove all the files in f from the workspace tree. If a file has been modified from the original as installed from the far (per md5sum) then the user should be asked if he is "sure" he wants to remove it.

+    </xs:documentation>

+    <xs:documentation>

+      14. When a far is created, a GUID is generated and assigned to the far. If a far is created from the same components at a later time, it would have a different GUID.

+    </xs:documentation>

+    <xs:documentation>

+      15. If a package p is marked with RePackage==false, then p may not be added to a far.

+    </xs:documentation>

+    <xs:documentation>

+      16. When constructing a far f that contains at least one platform, then f may optionally be constructed such that for each platform q in f, every package p on which q depends should be included in f, unless p->repackage==false. The far will have all the packages required, and may then be installed as a self-inflating executable that will create a brand new workspace on the developer's workstation.

+    </xs:documentation>

+    <xs:documentation>

+      17. A far f is identical to a far g, iff f->Guid == g->Guid.

+    </xs:documentation>

+    <xs:documentation>

+      18. A far f may be installed into the workspace w, iff there is no far g in w such that f->Guid==g->Guid.

+    </xs:documentation>

+    

+  </xs:annotation>

+</xs:schema>