desktop/test/deployment/dependencies/readme.txt

   1 #*************************************************************************
   2 #
   3 # DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   4 #
   5 # Copyright 2008 by Sun Microsystems, Inc.
   6 #
   7 # OpenOffice.org - a multi-platform office productivity suite
   8 #
   9 # $RCSfile: readme.txt,v $
  10 #
  11 # $Revision: 1.7.134.1 $
  12 #
  13 # This file is part of OpenOffice.org.
  14 #
  15 # OpenOffice.org is free software: you can redistribute it and/or modify
  16 # it under the terms of the GNU Lesser General Public License version 3
  17 # only, as published by the Free Software Foundation.
  18 #
  19 # OpenOffice.org is distributed in the hope that it will be useful,
  20 # but WITHOUT ANY WARRANTY; without even the implied warranty of
  21 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  22 # GNU Lesser General Public License version 3 for more details
  23 # (a copy is included in the LICENSE file that accompanied this code).
  24 #
  25 # You should have received a copy of the GNU Lesser General Public License
  26 # version 3 along with OpenOffice.org.  If not, see
  27 # <http://www.openoffice.org/license.html>
  28 # for a copy of the LGPLv3 License.
  29 #
  30 #*************************************************************************
  31
  32 no-description.oxt, no-dependencies.oxt, empty-dependencies.oxt effectively have
  33 no dependencies and should thus install successfully.
  34
  35 broken-dependencies.oxt contains a malformed description.xml and should thus
  36 display an error and not install.
  37
  38 double-dependencies.oxt contains a description.xml with two dependencies
  39 elements.  This is not allowed by the spec but behaviour is unspecified.  In the
  40 current implementation, it combines the two elements, and thus finds two
  41 unsatisfied dependencies, displays the Unsatisfied Dependencies dialog and does
  42 not install.
  43
  44 version21.oxt contains a dependency on OOo 2.1 (and should thus only install in
  45 OOo 2.1 or later); version21ns.oxt is the same, but with a different way of
  46 using XML namespaces; version21other.oxt additionally contains an unsatisfied
  47 dependency (and should thus not install in any OOo version).  version22.oxt
  48 contains a dependency on OOo 2.2 (and should thus only install in OOo 2.2 or
  49 later).  version23.oxt contains a dependency on OOo 2.3 (and should thus only
  50 install in OOo 2.3 or later).  version10000.oxt contains a dependency on the
  51 hypothetical OOo version 10000 (and should thus not install in any OOo version).
  52 versionempty.oxt contains an empty value attribute and versionnone.oxt lacks the
  53 value attribute; neither is allowed by the spec, but the current implementation
  54 treats both as pre OOo 2.1 versions (and the extensions should thus install in
  55 OOo 2.1 or later).
  56
  57 maxversion30.oxt contains a maximal version dependency on OOo 3.0 (and should
  58 thus only install in OOo 3.0 or earlier, back to OOo 2.3, thanks to the
  59 additionally specified OpenOffice.org-minimal-version attribute).
  60 maxversion10000.oxt contains a maximal version dependency on the hypothetical
  61 OOo version 10000 (and should thus install in any OOo version 3.1 or later;
  62 OpenOffice.org-maximal-version was introduced in OOo 3.1, and no OpenOffice.org-
  63 minimal-version attribute is specified).  bad-minmaxversion.oxt contains a
  64 minimal version dependency on OOo 3.2 and a maximal version dependency on
  65 OOo 3.1 (and should thus not install in any OOo version).
  66
  67 minattr22.oxt contains a (hypothetical, most probably never satisfied)
  68 UNSATISFIED dependency with an OpenOffice.org-minimal-version attribute of
  69 "2.2" (and should thus install in OOo 2.3 or later); minattr23.oxt is similar,
  70 but with an OpenOffice.org-minimal-version attribute of "2.3" (and should thus
  71 also install in OOo 2.3 or later); minattr24.oxt is similar, but with an
  72 OpenOffice.org-minimal-version attribute of "2.4" (and should thus only install
  73 in OOo 2.4 or later).
  74
  75 All of the following testcases should result in the Unsatisfied Dependencies
  76 dialog being displayed and the extension not being installed:
  77
  78 unknown-dependency.oxt contains a dependency without a name attribute, and
  79 should thus display "Unknown" (localized).
  80
  81 funny-dependency.oxt, many-dependencies.oxt contain somewhat extreme input.
  82
  83 license-dependency.oxt contains both a license to be accepted by the user and
  84 dependencies.  What is important here is that the Unsatisfied Dependencies
  85 dialog is displayed, but not the license (as installation aborts as soon as
  86 unsatisfied dependencies are found).