From 0a96c7741937a09f1ec8d410c81cf8cee4588b51 Mon Sep 17 00:00:00 2001 From: Stijn Buys Date: Tue, 19 Oct 2010 15:12:28 +0000 Subject: documentation updates --- doc/STORYLINE | 7 +- doc/TASKS | 15 ++ doc/attributions.html | 555 +++++++++++++++++++++++++++++++------------------- doc/installation.html | 117 ++++++----- 4 files changed, 438 insertions(+), 256 deletions(-) (limited to 'doc') diff --git a/doc/STORYLINE b/doc/STORYLINE index 1006650..b95602b 100644 --- a/doc/STORYLINE +++ b/doc/STORYLINE @@ -22,7 +22,7 @@ Great Houses - House Lindblade - - House Illia + - House Praetoria - Council Protectorate Tsu-Khan Empire @@ -45,6 +45,11 @@ - Dover system + HOUSE PRAETORIA (protected by the Praetorian Guard) + + - Praetoria system + planet Praetoria + PROTECTORATE (protected by the Ordinators) The seat of the Council and the capital of the central planets. diff --git a/doc/TASKS b/doc/TASKS index f6524ba..adbc508 100644 --- a/doc/TASKS +++ b/doc/TASKS @@ -33,4 +33,19 @@ Ship definitions Cargo definitions + Add cargo definitions to ini/cargo.ini. + Trade definitions + + Add trade definitions to the world ini files. + +Documentation + + The list of attributions needs updating + + Most of the documentation needs updating: + doc/attribution.html List of attributions + doc/guide.html Player guide + doc/manual.html Engine user manual + doc/world.html Editing the world + diff --git a/doc/attributions.html b/doc/attributions.html index aa39211..58f2777 100644 --- a/doc/attributions.html +++ b/doc/attributions.html @@ -18,278 +18,419 @@ The game data is distributed under the terms and conditions of the Create Commons Attribution-Share Alike 3.0 License.

+

+ Files by NASA are in the + public domain. +

Files by nathanshadow are distributed under the terms of the Creative Commons Sampling Plus 1.0 license.

-

- Files by NASA are in the - public domain. -

-
- Contributions +
+ List of data files
+

- These files were contributed to the project: + A list of game data files in the data/base directory, + with their original author and/or source.

-

