debian: Improve long descriptions so as to better describe the packages.

Reviewed-by: Simon Horman <horms@verge.net.au>
Signed-off-by: Thomas Goirand <zigo@debian.org>
Signed-off-by: Ben Pfaff <blp@nicira.com>

diff --git a/debian/control b/debian/control
index 1d6859e7935307874768a5ba02817495209755be..7666c82b05133da7fd82f3435b31407effe36515 100644 (file)
--- a/debian/control
+++ b/debian/control
@@ -16,17 +16,31 @@ Architecture: all
 Depends: module-assistant, bzip2, debhelper (>= 5.0.37), ${misc:Depends}
 Suggests: openvswitch-switch
 Description: Open vSwitch datapath module source - module-assistant version
 Depends: module-assistant, bzip2, debhelper (>= 5.0.37), ${misc:Depends}
 Suggests: openvswitch-switch
 Description: Open vSwitch datapath module source - module-assistant version

+ Open vSwitch is a production quality, multilayer, software-based, Ethernet
+ virtual switch. It is designed to enable massive network automation through
+ programmatic extension, while still supporting standard management interfaces
+ and protocols (e.g. NetFlow, sFlow, SPAN, RSPAN, CLI, LACP, 802.1ag). In
+ addition, it is designed to support distribution across multiple physical
+ servers similar to VMware's vNetwork distributed vswitch or Cisco's Nexus
+ 1000V.
+ .

  This package provides the Open vSwitch datapath module source code
  that is needed by openvswitch-switch.  The kernel module can be built
  from it using module-assistant or make-kpkg.  README.Debian in this
  package provides further instructions.
  This package provides the Open vSwitch datapath module source code
  that is needed by openvswitch-switch.  The kernel module can be built
  from it using module-assistant or make-kpkg.  README.Debian in this
  package provides further instructions.

- .
- Open vSwitch is a full-featured software-based Ethernet switch.

 
 Package: openvswitch-datapath-dkms
 Architecture: all
 Depends: dkms (>= 1.95), make, libc6-dev, ${misc:Depends}
 Description: Open vSwitch datapath module source - DKMS version
 
 Package: openvswitch-datapath-dkms
 Architecture: all
 Depends: dkms (>= 1.95), make, libc6-dev, ${misc:Depends}
 Description: Open vSwitch datapath module source - DKMS version

+ Open vSwitch is a production quality, multilayer, software-based, Ethernet
+ virtual switch. It is designed to enable massive network automation through
+ programmatic extension, while still supporting standard management interfaces
+ and protocols (e.g. NetFlow, sFlow, SPAN, RSPAN, CLI, LACP, 802.1ag). In
+ addition, it is designed to support distribution across multiple physical
+ servers similar to VMware's vNetwork distributed vswitch or Cisco's Nexus
+ 1000V.
+ .

  This package provides the Open vSwitch datapath module source code
  that is needed by openvswitch-switch.  DKMS can built the kernel
  module from it.
  This package provides the Open vSwitch datapath module source code
  that is needed by openvswitch-switch.  DKMS can built the kernel
  module from it.


@@ -38,20 +52,32 @@ Depends:
  python (>= 2.7) | python-argparse
 Suggests: ethtool
 Description: Open vSwitch common components
  python (>= 2.7) | python-argparse
 Suggests: ethtool
 Description: Open vSwitch common components

+ Open vSwitch is a production quality, multilayer, software-based, Ethernet
+ virtual switch. It is designed to enable massive network automation through
+ programmatic extension, while still supporting standard management interfaces
+ and protocols (e.g. NetFlow, sFlow, SPAN, RSPAN, CLI, LACP, 802.1ag). In
+ addition, it is designed to support distribution across multiple physical
+ servers similar to VMware's vNetwork distributed vswitch or Cisco's Nexus
+ 1000V.
+ .

  openvswitch-common provides components required by both openvswitch-switch
  and openvswitch-controller.
  openvswitch-common provides components required by both openvswitch-switch
  and openvswitch-controller.

