Package: timidity
Version: 2.13.2-16
Severity: minor
Tags: patch

The man page's "--force-keysig=n" description contains grammatical
errors and seems needlessly difficult:

    man timidity  | grep -nA 8 'keysig=n'
    375:  -H n, --force-keysig=n
    376-     Specify the number of key signature.   MIDI  file  is  performed
    377-     with  transposition to the key of the number of sharp (when n is
    378-     positive) or flat (when n is negative).  Valid values of  n  are
    379-     in the interval from -7 to 7.  For example, if n is 1, MIDI file
    380-     with any tonality will be performed transposing to 1 flat (i.e.,
    381-     F major or D minor).  Therefore, it is convenient to use for the
    382-     accompaniment when practicing a musical instrument by the tonal-
    383-     ity which is easy to perform.


Suggested revision:

       -H n, --force-keysig=n
              Specify  the  key signature.  MIDI playback is transposed to
              the key with the same number of sharps (when n is  positive)
              or  flats  (when  n  is negative).  Valid values for n range
              from -7 to 7.  For example, if n is 1, MIDI  playback  would
              transpose 1 flat (i.e., F major or D minor).

...attached  is a '.diff' for '/usr/share/man/man1/timidity.1.gz'.


Hope this helps...

PS: the last sentence (lines #381-383) was removed because I
cannot parse "...by the tonality which is easy to perform".


-- System Information:
Debian Release: lenny/sid
  APT prefers unstable
  APT policy: (500, 'unstable')
Architecture: i386 (i686)

Kernel: Linux 2.6.22-3-k7 (SMP w/1 CPU core)
Locale: LANG=C, LC_CTYPE=C (charmap=ANSI_X3.4-1968) (ignored: LC_ALL set to C)
Shell: /bin/sh linked to /bin/dash

Versions of packages timidity depends on:
ii  libartsc0               1.5.8-1          aRts sound system C support librar
ii  libasound2              1.0.15-2         ALSA library
ii  libaudio2               1.9.1-1          Network Audio System - shared libr
ii  libaudiofile0           0.2.6-7          Open-source version of SGI's audio
ii  libc6                   2.7-4            GNU C Library: Shared libraries
ii  libesd-alsa0 [libesd0]  0.2.36-3         Enlightened Sound Daemon (ALSA) - 
ii  libflac8                1.2.1-1          Free Lossless Audio Codec - runtim
ii  libglib2.0-0            2.14.4-2         The GLib library of C routines
ii  libice6                 2:1.0.4-1        X11 Inter-Client Exchange library
ii  libjack0                0.103.0-6        JACK Audio Connection Kit (librari
ii  libncurses5             5.6+20071124-1   Shared libraries for terminal hand
ii  libogg0                 1.1.3-2          Ogg Bitstream Library
ii  libpng12-0              1.2.15~beta5-3   PNG library - runtime
ii  libsm6                  2:1.0.3-1+b1     X11 Session Management library
ii  libvorbis0a             1.2.0.dfsg-2     The Vorbis General Audio Compressi
ii  libvorbisenc2           1.2.0.dfsg-2     The Vorbis General Audio Compressi
ii  libx11-6                2:1.0.3-7        X11 client-side library
ii  libxext6                1:1.0.3-2        X11 miscellaneous extension librar
ii  libxmu6                 1:1.0.3-1        X11 miscellaneous utility library
ii  libxt6                  1:1.0.5-3        X11 toolkit intrinsics library
ii  lsb-base                3.1-24           Linux Standard Base 3.1 init scrip
ii  xaw3dg                  1.5+E-15         Xaw3d widget set
ii  zlib1g                  1:1.2.3.3.dfsg-7 compression library - runtime

Versions of packages timidity recommends:
pn  freepats                      <none>     (no description available)

-- no debconf information

--- timidity.1  2007-12-09 08:48:57.000000000 -0500
+++ /tmp/timidity.1     2007-12-11 03:00:36.000000000 -0500
@@ -440,14 +440,12 @@
 system has support for the X Window System.
 .TP
 .BI "\-H " n ", \-\-force\-keysig=" n
-Specify the number of key signature.  MIDI file is performed with
-transposition to the key of the number of sharp (when \fIn\fP is
-positive) or flat (when \fIn\fP is negative).  Valid values of \fIn\fP
-are in the interval from \fB\-7\fP to \fB7\fP.  For example, if \fIn\fP
-is \fB1\fP, MIDI file with any tonality will be performed transposing
-to \fB1\fP flat (i.e., F major or D minor).  Therefore, it is
-convenient to use for the accompaniment when practicing a musical
-instrument by the tonality which is easy to perform.
+Specify the key signature.  MIDI playback is transposed to the key 
+with the same number of sharps (when \fIn\fP is
+positive) or flats (when \fIn\fP is negative).  Valid values for \fIn\fP
+range from \fB\-7\fP to \fB7\fP.  For example, if \fIn\fP
+is \fB1\fP, MIDI playback would transpose \fB1\fP flat 
+(i.e., F major or D minor). 
 .TP
 .B \-h, \-\-help
 Show the help message.

Reply via email to