From b43fe10e0265526c2138bd2a37e46e8f92ae3fd1 Mon Sep 17 00:00:00 2001 From: Simon McVittie Date: Fri, 11 Mar 2016 07:37:58 +0000 Subject: [PATCH] debian/control: improve description based on v2016.3's README --- debian/changelog | 1 + debian/control | 63 +++++++++++++++++++++++++----------------------- 2 files changed, 34 insertions(+), 30 deletions(-) diff --git a/debian/changelog b/debian/changelog index 1db4f23c..04f691f5 100644 --- a/debian/changelog +++ b/debian/changelog @@ -29,6 +29,7 @@ ostree (2016.1+deb-1) UNRELEASED; urgency=medium symlink in ostree-grub2 * Document the limited situations in which ostree-grub2 will work in practice + * debian/control: improve description based on v2016.3's README -- Simon McVittie Wed, 27 Jan 2016 13:04:34 +0100 diff --git a/debian/control b/debian/control index e20aced2..6794f7ad 100644 --- a/debian/control +++ b/debian/control @@ -39,13 +39,11 @@ Depends: ${gir:Depends}, ${misc:Depends}, Description: content-addressed filesystem for operating system binaries (introspection) - OSTree is a tool for managing bootable, immutable, versioned filesystem trees. - It is not a package system; nor is it a tool for managing full disk images. - Instead, it sits between those levels, offering a blend of the advantages (and - disadvantages) of both. + OSTree is a tool for managing bootable, immutable, versioned filesystem + trees. See the ostree package's description for more details. . - This package can be used by other packages using the GIRepository format to - generate dynamic bindings. + This package contains GObject-Introspection metadata, which can be used + to generate dynamic bindings into languages such as Python and JavaScript. Package: libostree-1-1 Architecture: any @@ -57,10 +55,14 @@ Pre-Depends: ${misc:Pre-Depends}, Multi-arch: same Description: content-addressed filesystem for operating system binaries (library) - OSTree is a tool for managing bootable, immutable, versioned filesystem trees. - It is not a package system; nor is it a tool for managing full disk images. - Instead, it sits between those levels, offering a blend of the advantages (and - disadvantages) of both. + OSTree is a tool and library for managing bootable, immutable, versioned + filesystem trees. It is like git in that it checksums individual files + and has a content-addressed object store; unlike git, it "checks out" + the files using hardlinks into an immutable directory tree. This + can be used to provide atomic upgrades with rollback, history and + parallel-installation, particularly useful on "fixed purpose" systems + such as embedded devices. It is also used by the xdg-app application + runtime system. . This package contains the shared library. @@ -76,10 +78,14 @@ Depends: Suggests: libostree-doc, Description: Development files for the ostree library - OSTree is a tool for managing bootable, immutable, versioned filesystem trees. - It is not a package system; nor is it a tool for managing full disk images. - Instead, it sits between those levels, offering a blend of the advantages (and - disadvantages) of both. + OSTree is a tool and library for managing bootable, immutable, versioned + filesystem trees. It is like git in that it checksums individual files + and has a content-addressed object store; unlike git, it "checks out" + the files using hardlinks into an immutable directory tree. This + can be used to provide atomic upgrades with rollback, history and + parallel-installation, particularly useful on "fixed purpose" systems + such as embedded devices. It is also used by the xdg-app application + runtime system. . This package contains development headers and the pkg-config file for ostree. @@ -91,10 +97,8 @@ Depends: Suggests: devhelp, Description: Development documentation for the ostree library - OSTree is a tool for managing bootable, immutable, versioned filesystem trees. - It is not a package system; nor is it a tool for managing full disk images. - Instead, it sits between those levels, offering a blend of the advantages (and - disadvantages) of both. + OSTree is a tool for managing bootable, immutable, versioned filesystem + trees. See the ostree package's description for more details. . This package contains development documentation for ostree. @@ -106,10 +110,13 @@ Depends: Suggests: dracut, Description: content-addressed filesystem for operating system binaries - OSTree is a tool for managing bootable, immutable, versioned filesystem trees. - It is not a package system; nor is it a tool for managing full disk images. - Instead, it sits between those levels, offering a blend of the advantages (and - disadvantages) of both. + OSTree is a tool and library for managing bootable, immutable, versioned + filesystem trees. It is like git in that it checksums individual files + and has a content-addressed object store; unlike git, it "checks out" + the files using hardlinks into an immutable directory tree. This + can be used to provide atomic upgrades with rollback, history and + parallel-installation, particularly useful on "fixed purpose" systems + such as embedded devices. . This package contains the executables. @@ -121,10 +128,8 @@ Depends: Recommends: grub-efi-amd64 | grub-pc, Description: GRUB 2 configuration for ostree - OSTree is a tool for managing bootable, immutable, versioned filesystem trees. - It is not a package system; nor is it a tool for managing full disk images. - Instead, it sits between those levels, offering a blend of the advantages (and - disadvantages) of both. + OSTree is a tool for managing bootable, immutable, versioned filesystem + trees. See the ostree package's description for more details. . This package contains configuration snippets for using ostree with GRUB 2. This integration currently has some limitations: @@ -150,9 +155,7 @@ Depends: ostree, python, Description: content-addressed filesystem for operating system binaries - tests - OSTree is a tool for managing bootable, immutable, versioned filesystem trees. - It is not a package system; nor is it a tool for managing full disk images. - Instead, it sits between those levels, offering a blend of the advantages (and - disadvantages) of both. + OSTree is a tool for managing bootable, immutable, versioned filesystem + trees. See the ostree package's description for more details. . This package contains automated tests.