- .
- Open vSwitch is a full-featured software-based Ethernet switch.

 
 Package: openvswitch-switch
 Architecture: linux-any
 Suggests: openvswitch-datapath-module
 Depends: ${shlibs:Depends}, ${misc:Depends}, ${python:Depends}, openvswitch-common (= ${binary:Version}), module-init-tools, procps, uuid-runtime
 Description: Open vSwitch switch implementations
 
 Package: openvswitch-switch
 Architecture: linux-any
 Suggests: openvswitch-datapath-module
 Depends: ${shlibs:Depends}, ${misc:Depends}, ${python:Depends}, openvswitch-common (= ${binary:Version}), module-init-tools, procps, uuid-runtime
 Description: Open vSwitch switch implementations

+ Open vSwitch is a production quality, multilayer, software-based, Ethernet
+ virtual switch. It is designed to enable massive network automation through
+ programmatic extension, while still supporting standard management interfaces
+ and protocols (e.g. NetFlow, sFlow, SPAN, RSPAN, CLI, LACP, 802.1ag). In
+ addition, it is designed to support distribution across multiple physical
+ servers similar to VMware's vNetwork distributed vswitch or Cisco's Nexus
+ 1000V.
+ .

  openvswitch-switch provides the userspace components and utilities for
  the Open vSwitch kernel-based switch.  
  openvswitch-switch provides the userspace components and utilities for
  the Open vSwitch kernel-based switch.  

- .
- Open vSwitch is a full-featured software-based Ethernet switch.

 
 Package: openvswitch-ipsec
 Architecture: linux-any
 
 Package: openvswitch-ipsec
 Architecture: linux-any


@@ -63,10 +89,16 @@ Depends:
  openvswitch-switch (= ${binary:Version}),
  python-openvswitch (= ${source:Version})
 Description: Open vSwitch GRE-over-IPsec support
  openvswitch-switch (= ${binary:Version}),
  python-openvswitch (= ${source:Version})
 Description: Open vSwitch GRE-over-IPsec support

+ Open vSwitch is a production quality, multilayer, software-based, Ethernet
+ virtual switch. It is designed to enable massive network automation through
+ programmatic extension, while still supporting standard management interfaces
+ and protocols (e.g. NetFlow, sFlow, SPAN, RSPAN, CLI, LACP, 802.1ag). In
+ addition, it is designed to support distribution across multiple physical
+ servers similar to VMware's vNetwork distributed vswitch or Cisco's Nexus
+ 1000V.
+ .

  The ovs-monitor-ipsec script provides support for encrypting GRE
  tunnels with IPsec.
  The ovs-monitor-ipsec script provides support for encrypting GRE
  tunnels with IPsec.

- .
- Open vSwitch is a full-featured software-based Ethernet switch.

 
 Package: openvswitch-pki
 Architecture: all
 
 Package: openvswitch-pki
 Architecture: all


@@ -74,11 +106,17 @@ Depends:
  ${misc:Depends}, openvswitch-common (>= ${source:Version}),
  openvswitch-common (<< ${source:Version}.1~)
 Description: Open vSwitch public key infrastructure dependency package
  ${misc:Depends}, openvswitch-common (>= ${source:Version}),
  openvswitch-common (<< ${source:Version}.1~)
 Description: Open vSwitch public key infrastructure dependency package

+ Open vSwitch is a production quality, multilayer, software-based, Ethernet
+ virtual switch. It is designed to enable massive network automation through
+ programmatic extension, while still supporting standard management interfaces
+ and protocols (e.g. NetFlow, sFlow, SPAN, RSPAN, CLI, LACP, 802.1ag). In
+ addition, it is designed to support distribution across multiple physical
+ servers similar to VMware's vNetwork distributed vswitch or Cisco's Nexus
+ 1000V.
+ .

  openvswitch-pki provides PKI (public key infrastructure) support for
  Open vSwitch switches and controllers, reducing the risk of
  man-in-the-middle attacks on the Open vSwitch network infrastructure.
  openvswitch-pki provides PKI (public key infrastructure) support for
  Open vSwitch switches and controllers, reducing the risk of
  man-in-the-middle attacks on the Open vSwitch network infrastructure.

