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

Merge branch 'platform-doxy-typo-fix' of https://github.com/kegilbert/mbed-os into dev_rollup

pull/8652/head
Martin Kojtal 2018-11-06 12:10:26 +00:00
parent 4cbcd64ca3 766359c7c5
commit 2ae9981bea
6 changed files with 24 additions and 24 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

2
platform/CallChain.h
View File

@ -147,7 +147,7 @@ public:
* @param method pointer to the member function to be called * @param method pointer to the member function to be called
* *
* @returns * @returns
* The function object created for 'tptr' and 'mptr' * The function object created for the object and method pointers
* *
* @deprecated * @deprecated
* The add_front function does not support cv-qualifiers. Replaced by * The add_front function does not support cv-qualifiers. Replaced by

2
platform/SharedPtr.h
View File

@ -29,7 +29,7 @@ namespace mbed {
/** Shared pointer class. /** Shared pointer class.
* *
* A shared pointer is a "smart" pointer that retains ownership of an object using * A shared pointer is a "smart" pointer that retains ownership of an object using
* reference counting accross all smart pointers referencing that object. * reference counting across all smart pointers referencing that object.
* *
* @code * @code
* #include "platform/SharedPtr.h" * #include "platform/SharedPtr.h"

32
platform/mbed_error.h
View File

@ -86,24 +86,24 @@ extern "C" {
\endverbatim \endverbatim
* *
* The error status value range for each error type is as follows:\n * The error status value range for each error type is as follows:\n
* Posix Error Status-es - 0xFFFFFFFF to 0xFFFFFF01(-1 -255) - This corresponds to Posix error codes represented as negative.\n * POSIX Error Status-es - 0xFFFFFFFF to 0xFFFFFF01(-1 -255) - This corresponds to POSIX error codes represented as negative.\n
* System Error Status-es - 0x80XX0100 to 0x80XX0FFF - This corresponds to System error codes range(all values are negative). Bits 23-16 will be module type(marked with XX)\n * System Error Status-es - 0x80XX0100 to 0x80XX0FFF - This corresponds to System error codes range(all values are negative). Bits 23-16 will be module type(marked with XX)\n
* Custom Error Status-es - 0xA0XX1000 to 0xA0XXFFFF - This corresponds to Custom error codes range(all values are negative). Bits 23-16 will be module type(marked with XX)\n\n * Custom Error Status-es - 0xA0XX1000 to 0xA0XXFFFF - This corresponds to Custom error codes range(all values are negative). Bits 23-16 will be module type(marked with XX)\n\n
* *
* The ERROR CODE(values encoded into ERROR CODE bit-field in mbed_error_status_t) value range for each error type is also separated as below:\n * The ERROR CODE(values encoded into ERROR CODE bit-field in mbed_error_status_t) value range for each error type is also separated as below:\n
* Posix Error Codes - 1 to 255.\n * POSIX Error Codes - 1 to 255.\n
* System Error Codes - 256 to 4095.\n * System Error Codes - 256 to 4095.\n
* Custom Error Codes - 4096 to 65535.\n * Custom Error Codes - 4096 to 65535.\n
* *
* @note Posix error codes are always encoded as negative of their actual value. For example, EPERM is encoded as -EPERM. * @note POSIX error codes are always encoded as negative of their actual value. For example, EPERM is encoded as -EPERM.
* And, the MODULE TYPE for Posix error codes are always encoded as MBED_MODULE_UNKNOWN.\n * And, the MODULE TYPE for POSIX error codes are always encoded as MBED_MODULE_UNKNOWN.\n
* This is to enable easy injection of Posix error codes into MbedOS error handling system without altering the actual Posix error values.\n * This is to enable easy injection of POSIX error codes into MbedOS error handling system without altering the actual POSIX error values.\n
* Accordingly, Posix error codes are represented as -1 to -255 under MbedOS error status representation. * Accordingly, POSIX error codes are represented as -1 to -255 under MbedOS error status representation.
*/ */
typedef int mbed_error_status_t; typedef int mbed_error_status_t;
/** /**
* Macro for defining a Posix error status. This macro is mainly used to define Posix error values in mbed_error_code_t enumeration. * Macro for defining a POSIX error status. This macro is mainly used to define POSIX error values in mbed_error_code_t enumeration.
* @param error_name Name of the error without the ERROR_ prefix * @param error_name Name of the error without the ERROR_ prefix
* @param error_code Error code value to be used, must be between 1 and 255(inclusive). * @param error_code Error code value to be used, must be between 1 and 255(inclusive).
* *
@ -201,7 +201,7 @@ typedef int mbed_error_status_t;
* See mbed_error_status_t description for more info.\n * See mbed_error_status_t description for more info.\n
* MBED_ERROR_TYPE_SYSTEM - Used to indicate that the error status is of System defined Error type.\n * MBED_ERROR_TYPE_SYSTEM - Used to indicate that the error status is of System defined Error type.\n
* MBED_ERROR_TYPE_CUSTOM - Used to indicate that the error status is of Custom defined Error type.\n * MBED_ERROR_TYPE_CUSTOM - Used to indicate that the error status is of Custom defined Error type.\n
* MBED_ERROR_TYPE_POSIX - Used to indicate that the error status is of Posix error type.\n * MBED_ERROR_TYPE_POSIX - Used to indicate that the error status is of POSIX error type.\n
* *
*/ */
typedef enum _mbed_error_type_t { typedef enum _mbed_error_type_t {
@ -301,23 +301,23 @@ typedef enum _mbed_module_type {
/** mbed_error_code_t definition /** mbed_error_code_t definition
* *
* mbed_error_code_t enumeration defines the Error codes and Error status values for MBED_MODULE_UNKNOWN.\n * mbed_error_code_t enumeration defines the Error codes and Error status values for MBED_MODULE_UNKNOWN.\n
* It defines all of Posix Error Codes/Statuses and Mbed System Error Codes/Statuses.\n\n * It defines all of POSIX Error Codes/Statuses and Mbed System Error Codes/Statuses.\n\n
* *
* @note * @note
* Posix Error codes are defined using the macro MBED_DEFINE_POSIX_ERROR\n * POSIX Error codes are defined using the macro MBED_DEFINE_POSIX_ERROR\n
* For example MBED_DEFINE_POSIX_ERROR( EPERM, EPERM ). This effectively defines the following values:\n * For example MBED_DEFINE_POSIX_ERROR( EPERM, EPERM ). This effectively defines the following values:\n
* ERROR_CODE_EPERM = EPERM\n * ERROR_CODE_EPERM = EPERM\n
* ERROR_EPERM = -EPERM\n * ERROR_EPERM = -EPERM\n
* *
* Posix Error codes are defined using the macro MBED_DEFINE_POSIX_ERROR\n * POSIX Error codes are defined using the macro MBED_DEFINE_POSIX_ERROR\n
* For example MBED_DEFINE_POSIX_ERROR( EPERM, EPERM ). This macro defines the following values:\n * For example MBED_DEFINE_POSIX_ERROR( EPERM, EPERM ). This macro defines the following values:\n
* ERROR_CODE_EPERM = MBED_POSIX_ERROR_BASE+EPERM\n * ERROR_CODE_EPERM = MBED_POSIX_ERROR_BASE+EPERM\n
* ERROR_EPERM = -(MBED_POSIX_ERROR_BASE+EPERM)\n * ERROR_EPERM = -(MBED_POSIX_ERROR_BASE+EPERM)\n
* Its effectively equivalent to:\n * Its effectively equivalent to:\n
* ERROR_CODE_EPERM = 1\n * ERROR_CODE_EPERM = 1\n
* ERROR_EPERM = -1\n * ERROR_EPERM = -1\n
* All Posix error codes currently supported by MbedOS(defined in mbed_retarget.h) are defined using the MBED_DEFINE_POSIX_ERROR macro.\n\n * All POSIX error codes currently supported by MbedOS(defined in mbed_retarget.h) are defined using the MBED_DEFINE_POSIX_ERROR macro.\n\n
* Below are the Posic error codes and the description:\n * Below are the POSIX error codes and the description:\n
* \verbatim * \verbatim
EPERM 1 Operation not permitted EPERM 1 Operation not permitted
ENOENT 2 No such file or directory ENOENT 2 No such file or directory
@ -546,9 +546,9 @@ typedef enum _mbed_module_type {
* *
* @note * @note
* **Using error codes:** \n * **Using error codes:** \n
* Posix error codes may be used in modules/functions currently using Posix error codes and switching them to Mbed-OS error codes * POSIX error codes may be used in modules/functions currently using POSIX error codes and switching them to Mbed-OS error codes
* may cause interoperability issues. For example, some of the filesystem, network stack implementations may need to use * may cause interoperability issues. For example, some of the filesystem, network stack implementations may need to use
* Posix error codes in order to keep them compatible with other modules interfacing with them, and may continue to use Posix error codes. * POSIX error codes in order to keep them compatible with other modules interfacing with them, and may continue to use POSIX error codes.
* *
* In all other cases, like for any native development of Mbed-OS modules Mbed-OS error codes should be used. * In all other cases, like for any native development of Mbed-OS modules Mbed-OS error codes should be used.
* This makes it easy to use Mbed-OS error reporting/logging infrastructure and makes debugging error scenarios * This makes it easy to use Mbed-OS error reporting/logging infrastructure and makes debugging error scenarios
@ -576,7 +576,7 @@ typedef enum _mbed_module_type {
typedef enum _mbed_error_code { typedef enum _mbed_error_code {
//Below are POSIX ERROR CODE definitions, which starts at MBED_POSIX_ERROR_BASE(=0) //Below are POSIX ERROR CODE definitions, which starts at MBED_POSIX_ERROR_BASE(=0)
//POSIX ERROR CODE definitions starts at offset 0(MBED_POSIX_ERROR_BASE) to align them with actual Posix Error Code //POSIX ERROR CODE definitions starts at offset 0(MBED_POSIX_ERROR_BASE) to align them with actual POSIX Error Code
//defintions in mbed_retarget.h //defintions in mbed_retarget.h
// Error Name Error Code // Error Name Error Code
MBED_DEFINE_POSIX_ERROR(EPERM, EPERM), /* 1 Operation not permitted */ MBED_DEFINE_POSIX_ERROR(EPERM, EPERM), /* 1 Operation not permitted */

6
platform/mbed_mem_trace.h
View File

@ -80,13 +80,13 @@ void mbed_mem_trace_set_callback(mbed_mem_trace_cb_t cb);
void mbed_mem_trace_disable(); void mbed_mem_trace_disable();
/** /**
* Renable the memory trace output with the cb in use when disable was called * Re-enable the memory trace output with the cb in use when disable was called
*/ */
void mbed_mem_trace_enable(); void mbed_mem_trace_enable();
/** /**
* Trace lock. * Trace lock.
* @note Locking prevent recursive tracing of malloc/free inside relloc/calloc * @note Locking prevent recursive tracing of malloc/free inside realloc/calloc
*/ */
void mbed_mem_trace_lock(); void mbed_mem_trace_lock();
@ -141,7 +141,7 @@ void mbed_mem_trace_free(void *ptr, void *caller);
* *
* @param op identifies the memory operation ('m' for 'malloc', 'r' for 'realloc', * @param op identifies the memory operation ('m' for 'malloc', 'r' for 'realloc',
* 'c' for 'calloc' and 'f' for 'free'). * 'c' for 'calloc' and 'f' for 'free').
* @param res (base 16) is the result of the memor operation. This is always NULL * @param res (base 16) is the result of the memory operation. This is always NULL
* for 'free', since 'free' doesn't return anything. * for 'free', since 'free' doesn't return anything.
* @param caller (base 16) is the caller of the memory operation. Note that the value * @param caller (base 16) is the caller of the memory operation. Note that the value
* of 'caller' might be unreliable. * of 'caller' might be unreliable.

2
platform/mbed_stats.h
View File

@ -65,7 +65,7 @@ typedef struct {
uint32_t thread_id; /**< Identifier for the thread that owns the stack or 0 if representing accumulated statistics */ uint32_t thread_id; /**< Identifier for the thread that owns the stack or 0 if representing accumulated statistics */
uint32_t max_size; /**< Maximum number of bytes used on the stack since the thread was started */ uint32_t max_size; /**< Maximum number of bytes used on the stack since the thread was started */
uint32_t reserved_size; /**< Current number of bytes reserved for the stack */ uint32_t reserved_size; /**< Current number of bytes reserved for the stack */
uint32_t stack_cnt; /**< The number of stacks represented in the accumulated statistics or 1 if repesenting a single stack */ uint32_t stack_cnt; /**< The number of stacks represented in the accumulated statistics or 1 if representing a single stack */
} mbed_stats_stack_t; } mbed_stats_stack_t;
/** /**

4
platform/mbed_toolchain.h
View File

@ -237,8 +237,8 @@
/** MBED_UNREACHABLE /** MBED_UNREACHABLE
* An unreachable statement. If the statement is reached, * An unreachable statement. If the statement is reached,
* behaviour is undefined. Useful in situations where the compiler * behavior is undefined. Useful in situations where the compiler
* cannot deduce the unreachability of code. * cannot deduce if the code is unreachable.
* *
* @code * @code
* #include "mbed_toolchain.h" * #include "mbed_toolchain.h"