From 109e58cf7529c3c172ba8fba9aba8de2e8da0015 Mon Sep 17 00:00:00 2001
From: J08nY <J08nY@users.noreply.github.com>
Date: Wed, 15 Jun 2016 13:32:12 +0200
Subject: [PATCH] Classref: Added docs for StreamPeer* (#5216)

(cherry picked from commit cffdc52482b12db0fec62a49680a350734cc5c6b)
---
 core/io/stream_peer.cpp |  1 -
 doc/base/classes.xml    | 47 +++++++++++++++++++++++++++++++++++++++++
 2 files changed, 47 insertions(+), 1 deletion(-)

diff --git a/core/io/stream_peer.cpp b/core/io/stream_peer.cpp
index 2a9dff86f8a..306e7d8c9d1 100644
--- a/core/io/stream_peer.cpp
+++ b/core/io/stream_peer.cpp
@@ -357,7 +357,6 @@ String StreamPeer::get_string(int p_bytes){
 String StreamPeer::get_utf8_string(int p_bytes){
 
 	ERR_FAIL_COND_V(p_bytes<0,String());
-	ERR_FAIL_COND_V(p_bytes<0,String());
 
 	Vector<uint8_t> buf;
 	buf.resize(p_bytes);
diff --git a/doc/base/classes.xml b/doc/base/classes.xml
index 4df05881326..ab25c18b06b 100644
--- a/doc/base/classes.xml
+++ b/doc/base/classes.xml
@@ -34532,150 +34532,175 @@ This method controls whether the position between two cached points is interpola
 			<return type="int">
 			</return>
 			<description>
+			Return the amount of bytes this [StreamPeer] has available.
 			</description>
 		</method>
 		<method name="set_big_endian">
 			<argument index="0" name="enable" type="bool">
 			</argument>
 			<description>
+			Set this [StreamPeer] to use big-endian format. Default is false.
 			</description>
 		</method>
 		<method name="is_big_endian_enabled" qualifiers="const">
 			<return type="bool">
 			</return>
 			<description>
+			Return whether this [StreamPeer] is using big-endian format.
 			</description>
 		</method>
 		<method name="put_8">
 			<argument index="0" name="val" type="int">
 			</argument>
 			<description>
+			Put a signed byte into the stream.
 			</description>
 		</method>
 		<method name="put_u8">
 			<argument index="0" name="val" type="int">
 			</argument>
 			<description>
+			Put an unsigned byte into the stream.
 			</description>
 		</method>
 		<method name="put_16">
 			<argument index="0" name="val" type="int">
 			</argument>
 			<description>
+			Put a signed 16 bit value into the stream.
 			</description>
 		</method>
 		<method name="put_u16">
 			<argument index="0" name="val" type="int">
 			</argument>
 			<description>
+			Put an unsigned 16 bit value into the stream.
 			</description>
 		</method>
 		<method name="put_32">
 			<argument index="0" name="val" type="int">
 			</argument>
 			<description>
+			Put a signed 32 bit value into the stream.
 			</description>
 		</method>
 		<method name="put_u32">
 			<argument index="0" name="val" type="int">
 			</argument>
 			<description>
+			Put an unsigned 32 bit value into the stream.
 			</description>
 		</method>
 		<method name="put_64">
 			<argument index="0" name="val" type="int">
 			</argument>
 			<description>
+			Put a signed 64 bit value into the stream.
 			</description>
 		</method>
 		<method name="put_u64">
 			<argument index="0" name="val" type="int">
 			</argument>
 			<description>
+			Put an unsigned 64 bit value into the stream.
 			</description>
 		</method>
 		<method name="put_float">
 			<argument index="0" name="val" type="float">
 			</argument>
 			<description>
+			Put a single-precision float into the stream.
 			</description>
 		</method>
 		<method name="put_double">
 			<argument index="0" name="val" type="float">
 			</argument>
 			<description>
+			Put a double-precision float into the stream.
 			</description>
 		</method>
 		<method name="put_utf8_string">
 			<argument index="0" name="val" type="String">
 			</argument>
 			<description>
+			Put a zero-terminated utf8 string into the stream.
 			</description>
 		</method>
 		<method name="put_var">
 			<argument index="0" name="val" type="Variant">
 			</argument>
 			<description>
+			Put a variable into the stream.
 			</description>
 		</method>
 		<method name="get_8">
 			<return type="int">
 			</return>
 			<description>
+			Get a signed byte from the stream.
 			</description>
 		</method>
 		<method name="get_u8">
 			<return type="int">
 			</return>
 			<description>
+			Get an unsigned byte from the stream.
 			</description>
 		</method>
 		<method name="get_16">
 			<return type="int">
 			</return>
 			<description>
+			Get a signed 16 bit value from the stream.
 			</description>
 		</method>
 		<method name="get_u16">
 			<return type="int">
 			</return>
 			<description>
+			Get an unsigned 16 bit value from the stream.
 			</description>
 		</method>
 		<method name="get_32">
 			<return type="int">
 			</return>
 			<description>
+			Get a signed 32 bit value from the stream.
 			</description>
 		</method>
 		<method name="get_u32">
 			<return type="int">
 			</return>
 			<description>
+			Get an unsigned 32 bit value from the stream.
 			</description>
 		</method>
 		<method name="get_64">
 			<return type="int">
 			</return>
 			<description>
+			Get a signed 64 bit value from the stream.
 			</description>
 		</method>
 		<method name="get_u64">
 			<return type="int">
 			</return>
 			<description>
+			Get an unsigned 16 bit value from the stream.
 			</description>
 		</method>
 		<method name="get_float">
 			<return type="float">
 			</return>
 			<description>
+			Get a single-precision float from the stream.
 			</description>
 		</method>
 		<method name="get_double">
 			<return type="float">
 			</return>
 			<description>
+			Get a double-precision float from the stream.
 			</description>
 		</method>
 		<method name="get_string">
@@ -34684,6 +34709,7 @@ This method controls whether the position between two cached points is interpola
 			<argument index="0" name="bytes" type="int">
 			</argument>
 			<description>
+			Get a string with byte-length "bytes" from the stream.
 			</description>
 		</method>
 		<method name="get_utf8_string">
@@ -34692,12 +34718,14 @@ This method controls whether the position between two cached points is interpola
 			<argument index="0" name="bytes" type="int">
 			</argument>
 			<description>
+			Get an utf8 string with byte-length "bytes" from the stream (this decodes the string sent as utf8).
 			</description>
 		</method>
 		<method name="get_var">
 			<return type="Variant">
 			</return>
 			<description>
+			Get a variable from the stream.
 			</description>
 		</method>
 	</methods>
@@ -34706,8 +34734,10 @@ This method controls whether the position between two cached points is interpola
 </class>
 <class name="StreamPeerSSL" inherits="StreamPeer" category="Core">
 	<brief_description>
+	SSL Stream peer.
 	</brief_description>
 	<description>
+	SSL Stream peer. This object can be used to connect to SSL servers.
 	</description>
 	<methods>
 		<method name="accept">
@@ -34728,27 +34758,34 @@ This method controls whether the position between two cached points is interpola
 			<argument index="2" name="for_hostname" type="String" default="&quot;&quot;">
 			</argument>
 			<description>
+			Connect to a peer using an underlying [StreamPeer] "stream", when "validate_certs" is true, [StreamPeerSSL] will validate that the certificate presented by the peer matches the "for_hostname".
 			</description>
 		</method>
 		<method name="get_status" qualifiers="const">
 			<return type="int">
 			</return>
 			<description>
+			Return the status of the connection, one of STATUS_* enum.
 			</description>
 		</method>
 		<method name="disconnect">
 			<description>
+			Disconnect from host.
 			</description>
 		</method>
 	</methods>
 	<constants>
 		<constant name="STATUS_DISCONNECTED" value="0">
+		A status representing a [StreamPeerSSL] that is disconnected.
 		</constant>
 		<constant name="STATUS_CONNECTED" value="1">
+		A status representing a [StreamPeerSSL] that is connected to a host.
 		</constant>
 		<constant name="STATUS_ERROR_NO_CERTIFICATE" value="2">
+		An errot status that shows the peer did not present a SSL certificate and validation was requested.
 		</constant>
 		<constant name="STATUS_ERROR_HOSTNAME_MISMATCH" value="3">
+		An error status that shows a mismatch in the SSL certificate domain presented by the host and the domain requested for validation.
 		</constant>
 	</constants>
 </class>
@@ -34768,45 +34805,55 @@ This method controls whether the position between two cached points is interpola
 			<argument index="1" name="port" type="int">
 			</argument>
 			<description>
+			Connect to the specified IP:port pair. Returns [OK] on success or [FAILED] on failure.
 			</description>
 		</method>
 		<method name="is_connected" qualifiers="const">
 			<return type="bool">
 			</return>
 			<description>
+			Return whether this peer is connected. Returns true while connecting and connected.
 			</description>
 		</method>
 		<method name="get_status" qualifiers="const">
 			<return type="int">
 			</return>
 			<description>
+			Return the status of the connection, one of STATUS_* enum.
 			</description>
 		</method>
 		<method name="get_connected_host" qualifiers="const">
 			<return type="String">
 			</return>
 			<description>
+			Return the IP of this peer.
 			</description>
 		</method>
 		<method name="get_connected_port" qualifiers="const">
 			<return type="int">
 			</return>
 			<description>
+			Return the port of this peer.
 			</description>
 		</method>
 		<method name="disconnect">
 			<description>
+			Disconnect from host.
 			</description>
 		</method>
 	</methods>
 	<constants>
 		<constant name="STATUS_NONE" value="0">
+		The initial status of the [StreamPeerTCP], also the status after a disconnect.
 		</constant>
 		<constant name="STATUS_CONNECTING" value="1">
+		A status representing a [StreamPeerTCP] that is connecting to a host.
 		</constant>
 		<constant name="STATUS_CONNECTED" value="2">
+		A status representing a [StreamPeerTCP] that is connected to a host.
 		</constant>
 		<constant name="STATUS_ERROR" value="3">
+		A staus representing a [StreamPeerTCP] in error state.
 		</constant>
 	</constants>
 </class>