linuxdcpp-team team mailing list archive

[noreply@xxxxxxxxxxxxx]

------------------------------------------------------------
revno: 2235
committer: eMTee <emtee11@xxxxxxxxx>
branch nick: dcplusplus
timestamp: Sun 2010-09-05 18:52:38 +0200
message:
  [help] Connection setup changes
added:
  help/faq_connection.html
modified:
  help/faq_activemode.html
  help/faq_install.html
  help/faq_nosearch.html
  help/faq_university.html
  help/get_started.html
  help/index.html
  help/window_download_queue.html


--
lp:dcplusplus
https://code.launchpad.net/~dcplusplus-team/dcplusplus/trunk

Your team Dcplusplus-team is subscribed to branch lp:dcplusplus.
To unsubscribe from this branch go to https://code.launchpad.net/~dcplusplus-team/dcplusplus/trunk/+edit-subscription

=== modified file 'help/faq_activemode.html'
--- help/faq_activemode.html	2010-07-17 18:37:34 +0000
+++ help/faq_activemode.html	2010-09-05 16:52:38 +0000
@@ -63,7 +63,7 @@
 <i>ipconfig</i> (Start Menu -&gt; Run
 -&gt; <i>cmd /k ipconfig</i>)</li>
   <li>When you have mapped the port(s) on the router, open up DC++ and
-go to <a href="settings_connection.html">Connection Settings</a>. 
+go to <a href="settings_connection.html#connection">Incoming connection settings</a>. 
 Select <b>Manual port forwarding (I have configured my router by myself)</b>. In the port fields, enter the port
 number(s) that you forwarded on the router. </li>
   <li>In the External / WAN IP field, you need to enter the <b>external</b> IP address of your router.
@@ -93,13 +93,13 @@
  <a href="http://www.dynip.com/"; target="_blank"
  class="external">Dynip</a>  or <a
  href="http://www.dyndns.org/"; target="_blank" class="external">DynDns</a>
-    and put your dynamic DNS address into the External / WAN IP field in DC++ <a href="settings_connection.html">Connection Settings</a>. Each DDNS provider has a downloadable IP updater software what updates the dynamic name service with your latest IP. Make sure you download, configure and  run this program while using DC++. Many router models have DDNS client software included for specific DDNS provider(s) so it worth a check in your router configurations before choosing a provider. After you setup the built-in DDNS client you won't need to run any IP updater software, your router will automatically take care of updating your DNS name.</li>
+    and put your dynamic DNS address into the External / WAN IP field in DC++ <a href="settings_connection.html#connection">Connection Settings</a>. Each DDNS provider has a downloadable IP updater software what updates the dynamic name service with your latest IP. Make sure you download, configure and  run this program while using DC++. Many router models have DDNS client software included for specific DDNS provider(s) so it worth a check in your router configurations before choosing a provider. After you setup the built-in DDNS client you won't need to run any IP updater software, your router will automatically take care of updating your DNS name.</li>
 	<li>
 If you find that your internal IP changes when you restart your computer then your operating system is obtaining an IP address from your router at boot using <a href="http://www.portforward.com/networking/dhcp.htm"; target="_blank" class="external">DHCP protocol</a>. If you want your computer to always have the same internal IP address you must setup Static DHCP in your router configuration. Static DHCP is a useful feature which makes your router always assign the same IP address to a specific computer on your network. You will have to <a href="http://www.dur.ac.uk/its/services/network/lan/mac/windows/"; target="_blank" class="external">find MAC address of your network card</a> to set up Static DHCP.<br/>
 Another option to ensure you'll always have the same internal IP address is to set up static IP address for your computer. Here's a <a href="http://www.portforward.com/networking/staticip.htm"; target="_blank" class="external">FAQ</a> how to do this for different versions of Windows.
     </li>
 </ul>    
