Proofread and improve the whole class reference

- Document a few more properties and methods
- Add more information to many classes
- Fix lots of typos and gramar mistakes
- Use [code] tags for parameters consistently
- Use [b] and [i] tags consistently
- Put "Warning:" and "Note:" on their own line to be more visible,
  and make them always bold
- Tweak formatting in code examples to be more readable
- Use double quotes consistently
- Add more links to third-party technologies

1 files changed, 32 insertions, 32 deletions

diff --git a/doc/classes/StreamPeer.xml b/doc/classes/StreamPeer.xml
index d278312fc3..11b4c116c4 100644
--- a/doc/classes/StreamPeer.xml
+++ b/doc/classes/StreamPeer.xml
@@ -4,7 +4,7 @@
 		Abstraction and base class for stream-based protocols.
 	</brief_description>
 	<description>
-		StreamPeer is an abstraction and base class for stream-based protocols (such as TCP or Unix Sockets). It provides an API for sending and receiving data through streams as raw data or strings.
+		StreamPeer is an abstraction and base class for stream-based protocols (such as TCP or UNIX sockets). It provides an API for sending and receiving data through streams as raw data or strings.
 	</description>
 	<tutorials>
 	</tutorials>
@@ -13,28 +13,28 @@
 			<return type="int">
 			</return>
 			<description>
-				Get a signed 16 bit value from the stream.
+				Gets a signed 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.
+				Gets a signed 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.
+				Gets a signed 64-bit value from the stream.
 			</description>
 		</method>
 		<method name="get_8">
 			<return type="int">
 			</return>
 			<description>
-				Get a signed byte from the stream.
+				Gets a signed byte from the stream.
 			</description>
 		</method>
 		<method name="get_available_bytes" qualifiers="const">
@@ -50,21 +50,21 @@
 			<argument index="0" name="bytes" type="int">
 			</argument>
 			<description>
-				Returns a chunk data with the received bytes. The amount of bytes to be received can be requested in the "bytes" argument. If not enough bytes are available, the function will block until the desired amount is received. This function returns two values, an Error code and a data array.
+				Returns a chunk data with the received bytes. The amount of bytes to be received can be requested in the [code]bytes[/code] argument. If not enough bytes are available, the function will block until the desired amount is received. This function returns two values, an [enum @GlobalScope.Error] code and a data array.
 			</description>
 		</method>
 		<method name="get_double">
 			<return type="float">
 			</return>
 			<description>
-				Get a double-precision float from the stream.
+				Gets a double-precision float from the stream.
 			</description>
 		</method>
 		<method name="get_float">
 			<return type="float">
 			</return>
 			<description>
-				Get a single-precision float from the stream.
+				Gets a single-precision float from the stream.
 			</description>
 		</method>
 		<method name="get_partial_data">
@@ -73,7 +73,7 @@
 			<argument index="0" name="bytes" type="int">
 			</argument>
 			<description>
-				Returns a chunk data with the received bytes. The amount of bytes to be received can be requested in the "bytes" argument. If not enough bytes are available, the function will return how many were actually received. This function returns two values, an Error code, and a data array.
+				Returns a chunk data with the received bytes. The amount of bytes to be received can be requested in the "bytes" argument. If not enough bytes are available, the function will return how many were actually received. This function returns two values, an [enum @GlobalScope.Error] code, and a data array.
 			</description>
 		</method>
 		<method name="get_string">
@@ -82,35 +82,35 @@
 			<argument index="0" name="bytes" type="int" default="-1">
 			</argument>
 			<description>
-				Get a string with byte-length [code]bytes[/code] from the stream. If [code]bytes[/code] is negative (default) the length will be read from the stream using the reverse process of [method put_string].
+				Gets a string with byte-length [code]bytes[/code] from the stream. If [code]bytes[/code] is negative (default) the length will be read from the stream using the reverse process of [method put_string].
 			</description>
 		</method>
 		<method name="get_u16">
 			<return type="int">
 			</return>
 			<description>
-				Get an unsigned 16 bit value from the stream.
+				Gets an unsigned 16-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.
+				Gets an unsigned 32-bit value from the stream.
 			</description>
 		</method>
 		<method name="get_u64">
 			<return type="int">
 			</return>
 			<description>
-				Get an unsigned 64 bit value from the stream.
+				Gets an unsigned 64-bit value from the stream.
 			</description>
 		</method>
 		<method name="get_u8">
 			<return type="int">
 			</return>
 			<description>
-				Get an unsigned byte from the stream.
+				Gets an unsigned byte from the stream.
 			</description>
 		</method>
 		<method name="get_utf8_string">
@@ -119,7 +119,7 @@
 			<argument index="0" name="bytes" type="int" default="-1">
 			</argument>
 			<description>
-				Get a utf8 string with byte-length [code]bytes[/code] from the stream (this decodes the string sent as utf8). If [code]bytes[/code] is negative (default) the length will be read from the stream using the reverse process of [method put_utf8_string].
+				Gets an UTF-8 string with byte-length [code]bytes[/code] from the stream (this decodes the string sent as UTF-8). If [code]bytes[/code] is negative (default) the length will be read from the stream using the reverse process of [method put_utf8_string].
 			</description>
 		</method>
 		<method name="get_var">
@@ -128,8 +128,8 @@
 			<argument index="0" name="allow_objects" type="bool" default="false">
 			</argument>
 			<description>
