diff options
author | Kurt Zenker <kz@openoffice.org> | 2006-10-04 15:57:17 +0000 |
---|---|---|
committer | Kurt Zenker <kz@openoffice.org> | 2006-10-04 15:57:17 +0000 |
commit | 275972318d289bad2b1b68433b1b8a2598e9e536 (patch) | |
tree | 8ec8001da60fefc90e2ed282e31cdcc87f52e11e /desktop/test/deployment/version/readme.txt | |
parent | bf67bc97960298c3fbeed13a8de1df317dad7fb9 (diff) |
INTEGRATION: CWS sb62 (1.1.2); FILE ADDED
2006/09/27 11:54:53 sb 1.1.2.1: #i69163# Added rudimentary extension version handling.
Diffstat (limited to 'desktop/test/deployment/version/readme.txt')
-rw-r--r-- | desktop/test/deployment/version/readme.txt | 99 |
1 files changed, 99 insertions, 0 deletions
diff --git a/desktop/test/deployment/version/readme.txt b/desktop/test/deployment/version/readme.txt new file mode 100644 index 000000000000..f2a25ef9ff0c --- /dev/null +++ b/desktop/test/deployment/version/readme.txt @@ -0,0 +1,99 @@ +/************************************************************************* + * + * OpenOffice.org - a multi-platform office productivity suite + * + * $RCSfile: readme.txt,v $ + * + * $Revision: 1.2 $ + * + * last change: $Author: kz $ $Date: 2006-10-04 16:57:17 $ + * + * The Contents of this file are made available subject to + * the terms of GNU Lesser General Public License Version 2.1. + * + * + * GNU Lesser General Public License Version 2.1 + * ============================================= + * Copyright 2006 by Sun Microsystems, Inc. + * 901 San Antonio Road, Palo Alto, CA 94303, USA + * + * This library is free software; you can redistribute it and/or + * modify it under the terms of the GNU Lesser General Public + * License version 2.1, as published by the Free Software Foundation. + * + * This library is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + * Lesser General Public License for more details. + * + * You should have received a copy of the GNU Lesser General Public + * License along with this library; if not, write to the Free Software + * Foundation, Inc., 59 Temple Place, Suite 330, Boston, + * MA 02111-1307 USA + * + ************************************************************************/ + +There are three extensions in various versions: + +1 version_XXX/plain.oxt has no dependencies and no license. +2a version_XXX/dependency.oxt has an unsatisfied dependency and no license. +2b version_nodependencies_XXX/dependency.oxt is identical to 2a but without the + dependency. +3 version_XXX/license.oxt has no dependencies and a license. + +The different versions are: + +A version_none contains no version element (treated as version "0"). +B version_badelement contains a bad <version val="1"/> (not allowed by the + specification, but treated by the current implementation as version "0"). +C version_badvalue contains a bad <version val="1.a"/> (not allowed by the + specification, but treated by the current implementation as version "1"). +D version_0.0 contains <version value="0.0"/> (same as version "0"). +E version_1.2.3 contains <version value="1.2.3"/>. +F version_1.2.4.7 contains <version value="1.2.4.7"/>. +G version_1.02.4.7.0 contains <version value="1.02.4.7.0"/> (same as version + "1.2.4.7"). +H version_1.2.15.3 contains <version value="1.2.15.3"/>. + +The total order among the various versions is thus + + A = B = D < C < E < F = G < H. + +Things to watch for: + +- If version y of extension e is to be installed and version x < y of + extension e is already installed, then + unopkg add e + and + pkgchk e + will replace x with y. + +- If version y of extension e is to be installed and version x >= y of + extension e is already installed, then + unopkg add e + and + pkgchk e + will fail with an error message. + +- If version y of extension e is to be installed and any version x of + extension e is already installed, then + unopkg add -f e + and + pkgchk -f e + will replace x with y. + +- If version y of extension e is to be installed and any version x of + extension e is already installed, then + unopkg gui "Add..." + and + soffice "Tools - Package Manager... - Add..." + will query with a dialog whether to replace x with y. The dialog will have + "OK" (replace) preselected if x < y, and "Cancel" otherwise. + +- If replacing an installed version x of an extension e with a version y fails + because y has unsatisfied dependencies, or because y has a license to wich the + user does not agree, version x is left installed afterwards. + +- Checking for already installed versions of an extension is only done within a + single layer (unopkg/pkgchk versus unopkg/pkgchk --shared; "My Packages" + versus "OpenOffice Packages" in unopkg gui/soffice), not across layers.
\ No newline at end of file |