-<p>Besides normal file transfers DC++ is capable of <a href="settings_certs.html">secure</a> (<a href="http://en.wikipedia.org/wiki/Secure_Sockets_Layer"; target="_blank" class="external">SSL encrypted</a>) way of receiving and transmitting files on ADC hubs. If you plan (or required) to use this feature and you <i>use DC++ in active mode with manual port forwarding</i> you should forward one more port for SSL handshake. You must choose and forward another free port between 1024 - 65535 for TLS which is <b>different than the one(s) you use for TCP and UDP</b>. In the port forwarding rule you should set the protocol type to <b>TCP or Both</b> for the TLS port. Finally you must put the port number to the TLS field in <a href="settings_connection.html">Incoming connections settings</a> to be able to download from users who have secure transfers enabled.</p>
+<p>Besides normal file transfers DC++ is capable of <a href="settings_certs.html">secure</a> (<a href="http://en.wikipedia.org/wiki/Secure_Sockets_Layer"; target="_blank" class="external">SSL encrypted</a>) way of receiving and transmitting files on ADC hubs. If you plan (or required) to use this feature and you <i>use DC++ in active mode with manual port forwarding</i> you should forward one more port for SSL handshake. You must choose and forward another free port between 1024 - 65535 for TLS which is <b>different than the one(s) you use for TCP and UDP</b>. In the port forwarding rule you should set the protocol type to <b>TCP or Both</b> for the TLS port. Finally you must put the port number to the TLS field in <a href="settings_connection.html#connection">Incoming connections settings</a> to be able to download from users who have secure transfers enabled.</p>
 	
 
 <h2 id="firewall">Troubleshooting Windows built-in firewall</h2>

