Change error code -1 to just negative error code

pull/89/head
Tatsuhiro Tsujikawa 2013-05-10 00:08:36 +09:00
parent 01d2cb197c
commit fb31e44d60
1 changed files with 9 additions and 8 deletions

View File

@ -66,7 +66,7 @@ struct Session;
*
* Initializes the global data. It also initializes underlying
* libraries libaria2 depends on. This function returns 0 if it
* succeeds, or -1.
* succeeds, or negative error code.
*
* Call this function only once before calling any other API
* functions.
@ -77,7 +77,7 @@ int libraryInit();
* @function
*
* Releases the global data. This function returns 0 if it succeeds,
* or -1.
* or negative error code.
*
* Call this function only once at the end of the application.
*/
@ -226,7 +226,7 @@ bool isNull(const A2Gid& gid);
* position in the waiting queue. If the |position| is negative or the
* |position| is larger than the size of the queue, it is appended at
* the end of the queue. This function returns 0 if it succeeds, or
* -1.
* negative error code.
*/
int addUri(Session* session,
A2Gid* gid,
@ -245,7 +245,7 @@ int addUri(Session* session,
* is inserted at position in the waiting queue. If the |position| is
* negative or the |position| is larger than the size of the queue, it
* is appended at the end of the queue. This function returns 0 if it
* succeeds, or -1.
* succeeds, or negative error code.
*/
int addMetalink(Session* session,
std::vector<A2Gid>* gids,
@ -268,7 +268,7 @@ std::vector<A2Gid> getActiveDownload(Session* session);
* removed download becomes :c:macro:`DOWNLOAD_REMOVED`. If the
* |force| is true, removal will take place without any action which
* takes time such as contacting BitTorrent tracker. This function
* returns 0 if it succeeds, or -1.
* returns 0 if it succeeds, or negative error code.
*/
int removeDownload(Session* session, const A2Gid& gid, bool force = false);
@ -283,7 +283,8 @@ int removeDownload(Session* session, const A2Gid& gid, bool force = false);
* :c:macro:`DOWNLOAD_WAITING`, use :func:`unpauseDownload()`
* function. If the |force| is true, pause will take place without
* any action which takes time such as contacting BitTorrent
* tracker. This function returns 0 if it succeeds, or -1.
* tracker. This function returns 0 if it succeeds, or negative error
* code.
*
* Please note that, to make pause work, the application must set
* :member:`SessionConfig::keepRunning` to true. Otherwise, the
@ -297,7 +298,7 @@ int pauseDownload(Session* session, const A2Gid& gid, bool force = false);
* Changes the status of the download denoted by the |gid| from
* :c:macro:`DOWNLOAD_PAUSED` to :c:macro:`DOWNLOAD_WAITING`. This
* makes the download eligible to restart. This function returns 0 if
* it succeeds, or -1.
* it succeeds, or negative error code.
*/
int unpauseDownload(Session* session, const A2Gid& gid);
@ -308,7 +309,7 @@ int unpauseDownload(Session* session, const A2Gid& gid);
* place without any action which takes time such as contacting
* BitTorrent tracker. After this call, the application must keep
* calling :func:`run()` function until it returns 0. This function
* returns 0 if it succeeds, or -1.
* returns 0 if it succeeds, or negative error code.
*/
int shutdown(Session* session, bool force = false);