+

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + - - - - - - - - - - - - - - - - - - - - - - - - -
directoryfile - contributor
/base/maps/shipsavatar.map - supertanker -
/base/maps/shipsbomber.map - Odin -
/base/maps/shipsbumblebee.map - supertanker -
/base/maps/shipscarrier.map - Odin -
/base/maps/shipsdestroyer.map - Odin -
/base/maps/shipsfreighter.map - Odin -
/base/maps/shipshalcyon.map - supertanker -
/base/maps/shipsheavycruiser.map - Odin
-
/base/maps/shipshorizon.map - Thorn
-
/base/maps/shipsinterceptor.map - Odin
-
/base/maps/shipsscout.map - Odin
-
/base/maps/shipssharkan.map - Thorn
-
/base/maps/shipssupertanker.map - supertanker
-
/base/maps/stationsstation15.map - supertanker
-
/base/maps/stationscivilian_housing.map - Odin
-
/base/maps/stationslindblade_central.map - supertanker
-
/base/maps/stationstsukhan_central.map - Odin
-
/base/textures/envsky12.tga - Thorn -
/base/textures/envsky17.tga - Thorn -
/base/textures/envsky20.tga - Thorn -
/base/textures/envsky21.tga - Thorn -
/base/textures/envsky31.tga - Thorn -
-
+ Directory + File(s) + Original author + + + maps/cargo + crate.map + Ingar + + + maps/cargo + pod.map + Ingar + + + maps/colonial + alexandria.map + Ingar + + + maps/colonial + alexandria_storage.map + Ingar + + + maps/colonial + cantor.map + Ingar + + + maps/colonial + custodian.map + Ingar + + + maps/colonial + helianthos.map + Ingar + + + maps/colonial + ikarus.map + Ingar + + + maps/colonial + jumpgate.map + Ingar + + + maps/colonial + regula.map + Ingar + + + maps/colonial + regula_storage.map + Ingar + + + maps/colonial + sharkan.map + Ingar + + + maps/derelict + ares.map + Odin + + + maps/derelict + hades.map + Odin + + + maps/independent + avenger.map + Odin + + + maps/independent + betelgeuse.map + Odin + + + maps/independent + bumblebee.map + Supertanker + + + maps/independent + ensor.map + Ingar + + + maps/independent + galaxy.map + Odin + + + maps/independent + horizon.map + Thorn + + + maps/independent + jupiter.map + Odin + + + maps/independent + orion.map + (?) + + + maps/independent + researchstation.map + Odin + + + maps/independent + shootingstar.map + Odin + + + maps/lindblade + avatar.map + Supertanker + + + maps/lindblade + halcyon.map + Supertanker + + + maps/lindblade + lindblade_central.map + Supertanker + + + maps/lindblade + lindblade_dock.map + Supertanker + + + maps/lindblade + powersat.map + Supertanker + + + maps/lindblade + station15.map + Supertanker + + + maps/lindblade + supertanker.map + Supertanker + + + maps/mercenary + archer.map + Odin + + + maps/mercenary + enforcer.map + Odin + + + maps/mercenary + longbow.map + Odin + + + maps/mercenary + pod.map + Ingar + + + maps/mercenary + talon.map + Odin + + + maps/merchant + matrix.map + Ingar + + + maps/merchant + scalar.map + Odin + + + maps/merchant + vector.map + Ingar + + + maps/miners + cruiser.map + Odin + + + maps/pirate + juggernaut.map + Odin + + + maps/pirate + jumpgate.map + Odin + + + maps/pirate + raider.map + Odin + + + maps/race + checkpoint.map + Ingar + + + maps/static + cannon001.map + + + + maps/static + cannon002.map + + + + maps/static + cargopod001.map + + + + maps/static + navpoint.map + Odin + + + maps/static + turret001.map + + + + maps/static + turret002.map + + + + maps/tsukhan + camel.map + Odin + + + maps/tsukhan + civilian_housing.map + Odin + + + maps/tsukhan + civilian_starscraper.map + Odin + + + maps/tsukhan + colosus.map + Odin + + + maps/tsukhan + imp.map + Odin + + + maps/tsukhan + inquisitor.map + Odin + + + maps/tsukhan + obliterator.map + Odin + + + maps/tsukhan + panzer.map + Odin + + + maps/tsukhan + ravager.map + Odin + + + maps/tsukhan + tsukhan_central.map + Odin + + + maps/tsukhan + warbringer.map + Odin + -

- -
+ -
- Derived works -
-
-

- These files are available on the internet or are based on freely available works: -

-

-

