doc/source/en/TortoiseGit/tsvn_dug/dug_settings_network.xml

   1 <?xml version="1.0" encoding="UTF-8"?>\r
   2 <!DOCTYPE sect2 SYSTEM "../../../dtd/dblite.dtd">\r
   3 <sect2 id="tsvn-dug-settings-network">\r
   4         <?dbhh topicname="HIDD_SETTINGSPROXY"?>\r
   5         <title>Network Settings</title>\r
   6         <indexterm>\r
   7                 <primary>proxy server</primary>\r
   8         </indexterm>\r
   9         <para>\r
  10                 <figure id="tsvn-dug-settings-dia-4">\r
  11                         <title>The Settings Dialog, Network Page</title>\r
  12                         <graphic fileref="../images/SettingsProxy.png"/>\r
  13                 </figure>\r
  14                 Here you can configure your proxy server, if you need one to get\r
  15                 through your company's firewall.\r
  16         </para>\r
  17         <para>\r
  18                 If you need to set up per-repository proxy settings, you will\r
  19                 need to use the Subversion <filename>servers</filename> file to\r
  20                 configure this. Use <guibutton>Edit</guibutton> to get there\r
  21                 directly. Consult the\r
  22                 <ulink url="http://svnbook.red-bean.com/en/1.5/svn.advanced.confarea.html">\r
  23                         <citetitle>Runtime Configuration Area</citetitle>\r
  24                 </ulink>\r
  25                 for details on how to use this file.\r
  26         </para>\r
  27         <para>\r
  28                 You can also specify which program TortoiseGit should use to\r
  29                 establish a secure connection to a svn+ssh repository.\r
  30                 We recommend that you use TortoisePlink.exe. This is a version\r
  31                 of the popular Plink program, and is included with TortoiseGit,\r
  32                 but it is compiled as a Windowless app, so you don't get a DOS\r
  33                 box popping up every time you authenticate.\r
  34         </para>\r
  35         <para>\r
  36                 You must specify the full path to the executable. For TortoisePlink.exe\r
  37                 this is the standard TortoiseGit bin directory. Use the\r
  38                 <guibutton>Browse</guibutton> button to help locate it.\r
  39                 Note that if the path contains spaces, you must enclose it in quotes,\r
  40                 e.g.\r
  41 <screen>\r
  42 "C:\Program Files\TortoiseGit\bin\TortoisePlink.exe"\r
  43 </screen>\r
  44         </para>\r
  45         <para>\r
  46                 One side-effect of not having a window is that there is\r
  47                 nowhere for any error messages to go, so if authentication\r
  48                 fails you will simply get a message saying something like\r
  49                 <quote>Unable to write to standard output</quote>.\r
  50                 For this reason we recommend that you first set up using\r
  51                 standard Plink. When everything is working, you can use\r
  52                 TortoisePlink with exactly the same parameters.\r
  53         </para>\r
  54         <para>\r
  55                 TortoisePlink does not have any documentation of its own because it\r
  56                 is just a minor variant of Plink. Find out about command line\r
  57                 parameters from the\r
  58                 <ulink url="http://www.chiark.greenend.org.uk/~sgtatham/putty/">\r
  59                         <citetitle>PuTTY website</citetitle>\r
  60                 </ulink>\r
  61         </para>\r
  62         <para>\r
  63                 To avoid being prompted for a password repeatedly, you might also\r
  64                 consider using a password caching tool such as Pageant. This is also\r
  65                 available for download from the PuTTY website.\r
  66         </para>\r
  67         <para>\r
  68                 Finally, setting up SSH on server and clients is a non-trivial process\r
  69                 which is beyond the scope of this help file. However, you can find a\r
  70                 guide in the TortoiseGit FAQ listed under\r
  71                 <ulink url="http://TortoiseGit.net/ssh_howto">\r
  72                         <citetitle>Subversion/TortoiseGit SSH How-To</citetitle>\r
  73                 </ulink>.\r
  74         </para>\r
  75 </sect2>\r