- .
- Open vSwitch is a full-featured software-based Ethernet switch.

 
 Package: openvswitch-controller
 Architecture: linux-any
 
 Package: openvswitch-controller
 Architecture: linux-any


@@ -86,10 +124,16 @@ Depends:
  ${shlibs:Depends}, openvswitch-common (= ${binary:Version}),
  openvswitch-pki (= ${source:Version}), ${misc:Depends}
 Description: Open vSwitch controller implementation
  ${shlibs:Depends}, openvswitch-common (= ${binary:Version}),
  openvswitch-pki (= ${source:Version}), ${misc:Depends}
 Description: Open vSwitch controller implementation

+ Open vSwitch is a production quality, multilayer, software-based, Ethernet
+ virtual switch. It is designed to enable massive network automation through
+ programmatic extension, while still supporting standard management interfaces
+ and protocols (e.g. NetFlow, sFlow, SPAN, RSPAN, CLI, LACP, 802.1ag). In
+ addition, it is designed to support distribution across multiple physical
+ servers similar to VMware's vNetwork distributed vswitch or Cisco's Nexus
+ 1000V.
+ .

  The Open vSwitch controller enables OpenFlow switches that connect to it
  to act as MAC-learning Ethernet switches.
  The Open vSwitch controller enables OpenFlow switches that connect to it
  to act as MAC-learning Ethernet switches.

- .
- Open vSwitch is a full-featured software-based Ethernet switch.

 
 Package: openvswitch-brcompat
 Architecture: linux-any
 
 Package: openvswitch-brcompat
 Architecture: linux-any


@@ -97,6 +141,14 @@ Depends:
  ${shlibs:Depends}, openvswitch-switch (= ${binary:Version}), ${misc:Depends}
 Recommends: bridge-utils
 Description: Open vSwitch bridge compatibility support
  ${shlibs:Depends}, openvswitch-switch (= ${binary:Version}), ${misc:Depends}
 Recommends: bridge-utils
 Description: Open vSwitch bridge compatibility support

+ Open vSwitch is a production quality, multilayer, software-based, Ethernet
+ virtual switch. It is designed to enable massive network automation through
+ programmatic extension, while still supporting standard management interfaces
+ and protocols (e.g. NetFlow, sFlow, SPAN, RSPAN, CLI, LACP, 802.1ag). In
+ addition, it is designed to support distribution across multiple physical
+ servers similar to VMware's vNetwork distributed vswitch or Cisco's Nexus
+ 1000V.
+ .

  openvswitch-brcompat provides a way for applications that use the
  Linux bridge to gradually migrate to Open vSwitch.  Programs that
  ordinarily control the Linux bridge module, such as "brctl", instead
  openvswitch-brcompat provides a way for applications that use the
  Linux bridge to gradually migrate to Open vSwitch.  Programs that
  ordinarily control the Linux bridge module, such as "brctl", instead


@@ -104,8 +156,6 @@ Description: Open vSwitch bridge compatibility support
  .
  Once this package is installed, adding BRCOMPAT=yes in
  /etc/default/openvswitch-switch enables bridge compatibility.
  .
  Once this package is installed, adding BRCOMPAT=yes in
  /etc/default/openvswitch-switch enables bridge compatibility.

- .
- Open vSwitch is a full-featured software-based Ethernet switch.

 
 Package: openvswitch-dbg
 Section: debug
 
 Package: openvswitch-dbg
 Section: debug


@@ -117,6 +167,14 @@ Depends:
  openvswitch-ipsec (= ${binary:Version}),
  openvswitch-switch (= ${binary:Version})
 Description: Debug symbols for Open vSwitch packages
  openvswitch-ipsec (= ${binary:Version}),
  openvswitch-switch (= ${binary:Version})
 Description: Debug symbols for Open vSwitch packages

