Files | |
file | deprecated.h |
NS_DEPRECATED macro definition. | |
Macros | |
#define | NS_DEPRECATED(msg) /** \deprecated msg */ [[deprecated(msg)]] |
Mark a function as deprecated. | |
#define | NS_DEPRECATED_3_40(msg) NS_DEPRECATED("Deprecated in ns-3.40: " msg) |
Tag for things deprecated in version ns-3.40. | |
#define | NS_DEPRECATED_3_41(msg) NS_DEPRECATED("Deprecated in ns-3.41: " msg) |
Tag for things deprecated in version ns-3.41. | |
#define | NS_DEPRECATED_3_42(msg) NS_DEPRECATED("Deprecated in ns-3.42: " msg) |
Tag for things deprecated in version ns-3.42. | |
#define | NS_DEPRECATED_3_43(msg) NS_DEPRECATED("Deprecated in ns-3.43: " msg) |
Tag for things deprecated in version ns-3.43. | |
#define NS_DEPRECATED | ( | msg | ) | /** \deprecated msg */ [[deprecated(msg)]] |
Mark a function as deprecated.
Users should expect deprecated features to be removed eventually.
When deprecating a feature, please update the documentation with information for users on how to update their code.
The following snippet shows an example of how to deprecate the function SomethingUseful() in favor of the new function TheNewWay(). Note: in the following snippet, the Doxygen blocks are not following the ns-3 style. This allows the code to be safely embedded in the documentation.
Please follow these two guidelines to ease future maintenance (primarily the eventual removal of the deprecated code):
NS_DEPRECATED_3_XX
, not the generic NS_DEPRECATED
.Typically only the declaration needs to be deprecated,
but it's helpful to put the same macro as a comment at the site of the definition, to make it easier to find all the bits which eventually have to be removed:
msg | Optional message to add to the compiler warning. |
Definition at line 84 of file deprecated.h.
#define NS_DEPRECATED_3_40 | ( | msg | ) | NS_DEPRECATED("Deprecated in ns-3.40: " msg) |
Tag for things deprecated in version ns-3.40.
Definition at line 112 of file deprecated.h.
#define NS_DEPRECATED_3_41 | ( | msg | ) | NS_DEPRECATED("Deprecated in ns-3.41: " msg) |
Tag for things deprecated in version ns-3.41.
Definition at line 105 of file deprecated.h.
#define NS_DEPRECATED_3_42 | ( | msg | ) | NS_DEPRECATED("Deprecated in ns-3.42: " msg) |
Tag for things deprecated in version ns-3.42.
Definition at line 98 of file deprecated.h.
#define NS_DEPRECATED_3_43 | ( | msg | ) | NS_DEPRECATED("Deprecated in ns-3.43: " msg) |
Tag for things deprecated in version ns-3.43.
Definition at line 91 of file deprecated.h.