Bug#517996: mldonkey-server: Undocumented changes make this package hard to use

[Balbir Thomas <thomas.1037@osu.edu>]

Package: mldonkey-server
Version: 2.9.5-2
Severity: normal


1) In etch mldonkey was started with mldonkey_server ...
   In lenny mldonkey_server is gone. README.Debian should have had
   a brief and simple write up on what the user must use in place
   If you are going to do this (change interfaces, a bad thing
   in any software development) to your users, it is a very good
   idea also to advice them how to cope with it. After some 
   searching through the man pages one finds mlnet. Aparently
   this is the userspace command (if I am not mistaken) that 
   replaces mldonkey_server. This should have been documented 
   in README.Debian

2) In etch mldonkey would download (commit) files to
   ~/.mldonkey/incoming . In lenny the files seem to dissapear 
   somewhere (if the server is started as root using the
   init scripts provided as part of the package) till you 
   figure out that they are in /var/lib/mldonkey. Shouldn't 
   this change have been documented clearly in 
   README.Debian instead of letting your user ferret it out.

3) While there are plenty of docs in the "docs" and "distrib" directories in
   /usr/share/doc/mldonkey-server folders, these are mostly of relavance
   to developers/hackers rather than an average user. Also your notes in
   README.Debian are not appropriate for an user trying to understand
   how to run and use the mldonkey server in debian. They may certainly
   be useful once the user has managed to run and use MLdonkey and then
   wants to tweak it to his/her preference. Such information must be
   provided clearly particularly, in view of the tendency of the
   mldonkey server package, to change its interface through sarge,
   etch and lenny.

Kindly improve quality of Debian specific user documentation in view of
the above.

-- System Information:
Debian Release: 5.0
  APT prefers stable
  APT policy: (500, 'stable')
Architecture: i386 (i686)

Kernel: Linux 2.6.26-1-486
Locale: LANG=en_US, LC_CTYPE=en_US (charmap=ISO-8859-1)
Shell: /bin/sh linked to /bin/bash

Versions of packages mldonkey-server depends on:
ii  adduser                3.110             add and remove users and groups
ii  debconf [debconf-2.0]  1.5.24            Debian configuration management sy
ii  dpkg                   1.14.25           Debian package management system
ii  libc6                  2.7-18            GNU C Library: Shared libraries
ii  libfreetype6           2.3.7-2           FreeType 2 font engine, shared lib
ii  libgcc1                1:4.3.2-1.1       GCC support library
ii  libgd2-xpm             2.0.36~rc1~dfsg-3 GD Graphics Library version 2
ii  libjpeg62              6b-14             The Independent JPEG Group's JPEG 
ii  libpng12-0             1.2.27-2          PNG library - runtime
ii  libstdc++6             4.3.2-1.1         The GNU Standard C++ Library v3
ii  mime-support           3.44-1            MIME files 'mime.types' & 'mailcap
ii  ucf                    3.0016            Update Configuration File: preserv
ii  zlib1g                 1:1.2.3.3.dfsg-12 compression library - runtime

mldonkey-server recommends no packages.

Versions of packages mldonkey-server suggests:
pn  makejail                      <none>     (no description available)

-- debconf information:
* mldonkey-server/max_hard_download_rate: 0
* mldonkey-server/launch_at_startup: false
* mldonkey-server/mldonkey_group: mldonkey
  mldonkey-server/false_password:
* mldonkey-server/max_hard_upload_rate: 0
  mldonkey-server/max_alive: 48
* mldonkey-server/run_as_user: mldonkey
  mldonkey-server/reown_file: false
* mldonkey-server/mldonkey_niceness: 0
  mldonkey-server/fasttrack_problem:
* mldonkey-server/mldonkey_dir: /var/lib/mldonkey
  mldonkey-server/mldonkey_move: false