[Pkg-ocaml-maint-commits] r3740 - in /trunk/packages/mldonkey/trunk/debian: README.Debian changelog mldonkey-server.manpages

smimram at users.alioth.debian.org smimram at users.alioth.debian.org
Tue May 8 11:19:35 UTC 2007


Author: smimram
Date: Tue May  8 11:19:34 2007
New Revision: 3740

URL: http://svn.debian.org/wsvn/pkg-ocaml-maint/?sc=1&rev=3740
Log:
Removed mldonkey_users and mldonkey_server manpages and cleaned up README.Debian.

Modified:
    trunk/packages/mldonkey/trunk/debian/README.Debian
    trunk/packages/mldonkey/trunk/debian/changelog
    trunk/packages/mldonkey/trunk/debian/mldonkey-server.manpages

Modified: trunk/packages/mldonkey/trunk/debian/README.Debian
URL: http://svn.debian.org/wsvn/pkg-ocaml-maint/trunk/packages/mldonkey/trunk/debian/README.Debian?rev=3740&op=diff
==============================================================================
--- trunk/packages/mldonkey/trunk/debian/README.Debian (original)
+++ trunk/packages/mldonkey/trunk/debian/README.Debian Tue May  8 11:19:34 2007
@@ -1,46 +1,26 @@
-----------------------------------
-*Packages: mldonkey-[server|gui]*
-----------------------------------
-
-I have implemented some commands to ease the installation
-and the maintenance process:
-
-- mldonkey_command: to send command to mlnet,
-- mldonkey_server: to keep mlnet instance alive,
-- mldonkey_submit: to have a more clean instance of automatic submission
-  program (before it was perl),
-- mldonkey_users: to manage the user/password,
-- mldonkey_create_chroot: to create chroot for mldonkey-server (thanks
-  to Mick Kappenburg).
-
-Enjoy p2p.
-
- -- Sylvain Le Gall <gildor at debian.org>  Mon, 16 Jun 2003 20:47:07 +0200
-
 ---------------------------------
 *                               *
 *      Mldonkey and chroot      *
 *                               *
 ---------------------------------
 
-
 Actually, there is an option to enable chroot for mldonkey.
 
 I decide not to use it for many reasons:
-- running the daemon under a different ID is safer than chrooting 
+- running the daemon under a different ID is safer than chrooting
 - chrooting doesn't cooperate well with chuid...
 
-Browsing the code of mldonkey, lead me to one conclusion: the creation of 
-*.ini file is erratic. If you try to make chuid && chroot, you will need to 
-start the daemon as root, it will create some file owned by root, then you 
+Browsing the code of mldonkey, lead me to one conclusion: the creation of
+*.ini file is erratic. If you try to make chuid && chroot, you will need to
+start the daemon as root, it will create some file owned by root, then you
 chroot, then you try to chuid. So it needs to have a etc/passwd in the chroot,
 we need to check file permission after start...
 
-So it is a lot of bug to correct. There is bugreport about this situation for 
+So it is a lot of bug to correct. There is bugreport about this situation for
 mldonkey:
 http://savannah.nongnu.org/bugs/?func=detailbug&group_id=1409&bug_id=3969
 
-For now, i prefer to use mldonkey-server to start mlnet. Mldonkey server 
+For now, i prefer to use mldonkey-server to start mlnet. Mldonkey server
 has a lot of very good reason to be use:
 - the code is very simple and short
 - it handle only start/stop and chuid of another process
@@ -51,14 +31,13 @@
 I think this method is reasonnably secure to run mlnet. I will keep it, until
 someone provide a good solution for mldonkey chrooting.
 
-
  -- Sylvain Le Gall <gildor at debian.org>  Sun, 17 Aug 2003 22:40:00 +0200
 
 Mick Kappenburg has created a script to create chroot for mldonkey. For now
 this script need more extensive testing, but i think it could be use to run
 more safely mldonkey.
 
-If this scripts works well enough, he will probably be integrated in the daemon 
+If this scripts works well enough, he will probably be integrated in the daemon
 start-stop script of mldonkey-server.
 
  -- Sylvain Le Gall <gildor at debian.org>  Sun, 05 Jun 2005 23:25:00 +0200
@@ -69,34 +48,32 @@
 *                               *
 ---------------------------------
 
