[SCM] bitscope packaging branch, master, updated. debian/1.1-6-21-g90f4127

[js at users.alioth.debian.org]

The following commit has been merged in the master branch:
commit 27ce69963e748a289aad414016d5d1622df8d77b
Author: Jonas Smedegaard <dr at jones.dk>
Date:   Thu Mar 11 20:34:22 2010 +0100

    Rewrite long description based on introduction of documentation. Closes: bug#431778, thanks to Christian Perrier.

diff --git a/debian/control.in b/debian/control.in
index 63dcd2b..bf807b8 100644
--- a/debian/control.in
+++ b/debian/control.in
@@ -11,38 +11,13 @@ Package: bitscope
 Architecture: any
 Depends: ${shlibs:Depends}, ${misc:Depends}, jackd (>= 0.50.0)
 Description: diagnosis tool for JACK audio software
- As its name might suggest, the bitscope operates at the bare metal 
- of JACK's I/O layer, looking at the 32 binary digits in each individual 
- sample.
+ JACK Bitscope is a diagnosis tool for JACK audio software.  As its name
+ might suggest, the bitscope operates at the bare metal of JACK's I/O
+ layer, looking at the 32 binary digits in each individual sample.
  .
- There are three main areas to the bitscope display:
- .
-  * Statistics, at the top, including the range of sample values and keeping 
-    a count of irregular and illegal sample values such as NaN. The statistics 
-    on the right are cumulative, and should ordinarily read zero.
-  * Sign & Mantissa, a row of 24 coloured indicators showing the sign 
-    (positive or negative) and mantissa of the samples.
-  * Adjusted scale, 40 smaller coloured indicators.
- . 
- The sign and mantissa statistics are show as coloured indicators which
- map to bits in the samples processed by the bitscope, with the left
- most indicator representing the sign bit, and then the mantissa left to
- right from most significant to least significant. The colour is based
- on the percentage of samples in which the associated bit was 1 over a
- period of 100ms or so. Blue indicates that all samples were 0, a light
- green-blue for up to 33%, green for 33-66% (i.e. about half), and orange
- for more than 66%, then finally red if all samples are 1, a possible
- "stuck bit". Gray is used when no samples touched the associated bit.
- .
- The "adjusted scale" shows each sample bit on a absolute scale,
- adjusted for the exponent of the sample, so that internally the
- bitscope records a 280-bit binary real. For simplicity only 40 bits are
- displayed, the 8 left-most bits are the integer part, and the remaining
- 32 bits after the marker are fractional bits.
- .
- The audio range of the adjusted scale is from about 200dB below FS to
- 40dB above, which would be excessive for audio work but proves useful
- in diagnosing problems at a lower level.
- .
- The sample rate reported by bitscope is directly from JACK. It's not
- used to perform any calculations and is purely informative.
+ Think of bitscope like the wire strippers in your toolbox. You cannot
+ use them to drive screws into wood, or to undo bolts, or measure how
+ long anything is, but they are perfect for removing the insulation from
+ cables.  You will rarely need bitscope, in fact most JACK users will
+ never need it at all, but you might want to keep it around just in
+ case.

-- 
bitscope packaging