-				Get a Variant from the stream. When [code]allow_objects[/code] is [code]true[/code] decoding objects is allowed.
-				[b]WARNING:[/b] Deserialized object can contain code which gets executed. Do not use this option if the serialized object comes from untrusted sources to avoid potential security threats (remote code execution).
+				Gets a Variant from the stream. If [code]allow_objects[/code] is [code]true[/code], decoding objects is allowed.
+				[b]Warning:[/b] Deserialized objects can contain code which gets executed. Do not use this option if the serialized object comes from untrusted sources to avoid potential security threats such as remote code execution.
 			</description>
 		</method>
 		<method name="put_16">
@@ -138,7 +138,7 @@
 			<argument index="0" name="value" type="int">
 			</argument>
 			<description>
-				Put a signed 16 bit value into the stream.
+				Puts a signed 16-bit value into the stream.
 			</description>
 		</method>
 		<method name="put_32">
@@ -147,7 +147,7 @@
 			<argument index="0" name="value" type="int">
 			</argument>
 			<description>
-				Put a signed 32 bit value into the stream.
+				Puts a signed 32-bit value into the stream.
 			</description>
 		</method>
 		<method name="put_64">
@@ -156,7 +156,7 @@
 			<argument index="0" name="value" type="int">
 			</argument>
 			<description>
-				Put a signed 64 bit value into the stream.
+				Puts a signed 64-bit value into the stream.
 			</description>
 		</method>
 		<method name="put_8">
@@ -165,7 +165,7 @@
 			<argument index="0" name="value" type="int">
 			</argument>
 			<description>
-				Put a signed byte into the stream.
+				Puts a signed byte into the stream.
 			</description>
 		</method>
 		<method name="put_data">
@@ -174,7 +174,7 @@
 			<argument index="0" name="data" type="PoolByteArray">
 			</argument>
 			<description>
-				Send a chunk of data through the connection, blocking if necessary until the data is done sending. This function returns an Error code.
+				Sends a chunk of data through the connection, blocking if necessary until the data is done sending. This function returns an [enum @GlobalScope.Error] code.
 			</description>
 		</method>
 		<method name="put_double">
@@ -183,7 +183,7 @@
 			<argument index="0" name="value" type="float">
 			</argument>
 			<description>
-				Put a double-precision float into the stream.
+				Puts a double-precision float into the stream.
 			</description>
 		</method>
 		<method name="put_float">
@@ -192,7 +192,7 @@
 			<argument index="0" name="value" type="float">
 			</argument>
 			<description>
-				Put a single-precision float into the stream.
+				Puts a single-precision float into the stream.
 			</description>
 		</method>
 		<method name="put_partial_data">
@@ -201,7 +201,7 @@
 			<argument index="0" name="data" type="PoolByteArray">
 			</argument>
 			<description>
-				Send a chunk of data through the connection, if all the data could not be sent at once, only part of it will. This function returns two values, an Error code and an integer, describing how much data was actually sent.
+				Sends a chunk of data through the connection. If all the data could not be sent at once, only part of it will. This function returns two values, an [enum @GlobalScope.Error] code and an integer, describing how much data was actually sent.
 			</description>
 		</method>
 		<method name="put_string">
@@ -210,7 +210,7 @@
 			<argument index="0" name="value" type="String">
 			</argument>
 			<description>
-				Put a zero-terminated ascii string into the stream prepended by a 32 bits unsigned integer representing its size.
+				Puts a zero-terminated ASCII string into the stream prepended by a 32-bit unsigned integer representing its size.
 			</description>
 		</method>
 		<method name="put_u16">
@@ -219,7 +219,7 @@
 			<argument index="0" name="value" type="int">
 			</argument>
 			<description>
-				Put an unsigned 16 bit value into the stream.
+				Puts an unsigned 16-bit value into the stream.
 			</description>
 		</method>
 		<method name="put_u32">
@@ -228,7 +228,7 @@
 			<argument index="0" name="value" type="int">
 			</argument>
 			<description>
-				Put an unsigned 32 bit value into the stream.
+				Puts an unsigned 32-bit value into the stream.
 			</description>
 		</method>
 		<method name="put_u64">
@@ -237,7 +237,7 @@
 			<argument index="0" name="value" type="int">
 			</argument>
 			<description>
-				Put an unsigned 64 bit value into the stream.
+				Puts an unsigned 64-bit value into the stream.
 			</description>
 		</method>
 		<method name="put_u8">
@@ -246,7 +246,7 @@
 			<argument index="0" name="value" type="int">
 			</argument>
 			<description>
-				Put an unsigned byte into the stream.
+				Puts an unsigned byte into the stream.
 			</description>
 		</method>
 		<method name="put_utf8_string">
@@ -255,7 +255,7 @@
 			<argument index="0" name="value" type="String">
 			</argument>
 			<description>
-				Put a zero-terminated utf8 string into the stream prepended by a 32 bits unsigned integer representing its size.
+				Puts a zero-terminated UTF-8 string into the stream prepended by a 32 bits unsigned integer representing its size.
 			</description>
 		</method>
 		<method name="put_var">
@@ -266,7 +266,7 @@
 			<argument index="1" name="full_objects" type="bool" default="false">
 			</argument>
 			<description>
-				Put a Variant into the stream. When [code]full_objects[/code] is [code]true[/code] encoding objects is allowed (and can potentially include code).
+				Puts a Variant into the stream. If [code]full_objects[/code] is [code]true[/code] encoding objects is allowed (and can potentially include code).
 			</description>
 		</method>
 	</methods>