Update package descriptions

 - Text from "what is puppet" at
   https://docs.puppetlabs.com/guides/faq.html

1 files changed, 74 insertions, 66 deletions

diff --git a/debian/control b/debian/control
index 7e45f562c..64fca4166 100644
--- a/debian/control
+++ b/debian/control
@@ -35,21 +35,21 @@ Recommends:
 Suggests: ruby-rrd | librrd-ruby
 Breaks: puppet (<< 2.7.5-3), puppetmaster (<< 0.25.4-1), ruby-hiera-puppet
 Replaces: puppet (<< 2.7.5-3), puppetmaster (<< 0.25.4-1), ruby-hiera-puppet
-Description: Centralized configuration management
- Puppet lets you centrally manage every important aspect of your system
- using a cross-platform specification language that manages all the
- separate elements normally aggregated in different files, like users,
- cron jobs, and hosts, along with obviously discrete elements like
- packages, services, and files.
+Description: configuration management system
+ Puppet is a server automation tool. It is composed of a declarative
+ language for expressing system configuration, a client and server for
+ distributing it, and a library for realizing the configuration.
  .
- Puppet's simple declarative specification language provides powerful
- classing abilities for drawing out the similarities between hosts while
- allowing them to be as specific as necessary, and it handles dependency
- and prerequisite relationships between objects clearly and explicitly.
+ The primary design goal of Puppet is to have an expressive enough
+ language backed by a powerful enough library that you can write your
+ own server automation applications in just a few lines of code.
+ Puppet’s deep extensibility and open source license lets you add
+ functionality as needed and share your innovations with others.
  .
- This package contains the puppet software and documentation.  For the startup
- scripts needed to run the puppet agent and master, see the "puppet" and
- "puppetmaster" packages, respectively.
+ This package contains the puppet software and documentation. To
+ automatically start a puppet agent, install the "puppet" package. To
+ install and configure a puppet master, install one of the
+ "puppetmaster" or "puppetmaster-passenger" packages.
 
 Package: puppet
 Architecture: all
@@ -58,20 +58,20 @@ Depends: ${misc:Depends},
  puppet-common (= ${binary:Version}),
  ruby | ruby-interpreter,
 Suggests: puppet-el, vim-puppet, etckeeper
-Description: Centralized configuration management - agent startup and compatibility scripts
- This package contains the startup script and compatbility scripts for the
- puppet agent, which is the process responsible for configuring the local node.
+Description: configuration management system, agent
+ Puppet is a server automation tool. It is composed of a declarative
+ language for expressing system configuration, a client and server for
+ distributing it, and a library for realizing the configuration.
  .
- Puppet lets you centrally manage every important aspect of your system
- using a cross-platform specification language that manages all the
- separate elements normally aggregated in different files, like users,
- cron jobs, and hosts, along with obviously discrete elements like
- packages, services, and files.
+ The primary design goal of Puppet is to have an expressive enough
+ language backed by a powerful enough library that you can write your
+ own server automation applications in just a few lines of code.
+ Puppet’s deep extensibility and open source license lets you add
+ functionality as needed and share your innovations with others.
  .
- Puppet's simple declarative specification language provides powerful
- classing abilities for drawing out the similarities between hosts while
- allowing them to be as specific as necessary, and it handles dependency
- and prerequisite relationships between objects clearly and explicitly.
+ This package contains "puppet" service and init script used to run
+ the puppet agent, and depend on the "puppet-common" package which
+ contains the software.
 
 Package: puppetmaster-common
 Architecture: all
@@ -88,20 +88,19 @@ Suggests:
  ruby-stomp,
  stompserver,
  vim-puppet,
-Description: Puppet master common scripts
- This package contains common scripts for the puppet master, 
- which is the server hosting manifests and files for the puppet nodes.
+Description: configuration management system, master common files
+ Puppet is a server automation tool. It is composed of a declarative
+ language for expressing system configuration, a client and server for
+ distributing it, and a library for realizing the configuration.
  .
- Puppet lets you centrally manage every important aspect of your system
- using a cross-platform specification language that manages all the
- separate elements normally aggregated in different files, like users,
- cron jobs, and hosts, along with obviously discrete elements like
- packages, services, and files.
+ The primary design goal of Puppet is to have an expressive enough
+ language backed by a powerful enough library that you can write your
+ own server automation applications in just a few lines of code.
+ Puppet’s deep extensibility and open source license lets you add
+ functionality as needed and share your innovations with others.
  .
- Puppet's simple declarative specification language provides powerful
- classing abilities for drawing out the similarities between hosts while
- allowing them to be as specific as necessary, and it handles dependency
- and prerequisite relationships between objects clearly and explicitly.
+ This package contains configuration files used by both puppetmaster
+ and puppetmaster-common packages.
 
 Package: puppetmaster
 Architecture: all
