document what the workarounds do

* daemon/gvfsbackendftp.c:
document what the workarounds do

svn path=/trunk/; revision=2096

2 files changed, 12 insertions, 0 deletions

diff --git a/ChangeLog b/ChangeLog
index d082364e..32c7de42 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,10 @@
 2008-11-17  Benjamin Otte  <otte@gnome.org>
 
+	* daemon/gvfsbackendftp.c:
+	document what the workarounds do
+
+2008-11-17  Benjamin Otte  <otte@gnome.org>
+
 	* daemon/gvfsbackendftp.c: (ftp_connection_prepare),
 	(ftp_connection_use):
 	If feat before login fails, try it again after login. (fixes bug
diff --git a/daemon/gvfsbackendftp.c b/daemon/gvfsbackendftp.c
index 23234224..5a133e79 100644
--- a/daemon/gvfsbackendftp.c
+++ b/daemon/gvfsbackendftp.c
@@ -109,8 +109,15 @@ typedef enum {
 } FtpSystem;
 
 typedef enum {
+  /* Server advertises support for EPSV (or we assume that it supports it),
+   * but it does fail to do so, we set this flag so we can fall back to 
+   * PASV. */
   FTP_WORKAROUND_BROKEN_EPSV = (1 << 0),
+  /* Server replies with a wrong address in PASV, we use connection IP 
+   * instead */
   FTP_WORKAROUND_PASV_ADDR = (1 << 1),
+  /* server does not allow querying features before login, so we try after
+   * logging in instead. */
   FTP_WORKAROUND_FEAT_AFTER_LOGIN = (1 << 2),
 } FtpWorkarounds;