- + + - - - - - + - + - + + + + - - + + - - + + - - + + - - + + - - + + - - + +
directoryfile - source
/base/sounds/enginessounds/engines loop00.wav nathanshadow
/base/sounds/enginessounds/engines loop01.wav nathanshadow
/base/sounds/enginessounds/engines loop02.wav nathanshadow
/base/textures/envsky.tgatextures/kurotoall files - The Tycho Catalog Skymap
- NASA/Goddard Space Flight Center Scientific Visualization Studio + Robert Kuroto
+ (released under CC-BY-SA-3.0 with permission)
/base/textures/planetsghant.tgatextures/planetsghant.png JPL Solar System Simulator (Phobos)
NASA/JPL-Caltech
/base/textures/planetslindblade.tgatextures/planetslindblade.png JPL Solar System Simulator (Saturn)
NASA/JPL-Caltech
/base/textures/planetsseymour.tgatextures/planetsseymour.png JPL Solar System Simulator (Venus)
NASA/JPL-Caltech
/base/textures/planetsbrogha.tgatextures/planetsbrogha.png Chance Ragen (Orion's Paradise)
- from the GalaxyStar project (with permission) + from the GalaxyStar project + (released under CC-BY-SA-3.0 with permission)
/base/textures/kurotoall filestextures/planetsfinnmark.png - Robert Kuroto
- (with permission) + Jeremy "Jestr" Gardner (Sedna)
+ from the Celestia Motherlode + (released under CC-BY-SA-3.0 with permission)
diff --git a/doc/installation.html b/doc/installation.html index 838c754..8631686 100644 --- a/doc/installation.html +++ b/doc/installation.html @@ -55,10 +55,13 @@

- Download the windows package:
- osirion-win32-latest.zip (32 bit)
- osirion-win64-latest.zip (64 bit)
- This package contains the win32 version of the server and the client. + Download for 32-bit windows
+ osirion-win32-latest.zip (32-bit)
+ This package should work on most windows systems. +

+ Download for 64-bit windows
+ osirion-win64-latest.zip (64-bit)
+

Dowload the game data package:
osirion-data-latest.zip
@@ -78,9 +81,9 @@

- Download the linux packages:
- osirion-linux-latest.zip(32 and 64 bit)
- This package contains the linux 32 and 64 bit versions of the client and the server. + Linux download:
+ osirion-linux-latest.zip(32- and 64-bit)
+ This package contains the linux version of the client and the server.

Extract the package, a new subdirectory will be created. The actual directory name will depend on the version number. Enter the new subdirectory. @@ -128,6 +131,7 @@ unzip ../osirion-data-latest.zip To build the client or the dedicated server:

@@ -135,10 +139,10 @@ unzip ../osirion-data-latest.zip

@@ -149,60 +153,63 @@ unzip ../osirion-data-latest.zip

- Obtaining the source code + Building the Bullet physics library
+

- You can get the osirion project source code from the subversion repository:
- svn://intranifty.no-ip.org/osirion + The engine uses the Bullet Physics Library + for physics support. You can download the bullet source code here: +

- On linux, you can use the Subversion command line client tool. The following - command will create a new subdirectory osirion and download the source code into it. + To download and install the library:

-svn co svn://intranifty.no-ip.org/osirion osirion +wget http://bullet.googlecode.com/files/bullet-2.77.tgz
+tar zxvf bullet-2.77.tgz
+cd bullet-2.77
+./autogen.sh
+./configure --prefix=/usr/local
+make
+sudo make install
-

- On windows, you can use the Turtoisesvn SubVersion client to access the - SVN repositories. You can download it here:
- http://tortoisesvn.tigris.org -

-

- You can also download the source package from the website:
- osirion-src-latest.tar.bz2 -

- +
Compiling the source code
@@ -219,6 +226,16 @@ autoreconf -fi
If you do not need the client and want to build the dedicated server only you can pass the --without-client option to configure:

+

+ Configure will automaticly detect the bullet library if itwass installed in /usr/local. + If it was installed somewhere else you will have to pass the --with-bullet=directory option + to configure. +

+

+ For example, if you want to use the system-provided package on Arch linux, use + --with-bullet=/usr. +

+
./configure --without-client
@@ -247,8 +264,10 @@ make

The game data should be located in the data subdirectory of the main distribution. - You can use the game data package from the website or get it from the osirion-data subversion repository:
- svn://intranifty.no-ip.org/osirion-data + You can use the game data package from the website or get it from the osirion-data subversion repository: +

Run the following command from within the main distribution directory to download @@ -329,8 +348,10 @@ make

You can skip this section if you do not intent to create to create models with netradiant or gtkradiant 1.5. Note that these files probably won't work with other versions. You can find precompiled - netradiant packages here:
- http://ingar.satgnu.net/gtkradiant + netradiant packages here: +

These instructions assume gtkradiant is installed in the directory /usr/local/games/netradiant. If it is installed in a different @@ -415,8 +436,8 @@ Organization of the distribution /bitmaps essential bitmaps /ini game world description files /maps 3D models (.map format) + /materials material definitions /models 3D models (ase and other formats) - /scripts radiant compatible shader files /textures game world textures /gtkradiant radiant support files -- cgit v1.2.3