Skip to content

Commit 6b8ebbb

Browse files
Fixed for formating
1 parent 70bf179 commit 6b8ebbb

File tree

7 files changed

+50
-49
lines changed

7 files changed

+50
-49
lines changed

libraries/WiFiS3/src/Modem.h

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ class ModemClass {
2828
/**
2929
* @brief Constructor for the ModemClass, which initializes the modem with the specified transmit (TX) and receive (RX) pins.
3030
*
31-
* @param Initializes an instance of the `ModemClass` class with
31+
* @param Initializes an instance of the ModemClass class with
3232
* specific transmit `tx` and receive `rx` pins for communication.
3333
*/
3434
ModemClass(int tx, int rx);

libraries/WiFiS3/src/WiFi.h

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ class CAccessPoint {
3636
/**
3737
* @brief Class to manage Wi-Fi connectivity and operations.
3838
*
39-
* The `CWifi` class provides an interface to manage Wi-Fi operations such as connecting
39+
* The CWifi class provides an interface to manage Wi-Fi operations such as connecting
4040
* to networks, setting up an access point, retrieving network information, and more.
4141
* It interfaces with a modem to execute commands related to Wi-Fi functionality and manages
4242
* connection settings such as IP address, DNS, and other network configurations.

libraries/WiFiS3/src/WiFiClient.h

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -34,12 +34,12 @@
3434
/**
3535
* @brief Represents a Wi-Fi client that connects to a remote server over a Wi-Fi network.
3636
*
37-
* The `WiFiClient` class allows for network communication over Wi-Fi, providing methods
37+
* The WiFiClient class allows for network communication over Wi-Fi, providing methods
3838
* for establishing connections, sending and receiving data, and managing the client’s
3939
* socket state. This class is used to manage client connections in a Wi-Fi network,
4040
* either for communication or for network data transfer.
4141
*
42-
* It inherits from the `Client` class, providing basic socket communication functionality.
42+
* It inherits from the Client class, providing basic socket communication functionality.
4343
*/
4444
class WiFiClient : public Client {
4545

@@ -231,17 +231,17 @@ class WiFiClient : public Client {
231231
}
232232

233233
/**
234-
* @brief Declares `WiFiServer` as a friend class.
234+
* @brief Declares WiFiServer as a friend class.
235235
*
236-
* This allows the `WiFiServer` class to access private and protected members
237-
* of the `WiFiClient` class.
236+
* This allows the WiFiServer class to access private and protected members
237+
* of the WiFiClient class.
238238
*/
239239
friend class WiFiServer;
240240

241241
/**
242242
* @brief Inherits the `write` method from the `Print` class.
243243
*
244-
* This allows the `WiFiSSLClient` class to use the `write` method defined in the
244+
* This allows the WiFiSSLClient class to use the `write` method defined in the
245245
* `Print` class.
246246
*/
247247
using Print::write;

libraries/WiFiS3/src/WiFiFileSystem.h

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ class WiFiFileSystem {
3434

3535
public:
3636
/**
37-
* @brief Initializes objects of the `WiFiFileSystem` class.
37+
* @brief Initializes objects of the WiFiFileSystem class.
3838
*/
3939
WiFiFileSystem();
4040

libraries/WiFiS3/src/WiFiSSLClient.h

Lines changed: 23 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -28,15 +28,15 @@
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
*/
3535
class WiFiSSLClient : public WiFiClient {
3636

3737
public:
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

libraries/WiFiS3/src/WiFiServer.h

Lines changed: 15 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,7 @@
2929
/**
3030
* @brief A class that provides server functionality for WiFi-based communication.
3131
*
32-
* The `WiFiServer` class inherits from the `Server` class and extends its functionality
32+
* The WiFiServer class inherits from the Server class and extends its functionality
3333
* to create and manage a server over a WiFi connection. This class allows for accepting
3434
* incoming client connections, handling data communication, and closing connections
3535
* in a networked environment.
@@ -42,12 +42,12 @@ class WiFiServer : public Server {
4242

4343
public:
4444
/**
45-
* @brief Initializes objects of the `WiFiServer` class.
45+
* @brief Initializes objects of the WiFiServer class.
4646
*/
4747
WiFiServer();
4848

4949
/**
50-
* @brief Constructs a `WiFiServer` object with the specified port.
50+
* @brief Constructs a WiFiServer object with the specified port.
5151
*
5252
* @param `p` The port number on which the server will listen for incoming connections.
5353
*/
@@ -61,15 +61,15 @@ class WiFiServer : public Server {
6161
* the client. It uses the modem to query the server for an available client
6262
* socket and accepts the connection if a valid client is found.
6363
*
64-
* @return Returns a `WiFiClient` object representing the next client connection that is available
64+
* @return Returns a WiFiClient object representing the next client connection that is available
6565
* for processing.
6666
*/
6767
WiFiClient available();
6868

6969
/**
7070
* @brief Accepts an incoming client connection on the server.
7171
*
72-
* @return Returns a `WiFiClient` object representing the accepted client.
72+
* @return Returns a WiFiClient object representing the accepted client.
7373
*/
7474
WiFiClient accept();
7575

@@ -120,9 +120,9 @@ class WiFiServer : public Server {
120120
void end();
121121

122122
/**
123-
* @brief Converts the `WiFiSSLClient` object to a boolean value.
123+
* @brief Converts the WiFiSSLClient object to a boolean value.
124124
*
125-
* This operator allows a `WiFiSSLClient` object to be implicitly or explicitly
125+
* This operator allows a WiFiSSLClient object to be implicitly or explicitly
126126
* converted to a boolean. It checks whether the client socket is valid (i.e.,
127127
* `_sock != -1`).
128128
*
@@ -131,20 +131,21 @@ class WiFiServer : public Server {
131131
explicit operator bool();
132132

133133
/**
134-
* @brief Compares two `WiFiServer` objects for equality.
134+
* @brief Compares two WiFiServer objects for equality.
135135
*
136136
* This virtual operator compares the underlying socket (`_sock`) of two `WiFiServer`
137137
* objects to determine if they refer to the same server connection.
138138
*
139-
* @param `WiFiServer` object to compare against.
140-
* @return `true` if both `WiFiServer` objects have the same socket; `false` otherwise.
139+
* @param WiFiServer object to compare against.
140+
*
141+
* @return `true` if both WiFiServer objects have the same socket; `false` otherwise.
141142
*/
142143
virtual bool operator==(const WiFiServer&);
143144

144145
/**
145-
* @brief Compares two `WiFiServer` objects for inequality.
146+
* @brief Compares two WiFiServer objects for inequality.
146147
*
147-
* This virtual operator compares the underlying socket (`_sock`) of two `WiFiServer`
148+
* This virtual operator compares the underlying socket (`_sock`) of two WiFiServer
148149
* objects. It returns `true` if the objects do not refer to the same server connection
149150
* (i.e., they have different socket values), and `false` otherwise.
150151
*
@@ -159,13 +160,13 @@ class WiFiServer : public Server {
159160
/**
160161
* @brief Inherits the `write` method from the `Print` class.
161162
*
162-
* This allows the `WiFiSSLClient` class to use the `write` method defined in the
163+
* This allows the WiFiSSLClient class to use the `write` method defined in the
163164
* `Print` class.
164165
*/
165166
using Print::write;
166167

167168
/**
168-
* @brief Grants `WiFiClient` class access to private and protected members of `WiFiServer`.
169+
* @brief Grants WiFiClient class access to private and protected members of WiFiServer.
169170
*/
170171
friend class WiFiClient;
171172
};

libraries/WiFiS3/src/WiFiUdp.h

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@
3333
/**
3434
* @brief A class for handling UDP communication over a Wi-Fi network.
3535
*
36-
* The `WiFiUDP` class is an extension of the `UDP` class that enables sending and receiving UDP packets
36+
* The WiFiUDP class is an extension of the UDP class that enables sending and receiving UDP packets
3737
* over a Wi-Fi network. It provides functions for initialization, packet transmission, and reception
3838
* tailored for Wi-Fi connectivity.
3939
*/
@@ -150,9 +150,9 @@ class WiFiUDP : public UDP {
150150
virtual size_t write(const uint8_t *buffer, size_t size);
151151

152152
/**
153-
* @brief Inherits the `write` method from the `Print` class.
153+
* @brief Inherits the `write` method from the Print class.
154154
*
155-
* This allows the `WiFiSSLClient` class to use the `write` method defined in the
155+
* This allows the WiFiSSLClient class to use the `write` method defined in the
156156
* `Print` class.
157157
*/
158158
using Print::write;

0 commit comments

Comments
 (0)