@@ -110,20 +109,19 @@ Depends: ${misc:Depends},
  ruby | ruby-interpreter,
 Breaks: puppet (<< 0.24.7-1)
 Replaces: puppet (<< 0.24.7-1)
-Description: Centralized configuration management - master startup and compatibility scripts
- This package contains the startup and compatibility scripts for the puppet
- master, which is the server hosting manifests and files for the puppet nodes.
+Description: configuration management system, master service
+ Puppet is a server automation tool. It is composed of a declarative
+ language for expressing system configuration, a client and server for
+ distributing it, and a library for realizing the configuration.
  .
- Puppet lets you centrally manage every important aspect of your system
- using a cross-platform specification language that manages all the
- separate elements normally aggregated in different files, like users,
- cron jobs, and hosts, along with obviously discrete elements like
- packages, services, and files.
+ The primary design goal of Puppet is to have an expressive enough
+ language backed by a powerful enough library that you can write your
+ own server automation applications in just a few lines of code.
+ Puppet’s deep extensibility and open source license lets you add
+ functionality as needed and share your innovations with others.
  .
- Puppet's simple declarative specification language provides powerful
- classing abilities for drawing out the similarities between hosts while
- allowing them to be as specific as necessary, and it handles dependency
- and prerequisite relationships between objects clearly and explicitly.
+ This package contains the "puppetmaster" service and init script,
+ which is suitable for small deployments.
 
 Package: puppetmaster-passenger
 Architecture: all
@@ -135,20 +133,20 @@ Depends: ${misc:Depends},
  ruby | ruby-interpreter,
 Breaks: puppetmaster (<< 2.6.1~rc2-1)
 Replaces: puppetmaster (<< 2.6.1~rc2-1)
-Description: Centralised configuration management - master setup to run under mod passenger
- This package provides a puppetmaster running under mod passenger.
- This configuration offers better performance and scalability.
+Description: configuration management system, scalable master service
+ Puppet is a server automation tool. It is composed of a declarative
+ language for expressing system configuration, a client and server for
+ distributing it, and a library for realizing the configuration.
  .
- Puppet lets you centrally manage every important aspect of your system
- using a cross-platform specification language that manages all the
- separate elements normally aggregated in different files, like users,
- cron jobs, and hosts, along with obviously discrete elements like
- packages, services, and files.
+ The primary design goal of Puppet is to have an expressive enough
+ language backed by a powerful enough library that you can write your
+ own server automation applications in just a few lines of code.
+ Puppet’s deep extensibility and open source license lets you add
+ functionality as needed and share your innovations with others.
  .
- Puppet's simple declarative specification language provides powerful
- classing abilities for drawing out the similarities between hosts while
- allowing them to be as specific as necessary, and it handles dependency
- and prerequisite relationships between objects clearly and explicitly.
+ This package provides a puppet master running under apache with
+ mod_passenger, suitable for large deployments. This offers better
+ scalability than the "puppetmaster" package.
 
 Package: vim-puppet
 Architecture: all
@@ -157,8 +155,8 @@ Recommends: vim-addon-manager
 Breaks: puppet (<< 0.25.4-1)
 Replaces: puppet (<< 0.25.4-1)
 Description: syntax highlighting for puppet manifests in vim
- The vim-puppet package provides filetype detection and syntax highlighting for
- puppet manifests (files ending with ".pp").
+ The vim-puppet package provides filetype detection and syntax
+ highlighting for puppet manifests (files ending with ".pp").
  .
  As per the Debian vim policy, installed addons are not activated
  automatically, but the "vim-addon-manager" tool can be used for this
@@ -193,9 +191,19 @@ Recommends:
  cron,
  ruby-rgen,
 Suggests: ruby
-Description: Centralized configuration management - test suite
- This package provides all the tests from the upstream puppet source code.
- The tests are used for improving the QA of the puppet package.
+Description: configuration management system, development test suite
+ Puppet is a server automation tool. It is composed of a declarative
+ language for expressing system configuration, a client and server for
+ distributing it, and a library for realizing the configuration.
+ .
+ The primary design goal of Puppet is to have an expressive enough
+ language backed by a powerful enough library that you can write your
+ own server automation applications in just a few lines of code.
+ Puppet’s deep extensibility and open source license lets you add
+ functionality as needed and share your innovations with others.
+ .
+ This package provides all the tests from the upstream puppet source
+ code. The tests are used for improving the QA of the puppet package.
  .
  Tests are installed under /usr/share/puppet-testsuite, and can be
  performed using "rake unit" in that directory.