Index: src/OFDataArray.h
==================================================================
--- src/OFDataArray.h
+++ src/OFDataArray.h
@@ -203,14 +203,14 @@
atIndex: (size_t)index;
/*!
* @brief Adds items from a C array to the OFDataArray.
*
- * @param count The number of items to add
* @param items A C array containing the items to add
+ * @param count The number of items to add
*/
-- (void)addItems: (const void*)array
+- (void)addItems: (const void*)items
count: (size_t)count;
/*!
* @brief Adds items from a C array to the OFDataArray at the specified index.
*
Index: src/OFHTTPClient.h
==================================================================
--- src/OFHTTPClient.h
+++ src/OFHTTPClient.h
@@ -173,10 +173,11 @@
- (OFHTTPRequestReply*)performRequest: (OFHTTPRequest*)request;
/*!
* @brief Performs the HTTP request and returns an OFHTTPRequestReply.
*
+ * @param request The request which was redirected
* @param redirects The maximum number of redirects after which no further
* attempt is done to follow the redirect, but instead the
* redirect is returned as an OFHTTPRequestReply
* @return An OFHTTPRequestReply with the reply of the HTTP request
*/
Index: src/OFHTTPRequest.h
==================================================================
--- src/OFHTTPRequest.h
+++ src/OFHTTPRequest.h
@@ -117,11 +117,11 @@
/*!
* @brief Sets the POST data of the HTTP request.
*
* @param POSTData The POST data of the HTTP request
*/
-- (void)setPOSTData: (OFDataArray*)postData;
+- (void)setPOSTData: (OFDataArray*)POSTData;
/*!
* @brief Returns the POST data of the HTTP request.
*
* @return The POST data of the HTTP request
Index: src/OFHTTPServer.h
==================================================================
--- src/OFHTTPServer.h
+++ src/OFHTTPServer.h
@@ -42,18 +42,19 @@
#endif
/*!
* @brief This method is called when the HTTP server's listening socket
* encountered an exception.
*
+ * @param server The HTTP server which encountered an exception
* @param exception The exception that occurred on the HTTP server's listening
* socket
* @return Whether to continue listening. If you return NO, existing connections
* will still be handled and you can start accepting new connections
- * again by calling @ref start again.
+ * again by calling @ref OFHTTPServer::start again.
*/
- (BOOL)server: (OFHTTPServer*)server
- didReceiveExceptionOnListeningSocket: (OFException*)e;
+ didReceiveExceptionOnListeningSocket: (OFException*)exception;
@end
/*!
* @brief A class for creating a simple HTTP server inside of applications.
*/
Index: src/OFStream.h
==================================================================
--- src/OFStream.h
+++ src/OFStream.h
@@ -143,14 +143,14 @@
/*!
* @brief Asyncronously reads exactly the specified length bytes from the
* stream into a buffer.
*
- * Unlike @ref asyncReadIntoBuffer:length:block, this method does not call the
- * method when less than the specified length has been read - instead, it waits
- * until it got exactly the specified length, the stream has ended or an
- * exception occurred.
+ * Unlike @ref asyncReadIntoBuffer:length:target:selector:, this method does
+ * not call the method when less than the specified length has been read -
+ * instead, it waits until it got exactly the specified length, the stream has
+ * ended or an exception occurred.
*
* @param buffer The buffer into which the data is read
* @param length The length of the data that should be read.
* The buffer must be exactly this big!
* @param target The target on which the selector should be called when the
@@ -195,13 +195,13 @@
/*!
* @brief Asyncronously reads exactly the specified length bytes from the
* stream into a buffer.
*
- * Unlike @ref asyncReadIntoBuffer:length:block, this method does not invoke the
- * block when less than the specified length has been read - instead, it waits
- * until it got exactly the specified length, the stream has ended or an
+ * Unlike @ref asyncReadIntoBuffer:length:block:, this method does not invoke
+ * the block when less than the specified length has been read - instead, it
+ * waits until it got exactly the specified length, the stream has ended or an
* exception occurred.
*
* @param buffer The buffer into which the data is read
* @param length The length of the data that should be read.
* The buffer must be exactly this big!
@@ -675,11 +675,11 @@
*/
- (OFString*)tryReadTillDelimiter: (OFString*)delimiter;
/*!
* @brief Tries to read until the specified string or \\0 is found or the end
- * of stream occurs (see @ref readTillDelimiterWithEncoding:) and
+ * of stream occurs (see @ref readTillDelimiter:encoding:) and
* returns nil if not enough data has been received yet.
*
* @param delimiter The delimiter
* @param encoding The encoding used by the stream
* @return The line that was read, autoreleased, or nil if the end of the
Index: src/OFStreamObserver.h
==================================================================
--- src/OFStreamObserver.h
+++ src/OFStreamObserver.h
@@ -39,14 +39,15 @@
@optional
#endif
/*!
* @brief This callback is called when a stream did get ready for reading.
*
- * @note When @ref tryReadLine or @ref tryReadTillDelimiter: has been called on
- * the stream, this callback will not be called again until new data has
- * been received, even though there is still data in the cache. The reason
- * for this is to prevent spinning in a loop when there is an incomplete
+ * @note When @ref OFStream::tryReadLine or
+ * @ref OFStream::tryReadTillDelimiter: has been called on the stream,
+ * this callback will not be called again until new data has been
+ * received, even though there is still data in the cache. The reason for
+ * this is to prevent spinning in a loop when there is an incomplete
* string in the cache. Once the string is complete, the callback will be
* called again if there is data in the cache.
*
* @param stream The stream which did become ready for reading
*/
Index: src/OFURL.h
==================================================================
--- src/OFURL.h
+++ src/OFURL.h
@@ -48,11 +48,10 @@
#endif
/*!
* Creates a new URL.
*
- * @param string A string describing a URL
* @return A new, autoreleased OFURL
*/
+ (instancetype)URL;
/*!
Index: src/OFXMLElement.h
==================================================================
--- src/OFXMLElement.h
+++ src/OFXMLElement.h
@@ -359,11 +359,11 @@
atIndex: (size_t)index;
/*!
* @brief Inserts the specified children at the specified index.
*
- * @param child An OFXMLNode which is added as a child
+ * @param children An array of OFXMLNodes which are added as children
* @param index The index where the child is added
*/
- (void)insertChildren: (OFArray*)children
atIndex: (size_t)index;