Skip to main content
Jump to: navigation, search

Orbit/IP Log

< Orbit
Revision as of 15:12, 15 March 2007 by Dj (Talk | contribs) (Example)

Orbit projects need to have a common way to keep track of the IP information for all versions of the project. In an effort to make this easier, we will put an XML file in each project root in HEAD and it will contain all of the information for that project and all of its versions.


Here is an initial stab at a file format for the IP Log info for the Orbit projects.

<!DOCTYPE project[

<!-- A "project" element represents a specific version of an Orbit project. The
     "id" is the bundle symbolic name and the "version" is the project version. 
<!ELEMENT project info contact notes legal+>
<!ATTLIST project version CDATA #REQUIRED>

<!-- An "info" element contains more information on the project including where we got 
     it and optional references on the web, etc. -->
<!ELEMENT info (name? origin? reference? repository location tag?)>

<!-- The "name" is a human-readable name for the project. -->

<!-- The "origin" is the originating company for the project. -->
<!ELEMENT origin (#PCDATA)>

<!-- The "reference" a URL or reference to the original project. (e.g. web site) -->
<!ELEMENT reference (#PCDATA)>

<!-- The "repository" is the path to the CVS repository. -->
<!ELEMENT repository (#PCDATA)>

<!-- The "location" is the path in the CVS repository. -->
<!ELEMENT location (#PCDATA)>

<!-- The "tag" is the CVS tag or branch for the project. -->

<!-- The "contact" element describes the person on Orbit who is the contact for that project. -->
<!ELEMENT contact (name? email company?)>
<!ELEMENT email (#PCDATA)>
<!ELEMENT company (#PCDATA)>

<!-- The "notes" element is an area for free-form notes about the project. -->
<!ELEMENT notes (note+)>

<!-- The "legal" element describes the legal items related to the project. There can be more 
     than one if we have more than one package (JAR, package, or some other unit that has a 
     different license than the enclosing project) The "package" element is not required (and 
     there should only be one "legal" element) if the "legal" element applies to the whole project. 
<!ELEMENT legal (ipzilla license package?)>
<!ELEMENT ipzilla>
<!ATTLIST ipzilla bug_id CDATA #REQUIRED>
<!ELEMENT license (name? reference)>
<!ELEMENT package (#PCDATA)>


Example for Xerces:

<project id="org.apache.xerces" version="2.8.0">
		<name>Apache Xerces</name>
		<name>Joe Smith</name>
		<company>Example Company</company>
		<note>We use this bundle for parsing XML.</note>
		<ipzilla bug_id="103"/>
			<name>Apache License Version 2.0</name>
		<ipzilla bug_id="1234"/>
			<name>Apache License Version 2.1</name>

Back to the top