From fbae3e923a4d8a98b896a818c64a4ad0f546fafd Mon Sep 17 00:00:00 2001
From: zzz <zzz@i2pmail.org>
Date: Sat, 8 Jan 2022 15:26:30 -0500
Subject: [PATCH] i2pcontrol: Add i2pd compatibility notes

---
 i2p2www/pages/site/docs/api/i2pcontrol.html | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/i2p2www/pages/site/docs/api/i2pcontrol.html b/i2p2www/pages/site/docs/api/i2pcontrol.html
index e3cf09b9..4fc759b9 100644
--- a/i2p2www/pages/site/docs/api/i2pcontrol.html
+++ b/i2p2www/pages/site/docs/api/i2pcontrol.html
@@ -119,7 +119,10 @@ Parameters are only provided in a named way (maps).
 	</ul>
 	<ul>{{ _('Response:') }}
 		<li>**i2p.router.status &ndash; [String] {% trans %}What the status of the router is.{% endtrans %}</li>
-		<li>**i2p.router.uptime &ndash; [long] {% trans %}What the uptime of the router is in ms.{% endtrans %}</li>
+		<li>**i2p.router.uptime &ndash; [long] {% trans %}What the uptime of the router is in ms.{% endtrans %}
+			Note: i2pd routers prior to version 2.41 returned this value as a string.
+			For compatibility, clients should handle both string and long.
+		</li>
 		<li>**i2p.router.version &ndash; [String] {% trans %}What version of I2P the router is running.{% endtrans %}</li>
 		<li>**i2p.router.net.bw.inbound.1s &ndash; [double] {% trans %}The 1 second average inbound bandwidth in Bps.{% endtrans %}</li>
 		<li>**i2p.router.net.bw.inbound.15s &ndash; [double] {% trans %}The 15 second average inbound bandwidth in Bps.{% endtrans %}</li>
@@ -190,6 +193,10 @@ Parameters are only provided in a named way (maps).
 		<li>Token &ndash; [String] {% trans %}Token used for authenticating the client. Is provided by the server via the 'Authenticate' RPC method. If null is submitted, current setting will be returned.{% endtrans %}</li>
 	</ul>
 	<ul>{{ _('Response:') }}
+		<li>
+			Note: i2pd routers prior to version 2.41 returned some of these values as numbers.
+			For compatibility, clients should handle both strings and numbers.
+		</li>
 		<li>**i2p.router.net.ntcp.port &ndash; [String] {% trans %}If requested, returns the port used for the TCP transport.{% endtrans %}</li>
 		<li>**i2p.router.net.ntcp.hostname &ndash; [String] {% trans %}If requested, returns the hostname used for the TCP transport.{% endtrans %}</li>
 		<li>**i2p.router.net.ntcp.autoip &ndash; [String] {% trans %}If requested, returns the method used for automatically detecting ip for the TCP transport.{% endtrans %}</li>