=== added file 'help/faq_connection.html'
--- help/faq_connection.html	1970-01-01 00:00:00 +0000
+++ help/faq_connection.html	2010-09-05 16:52:38 +0000
@@ -0,0 +1,89 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd";>
+<html xmlns="http://www.w3.org/1999/xhtml";>
+<head>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
+<link type="text/css" rel="stylesheet" href="office11.css"/>
+<link type="text/css" rel="stylesheet" href="style.css"/>
+</head>
+<body>
+
+<h1>How to set up connection manually?</h1>
+
+<p>In most cases DC++ should be able to automatically detect the appropriate
+connection method. This FAQ gives detailed information how to set up
+your incoming connection manually in case of the <a href="settings_connection.html">
+automatic detection</a> fails or its result isn't acceptable for you.</p>
+
+<p>Note that correct incoming connection settings are needed for searches and
+downloads to work. These settings have no effect on ability to connecting to hubs
+or downloading hublists. Before you go on with this FAQ make sure that you are
+able to download hublists and connect to hubs. If not then please follow 
+<a href="get_started.html#firewall">this guide</a> instead.</p>
+
+<p>To get the most out of DC++ you should find out what is the best connection
+mode for you. From a protocol perspective, there are two connection methods available:
+<b>active mode</b> and <b>passive mode</b>. While passive mode is almost guaranteed
+to work, it does not work as well as a properly configured active mode connection.
+For a more in-depth explanation, read <a href="faq_whyactive.html">
+Why do I need active mode?</a></p>
+
+<p>It is very important to decide what <i>active connection mode</i> is available
+for you. It depends on your network structure, so you need to know exactly how
+you access the Internet. Is it a direct connection through a modem or do you
+have a local network and access the Internet through a router or other gateway?
+If unsure, <a href="http://www.b.ali.btinternet.co.uk/DCPlusPlus/advancedUsage.html#activepassive"; target="_blank" class="external">this page</a> 
+should help you figure it out. </p>
+
+<p>If you're still unsure what network devices you use to connect to the Internet,
+then use <a href="http://www.google.com/"; target="_blank" class="external">Google</a>! It can give you
+information on every network device you own, just by searching for the <u>model
+number</u> printed on the device.  Many ISPs call their device a simple modem
+when it is actually a router, so it never hurts to check.</p>
+
+<p>In order to choose a proper active connection mode, you must know whether you
+are <i>behind a router or gateway</i> or if you <i>access the Internet
+directly</i>. You can also determine if you have a router or not by checking
+your <i>external</i> and <i>internal</i> IP addresses. If these IP addresses
+<b>do NOT match then you access the Internet through a local gateway or
+router</b>.</p>
+
+<ul> <li style="margin-left: 10px;">To see your <i>internal IP address</i> go
+to the Windows Start menu, click Run... and type : cmd /k ipconfig</li>
+
+<li style="margin-left: 10px;">To see your <i>external IP address</i> go to one
+of the following websites : <a href="http://www.whatismyip.com/"; target="_blank" class="external">www.whatismyip.com</a>, <a href="http://www.dslreports.com/ip"; target="_blank" class="external">www.dslreports.com/ip</a>, <a href="http://www.ip2location.com/"; target="_blank" class="external">www.ip2location.com</a></li> 
+</ul>
+
+<p>If you are still unsure you may want to consult your ISP support hotline or
+system administrator (if on an organization's network).</p>
+
+<p>To set up your connection manually you must uncheck <a href="settings_connection.html">
+Enable automatic connection type detection</a> in the Connection settings pane of the settings
+dialog. This will enable the whole <a href="settings_connection.html#connection">Incoming connection settings</a>
+group below so you can alter every connection related settings manually.</p>
+
+<p>When you look at the <a href="settings_connection.html#connection">Incoming connection settings</a>
+you will find 3 options for active mode and the last option for being passive
+as a last resort. For being active:</p>
+
+<ul>
+<li style="margin-left: 10px;">You can use the <i>My computer is directly connected 
+to Internet (no router)</i> option <b>ONLY if you don't have a router/gateway</b>.
+
+</li><li style="margin-left: 10px;">If you <b>have a router/gateway you can use ONLY
+the 2nd or the 3rd option</b> : <i>Use UPnP to let DC++ configure
+my router</i> or <i>Manual port forwarding (I have configured my router by myself)</i></li>
+
+</ul>
+
+<p>For setting up any of the three active mode options follow the <a href="faq_activemode.html">active mode setup FAQ</a>.</p>
+
+<p>If none of the above helped or you are not able to use active mode in your
+network (e.g. you have no access to the configuration page of the
+router/gateway or you have firewall service provided by your ISP) then you must
+choose <i>Passive mode (last resort - has serious limitations)</i> option in 
+<a href="settings_connection.html">Connection Settings</a>. As linked above,
+however, passive mode has several disadvantages.</p>
+
+</body>
+</html>

=== modified file 'help/faq_install.html'
--- help/faq_install.html	2010-01-16 15:01:05 +0000
+++ help/faq_install.html	2010-09-05 16:52:38 +0000
@@ -8,7 +8,7 @@
 <body>
 <h1>How do I install DC++?</h1>
 <p>
-Just run the installer and fire up DC++, then enter the settings to set it up according to your preferences (most important is <a href="settings_general.html">nick</a>, <a href="settings_connection.html">connection mode</a>, <a href="settings_downloads.html">download location</a> and <a href="settings_sharing.html">shared folders</a>). When using the installer, DC++ will store its settings and create the default downloads folder in the current user's profile folders.
+Just run the installer and fire up DC++, then enter the settings to set it up according to your preferences (most important is <a href="settings_general.html">nick</a>, <a href="settings_connection.html#connection">connection mode</a>, <a href="settings_downloads.html">download location</a> and <a href="settings_sharing.html">shared folders</a>). When using the installer, DC++ will store its settings and create the default downloads folder in the current user's profile folders.
 </p>
 <p>
 You can also download the .zip file (Binary, portable version) and unpack it to any folder you like. If you use the portable version, all the settings and the downloads folder will be stored in the directory where DC++ has been unpacked. You can configure DC++ to use another folder for settings by editing a file called dcppboot.xml located besides the DC++ executable. You can read more about the storage of settings and downloaded files in <a href="faq_settings_files.html">this FAQ</a>.

=== modified file 'help/faq_nosearch.html'
--- help/faq_nosearch.html	2008-11-13 16:27:41 +0000
+++ help/faq_nosearch.html	2010-09-05 16:52:38 +0000
@@ -34,7 +34,7 @@
 <ol>
   <li>If you use one of the active connection modes, enter your external 
   	<acronym title="Internet Protocol">IP</acronym> address
-to the <i>External/WAN IP</i> field in the <a href="settings_connection.html">
+to the <i>External/WAN IP</i> field in the <a href="settings_connection.html#connection">
 Connection settings dialog</a> and try to search again. 
 Find out the IP from <a href="http://www.dslreports.com/ip"; target="_blank"
  class="external">DSLReport's IP page</a>.</li>

=== modified file 'help/faq_university.html'
--- help/faq_university.html	2010-02-04 14:29:32 +0000
+++ help/faq_university.html	2010-09-05 16:52:38 +0000
@@ -63,7 +63,7 @@
 class="external">IANA recommendations</a>) may not allow all ports
 for incoming P2P transfers. In this case you need to choose any port within the
 region of 49152 - 65535 for the port fields in the 
