From: Roger Dingledine <arma@torproject.org>
Date: Tue, 14 Feb 2017 08:52:01 +0000 (-0500)
Subject: give tor_version_parse_platform some function documentation
X-Git-Tag: tor-0.2.9.10~12^2~1^2
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=3c4da8a130e41b9096eef360c437cef3cd22a62c;p=thirdparty%2Ftor.git

give tor_version_parse_platform some function documentation
---

diff --git a/src/or/routerparse.c b/src/or/routerparse.c
index 28b9c57e4d..c4691b58ce 100644
--- a/src/or/routerparse.c
+++ b/src/or/routerparse.c
@@ -5512,9 +5512,14 @@ microdescs_parse_from_string(const char *s, const char *eos,
   return result;
 }
 
-/** Parse the Tor version of the platform string <b>platform</b>,
- * and compare it to the version in <b>cutoff</b>. Return 1 if
- * the router is at least as new as the cutoff, else return 0.
+/** Extract a Tor version from a <b>platform</b> line from a router
+ * descriptor, and place the result in <b>router_version</b>.
+ *
+ * Return 1 on success, -1 on parsing failure, and 0 if the
+ * platform line does not indicate some version of Tor.
+ *
+ * If <b>strict</b> is non-zero, finding any weird version components
+ * (like negative numbers) counts as a parsing failure.
  */
 int
 tor_version_parse_platform(const char *platform,
@@ -5552,6 +5557,7 @@ tor_version_parse_platform(const char *platform,
       return -1;
     }
   }
+
   return 1;
 }