1
0
Fork 0
mirror of https://github.com/transmission/transmission synced 2024-12-27 18:18:10 +00:00

(trunk) #1220 'change top folder names' -- tweak the API documentation in transmission.h

This commit is contained in:
Jordan Lee 2013-01-19 08:50:57 +00:00
parent 03ac81e7c7
commit 10e4c297d6

View file

@ -1111,16 +1111,16 @@ typedef void (tr_torrent_rename_done_func)(tr_torrent * torrent,
* *
* EXAMPLES * EXAMPLES
* *
* Consider a torrent where * Consider a tr_torrent where its
* files[0].path is "frobnitz-linux/checksum" and * info.files[0].name is "frobnitz-linux/checksum" and
* files[1].path is "frobnitz-linux/frobnitz.iso". * info.files[1].name is "frobnitz-linux/frobnitz.iso".
* *
* 1. tr_torrentRenamePath (tor, "frobnitz-linux", "foo") will rename * 1. tr_torrentRenamePath (tor, "frobnitz-linux", "foo") will rename
* the "frotbnitz-linux" folder as "foo" and update files[*].path. * the "frotbnitz-linux" folder as "foo" and update files[*].name.
* *
* 2. tr_torrentRenamePath (tor, "frobnitz-linux/checksum", "foo") will * 2. tr_torrentRenamePath (tor, "frobnitz-linux/checksum", "foo") will
* rename the "frobnitz-linux/checksum" file as "foo" and update * rename the "frobnitz-linux/checksum" file as "foo" and update
* files[0].path to "frobnitz-linux/foo". * files[0].name to "frobnitz-linux/foo".
* *
* RETURN * RETURN
* *
@ -1130,8 +1130,8 @@ typedef void (tr_torrent_rename_done_func)(tr_torrent * torrent,
* *
* On success, the callback's error argument will be 0. * On success, the callback's error argument will be 0.
* *
* If oldpath can't be found in files[*].path, or if newname is already * If oldpath can't be found in files[*].name, or if newname is already
* in files[*].path, or contains a directory separator, or is NULL, "", * in files[*].name, or contains a directory separator, or is NULL, "",
* ".", or "..", the error argument will be EINVAL. * ".", or "..", the error argument will be EINVAL.
* *
* If the path exists on disk but can't be renamed, the error argument * If the path exists on disk but can't be renamed, the error argument