-<a href="settings_connection.html">Connection Settings</a>. </p>
+<a href="settings_connection.html#connection">Connection Settings</a>. </p>
 <p>If you appear to be completely blocked from the DC network, the
 above advice applies.</p>
 </body>

=== modified file 'help/get_started.html'
--- help/get_started.html	2010-07-17 18:37:34 +0000
+++ help/get_started.html	2010-09-05 16:52:38 +0000
@@ -101,7 +101,7 @@
 
 <p>If you use Windows XP with third party software firewall installed then make 
 sure you have the <a href="http://support.microsoft.com/kb/283673"; target="_blank" class="external">internal Windows firewall disabled</a>. 
-On Vista and Windows 7 this should be always done by the external firewall application.
+On Vista and Windows 7 this should be automatically done by your 3rd party firewall application.
 </p>
 
 <p>The easiest way to check if DC++ is blocked is to go the Help/About menu in
@@ -113,7 +113,7 @@
 <p><a href="faq_activemode.html#firewall">Here are some tips</a> how to try to unblock DC++ in the built-in Windows firewall.</p>
 
 <p>The method for unblocking programs in 3rd party firewalls varies from product to product.
-Check your firewall's help or manual for instructions. The best practice is to
+Check your firewall's help or manual for instructions. The best general practice is to
 exit DC++ and remove ALL the rules for DC++ in the firewall configuration. In
 most cases the time of next start of DC++ you'll be shown a popup window where
 you can re-enable DC++. You can find configuration instructions for some
@@ -121,66 +121,25 @@
 
 <h2 id="connection">Setting up your connection</h2>
 
-<p>To make your life easier while using DC++ you should find out what connection
-mode works for you. From a protocol perspective, there are two connection
+<p>To make your life easier while using DC++ your connection must be set up correctly.
+In other words your incoming connection type must be correctly chosen for searches and
+downloads to work. The available connection modes depend on the structure of your network
+and the way you access the Internet. From a protocol perspective, there are two connection
 methods available: <b>active mode</b> and <b>passive mode</b>. While passive
 mode is almost guaranteed to work, it does not work as well as a properly
