diff --git a/doc/app.html b/doc/app.html index 8e62e18fbb..13f69fc821 100644 --- a/doc/app.html +++ b/doc/app.html @@ -2,53 +2,58 @@ "http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd"> - Platforms, Applications, and Versions - + Platforms, Applications, and Versions +

Platforms, Applications, and Versions

- A platform is a compilation target (Windows/Intel, -Linux/Intel, MacOS/PPC, etc.). Platforms are maintained in the -platform table in the BOINC DB, and can be created using the add utility program. -

+ A platform is a compilation target (Windows/Intel, +Linux/Intel, MacOS/PPC, etc.). +Platforms are maintained in the platform table in the BOINC +DB, and can be created using the add +utility program. +

- An application is a computational task; in concrete terms it + An application is a computational task; in concrete terms it consists of an executable program (perhaps in versions for various -platforms) and a set of input files to be processed by the program. A -project can operate many applications. Applications are maintained in -the application table in the BOINC DB, and can be created using -the add utility. -

+platforms) and a set of input files to be processed by the program. +A project can operate many applications. +Applications are maintained in the application table in the +BOINC DB, and can be created using the add +utility. +

- An application program may go through a sequence of versions. A particular version, compiled for a -particular platform, is called an application version. An -application version can consist of multiple files: for example, a + An application program may go through a sequence of versions. +A particular version, compiled for a particular platform, is +called an application version. +An application version can consist of multiple files: for example, a controller script, pre- and post-processing programs, and a primary. -

+

- Each application version has an integer version number. + Each application version has an integer version number. Projects can assign version numbers however they like; for example, -version 304 might represent major version 3 and minor version 4. Version -numbers should be used consistently across platforms; Windows version -304 should be computationally identical to Mac version 304. -

+version 304 might represent major version 3 and minor version 4. +Version numbers should be used consistently across platforms; +Windows version 304 should be computationally identical to +Mac version 304. +

- Each application has a minimum version. When a client is sent -work for an application, it is also sent the latest application version -for its platform. It is sent work only if this version is the minimum or -greater. -

+ Each application has a minimum version. +When a client is sent work for an application, it is also sent +the latest application version for its platform. +It is sent work only if this version is the minimum or greater. +

- Application version are maintained in the app_version table + Application version are maintained in the app_version table in the BOINC DB, Each entry includes an XML document describing the files that make up the application version: -

-<file_info> ... </file_info>
-[ ... ]
+<file_info> ... 
+</file_info>
+[ ... 
+]
 <app_version>
     <app_name>foobar</app_name>
     <version_num>4</version_num>
@@ -62,5 +67,6 @@ files that make up the application version:
 </app_version>
The add utility program provides a simplified interface for creating application versions. +