2828/* *
2929 * @brief A specialized client class for secure SSL/TLS connections.
3030 *
31- * The ` WiFiSSLClient` class extends the functionality of the ` WiFiClient` class to provide secure
31+ * The WiFiSSLClient class extends the functionality of the WiFiClient class to provide secure
3232 * communication over SSL/TLS protocols. It ensures encrypted and authenticated communication
3333 * between the client and a remote server.
3434 */
3535class WiFiSSLClient : public WiFiClient {
3636
3737public:
3838 /* *
39- * @brief Initializes objects of the ` WiFiSSLClient` class.
39+ * @brief Initializes objects of the WiFiSSLClient class.
4040 */
4141 WiFiSSLClient ();
4242 ~WiFiSSLClient ();
@@ -58,7 +58,7 @@ class WiFiSSLClient : public WiFiClient {
5858 * @param `host` is the hostname or IP address of the server to connect to.
5959 * `port` is the port number to connect to.
6060 *
61- * @return Returns 1 if the connection is successfully established, 0 otherwise.
61+ * @return Returns `1` if the connection is successfully established, `0` otherwise.
6262 */
6363 virtual int connect (const char * host, uint16_t port);
6464
@@ -76,8 +76,8 @@ class WiFiSSLClient : public WiFiClient {
7676 * certificate for establishing secure SSL connections.
7777 *
7878 * @param `int ecc508KeySlot` specifies the ECC key slot to be used for the SSL connection.
79- * `const byte cert[]` is a pointer to the certificate data in the form of an array of bytes.
80- * `int certLength` specifies the length of the certificate data array.
79+ * @param `const byte cert[]` is a pointer to the certificate data in the form of an array of bytes.
80+ * @param `int certLength` specifies the length of the certificate data array.
8181 */
8282 void setEccSlot (int ecc508KeySlot, const byte cert[], int certLength);
8383
@@ -86,19 +86,19 @@ class WiFiSSLClient : public WiFiClient {
8686 *
8787 * @param `b` is the byte to be sent.
8888 *
89- * @return size_t The number of bytes successfully written. Returns 1 if the byte
90- * was sent successfully, or 0 if an error occurred.
89+ * @return The number of bytes successfully written. Returns `1` if the byte
90+ * was sent successfully, or `0` if an error occurred.
9191 */
9292 virtual size_t write (uint8_t );
9393
9494 /* *
9595 * @brief Writes a buffer of data to the SSL connection.
9696 *
9797 * @param `buf` is a pointer to the buffer containing the data to be sent.
98- * `size` is the number of bytes to send from the buffer.
98+ * @param `size` is the number of bytes to send from the buffer.
9999 *
100100 * @return Returns `size` if the data is successfully sent,
101- * or 0 if the transmission fails or the socket is invalid.
101+ * or `0` if the transmission fails or the socket is invalid.
102102 */
103103 virtual size_t write (const uint8_t *buf, size_t size);
104104
@@ -113,7 +113,7 @@ class WiFiSSLClient : public WiFiClient {
113113 * @brief Reads data from the SSL connection into the receive buffer.
114114 *
115115 * @return Returns the number of bytes successfully read into the buffer. Returns
116- * 0 if no data is received, or -1 if the socket is invalid or an error occurs.
116+ * `0` if no data is received, or `-1` if the socket is invalid or an error occurs.
117117 */
118118 virtual int read ();
119119
@@ -123,7 +123,7 @@ class WiFiSSLClient : public WiFiClient {
123123 * @param `buf` is a pointer to the buffer where the read data will be stored.
124124 * `size` is the maximum number of bytes to read into the buffer.
125125 *
126- * @return The number of bytes successfully read. Returns 0 if no data is
126+ * @return The number of bytes successfully read. Returns `0` if no data is
127127 * available or an error occurs.
128128 */
129129 virtual int read (uint8_t *buf, size_t size);
@@ -134,7 +134,7 @@ class WiFiSSLClient : public WiFiClient {
134134 * This function queries the modem to retrieve the next byte available in the
135135 * SSL/TLS connection, allowing the byte to remain in the buffer for future reads.
136136 *
137- * @return The next byte available as an integer value (0–255), or -1 if
137+ * @return The next byte available as an integer value (0–255), or `-1` if
138138 * the socket is invalid or no data is available.
139139 */
140140 virtual int peek ();
@@ -159,7 +159,7 @@ class WiFiSSLClient : public WiFiClient {
159159 * the modem for the connection status. It checks the validity of the socket
160160 * before proceeding with the query.
161161 *
162- * @return uint8_t Returns 1 if the client is connected, 0 otherwise.
162+ * @return Returns `1` if the client is connected, `0` otherwise.
163163 */
164164 virtual uint8_t connected ();
165165
@@ -177,7 +177,7 @@ class WiFiSSLClient : public WiFiClient {
177177 *
178178 * @param `WiFiSSLClient` object to compare.
179179 *
180- * @return `true` if both ` WiFiSSLClient` objects are equivalent (i.e., they have the same socket),
180+ * @return `true` if both WiFiSSLClient objects are equivalent (i.e., they have the same socket),
181181 * `false` otherwise.
182182 */
183183 virtual bool operator ==(const WiFiSSLClient&);
@@ -189,7 +189,7 @@ class WiFiSSLClient : public WiFiClient {
189189 * to determine if they are not equal, based on their underlying socket or connection.
190190 *
191191 * @param `whs` The WiFiSSLClient object to compare with.
192- * @return `true` if the two ` WiFiSSLClient` objects do not represent the same connection (i.e., have different sockets),
192+ * @return `true` if the two WiFiSSLClient objects do not represent the same connection (i.e., have different sockets),
193193 * `false` otherwise.
194194 */
195195 virtual bool operator !=(const WiFiSSLClient& whs)
@@ -203,7 +203,7 @@ class WiFiSSLClient : public WiFiClient {
203203 * This function queries the modem for the remote IP address associated with
204204 * the current connection.
205205 *
206- * @return The remote IP address of the client. Returns 0.0.0.0 if the
206+ * @return The remote IP address of the client. Returns ` 0.0.0.0` if the
207207 * socket is not valid or the query fails.
208208 */
209209 virtual IPAddress remoteIP ();
@@ -214,25 +214,25 @@ class WiFiSSLClient : public WiFiClient {
214214 * This function queries the modem to obtain the remote port number associated
215215 * with the current connection.
216216 *
217- * @return Returns the remote port number of the client. Returns 0 if the socket
217+ * @return Returns the remote port number of the client. Returns `0` if the socket
218218 * is not valid or the query fails.
219219 */
220220 virtual uint16_t remotePort ();
221221
222222
223223 /* *
224- * @brief Declares ` WiFiServer` as a friend class.
224+ * @brief Declares WiFiServer as a friend class.
225225 *
226- * This allows the ` WiFiServer` class to access private and protected members
227- * of the ` WiFiSSLClient` class.
226+ * This allows the WiFiServer class to access private and protected members
227+ * of the WiFiSSLClient class.
228228 */
229229 friend class WiFiServer ;
230230
231231 /* *
232- * @brief Inherits the `write` method from the ` Print` class.
232+ * @brief Inherits the `write` method from the Print class.
233233 *
234- * This allows the ` WiFiSSLClient` class to use the `write` method defined in the
235- * ` Print` class.
234+ * This allows the WiFiSSLClient class to use the `write` method defined in the
235+ * Print class.
236236 */
237237 using Print::write;
238238
0 commit comments