]> git.donarmstrong.com Git - debian/debian-policy.git/commitdiff
Disambiguate "installed" and "present" for package states
authorRuss Allbery <rra@debian.org>
Mon, 2 Feb 2009 05:16:05 +0000 (21:16 -0800)
committerRuss Allbery <rra@debian.org>
Mon, 2 Feb 2009 05:16:05 +0000 (21:16 -0800)
Replace some "installed" and "present" descriptions of packages with
"unpacked" to more clearly distinguish between the unpacked and
configured states and be more consistent with the verbs used on the
dpkg command line.

Wording from Colin Watson.  Closes #504880.

policy.sgml

index 9b9ee4c22e4ebf6b9dd7421df0e830b53cb7a9e5..f5c6818dd5a741403186c580b4c0ec6807358786 100644 (file)
        </p>
 
        <p>
-         Sometimes, a package requires another package to be installed
-         <em>and</em> configured before it can be installed. In this
+         Sometimes, a package requires another package to be unpacked
+         <em>and</em> configured before it can be unpacked. In this
          case, you must specify a <tt>Pre-Depends</tt> entry for
          the package.
        </p>
@@ -3462,7 +3462,7 @@ Package: libc6
 
        <p>
          Broadly speaking the <prgn>preinst</prgn> is called before
-         (a particular version of) a package is installed, and the
+         (a particular version of) a package is unpacked, and the
          <prgn>postinst</prgn> afterwards; the <prgn>prerm</prgn>
          before (a version of) a package is removed and the
          <prgn>postrm</prgn> afterwards.
@@ -3841,7 +3841,7 @@ Package: libc6
                behavior which, though deterministic, is hard for the
                system administrator to understand.  It can easily
                lead to "missing" programs if, for example, a package
-               is installed which overwrites a file from another
+               is unpacked which overwrites a file from another
                package, and is then removed again.<footnote>
                    Part of the problem is due to what is arguably a
                    bug in <prgn>dpkg</prgn>.
@@ -3977,7 +3977,7 @@ Package: libc6
                If there was a conflicting package we go and do the
                removal actions (described below), starting with the
                removal of the conflicting package's files (any that
-               are also in the package being installed have already
+               are also in the package being unpacked have already
                been removed from the conflicting package's file list,
                and so do not get removed now).
            </item>
@@ -4285,8 +4285,8 @@ Build-Depends: foo [!i386] | bar [!amd64]
           removal order honoring the dependency order can't be
           established, dependency loops are broken at some point
           (based on rules below), and some packages may not be able to
-          rely on their dependencies being present when being
-          installed or removed, depending on which side of the break
+          rely on their dependencies being unpacked when being
+          unpacked or removed, depending on which side of the break
           of the circular dependency loop they happen to be on.  If one
           of the packages in the loop has no postinst script, then the
           cycle will be broken at that package, so as to ensure that
@@ -4435,7 +4435,7 @@ Build-Depends: foo [!i386] | bar [!amd64]
        <p>
          When one binary package declares that it breaks another,
          <prgn>dpkg</prgn> will refuse to allow the package which
-         declares <tt>Breaks</tt> be installed unless the broken
+         declares <tt>Breaks</tt> be unpacked unless the broken
          package is deconfigured first, and it will refuse to
          allow the broken package to be reconfigured.
        </p>
@@ -4476,13 +4476,13 @@ Build-Depends: foo [!i386] | bar [!amd64]
        <p>
           When one binary package declares a conflict with another
          using a <tt>Conflicts</tt> field, <prgn>dpkg</prgn> will
-         refuse to allow them to be installed on the system at the
+         refuse to allow them to be unpacked on the system at the
          same time.
        </p>
 
        <p>
-         If one package is to be installed, the other must be removed
-         first - if the package being installed is marked as
+         If one package is to be unpacked, the other must be removed
+         first - if the package being unpacked is marked as
          replacing (see <ref id="replaces">) the one on the system,
          or the one on the system is marked as deselected, or both
          packages are marked <tt>Essential</tt>, then
@@ -4677,7 +4677,7 @@ Provides: mail-transport-agent
 Conflicts: mail-transport-agent
 Replaces: mail-transport-agent
            </example>
-           ensuring that only one MTA can be installed at any one
+           ensuring that only one MTA can be unpacked at any one
            time.
        </sect1>
       </sect>
@@ -4909,7 +4909,7 @@ Replaces: mail-transport-agent
          <footnote>
            <p>
              During install or upgrade, the preinst is called before
-             the new files are installed, so calling "ldconfig" is
+             the new files are unpacked, so calling "ldconfig" is
              pointless.  The preinst of an existing package can also be
              called if an upgrade fails.  However, this happens during
              the critical time when a shared libs may exist on-disk
@@ -5045,7 +5045,7 @@ Replaces: mail-transport-agent
        <ref id="conflicts">) to ensure that the user only installs one
        development version at a time (as different development versions are
        likely to have the same header files in them, which would cause a
-       filename clash if both were installed).
+       filename clash if both were unpacked).
       </p>
 
       <p>
@@ -9305,7 +9305,7 @@ install-info --quiet --remove /usr/share/info/foobar.info
        <p>
          The <prgn>DEBIAN</prgn> directory will not appear in the
          file system archive of the package, and so won't be installed
-         by <prgn>dpkg</prgn> when the package is installed.
+         by <prgn>dpkg</prgn> when the package is unpacked.
        </p>
 
        <p>