Adding @deprecated functions to the inline documentation of deprecated functions

pull/6510/head
Yossi Levy 2018-03-29 12:05:26 +03:00
parent f895392374
commit 57b4653a98
2 changed files with 9 additions and 0 deletions

View File

@ -105,6 +105,7 @@ public:
* @returns * @returns
* 0 on success, * 0 on success,
* -1 on error. * -1 on error.
* @deprecated Replaced by `DirHandle::close'
*/ */
MBED_DEPRECATED_SINCE("mbed-os-5.4", "Replaced by DirHandle::close") MBED_DEPRECATED_SINCE("mbed-os-5.4", "Replaced by DirHandle::close")
virtual int closedir() { return close(); }; virtual int closedir() { return close(); };
@ -116,6 +117,7 @@ public:
* A pointer to a dirent structure representing the * A pointer to a dirent structure representing the
* directory entry at the current position, or NULL on reaching * directory entry at the current position, or NULL on reaching
* end of directory or error. * end of directory or error.
* @deprecated Replaced by `DirHandle::read'
*/ */
MBED_DEPRECATED_SINCE("mbed-os-5.4", "Replaced by DirHandle::read") MBED_DEPRECATED_SINCE("mbed-os-5.4", "Replaced by DirHandle::read")
virtual struct dirent *readdir() virtual struct dirent *readdir()
@ -125,6 +127,7 @@ public:
} }
/** Resets the position to the beginning of the directory. /** Resets the position to the beginning of the directory.
* @deprecated Replaced by `DirHandle::rewind'
*/ */
MBED_DEPRECATED_SINCE("mbed-os-5.4", "Replaced by DirHandle::rewind") MBED_DEPRECATED_SINCE("mbed-os-5.4", "Replaced by DirHandle::rewind")
virtual void rewinddir() { rewind(); } virtual void rewinddir() { rewind(); }
@ -134,6 +137,7 @@ public:
* @returns * @returns
* the current position, * the current position,
* -1 on error. * -1 on error.
* @deprecated Replaced by `DirHandle::tell'
*/ */
MBED_DEPRECATED_SINCE("mbed-os-5.4", "Replaced by DirHandle::tell") MBED_DEPRECATED_SINCE("mbed-os-5.4", "Replaced by DirHandle::tell")
virtual off_t telldir() { return tell(); } virtual off_t telldir() { return tell(); }
@ -141,6 +145,7 @@ public:
/** Sets the position of the DirHandle. /** Sets the position of the DirHandle.
* *
* @param location The location to seek to. Must be a value returned by telldir. * @param location The location to seek to. Must be a value returned by telldir.
* @deprecated Replaced by `DirHandle::seek'
*/ */
MBED_DEPRECATED_SINCE("mbed-os-5.4", "Replaced by DirHandle::seek") MBED_DEPRECATED_SINCE("mbed-os-5.4", "Replaced by DirHandle::seek")
virtual void seekdir(off_t location) { seek(location); } virtual void seekdir(off_t location) { seek(location); }

View File

@ -146,6 +146,8 @@ public:
* @returns * @returns
* new file position on success, * new file position on success,
* -1 on failure or unsupported * -1 on failure or unsupported
* @deprecated Replaced by `FileHandle::seek'
*
*/ */
MBED_DEPRECATED_SINCE("mbed-os-5.4", "Replaced by FileHandle::seek") MBED_DEPRECATED_SINCE("mbed-os-5.4", "Replaced by FileHandle::seek")
virtual off_t lseek(off_t offset, int whence) virtual off_t lseek(off_t offset, int whence)
@ -159,6 +161,7 @@ public:
* @returns * @returns
* 0 on success or un-needed, * 0 on success or un-needed,
* -1 on error * -1 on error
* @deprecated Replaced by `FileHandle::sync'
*/ */
MBED_DEPRECATED_SINCE("mbed-os-5.4", "Replaced by FileHandle::sync") MBED_DEPRECATED_SINCE("mbed-os-5.4", "Replaced by FileHandle::sync")
virtual int fsync() virtual int fsync()
@ -170,6 +173,7 @@ public:
* *
* @returns * @returns
* Length of the file * Length of the file
* @deprecated Replaced by `FileHandle::size'
*/ */
MBED_DEPRECATED_SINCE("mbed-os-5.4", "Replaced by FileHandle::size") MBED_DEPRECATED_SINCE("mbed-os-5.4", "Replaced by FileHandle::size")
virtual off_t flen() virtual off_t flen()