diff --git a/MANIFEST.MF b/MANIFEST.MF new file mode 100644 index 0000000000000000000000000000000000000000..4044607e06904956dc0314b7deb13260350eba6a --- /dev/null +++ b/MANIFEST.MF @@ -0,0 +1,11 @@ +Manifest-Version: 1.0 +Ant-Version: Apache Ant 1.10.4 +Created-By: 11.0.2+9-LTS (Oracle Corporation) +Built-By: open-dis-7-java +Specification-Title: DIS 7 Class Library +Specification-Version: 7.0 +Specification-Vendor: Naval Postgraduate School +Implementation-Title: edu.nps.moves.dis7 +Implementation-Version: build01 +Implementation-Vendor: Naval Postgraduate School + diff --git a/README.md b/README.md index fe3493b9e73de39075ee0901c3822916e0248ff9..c53f2aaca45282ad784ca05ebc2176ee44bcd75f 100644 --- a/README.md +++ b/README.md @@ -2,3 +2,40 @@ Type-safe java implementation of the DIS Protocol v. 7, IEE 1278.1-2012 **IMPORTANT!** This project is not complete and is in a testing phase. Until this notice is removed, use the DIS libraries under the **open-dis-java** and **Enumerations** projects. + +<H2>Building the release</H2> +This source is organized as a Netbeans Ant project. It includes the necessary support files required by Netbeans, specifically, the `netbproject` directory and `build.xml`. + +After downloading or cloning the project from the Git repository, a simple `Run->Build Project` from the Netbeans menu should compile the source, as well as produce `open-dis7-java.jar` in then `dist` directory. + +The other two artifacts of the build are produced by running two special targets in `build.xml`. Run each target by right-clicking `build.xml`, then selecting `Run Target->Other Targets->targetname`. The two targets to run, in no particular order are `jar-javadoc` and `jar-source`. + +The completed build should produce the following files in the `dist` directory: + +1. `open-dis7-java.jar` +2. `open-dis7-javadoc.jar` +3. `open-dis7-source.jar` + +<H2>DIS Entities</H2> +The SISO specification, which is the foundation for much of the DIS library, enumerates values for a myriad of entity types, which are each descendant from the DIS class, `edu.nps.moves.dis7.EntityType`. Instances of this class are used in several DIS pdus, most notably `edu.nps.moves.dis7.EntityStatePdu`. The entities described by SISO are hierarchically organized by country, kind, domain, category, subcategory and extra values. They cover vehicles, munitions, radios, and sensors, and include entities from air, surface, subsurface, land and space domains. + +Not all entities are of value to specific DIS applications. Since the number of classes is large, the spectrum of SISO entities has been partitioned into the following jars, contained in the `entityjars` directory: + +1. `open-dis7-entities-usa-air.jar` +2. `open-dis7-entities-usa-land.jar` +3. `open-dis7-entities-usa-munitions.jar` +4. `open-dis7-entities-usa-surface.jar` +5. `open-dis7-entities-usa-all.jar` +6. `open-dis7-entities-chn.jar` +7. `open-dis7-entities-deu.jar` +8. `open-dis7-entities-nato.jar` +9. `open-dis7-entities-rus.jar` +10. `open-dis7-entities-all.jar` + +Jar number 10 includes all entities from all countrys. + +`open-dis7-entities-javadoc.jar` is javadoc describing all entities from all countries. + + + + diff --git a/build.xml b/build.xml index 35c6b420c81efbf8623678a935ca158be0e95229..f8dc126cb5c3721b41c10ac19dbd0da6d8c76891 100644 --- a/build.xml +++ b/build.xml @@ -70,7 +70,8 @@ nbproject/build-impl.xml file. --> - <target name="jar-javadoc"> + <target name="jar-javadoc" depends="javadoc"> + <mkdir dir="${basedir}/dist/javadoc"/> <jar destfile="${basedir}/dist/open-dis7-javadoc.jar" basedir="${basedir}/dist/javadoc"> <manifest> <attribute name="Built-By" value="open-dis-7-java"/> diff --git a/entityjars/open-dis7.jar b/entityjars/open-dis7.jar deleted file mode 100644 index da15cd8ae761b7215b4353e4f883910ec01cad5a..0000000000000000000000000000000000000000 Binary files a/entityjars/open-dis7.jar and /dev/null differ diff --git a/nbproject/project.properties b/nbproject/project.properties index 6f646697f0dd344bee4e6731936bbd034a9aed6c..bc859a656348154c53852685c0ebca3385cefb90 100644 --- a/nbproject/project.properties +++ b/nbproject/project.properties @@ -102,3 +102,4 @@ source.encoding=UTF-8 src.dir=src src.src-generated.dir=src-generated test.src.dir=test +manifest.file=MANIFEST.MF