diff options
| author | Rémi Verschelde <rverschelde@gmail.com> | 2021-07-30 15:28:05 +0200 |
|---|---|---|
| committer | Rémi Verschelde <rverschelde@gmail.com> | 2021-07-30 15:29:52 +0200 |
| commit | 7adf4cc9b5de6701a41e27690a69b9892d5eed85 (patch) | |
| tree | 0019e6d1b7cd993b81d5bba268074cfc4e10a213 /doc/classes/StreamPeerSSL.xml | |
| parent | a1c19b9a1e53f78c75c13cb418270db80057b21a (diff) | |
| download | redot-engine-7adf4cc9b5de6701a41e27690a69b9892d5eed85.tar.gz | |
doc: Use self-closing tags for `return` and `argument`
For the time being we don't support writing a description for those, preferring
having all details in the method's description.
Using self-closing tags saves half the lines, and prevents contributors from
thinking that they should write the argument or return documentation there.
Diffstat (limited to 'doc/classes/StreamPeerSSL.xml')
| -rw-r--r-- | doc/classes/StreamPeerSSL.xml | 39 |
1 files changed, 13 insertions, 26 deletions
diff --git a/doc/classes/StreamPeerSSL.xml b/doc/classes/StreamPeerSSL.xml index 6a06c0b3f4..034168c2a0 100644 --- a/doc/classes/StreamPeerSSL.xml +++ b/doc/classes/StreamPeerSSL.xml @@ -11,53 +11,40 @@ </tutorials> <methods> <method name="accept_stream"> - <return type="int" enum="Error"> - </return> - <argument index="0" name="stream" type="StreamPeer"> - </argument> - <argument index="1" name="private_key" type="CryptoKey"> - </argument> - <argument index="2" name="certificate" type="X509Certificate"> - </argument> - <argument index="3" name="chain" type="X509Certificate" default="null"> - </argument> + <return type="int" enum="Error" /> + <argument index="0" name="stream" type="StreamPeer" /> + <argument index="1" name="private_key" type="CryptoKey" /> + <argument index="2" name="certificate" type="X509Certificate" /> + <argument index="3" name="chain" type="X509Certificate" default="null" /> <description> Accepts a peer connection as a server using the given [code]private_key[/code] and providing the given [code]certificate[/code] to the client. You can pass the optional [code]chain[/code] parameter to provide additional CA chain information along with the certificate. </description> </method> <method name="connect_to_stream"> - <return type="int" enum="Error"> - </return> - <argument index="0" name="stream" type="StreamPeer"> - </argument> - <argument index="1" name="validate_certs" type="bool" default="false"> - </argument> - <argument index="2" name="for_hostname" type="String" default=""""> - </argument> - <argument index="3" name="valid_certificate" type="X509Certificate" default="null"> - </argument> + <return type="int" enum="Error" /> + <argument index="0" name="stream" type="StreamPeer" /> + <argument index="1" name="validate_certs" type="bool" default="false" /> + <argument index="2" name="for_hostname" type="String" default="""" /> + <argument index="3" name="valid_certificate" type="X509Certificate" default="null" /> <description> Connects to a peer using an underlying [StreamPeer] [code]stream[/code]. If [code]validate_certs[/code] is [code]true[/code], [StreamPeerSSL] will validate that the certificate presented by the peer matches the [code]for_hostname[/code]. [b]Note:[/b] Specifying a custom [code]valid_certificate[/code] is not supported in HTML5 exports due to browsers restrictions. </description> </method> <method name="disconnect_from_stream"> - <return type="void"> - </return> + <return type="void" /> <description> Disconnects from host. </description> </method> <method name="get_status" qualifiers="const"> - <return type="int" enum="StreamPeerSSL.Status"> - </return> + <return type="int" enum="StreamPeerSSL.Status" /> <description> Returns the status of the connection. See [enum Status] for values. </description> </method> <method name="poll"> - <return type="void"> - </return> + <return type="void" /> <description> Poll the connection to check for incoming bytes. Call this right before [method StreamPeer.get_available_bytes] for it to work properly. </description> |