home *** CD-ROM | disk | FTP | other *** search
/ PC World 2003 December / PCWorld_2003-12_cd.bin / Komunik / dc / DCPlusPlus-0.301.exe / $_14326_ / readme.txt < prev    next >
Text File  |  2003-07-15  |  11KB  |  228 lines
  1. DC++ 0.24 Readme
  2.  
  3. --------------------------------------------------
  4. DC++
  5. Copyright (C) 2001-2003 Jacek Sieka, jacek@creatio.se
  6.  
  7. License
  8.  
  9. This program is free software; you can redistribute it and/or modify
  10. it under the terms of the GNU General Public License as published by
  11. the Free Software Foundation; either version 2 of the License, or
  12. (at your option) any later version.
  13.  
  14. This program is distributed in the hope that it will be useful,
  15. but WITHOUT ANY WARRANTY; without even the implied warranty of
  16. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17. GNU General Public License for more details.
  18.  
  19. You should have received a copy of the GNU General Public License
  20. along with this program; if not, write to the Free Software
  21. Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
  22. --------------------------------------------------
  23.  
  24. This Readme will give you a quick startup guide and explain some features
  25. that are NOT obvious :)
  26. So this is especially for NMDC upgraders.
  27. Newbies should (also) check out the web site, http://dcplusplus.sourceforge.net
  28. There you can also find a FAQ (Frequenty Asked Questions) and a forum
  29. (http://dcplusplus.sf.net/forum).
  30.  
  31. Contents
  32. --------
  33.  1 Installation
  34.  2 Upgrade
  35.  3 Uninstall
  36.  4 Available commands (type in main chat or pm)
  37.  5 What do those Icons mean ??
  38.  6 Not-so-obvious options
  39.  7 Other things you might want to know about
  40.  8 Shortcuts
  41.  9 Further information
  42. 10 Have fun
  43.  
  44.  
  45.  1 Installation
  46. ---------------
  47.  
  48.   Just run the installer and fire it up, then enter the settings to set it up according to your
  49.   preferences (most important is nick, download location and shared folders).
  50.  
  51.   version without installer available at http://sourceforge.net/projects/dcplusplus
  52.  
  53.  2 Upgrade
  54. ----------
  55.   If u used NMDC: You can import your queue file now !
  56.   If u used older DC++ version:
  57.    Just install in the folder your old version was in.
  58.    Your old settings will still be there as is your queue.
  59.  
  60.   BEWARE: Old (ver <= 0.163) Notepad notes will get lost, format change in 0.17
  61.   BEWARE: If you upgrade to 0.22, all old queue items that are missing a directory in the
  62.   target file-name will be removed. Don't upgrade if your queue is precious to you, and you didn't have
  63.   anything in the default download directory box in the settings (finish it with version 0.181
  64.   or edit your queue.xml file and add a directory to all targets without...).
  65.  
  66.  3 Uninstall
  67. ------------
  68.   There is an uninstaller as well ...
  69.   If you didn't use the installer: Just delete the folder, there are no .dll's or registry settings :)
  70.  
  71.  4 Available commands (type in main chat or pm)
  72. ----------------------------------------
  73.   /grant            grants a slot to the user of the pm window you type in
  74.   /close            close current window
  75.   /help             short help message
  76.   /refresh          Refreshes list of shared files :)
  77.   /away <message>   Specifies a message to auto-respond in PM's while you're AFK
  78.                      (there's a default message so you don't need to specify one)
  79.   /back             Turn away message off
  80.   /slots <#>        Changes number of slots to <#>
  81.   /clear            Clears the main chat windows
  82.   /ts               Switches timestamps in chat windows on and off
  83.   /showjoins        Toggles joins/parts messages for the current hub
  84.   /search <string>  Searches for <string>
  85.   /join <hub>       Joins <hub>
  86.   /dc++             Gives a comment about DC++ and shows the URL where
  87.                      you can get it
  88.   /fav /favorite    Adds hub to favourites (also works in pm's from that user)
  89.  
  90.  5 What do those Icons mean ??
  91. -----------------------------
  92.  green       = normal Icon
  93.  blue        = DC++ user (identified on 1st direct connection to this user)
  94.  with bricks = User is in passive mode
  95.  with key    = User is an Operator
  96.  
  97.  6 Not-so-obvious options
  98. ------------------------
  99.   Settings:
  100.    General:
  101.     Active:              The usual connection mode, you can specify your IP
  102.                           if detection fails and a port of your choice if you need to.
  103.                           This mode will use a random port between 1025 and 32000
  104.                           chosen anew on restart if nothing is set in settings.
  105.     Passive:             Compatibility connection mode for users behind
  106.                           Firewalls they can't change to let DC++
  107.                           connections trough.
  108.                          Only use this if Active is not working.
  109.                          Note: Passive <-> Passive connections aren't possible.
  110.    Downloads:
  111.     Unfinished files temporary directory:    You can specify a Directory for your
  112.                          partial files here, suggestion si to have it on another
  113.                          partition than the "Default download directory" to have
  114.                          the files defragmented through moving there :)
  115.     Download slots:      Maximum number of Downloads runing at once, suggestion
  116.                          is to set it to the same number as your upload slots
  117.    Sharing:
  118.     Upload slots:        The number of maximum simultaneous uploads, set to a reasonable
  119.                           value; you should have at least 4-5 KB/s uplaod speed per slot.
  120.    Appearance:
  121.     Use system icons:    Displays the icons set in Windows for filetypes
  122.     Language File:       A XML-file containing most of the text used in DC++.
  123.                           You can specify a file to have DC++ in your favourite language.
  124.                           There's an example.xml if you want to make your own.
  125.                           Language files available at http://DCPlusPlus.sourceforge.net
  126.    Logs and Sound:
  127.     Log Downloads:       You can use this feature to see what downloads
  128.                           completed while you were AFK :)
  129.     Parameters for the logging (the things in %[xxx]):
  130.      target         target filename (for downloads)
  131.      source         source filename (for uploads)
  132.      user           nick
  133.      hub            hub name
  134.      hubip          hub ip
  135.      size           size of the file
  136.      sizeshort      size in b/kB/MB/GB (short version)
  137.      chunksize      size downloaded this session (if resuming, otherwise the same as size)
  138.      chunksizeshort ...
  139.      speed          speed of download
  140.      time           time to download (hh:mm:ss format)
  141.      sfv            1 if the file was sfv/crc32 checked, 0 otherwise
  142.    
  143.     You can also use all date and time parameters (%Y, %m, ...) of strftime (google for it).
  144.  
  145.  
  146.    Advanced:
  147.     Rollback:            Size of bytes to rollback when resuming a file to
  148.                           ensure it contains no errors.
  149.                          If there is an error DC++ deletes <rollback>
  150.                           bytes and checks again.
  151.     Write buffer size:   Anti-fragmentation feature, DC++ saves every
  152.                           <write buffer size> bytes to keep fragmentation low.
  153.     Client version:      Since most hubs specify a min client version that
  154.                           is much higher than DC++'s real version number you
  155.                           can set something here, i suggest adding 1 to version
  156.                           number e.g. 1.181
  157.                          to be able to enter the hub.
  158.     Automatically search for alternate download locations:  Allows DC++ to try
  159.                           to find other locations to download your files.
  160.                           Useful if you're AFK a lot.
  161.     Install URL handler on startup:     Set if you want URLS of type dchub://
  162.                          to open in DC++
  163.     Use small send buffer:    If uploads slow down your downloads A LOT you may
  164.                          try this option, but beware it increases HD usage and
  165.                          slows down upload, so it's not suggested.
  166.     Enable SFV checking: Many downloads on DC contain an sfv file to check the integrity of
  167.                          a download. DC++ can on-the-fly calculate CRC-32 values for
  168.                          a file and compare it agains the sfv file. If the check fails,
  169.                          the file is automatically downloaded once more from the same user
  170.                          and if that fails, the user is removed as a source. For this to work,
  171.                          the .sfv file must be in the same target directory as the download goes.
  172.  
  173.  7 Other things you might want to know about
  174. --------------------------------------------
  175.   * you can doubleclick on a user name in chat to select him in the user list
  176.   * you can doubleclick on stuff starting with www. http:// of ftp:// to open :)
  177.   * DC++ supports uploading filelists and files <16 kB to other DC++ users
  178.     WITHOUT REQUIRING A SLOT. There's a max of 3 connections in addition to
  179.     normal slots.
  180.   * Files <16 kB and filelists are downloaded first.
  181.   * There is information added to the description field:
  182.     <++ V:x,M:x,H:x/y/z,S:x[,O:x]> where
  183.      V = client version,
  184.      M = mode (a=active, p=passive),
  185.      H: x = number of hubs connected to where you're not a registered user
  186.         y = number of hubs you're registered in
  187.         z = number of hubs you're registered as op
  188.      S = number of slots you have open.
  189.      O = if total upload is below this value DC++ will open another slot
  190.          this part of the tag is only shown when the option for it is enabled
  191.      This is updated every 1-2 minutes if there are changes.
  192.   * There is a limit so that only 15 users and 1 op can be kicked at a time
  193.     from the hub user list
  194.   * Passive user detection, those that are behind a set of bricks are passive.
  195.     (detected when the user searches or tries to connect to you)
  196.   * DC++ user detection, those appear blue.
  197.   * Dupe file removal, files with same name and size are automatically removed
  198.     from your share
  199.   * Search flood detection (If more than 5 searches are received from the same
  200.     user within 7 seconds, DC++ will send out a warning)
  201.   * if a user leaves the hub DC++ will close his slots, if the user is back within 10 minutes
  202.     DC++ will grant him a slot.
  203.     THIS CAN CAUSE YOUR UPLOAD GOING OVER MAXIMUM SET IN SETTINGS
  204.   * filelist will be recreated if missing on request
  205.   * optional SFV will remove and requeue file if check failed
  206.   * If DC++ receives "banned" during the login phase, it'll stop automatically reconnecting
  207.   * Files containing "$" aren't added to share 'cause they won't be downloadable alter on.
  208.     This is a protocol limitation ....
  209.  
  210.  
  211.  8 Shortcuts
  212. -----------
  213.   ALT-s   send chat message
  214.  
  215.  
  216.  9 Further information
  217. ------------------------
  218.   * Homepage                  @ http://dcplusplus.sourceforge.net
  219.   * Forum                     @ http://dcplusplus.sourceforge.net/forum
  220.   * Report bugs               @ http://sourceforge.net/tracker/?atid=427632&group_id=40287&func=browse
  221.   * Request features          @ http://sourceforge.net/tracker/?atid=427635&group_id=40287&func=browse
  222.   * Download language files   @ http://dcplusplus.sourceforge.net/index.php?page=download
  223.   * Get newest version        @ http://dcplusplus.sourceforge.net/index.php?page=download
  224.   * Typos and errors in readme go to Fireball@enLightning.de
  225.  
  226. 10 Have fun
  227. ----------
  228.   Go out, share some files, be a happy DC++ user and have fun.