-configured active mode connection.  For a more in-depth explanation, read 
-<a href="faq_whyactive.html">Why do I need active mode?</a>
-</p>
-
-<p>It is very important to decide what <i>active connection mode</i> is available
-for you. It depends on your network structure, so you need to know exactly how
-you access the Internet. Is it a direct connection through a modem or do you
-have a local network and access the Internet through a router or other gateway?
-If unsure, <a href="http://www.b.ali.btinternet.co.uk/DCPlusPlus/advancedUsage.html#activepassive"; target="_blank" class="external">this page</a> 
-should help you figure it out. </p>
-
-<p>If you're still unsure what network devices you use to connect to the Internet,
-then use <a href="http://www.google.com/"; target="_blank" class="external">Google</a>! It can give you
-information on every network device you own, just by searching for the <u>model
-number</u> printed on the device.  Many ISPs call their device a simple modem
-when it is actually a router, so it never hurts to check.</p>
-
-<p>In order to choose a proper active connection mode, you must know whether you
-are <i>behind a router or gateway</i> or if you <i>access the Internet
-directly</i>. You can also determine if you have a router or not by checking
-your <i>external</i> and <i>internal</i> IP addresses. If these IP addresses
-<b>do NOT match then you access the Internet through a local gateway or
-router</b>.</p>
-
-<ul> <li style="margin-left: 10px;">To see your <i>internal IP address</i> go
-to the Windows Start menu, click Run... and type : cmd /k ipconfig</li>
-
-<li style="margin-left: 10px;">To see your <i>external IP address</i> go to one
-of the following websites : <a href="http://www.whatismyip.com/"; target="_blank" class="external">www.whatismyip.com</a>, <a href="http://www.dslreports.com/ip"; target="_blank" class="external">www.dslreports.com/ip</a>, <a href="http://www.ip2location.com/"; target="_blank" class="external">www.ip2location.com</a></li> 
-</ul>
-
-<p>If you are still unsure you may want to consult your ISP support hotline or
-system administrator (if on an organization's network).</p>
-
-<p>When you look at the <a href="settings_connection.html">Connection Settings</a>
-you will find 3 options for active mode and the last option for being passive
-as a last resort. For being active:</p>
-
-<ul>
-<li style="margin-left: 10px;">You can use the <i>My computer is directly connected 
-to Internet (no router)</i> option <b>ONLY if you don't have a router/gateway</b>.
-
-</li><li style="margin-left: 10px;">If you <b>have a router/gateway you can use ONLY
-the 2nd or the 3rd option</b> : <i>Use UPnP to let DC++ configure
-my router</i> or <i>Manual port forwarding (I have configured my router by myself)</i></li>
-
-</ul>
-
-<p>For setting up any of the three active mode options follow the <a href="faq_activemode.html">active mode setup FAQ</a>.</p>
-
-<p>If none of the above helped or you are not able to use active mode in your
-network (e.g. you have no access to the configuration page of the
-router/gateway or you have firewall service provided by your ISP) then you must
-choose <i>Passive mode (last resort - has serious limitations)</i> option in 
-<a href="settings_connection.html">Connection Settings</a>. As linked above,
-however, passive mode has several disadvantages.</p>
+configured active mode connection. For a more in-depth explanation, read
+<a href="faq_whyactive.html">Why do I need active mode?</a></p>
+
+<p>In most cases DC++ should be able to detect the appropriate connection method for you.
+The <a href="settings_connection.html">automatic connection type detection feature</a>
+is enabled by default and it tries to decide the best available connection mode at start.
+If you able to search and download from the users of the hubs you're connected to then
+you're done.</p>
+
+<p>If searches and/or downloads do not work then make sure that <a href="settings_connection.html">
+Enable automatic connection type detection</a> setting is enabled. If it doesn't help
+(or it forces you into passive mode and you want to improve your connectivity) then follow
+<a href="faq_connection.html">the FAQ that tells you how to set up connection manually in DC++.</a></p>
 
 <h2>Help resources</h2>
 <p>

=== modified file 'help/index.html'
--- help/index.html	2010-08-23 16:04:27 +0000
+++ help/index.html	2010-09-05 16:52:38 +0000
@@ -113,6 +113,7 @@
 <h3 id="faqs">Frequently Asked Questions</h3>
 <ul>
 <li><placeholder><a href="faq_whyactive.html">Why do I need active mode?</a></placeholder></li>
+<li><placeholder><a href="faq_connection.html">How to set up connection manually?</a></placeholder></li>
 <li><placeholder><a href="faq_activemode.html">How to set up active mode?</a></placeholder></li>
 <li><placeholder><a href="faq_upnp.html">How to set up UPnP?</a></placeholder></li>
 <li><placeholder><a href="faq_university.html">My ISP or University blocks DC++</a></placeholder></li>

=== modified file 'help/window_download_queue.html'
--- help/window_download_queue.html	2010-01-21 20:20:28 +0000
+++ help/window_download_queue.html	2010-09-05 16:52:38 +0000
@@ -62,7 +62,7 @@
   		<p>The file cannot be downloaded from the source at the moment. Either the user's filelist was outdated when this file was added to the queue or the user removed the file from his/her share since then.</p>
   	</li>	
   	<li><p><i>Passive user</i></p>
-  		<p>You can get this error only if you are in <a href="settings_connection.html">Passive connection mode</a>. The client of the given source is in passive mode, either and two <a href="faq_whyactive.html">passive users cannot download from each other</a>. The source will be used automatically if at least one of the peers <a href="faq_activemode.html">switches to Active mode</a>.</p>
+  		<p>You can get this error only if you are in <a href="settings_connection.html#connection">Passive connection mode</a>. The client of the given source is in passive mode, either and two <a href="faq_whyactive.html">passive users cannot download from each other</a>. The source will be used automatically if at least one of the peers <a href="faq_activemode.html">switches to Active mode</a>.</p>
   	</li>	
   	<li><p><i>CRC32 inconsistency (SFV-Check)</i></p>
   	<p>The file was downloaded but its CRC32 checksum does not match the checksum stored in an accompanying .sfv file. The file will be redownloaded from another source. You can disable this integrity check with the corresponding checkbox in <a href="settings_advanced.html#sfvcheck">Advanced settings</a>.</p>