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;