home *** CD-ROM | disk | FTP | other *** search
/ Chip 2005 February / CMCD0205.ISO / Software / Freeware / Comunicatii / dcplus / DCPlusPlus-0.668.exe / readme.txt < prev    next >
Text File  |  2004-10-05  |  15KB  |  299 lines
  1. DC++ Readme
  2.  
  3. --------------------------------------------------
  4. DC++
  5. Copyright (C) 2001-2004 Jacek Sieka, j_s at telia com
  6.  
  7. License
  8.  
  9. This program is licensed under GPL-2 with the notable exception
  10. that you may compile it with WTL when redistributing binaries. 
  11. You can find the full text of the license in license.txt that
  12. should have been distributed with the rest of the application.
  13.  
  14. This program is free software; you can redistribute it and/or modify
  15. it under the terms of the GNU General Public License as published by
  16. the Free Software Foundation; either version 2 of the License, or
  17. (at your option) any later version.
  18.  
  19. This program is distributed in the hope that it will be useful,
  20. but WITHOUT ANY WARRANTY; without even the implied warranty of
  21. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  22. GNU General Public License for more details.
  23.  
  24. You should have received a copy of the GNU General Public License
  25. along with this program; if not, write to the Free Software
  26. Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
  27.  
  28. Magnet.exe is licensed under the Apache License.
  29. Full license text: http://www.apache.org/licenses/LICENSE-2.0
  30. Project Home Page: http://sourceforge.net/projects/magnethandler
  31.  
  32. GeoIP database Copyright (c) 2003 MaxMind LLC.  All Rights Reserved.
  33. This product includes GeoIP data created by MaxMind, available from
  34. http://maxmind.com/
  35.  
  36. --------------------------------------------------
  37.  
  38. This Readme will give you a quick startup guide and explain some features
  39. that are NOT obvious :)
  40. So this is especially for NMDC upgraders.
  41. Newbies should (also) check out the web site, http://dcplusplus.sourceforge.net
  42. There you can also find a FAQ (Frequenty Asked Questions) and a forum
  43. (http://dcplusplus.sf.net/forum).
  44.  
  45. Contents
  46. ----------
  47.  1 Installation
  48.  2 Upgrade
  49.  3 Uninstall
  50.  4 Available commands (type in main chat or pm)
  51.  5 What do those Icons mean ??
  52.  6 Not-so-obvious options
  53.  7 Other things you might want to know about
  54.  8 Shortcuts
  55.  9 Automatic search for alternative download locations
  56. 10 Further information
  57. 11 Have fun
  58.  
  59.  
  60.  1 Installation
  61. -----------------
  62.  
  63.   Just run the installer and fire it up, then enter the settings to set it up according to your
  64.   preferences (most important is nick, download location and shared folders).
  65.  
  66.   version without installer available at http://sourceforge.net/projects/dcplusplus
  67.  
  68.  2 Upgrade
  69. ------------
  70.   If u used NMDC: You can import your queue file now !
  71.   If u used older DC++ version:
  72.    Just install in the folder your old version was in.
  73.    Your old settings will still be there as is your queue.
  74.  
  75.   BEWARE: Old (ver <= 0.163) Notepad notes will get lost, format change in 0.17
  76.   BEWARE: If you upgrade to 0.22, all old queue items that are missing a directory in the
  77.   target file-name will be removed. Don't upgrade if your queue is precious to you, and you didn't have
  78.   anything in the default download directory box in the settings (finish it with version 0.181
  79.   or edit your queue.xml file and add a directory to all targets without...).
  80.  
  81.  3 Uninstall
  82. --------------
  83.   There is an uninstaller as well ...
  84.   If you didn't use the installer: Just delete the folder, there are no .dll's or registry settings :)
  85.  
  86.  4 Available commands (type in main chat or pm)
  87. -------------------------------------------------
  88.   /grant            grants a slot to the user of the pm window you type in
  89.   /close            close current window
  90.   /help             short help message
  91.   /refresh          Refreshes list of shared files :)
  92.   /away <message>   Specifies a message to auto-respond in PM's while you're AFK
  93.                      (there's a default message so you don't need to specify one)
  94.   /back             Turn away message off
  95.   /slots <#>        Changes number of slots to <#>
  96.   /clear            Clears the main chat windows
  97.   /ts               Switches timestamps in chat windows on and off
  98.   /showjoins        Toggles joins/parts messages for the current hub
  99.   /favshowjoins     Toggles joins/parts messages of favorite users for the current hub
  100.                      (requires showjoins to be enabled)
  101.   /search <string>  Searches for <string>
  102.   /join <hub>       Joins <hub>
  103.   /dc++             Gives a comment about DC++ and shows the URL where
  104.                      you can get it
  105.   /fav /favorite    Adds hub to favourites (also works in pm's from that user)
  106.  
  107.  5 What do those Icons mean ??
  108. --------------------------------
  109.  green       = normal Icon
  110.  blue        = DC++ user (identified on 1st direct connection to this user)
  111.  with bricks = User is in passive mode
  112.  with key    = User is an Operator
  113.  
  114.  6 Not-so-obvious options
  115. ---------------------------
  116.   Settings:
  117.    General:
  118.     Active:              The usual connection mode, you can specify your IP
  119.                           if detection fails and a port of your choice if you need to.
  120.                           This mode will use a random port between 1025 and 32000
  121.                           chosen anew on restart if nothing is set in settings.
  122.     Passive:             Compatibility connection mode for users behind
  123.                           Firewalls they can't change to let DC++
  124.                           connections trough.
  125.                          Only use this if Active is not working.
  126.                          Note: Passive <-> Passive connections aren't possible.
  127.    Downloads:
  128.     Unfinished files temporary directory:    You can specify a Directory for your
  129.                          partial files here, suggestion si to have it on another
  130.                          partition than the "Default download directory" to have
  131.                          the files defragmented through moving there :)
  132.     Download slots:      Maximum number of Downloads runing at once, suggestion
  133.                          is to set it to the same number as your upload slots
  134.    Sharing:
  135.     Upload slots:        The number of maximum simultaneous uploads, set to a reasonable
  136.                           value; you should have at least 4-5 KB/s uplaod speed per slot.
  137.    Appearance:
  138.     Use system icons:    Displays the icons set in Windows for filetypes
  139.     Language File:       A XML-file containing most of the text used in DC++.
  140.                           You can specify a file to have DC++ in your favourite language.
  141.                           There's an example.xml if you want to make your own.
  142.                           Language files available at http://DCPlusPlus.sourceforge.net
  143.    Logs and Sound:
  144.     Log Downloads:       You can use this feature to see what downloads
  145.                           completed while you were AFK :)
  146.     Parameters for the logging (the things in %[xxx]):
  147.      target         target filename (for downloads)
  148.      source         source filename (for uploads)
  149.      user           nick
  150.      hub            hub name
  151.      hubip          hub ip
  152.      size           size of the file
  153.      sizeshort      size in b/kB/MB/GB (short version)
  154.      chunksize      size downloaded this session (if resuming, otherwise the same as size)
  155.      chunksizeshort ...
  156.      speed          speed of download
  157.      time           time to download (hh:mm:ss format)
  158.      sfv            1 if the file was sfv/crc32 checked, 0 otherwise
  159.      tth            base32 representation of the tiger tree root hash
  160.    
  161.     You can also use all date and time parameters (%Y, %m, ...) of strftime (google for it).
  162.  
  163.  
  164.    Advanced:
  165.     Rollback:            Size of bytes to rollback when resuming a file to
  166.                           ensure it contains no errors.
  167.                          If there is an error DC++ deletes <rollback>
  168.                           bytes and checks again.
  169.     Write buffer size:   Anti-fragmentation feature, DC++ saves every
  170.                           <write buffer size> bytes to keep fragmentation low.
  171.     Client version:      Since most hubs specify a min client version that
  172.                           is much higher than DC++'s real version number you
  173.                           can set something here, i suggest adding 1 to version
  174.                           number e.g. 1.181
  175.                          to be able to enter the hub.
  176.     Automatically search for alternate download locations:  Allows DC++ to try
  177.                           to find other locations to download your files.
  178.                           Useful if you're AFK a lot.
  179.     Install URL handler on startup:     Set if you want URLS of type dchub://
  180.                          to open in DC++
  181.     Use small send buffer:    If uploads slow down your downloads A LOT you may
  182.                          try this option, but beware it increases HD usage and
  183.                          slows down upload, so it's not suggested.
  184.     Enable SFV checking: Many downloads on DC contain an sfv file to check the integrity of
  185.                          a download. DC++ can on-the-fly calculate CRC-32 values for
  186.                          a file and compare it agains the sfv file. If the check fails,
  187.                          the file is automatically downloaded once more from the same user
  188.                          and if that fails, the user is removed as a source. For this to work,
  189.                          the .sfv file must be in the same target directory as the download goes.
  190.  
  191.  7 Other things you might want to know about
  192. ----------------------------------------------
  193.   * you can doubleclick on a user name in chat to select him in the user list
  194.   * you can doubleclick on stuff starting with www. http:// of ftp:// to open :)
  195.   * DC++ supports uploading filelists and files <64 kB to other DC++ users
  196.     WITHOUT REQUIRING A SLOT. There's a max of 3 connections in addition to
  197.     normal slots.
  198.   * Files <64 kB and filelists are downloaded first.
  199.   * There is information added to the description field:
  200.     <++ V:x,M:x,H:x/y/z,S:x[,O:x]> where
  201.      V = client version,
  202.      M = mode (a=active, p=passive),
  203.      H: x = number of hubs connected to where you're not a registered user
  204.         y = number of hubs you're registered in
  205.         z = number of hubs you're registered as op
  206.      S = number of slots you have open.
  207.      O = if total upload is below this value DC++ will open another slot
  208.          this part of the tag is only shown when the option for it is enabled
  209.      This is updated every 1-2 minutes if there are changes.
  210.   * There is a limit so that only 15 users and 1 op can be kicked at a time
  211.     from the hub user list
  212.   * Passive user detection, those that are behind a set of bricks are passive.
  213.     (detected when the user searches or tries to connect to you)
  214.   * DC++ user detection, those appear blue.
  215.   * Dupe file removal, files with same name and size are automatically removed
  216.     from your share
  217.   * Search flood detection (If more than 5 searches are received from the same
  218.     user within 7 seconds, DC++ will send out a warning)
  219.   * if a user leaves the hub DC++ will close his slots, if the user is back within 10 minutes
  220.     DC++ will grant him a slot.
  221.     THIS CAN CAUSE YOUR UPLOAD GOING OVER MAXIMUM SET IN SETTINGS
  222.   * filelist will be recreated if missing on request
  223.   * optional SFV will remove and requeue file if check failed
  224.   * If DC++ receives "banned" during the login phase, it'll stop automatically reconnecting
  225.   * Files containing "$" aren't added to share 'cause they won't be downloadable alter on.
  226.     This is a protocol limitation ....
  227.  
  228.  
  229.  8 Shortcuts
  230. --------------
  231.   ALT-s   send chat message
  232.  
  233.  
  234.  9 Automatic search for alternative download locations
  235. --------------------------------------------------------
  236. An automatic search (the advanced option "Automatically search for 
  237. alternative download locations") will use the search string defined in the 
  238. download queue and it can be changed by the user. Previously (before 
  239. v0.301) the search used the target filename. A good search string is the 
  240. key to find many sources. If the search string is empty there will be no 
  241. search. The search string is also used when manually searching for alternates.
  242.  
  243. You can change the search string for many files at once, which is good for 
  244. rar sets. However, a client will return at most 10 results on a search, 5 
  245. if you are passive, and trying to alter the search string for more than 
  246. those numbers will give you a warning.
  247.  
  248. The option in advanced settings below auto-search "Automatically add search 
  249. string for alternative download locations" will automatically set the 
  250. target file name as search string when adding files to the download queue.
  251.  
  252. Since v0.301 the auto search will also search for items in the download 
  253. queue which have online users. Previously only items with offline users 
  254. were searched and lead people to believe auto search was not working at 
  255. all. This feature comes at a cost though. The delay between searches for 
  256. items with online users is 5 minutes whereas searches for items with no 
  257. online users is done every other minute. No search will be made for an item 
  258. which has a source from whom you are already downloading a different file 
  259. from. A file will be searched for no more than once per hour, so if you 
  260. only have one item in the download queue it will take one hour between 
  261. searches.
  262.  
  263. What does "Automatically search for alternative download locations" do when 
  264. no search strings are set? It will automatically match any search results 
  265. coming from manual searches against files in the download queue. So 
  266. basically it saves you the trouble of right-clicking every file you want to 
  267. add as an alternate source.
  268.  
  269. Example search string for rar sets:
  270. Files abc-cd1.r01 to abc-cd1.r09 can have the same search string set to 
  271. "abc-cd1.r0" (passive users will only get 5 files returned so one search 
  272. string per file, like "abc-cd1.r01"). But don't set it to "abc .r0" or 
  273. something similar, this will give you rar files for CD2 as well. If you 
  274. don't have sfv checking enabled (the advanced option "Enable automatic SFV 
  275. checking") you can end up with the right files in the wrong place. This 
  276. search for rar sets is so good that it's even better (at least less time 
  277. consuming) than doing it yourself with manual searches and getting 
  278. filelists and use match queue. It gives you 10 files at once, even if there 
  279. are online users.
  280.  
  281. That pretty much covers it.
  282.  
  283. Thanks Lundis for the first draft of this feature description and 
  284. suggesting and testing of the enhanced auto search in the first place.
  285.  
  286.  
  287. 10 Further information
  288. ------------------------
  289.   * Homepage                  @ http://dcplusplus.sourceforge.net
  290.   * Forum                     @ http://dcplusplus.sourceforge.net/forum
  291.   * Report bugs               @ http://dcplusplus.sourceforge.net/bugs
  292.   * Request features          @ http://dcplusplus.sourceforge.net/bugs
  293.   * Download language files   @ http://sourceforge.net/tracker/?atid=460289&group_id=40287&func=browse
  294.   * Get newest version        @ http://dcplusplus.sourceforge.net/index.php?t=2&s=1
  295.   * Typos and errors in readme go to Fireball@enLightning.de
  296.  
  297. 11 Have fun
  298. -------------
  299.   Go out, share some files, be a happy DC++ user and have fun.