+ Open vSwitch is a production quality, multilayer, software-based, Ethernet
+ virtual switch. It is designed to enable massive network automation through
+ programmatic extension, while still supporting standard management interfaces
+ and protocols (e.g. NetFlow, sFlow, SPAN, RSPAN, CLI, LACP, 802.1ag). In
+ addition, it is designed to support distribution across multiple physical
+ servers similar to VMware's vNetwork distributed vswitch or Cisco's Nexus
+ 1000V.
+ .

  This package contains the debug symbols for all the other openvswitch-*
  packages.  Install it to debug one of them or to examine a core dump
  produced by one of them.
  This package contains the debug symbols for all the other openvswitch-*
  packages.  Install it to debug one of them or to examine a core dump
  produced by one of them.


@@ -126,6 +184,14 @@ Architecture: all
 Section: python
 Depends: ${misc:Depends}, ${python:Depends}
 Description: Python bindings for Open vSwitch
 Section: python
 Depends: ${misc:Depends}, ${python:Depends}
 Description: Python bindings for Open vSwitch

+ Open vSwitch is a production quality, multilayer, software-based, Ethernet
+ virtual switch. It is designed to enable massive network automation through
+ programmatic extension, while still supporting standard management interfaces
+ and protocols (e.g. NetFlow, sFlow, SPAN, RSPAN, CLI, LACP, 802.1ag). In
+ addition, it is designed to support distribution across multiple physical
+ servers similar to VMware's vNetwork distributed vswitch or Cisco's Nexus
+ 1000V.
+ .

  This package contains the full Python bindings for Open vSwitch database.
 
 Package: ovsdbmonitor
  This package contains the full Python bindings for Open vSwitch database.
 
 Package: ovsdbmonitor


@@ -133,19 +199,31 @@ Architecture: all
 Section: utils
 Depends: ${python:Depends}, python-openvswitch, ${misc:Depends}
 Description: Open vSwitch graphical monitoring tool
 Section: utils
 Depends: ${python:Depends}, python-openvswitch, ${misc:Depends}
 Description: Open vSwitch graphical monitoring tool

+ Open vSwitch is a production quality, multilayer, software-based, Ethernet
+ virtual switch. It is designed to enable massive network automation through
+ programmatic extension, while still supporting standard management interfaces
+ and protocols (e.g. NetFlow, sFlow, SPAN, RSPAN, CLI, LACP, 802.1ag). In
+ addition, it is designed to support distribution across multiple physical
+ servers similar to VMware's vNetwork distributed vswitch or Cisco's Nexus
+ 1000V.
+ .

  This package is a GUI tool for monitoring and troubleshooting local
  or remote Open vSwitch installations.  It presents GUI tables that
  graphically represent an Open vSwitch kernel flow table (similar to
  "ovs-dpctl dump-flows") and Open vSwitch database contents (similar
  to "ovs-vsctl list <table>").
  This package is a GUI tool for monitoring and troubleshooting local
  or remote Open vSwitch installations.  It presents GUI tables that
  graphically represent an Open vSwitch kernel flow table (similar to
  "ovs-dpctl dump-flows") and Open vSwitch database contents (similar
  to "ovs-vsctl list <table>").

- .
- Open vSwitch is a full-featured software-based Ethernet switch.

 
 Package: openvswitch-test
 Architecture: all
 Depends: ${misc:Depends}, python-twisted-web, python (>= 2.7) | python-argparse
 Description: Open vSwitch test package
 
 Package: openvswitch-test
 Architecture: all
 Depends: ${misc:Depends}, python-twisted-web, python (>= 2.7) | python-argparse
 Description: Open vSwitch test package

+ Open vSwitch is a production quality, multilayer, software-based, Ethernet
+ virtual switch. It is designed to enable massive network automation through
+ programmatic extension, while still supporting standard management interfaces
+ and protocols (e.g. NetFlow, sFlow, SPAN, RSPAN, CLI, LACP, 802.1ag). In
+ addition, it is designed to support distribution across multiple physical
+ servers similar to VMware's vNetwork distributed vswitch or Cisco's Nexus
+ 1000V.
+ .

  This package contains utilities that are useful to diagnose
  performance and connectivity issues in Open vSwitch setup.
  This package contains utilities that are useful to diagnose
  performance and connectivity issues in Open vSwitch setup.

- .
- Open vSwitch is a full-featured software-based Ethernet switch.