Package: util-linux
Version: 2.12r-8
Severity: wishlist

whatis cytune
cytune (8)           - Tune Cyclades driver parameters

This seems unnecessarily cryptic; not just obscure, but obscure in a
way that forces readers to wrack their brains for any context that
would explain what a "Cyclades driver" is or why software for tuning
its parameters should have been automatically installed on their new
laptop.  The only way they can tell that it's a man page they'll
never need to read is by reading it!

Indeed, even when they've invoked "man cytune" it takes a bit of
reading between the lines to work out that it isn't talking about
the Aegean island group, the "Cyclades Network" from the seventies,
or any item of hardware currently available from the Californian KVM
manufacturers known as "Cyclades Corporation".  No, the man page is
talking about tuning a particular specialised piece of kit that
cyclades.com used to manufacture way back in the early days of Linux
ISPs. 

Hence this wishlist patch designed to make the man page more
self-explanatory in its obscurity:

diff -ru util-linux-2.12r.orig/sys-utils/cytune.8 
util-linux-2.12r/sys-utils/cytune.8
--- util-linux-2.12r.orig/sys-utils/cytune.8    2004-12-22 15:12:35.000000000 
+0000
+++ util-linux-2.12r/sys-utils/cytune.8 2006-06-22 21:11:00.000000000 +0100
@@ -26,7 +26,7 @@
 .\" "
 .TH CYTUNE 8 " 4 Mar 1995" "" "Linux Programmer's Manual"
 .SH NAME
-cytune \- Tune Cyclades driver parameters
+cytune \- Tune driver parameters for Cyclades-Z multiport serial card
 .SH SYNOPSIS
 .BI "cytune [-q [-i " interval "]] ([-s " value "]|[-S " value "]) [-g|G] "
 .BI ([-t " timeout" ]|[-T " timeout" ]) " tty" " [" tty " ...]"


Maybe one to send upstream, definitely not one to delay Etch for.

-- System Information:
Debian Release: testing/unstable
  APT prefers testing
  APT policy: (500, 'testing'), (50, 'unstable')
Architecture: i386 (i586)
Shell:  /bin/sh linked to /bin/bash
Kernel: Linux 2.6.16.hurakan
Locale: LANG=en_GB, LC_CTYPE=en_GB (charmap=ISO-8859-1)

Versions of packages util-linux depends on:
ii  libc6                         2.3.6-13   GNU C Library: Shared libraries
ii  libncurses5                   5.5-2      Shared libraries for terminal hand
ii  libslang2                     2.0.6-2    The S-Lang programming library - r
ii  libuuid1                      1.39-1     universally unique id library
ii  lsb-base                      3.1-10     Linux Standard Base 3.1 init scrip
ii  zlib1g                        1:1.2.3-11 compression library - runtime

util-linux recommends no packages.

-- no debconf information

-- 
JBR
Ankh kak! (Ancient Egyptian blessing)


-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]

Reply via email to