-1. Native way
-
-1.1 Changing Password
+1 Changing Password
 
 MLDonkey natively support only two ways to set the password: through the GUI,
 through the telnet interface.
 
 To change the password through the telnet interface:
 - you log into the telnet interface with the former user/password
-- you change the password with the auth command. 
+- you change the password with the auth command.
 
   telnet>auth user old-passwd
   telnet>add_user user new-passwd
   telnet>auth user new-passwd
 
 You can also do the same through the GUI by providing at the beginning the
-old password in Files->Settings->Password, connect to the core, change the 
+old password in Files->Settings->Password, connect to the core, change the
 password in Files->Settings->Password.
 
-1.2 Default parameter
+2 Default parameter
 
-At the beginning only one user exist in the system: admin. The default 
+At the beginning only one user exist in the system: admin. The default
 password for this user is an empty string. In order to connect through the
 telnet interface, you nee to type:
 
   telnet>auth admin ""
-  
-To login through the GUI: 
+
+To login through the GUI:
 - Files->Settings->Password (empty)
 - Files->Settings->Password admin
 
@@ -104,32 +81,14 @@
 - User: admin
 - Password: (empty)
 
-1.3 Adding user
+3 Adding user
 
 There is only one way to add new user: through the telnet interface.  You
 need to invoke the command add_user. See help in the telnet interface about
 this command.
 
-2. Debian way
+ -- Sylvain Le Gall <gildor at debian.org>  Sun, 02 Sep 2003 00:22:00 +0200
 
-As part of utilities available in the debian package, the program mldonkey_users 
-enable to manipulate the user management system through the command line.
-
-You should use it with care: the system manipulate download.ini which is
-regularly updated by the mldonkey server, if this one is running.
-
-If you want to manipulate user/password, you need to stop your server, or to
-go back to native ways of managing user/password.
-
-Refer to mldonkey_users manpage.
-
-Important note: the default value of the debconf screen for password is an
-empty string.  If you leave an empty string for password, no password will be
-registered. It is a way of keeping old password, which could have been changed
-by other way than debconf.
-
- -- Sylvain Le Gall <gildor at debian.org>  Sun, 02 Sep 2003 00:22:00 +0200
- 
 ---------------------------------
 *                               *
 *     The FASTTRACK problem     *
@@ -139,7 +98,7 @@
 See FASSTRACK.
 
 In order to fix the problem coming with the FASTTRACK problem, i build the
-program called mldonkey_files. 
+program called mldonkey_files.
 
 This program permits you to filter the files.ini to extract Fasttrack sources.
 But you can also use with any other plugin:
@@ -147,83 +106,19 @@
   files.ini.fasttrack -f2 files.ini
 - for edonkey mldonkey_files --split Donkey -f0 files.ini -f1
   files.ini.edonkey -f2 files.ini
-...
 
  -- Sylvain Le Gall <gildor at debian.org>  Sun, 25 Sep 2003 00:33:00 +0200
 
----------------------------------------
-*                                     *
-* Notes for woody user && backporters *
-*                                     *
----------------------------------------
-
-The initial package was release for Sarge/Sid. It was not targeted to Woody.
-Regarding this it leads the packager to do certain choice, regarding the
-scripting possibility...
-
-I choose to use the command "stat" to get the owner of certains files. It was
-easy since stat belongs to coreutils in Sarge/Sid which is marked as
-essential. This means, i should not have any dependence on this package...
-
-In woody the situation is different: the arguments of the command are not the
-same, and the dependency to the package containing stat should be explicit. So
-if you are backporting or using mldonkey packages in Woody:
-
-- install coreutils from testing
-or 
-- install stat and edit the corresponding script ( config, /etc/init.d ... )
-
-If you have downloaded this package from a private repository, you should try
-to contact the maintainer from this repository to explain the situation.
- 
- -- Sylvain Le Gall <gildor at debian.org>  Sun, 01 Feb 2004 21:56:00 +0200
-
-If you try to use the init script of mldonkey, you should encounter problem
-with the option used for the nicelevel of start-stop-daemon. On woody system,
-it seems that you could only have a niceness of 0 set by this way.
-
-Use a niceness of 0 when using Woody start-stop-daemon.
-
- -- Sylvain Le Gall <gildor at debian.org>  Wed, 27 Apr 2005 23:35:36 +0200
-
 ----------------------
-* Note for upgrading *
+*                    *
+* GTK2 interface     *
+*                    *
 ----------------------
 
