Index: openacs-4/packages/acs-core-docs/www/xml/kernel/apm-requirements.xml =================================================================== RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/xml/kernel/apm-requirements.xml,v diff -u -r1.7 -r1.8 --- openacs-4/packages/acs-core-docs/www/xml/kernel/apm-requirements.xml 11 Dec 2003 21:39:49 -0000 1.7 +++ openacs-4/packages/acs-core-docs/www/xml/kernel/apm-requirements.xml 17 Jul 2006 05:38:38 -0000 1.8 @@ -1,6 +1,6 @@ - %myvars; ]> @@ -677,13 +677,13 @@ status of a package, or all packages, with a single click. -4.200.0 Compound Package Construction +4.400.0 Compound Package Construction -4.200.1 The developer can include .APM packages +4.400.1 The developer can include .APM packages (sub-packages) within a package (the compound package) like any other file. -4.200.5 The recommended usage for this feature is to +4.400.5 The recommended usage for this feature is to allow for separation of optional and required components from the installation as well as better organization of files once installed. For example, all documentation for the community-core can be packages as @@ -692,7 +692,7 @@ but this is discouraged. In such a case, the sub-package should really be a separate package that is required by the compound package. -4.200.10 If a sub-package is required for the +4.400.10 If a sub-package is required for the installation of the compound package, the compound package should have a registered dependency on the sub-package. @@ -730,7 +730,7 @@ and then optionally removes the .APM file just downloaded. 90.10.1 If .APM files are present in a package, then it -is considered a compound package (use 4.210.0). +is considered a compound package (use 4.410.0). 90.15.0 Installation requires these steps: @@ -755,53 +755,53 @@ -4.210.0 Compound package Install +4.410.0 Compound package Install -4.210.1 If .APM files are present in a package, then it +4.410.1 If .APM files are present in a package, then it is considered a compound package. -4.210.5.0 Installation of a compound package proceeds +4.410.5.0 Installation of a compound package proceeds according to the following sequence: -4.210.5.1 Identify the set of all sub-packages within +4.410.5.1 Identify the set of all sub-packages within the compound package by scanning for all files with .APM. -4.210.5.2 Identify which sub-packages are required by +4.410.5.2 Identify which sub-packages are required by checking the dependencies of the compound package. If there dependencies not satisfied by the current system or the packages included with the compound package, halt installation and inform user to install these packages first. -4.210.5.3 Present Administrator with the ability to +4.410.5.3 Present Administrator with the ability to choose which sub-packages to install. Required sub-packages must be installed. -4.210.5.4 Proceed with the installation of each +4.410.5.4 Proceed with the installation of each sub-package, starting with required packages. If the sub-package is already installed, then do nothing. Else, If the sub-package is a normal package, proceed according to 90.15.0, otherwise if it is a compound -package, proceed according to 4.210.5.0. +package, proceed according to 4.410.5.0. -4.210.5.5 If all required sub-packages are installed, +4.410.5.5 If all required sub-packages are installed, proceed to install non-required sub-packages. If there was a failure during the installation of a required sub-package, then the installation of the compound package is also a failure. -4.210.5.6 Any attempt to install a compound package in +4.410.5.6 Any attempt to install a compound package in the future involves a choice presented to the admin of installing any uninstalled sub-packages. -4.220.0 Recovering from failed package installation +4.420.0 Recovering from failed package installation -4.220.1 If any error is generated during package +4.420.1 If any error is generated during package installation, the package is not considered installed. To recover from this failure, the package should be selected for installation again.