ARMmbed
/
mbed-os
mirror of https://github.com/ARMmbed/mbed-os.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Merge pull request #6531 from SenRamakri/sen_DeprecatedFixes 

Fix doxygen comments to reflect the deprecated functions
pull/6561/head
Martin Kojtal 2018-04-06 10:06:31 +02:00 committed by GitHub
parent 02d4631c13 194b89cce6
commit 3328ecd92a
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
5 changed files with 60 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
drivers/InterruptManager.h
View File

@ -26,6 +26,7 @@ namespace mbed {
/** \addtogroup drivers */ /** \addtogroup drivers */
/** Use this singleton if you need to chain interrupt handlers. /** Use this singleton if you need to chain interrupt handlers.
* @deprecated Do not use this class. This class is not part of the public API of mbed-os and is being removed in the future.
* *
* @note Synchronization level: Thread safe * @note Synchronization level: Thread safe
* *
@ -57,6 +58,8 @@ namespace mbed {
class InterruptManager : private NonCopyable<InterruptManager> { class InterruptManager : private NonCopyable<InterruptManager> {
public: public:
/** Get the instance of InterruptManager Class /** Get the instance of InterruptManager Class
* @deprecated
* Do not use this function, this class is not part of the public API of mbed-os and is being removed in the future.
* *
* @return the only instance of this class * @return the only instance of this class
*/ */
@ -65,12 +68,17 @@ public:
static InterruptManager* get(); static InterruptManager* get();
/** Destroy the current instance of the interrupt manager /** Destroy the current instance of the interrupt manager
* @deprecated
* Do not use this function, this class is not part of the public API of mbed-os and is being removed in the future.
*
*/ */
MBED_DEPRECATED_SINCE("mbed-os-5.6", "This class is not part of the " MBED_DEPRECATED_SINCE("mbed-os-5.6", "This class is not part of the "
"public API of mbed-os and is being removed in the future.") "public API of mbed-os and is being removed in the future.")
static void destroy(); static void destroy();
/** Add a handler for an interrupt at the end of the handler list /** Add a handler for an interrupt at the end of the handler list
* @deprecated
* Do not use this function, this class is not part of the public API of mbed-os and is being removed in the future.
* *
* @param function the handler to add * @param function the handler to add
* @param irq interrupt number * @param irq interrupt number
@ -86,6 +94,8 @@ public:
} }
/** Add a handler for an interrupt at the beginning of the handler list /** Add a handler for an interrupt at the beginning of the handler list
* @deprecated
* Do not use this function, this class is not part of the public API of mbed-os and is being removed in the future.
* *
* @param function the handler to add * @param function the handler to add
* @param irq interrupt number * @param irq interrupt number
@ -101,6 +111,8 @@ public:
} }
/** Add a handler for an interrupt at the end of the handler list /** Add a handler for an interrupt at the end of the handler list
* @deprecated
* Do not use this function, this class is not part of the public API of mbed-os and is being removed in the future.
* *
* @param tptr pointer to the object that has the handler function * @param tptr pointer to the object that has the handler function
* @param mptr pointer to the actual handler function * @param mptr pointer to the actual handler function
@ -118,6 +130,8 @@ public:
} }
/** Add a handler for an interrupt at the beginning of the handler list /** Add a handler for an interrupt at the beginning of the handler list
* @deprecated
* Do not use this function, this class is not part of the public API of mbed-os and is being removed in the future.
* *
* @param tptr pointer to the object that has the handler function * @param tptr pointer to the object that has the handler function
* @param mptr pointer to the actual handler function * @param mptr pointer to the actual handler function
@ -135,6 +149,8 @@ public:
} }
/** Remove a handler from an interrupt /** Remove a handler from an interrupt
* @deprecated
* Do not use this function, this class is not part of the public API of mbed-os and is being removed in the future.
* *
* @param handler the function object for the handler to remove * @param handler the function object for the handler to remove
* @param irq the interrupt number * @param irq the interrupt number

3
platform/ATCmdParser.h
View File

@ -124,6 +124,7 @@ public:
/** /**
* For backwards compatibility. * For backwards compatibility.
* @deprecated Do not use this function. This function has been replaced with set_timeout for consistency.
* *
* Please use set_timeout(int) API only from now on. * Please use set_timeout(int) API only from now on.
* Allows timeout to be changed between commands * Allows timeout to be changed between commands
@ -149,6 +150,7 @@ public:
/** /**
* For backwards compatibility. * For backwards compatibility.
* @deprecated Do not use this function. This function has been replaced with set_delimiter for consistency.
* *
* Please use set_delimiter(const char *) API only from now on. * Please use set_delimiter(const char *) API only from now on.
* Sets string of characters to use as line delimiters * Sets string of characters to use as line delimiters
@ -173,6 +175,7 @@ public:
/** /**
* For backwards compatibility. * For backwards compatibility.
* @deprecated Do not use this function. This function has been replaced with debug_on for consistency.
* *
* Allows traces from modem to be turned on or off * Allows traces from modem to be turned on or off
* *

36
platform/CallChain.h
View File

@ -38,6 +38,7 @@ class CallChainLink;
* sequence using CallChain::call(). Used mostly by the interrupt chaining code, * sequence using CallChain::call(). Used mostly by the interrupt chaining code,
* but can be used for other purposes. * but can be used for other purposes.
* *
* @deprecated Do not use this class. This class is not part of the public API of mbed-os and is being removed in the future.
* @note Synchronization level: Not protected * @note Synchronization level: Not protected
* *
* Example: * Example:
@ -74,6 +75,8 @@ class CallChainLink;
class CallChain : private NonCopyable<CallChain> { class CallChain : private NonCopyable<CallChain> {
public: public:
/** Create an empty chain /** Create an empty chain
* @deprecated
* Do not use this function, this class is not part of the public API of mbed-os and is being removed in the future.
* *
* @param size (optional) Initial size of the chain * @param size (optional) Initial size of the chain
*/ */
@ -81,11 +84,18 @@ public:
"public API of mbed-os and is being removed in the future.") "public API of mbed-os and is being removed in the future.")
CallChain(int size = 4); CallChain(int size = 4);
/** Create an empty chain
* @deprecated
* Do not use this function, this class is not part of the public API of mbed-os and is being removed in the future.
*/
MBED_DEPRECATED_SINCE("mbed-os-5.6", "This class is not part of the " MBED_DEPRECATED_SINCE("mbed-os-5.6", "This class is not part of the "
"public API of mbed-os and is being removed in the future.") "public API of mbed-os and is being removed in the future.")
virtual ~CallChain(); virtual ~CallChain();
/** Add a function at the end of the chain /** Add a function at the end of the chain
*
* @deprecated
* Do not use this function, this class is not part of the public API of mbed-os and is being removed in the future.
* *
* @param func A pointer to a void function * @param func A pointer to a void function
* *
@ -117,6 +127,9 @@ public:
} }
/** Add a function at the beginning of the chain /** Add a function at the beginning of the chain
* @deprecated
* Do not use this function, this class is not part of the public API of mbed-os and is being removed in the future.
*
* *
* @param func A pointer to a void function * @param func A pointer to a void function
* *
@ -148,12 +161,17 @@ public:
} }
/** Get the number of functions in the chain /** Get the number of functions in the chain
* @deprecated
* Do not use this function, this class is not part of the public API of mbed-os and is being removed in the future.
*
*/ */
MBED_DEPRECATED_SINCE("mbed-os-5.6", "This class is not part of the " MBED_DEPRECATED_SINCE("mbed-os-5.6", "This class is not part of the "
"public API of mbed-os and is being removed in the future.") "public API of mbed-os and is being removed in the future.")
int size() const; int size() const;
/** Get a function object from the chain /** Get a function object from the chain
* @deprecated
* Do not use this function, this class is not part of the public API of mbed-os and is being removed in the future.
* *
* @param i function object index * @param i function object index
* *
@ -165,6 +183,8 @@ public:
pFunctionPointer_t get(int i) const; pFunctionPointer_t get(int i) const;
/** Look for a function object in the call chain /** Look for a function object in the call chain
* @deprecated
* Do not use this function, this class is not part of the public API of mbed-os and is being removed in the future.
* *
* @param f the function object to search * @param f the function object to search
* *
@ -176,12 +196,15 @@ public:
int find(pFunctionPointer_t f) const; int find(pFunctionPointer_t f) const;
/** Clear the call chain (remove all functions in the chain). /** Clear the call chain (remove all functions in the chain).
* @deprecated Do not use this function. This class is not part of the public API of mbed-os and is being removed in the future.
*/ */
MBED_DEPRECATED_SINCE("mbed-os-5.6", "This class is not part of the " MBED_DEPRECATED_SINCE("mbed-os-5.6", "This class is not part of the "
"public API of mbed-os and is being removed in the future.") "public API of mbed-os and is being removed in the future.")
void clear(); void clear();
/** Remove a function object from the chain /** Remove a function object from the chain
* @deprecated
* Do not use this function, this class is not part of the public API of mbed-os and is being removed in the future.
* *
* @arg f the function object to remove * @arg f the function object to remove
* *
@ -193,17 +216,30 @@ public:
bool remove(pFunctionPointer_t f); bool remove(pFunctionPointer_t f);
/** Call all the functions in the chain in sequence /** Call all the functions in the chain in sequence
* @deprecated
* Do not use this function, this class is not part of the public API of mbed-os and is being removed in the future.
*
*/ */
MBED_DEPRECATED_SINCE("mbed-os-5.6", "This class is not part of the " MBED_DEPRECATED_SINCE("mbed-os-5.6", "This class is not part of the "
"public API of mbed-os and is being removed in the future.") "public API of mbed-os and is being removed in the future.")
void call(); void call();
/**
* @deprecated
* Do not use this function, this class is not part of the public API of mbed-os and is being removed in the future.
*
*/
MBED_DEPRECATED_SINCE("mbed-os-5.6", "This class is not part of the " MBED_DEPRECATED_SINCE("mbed-os-5.6", "This class is not part of the "
"public API of mbed-os and is being removed in the future.") "public API of mbed-os and is being removed in the future.")
void operator ()(void) { void operator ()(void) {
call(); call();
} }
/**
* @deprecated
* Do not use this function, this class is not part of the public API of mbed-os and is being removed in the future.
*
*/
MBED_DEPRECATED_SINCE("mbed-os-5.6", "This class is not part of the " MBED_DEPRECATED_SINCE("mbed-os-5.6", "This class is not part of the "
"public API of mbed-os and is being removed in the future.") "public API of mbed-os and is being removed in the future.")
pFunctionPointer_t operator [](int i) const { pFunctionPointer_t operator [](int i) const {

2
platform/CriticalSectionLock.h
View File

@ -68,6 +68,7 @@ public:
} }
/** Mark the start of a critical section /** Mark the start of a critical section
* @deprecated This function is inconsistent with RAII and is being removed in the future. Replaced by static function CriticalSectionLock::enable.
* *
*/ */
MBED_DEPRECATED_SINCE("mbed-os-5.8", MBED_DEPRECATED_SINCE("mbed-os-5.8",
@ -79,6 +80,7 @@ public:
} }
/** Mark the end of a critical section /** Mark the end of a critical section
* @deprecated This function is inconsistent with RAII and is being removed in the future. Replaced by static function CriticalSectionLock::enable.
* *
*/ */
MBED_DEPRECATED_SINCE("mbed-os-5.8", MBED_DEPRECATED_SINCE("mbed-os-5.8",

3
platform/mbed_power_mgmt.h
View File

@ -167,6 +167,9 @@ static inline void sleep(void)
} }
/** Send the microcontroller to deep sleep /** Send the microcontroller to deep sleep
*
* @deprecated
* Do not use this function. Applications should use sleep() API which puts the system in deepsleep mode if supported.
* *
* @note This function can be a noop if not implemented by the platform. * @note This function can be a noop if not implemented by the platform.
* @note This function will be a noop in debug mode (debug build profile when MBED_DEBUG is defined) * @note This function will be a noop in debug mode (debug build profile when MBED_DEBUG is defined)