-From time to time upgrade is quite difficult. You could encounter errors like
-"Exception Not_found while handling ...". This generally means that there is
-problems concerning a certain pair of file you was downloading before the
-upgrade.
-
-You can try to reconstruct your database following this step:
-- delete the files.ini in you mldonkey dir
-- start mldonkey ( system wide or user )
-- go to the console ( GUI or telnet to the core ).
-- while authenticated, issue a command recover_temp
-
-This should build you a minimal file.ini.
-
-WARNING: this method is known not to be 100% safe. You can loose files, you
-can restart downloading et al. This command is not really reliable for
-everything. This command is know to work pretty well for ed2k and emule -- and
-very bad with bittorent.
-
-The best method is maybe to come back to an older version of mldonkey and try
-to get your download finished.
-
-More information:
-  http://mldonkey.berlios.de/modules.php?name=Wiki&pagename=recover_temp
-
- -- Sylvain Le Gall <gildor at debian.org>  Mon, 23 Aug 2004 01:07:07 +0200
-
-----------------------
-* GTK2 interface     *
-----------------------
-
-In order to make the new GTK2 interface to work, we need to use UTF 8
+In order to make the new GTK2 interface to work, we need to use UTF-8
 everywhere on the GUI side. This means in particular, you have to be sure that
-every strings in the GUI configuration file is UTF8 encoded. In particular,
-you need to be sure that your login/password are UTF 8 encoded.
+every strings in the GUI configuration file is UTF-8 encoded. In particular,
+you need to be sure that your login/password are UTF-8 encoded.
 
 So you have two choice:
 - use "iconv" to convert the file
@@ -234,7 +129,9 @@
  -- Sylvain Le Gall <gildor at debian.org>  Mon, 24 Aug 2004 23:23:00 +0200
 
 ----------------------
+*                    *
 * Force startup      *
+*                    *
 ----------------------
 
 Since the beginning of the package, a choice has been made to allow user to
@@ -258,7 +155,9 @@
  -- Sylvain Le Gall <gildor at debian.org>  Wed, 27 Apr 2005 23:35:36 +0200
 
 -----------------------
+*                     *
 * MLDonkey and groups *
+*                     *
 -----------------------
 
 MLDonkey cannot handle more than one group when running. This limitation is
@@ -266,7 +165,7 @@
 MLDonkey server will only be run using the user/primary group that is assigned
 to the MLDonkey user.
 
-For example: 
+For example:
 $ cat /etc/passwd | grep mldonkey
 mldonkey:x:102:1002::/var/lib/mldonkey:/bin/false
 $ cat /etc/group | grep mldonkey

Modified: trunk/packages/mldonkey/trunk/debian/changelog
URL: http://svn.debian.org/wsvn/pkg-ocaml-maint/trunk/packages/mldonkey/trunk/debian/changelog?rev=3740&op=diff
==============================================================================
--- trunk/packages/mldonkey/trunk/debian/changelog (original)
+++ trunk/packages/mldonkey/trunk/debian/changelog Tue May  8 11:19:34 2007
@@ -1,3 +1,10 @@
+mldonkey (2.8.5-2) unstable; urgency=low
+
+  * Removed mldonkey_users and mldonkey_server manpages and cleaned up
+    README.Debian, closes: #422581.
+
+ -- Samuel Mimram <smimram at debian.org>  Tue, 08 May 2007 13:08:23 +0200
+
 mldonkey (2.8.5-1) unstable; urgency=low
 
   * New upstream release.

Modified: trunk/packages/mldonkey/trunk/debian/mldonkey-server.manpages
URL: http://svn.debian.org/wsvn/pkg-ocaml-maint/trunk/packages/mldonkey/trunk/debian/mldonkey-server.manpages?rev=3740&op=diff
==============================================================================
--- trunk/packages/mldonkey/trunk/debian/mldonkey-server.manpages (original)
+++ trunk/packages/mldonkey/trunk/debian/mldonkey-server.manpages Tue May  8 11:19:34 2007
@@ -1,8 +1,5 @@
 debian/xml-man/mlnet.1
-debian/xml-man/mldonkey_server.1
 debian/xml-man/mldonkey_options.1
 debian/xml-man/mldonkey_command.1
 debian/xml-man/mldonkey_submit.1
-debian/xml-man/mldonkey_users.1
 debian/xml-man/mldonkey_files.1
-debian/xml-man/mldonkey_create_chroot.8




More information about the Pkg-ocaml-maint-commits mailing list