Symbian3/PDK/Source/GUID-474A9F80-2B3E-5D11-8D2E-95E217BEB84A.dita
changeset 9 59758314f811
parent 5 f345bda72bc4
child 12 80ef3a206772
--- a/Symbian3/PDK/Source/GUID-474A9F80-2B3E-5D11-8D2E-95E217BEB84A.dita	Fri Jun 11 12:39:03 2010 +0100
+++ b/Symbian3/PDK/Source/GUID-474A9F80-2B3E-5D11-8D2E-95E217BEB84A.dita	Fri Jun 11 15:24:34 2010 +0100
@@ -1,53 +1,57 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
-<!-- This component and the accompanying materials are made available under the terms of the License 
-"Eclipse Public License v1.0" which accompanies this distribution, 
-and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
-<!-- Initial Contributors:
-    Nokia Corporation - initial contribution.
-Contributors: 
--->
-<!DOCTYPE concept
-  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
-<concept id="GUID-474A9F80-2B3E-5D11-8D2E-95E217BEB84A" xml:lang="en"><title>Preinstalled
-Package Upgrades</title><prolog><metadata><keywords/></metadata></prolog><conbody>
-<p>Packages that are preinstalled using InterpretSIS must follow certain rules
-while upgrading, as explained in the following sections: </p>
-<section><title>Standard upgrade rules</title> <p>InterpretSIS supports the
-following upgrade types: </p> <fig id="GUID-E97B0D4F-6B3A-5595-A0C2-B87C1457E80F">
-<image href="GUID-718E1B9F-C05D-559A-AF69-BD9CFAF190FB_d0e30458_href.png" placement="inline"/>
-</fig> <p>* The base SA and associated upgrades are removed ** The base SA
-is removed prior to the installation of the SA upgrade. </p> <p>InterpretSIS
-returns an error if the rules are violated during an upgrade. It supports
-variants of file names and usage of wildcards for Stub SIS files. </p> </section>
-<section><title>Non-removable package upgrade rules</title> <p>The following
-table summarises the rules that apply when performing patch upgrade, partial
-upgrade or replacement of <i>non-removable</i> packages installed using <codeph>InterpretSIS</codeph>.
-The general rule is that a removable package cannot be made non-removable,
-and a non-removable package cannot be made removable. </p> <fig id="GUID-20A6F1E5-45DC-5AC0-92F2-181A5AFB77F0">
-<image href="GUID-301CEDFA-6329-56BA-ADA6-8A89BA17E398_d0e30483_href.png" placement="inline"/>
-</fig> <p>* If the partial upgrade modifies files in the <codeph>SP</codeph>,
-the <codeph>PU(NR)</codeph> is modified when the <codeph>SP</codeph> is removed. </p> <p>**
-The original <codeph>PA</codeph> is removed, including the private directory,
-before upgrading. </p><p><b>Notes:</b></p><ul>
-<li><p><codeph>NR</codeph> upgrades are performed to the same drive as the
-original package. </p></li>
-<li><p><codeph>NR </codeph>upgrades or patches delivered on preinstalled media
-cards are rejected as invalid. Any invalid upgrade generates a <codeph>KErrInvalidUpgrade</codeph> error. </p></li>
-<li><p>Back-up and restore is not functional for preinstalled SIS files that
-are in the system drive. </p></li>
-<li><p>Preinstalled SIS files that are in the system drive can be uninstalled
-if <codeph>DeletePreinstalledFilesOnUninstall</codeph> is set in <filepath>swipolicy.ini</filepath> file.
-For details see, <xref href="GUID-F8C2E97C-35EC-5437-BC6B-E2A622D2DC4D.dita#GUID-F8C2E97C-35EC-5437-BC6B-E2A622D2DC4D/GUID-F8C2E97C-35EC-5437-BC6B-E2A622D2DC4D">Secure
-Software Install Reference</xref>. </p></li>
-</ul> </section>
-</conbody><related-links>
-<link href="GUID-8792CCC3-B70F-53FC-B394-B0069AF90349.dita"><linktext>InterpretSIS</linktext>
-</link>
-<link href="GUID-906165AD-D45D-54BB-8094-023F792F1632.dita"><linktext>Preinstalling
-Packages</linktext></link>
-<link href="GUID-7FD72D9F-D65E-5248-A296-F2196F1DF5CF.dita"><linktext>Upgrade Types</linktext>
-</link>
-<link href="GUID-F8A26275-883A-5299-9C37-9DDCC2F62108.dita"><linktext>Eclipsing</linktext>
-</link>
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
+<!-- This component and the accompanying materials are made available under the terms of the License 
+"Eclipse Public License v1.0" which accompanies this distribution, 
+and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
+<!-- Initial Contributors:
+    Nokia Corporation - initial contribution.
+Contributors: 
+-->
+<!DOCTYPE concept
+  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
+<concept id="GUID-474A9F80-2B3E-5D11-8D2E-95E217BEB84A" xml:lang="en"><title>Preinstalled
+Package Upgrades</title><prolog><metadata><keywords/></metadata></prolog><conbody>
+<p>Packages that are preinstalled using InterpretSIS must follow certain rules
+while upgrading, as explained in the following sections: </p>
+<section id="GUID-BCC49EB3-DE9A-4B34-8F6C-644D67663996"><title>Standard upgrade
+rules</title> <p>InterpretSIS supports the following upgrade types: </p> <fig id="GUID-E97B0D4F-6B3A-5595-A0C2-B87C1457E80F">
+<image href="GUID-718E1B9F-C05D-559A-AF69-BD9CFAF190FB_d0e24740_href.png" placement="inline"/>
+</fig> <p>* The base SA and associated upgrades are removed ** The base SA
+is removed prior to the installation of the SA upgrade. </p> <p>InterpretSIS
+returns an error if the rules are violated during an upgrade. It supports
+variants of file names and usage of wildcards for Stub SIS files. </p> </section>
+<section id="GUID-293CEBCE-78B3-4D3A-90F4-281AD905FE14"><title>Non-removable
+package upgrade rules</title> <p>The following table summarizes the rules
+that apply when performing patch upgrade, partial upgrade or replacement of <i>non-removable</i> packages
+installed using <codeph>InterpretSIS</codeph> with the <codeph>NR</codeph> option
+set (<codeph>+nonremovablepkg</codeph>). The general rule is that a removable
+package cannot be made non-removable, and a non-removable package cannot be
+made removable.</p> <fig id="GUID-20A6F1E5-45DC-5AC0-92F2-181A5AFB77F0">
+<image href="GUID-301CEDFA-6329-56BA-ADA6-8A89BA17E398_d0e24772_href.png" placement="inline"/>
+</fig> <p>** The original <codeph>PA</codeph> is removed, including the private
+directory, before upgrading. </p><p><b>Notes:</b></p><ul>
+<li><p>If the base package (SA) is removable then patch upgrade (SP) must
+also be removable.</p></li>
+<li><p>If base package (SA) is removable but partial upgrade (PU ) is non-removable
+then both base package and partial upgrades (SA+PU) are non-removable.</p></li>
+<li><p><codeph>NR</codeph> upgrades are performed to the same drive as the
+original package. </p></li>
+<li><p><codeph>NR </codeph>upgrades or patches delivered on preinstalled media
+cards are rejected as invalid. Any invalid upgrade generates a <codeph>KErrInvalidUpgrade</codeph> error. </p></li>
+<li><p>Back-up and restore is not functional for preinstalled SIS files that
+are in the system drive. </p></li>
+<li><p>Preinstalled SIS files that are in the system drive can be uninstalled
+if <codeph>DeletePreinstalledFilesOnUninstall</codeph> is set in <filepath>swipolicy.ini</filepath> file.
+For details see, <xref href="GUID-F8C2E97C-35EC-5437-BC6B-E2A622D2DC4D.dita#GUID-F8C2E97C-35EC-5437-BC6B-E2A622D2DC4D/GUID-F8C2E97C-35EC-5437-BC6B-E2A622D2DC4D">Secure
+Software Install Reference</xref>. </p></li>
+</ul> </section>
+</conbody><related-links>
+<link href="GUID-8792CCC3-B70F-53FC-B394-B0069AF90349.dita"><linktext>InterpretSIS</linktext>
+</link>
+<link href="GUID-906165AD-D45D-54BB-8094-023F792F1632.dita"><linktext>Preinstalling
+Packages</linktext></link>
+<link href="GUID-7FD72D9F-D65E-5248-A296-F2196F1DF5CF.dita"><linktext>Upgrade Types</linktext>
+</link>
+<link href="GUID-F8A26275-883A-5299-9C37-9DDCC2F62108.dita"><linktext>Eclipsing</linktext>
+</link>
 </related-links></concept>
\ No newline at end of file