Copy edit Mail.h

Copy edit file for active voice and American English.
pull/5760/head
Amanda Butler 2018-01-08 17:41:37 -06:00 committed by GitHub
parent 30b8da9d4f
commit d4b3da6700
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 9 additions and 9 deletions

View File

@ -55,9 +55,9 @@ namespace rtos {
template<typename T, uint32_t queue_sz> template<typename T, uint32_t queue_sz>
class Mail : private mbed::NonCopyable<Mail<T, queue_sz> > { class Mail : private mbed::NonCopyable<Mail<T, queue_sz> > {
public: public:
/** Create and Initialise Mail queue. /** Create and Initialize Mail queue.
* *
* @note This function cannot be called from ISR context. * @note You cannot call this function from ISR context.
*/ */
Mail() { }; Mail() { };
@ -65,7 +65,7 @@ public:
* *
* @return True if the mail queue is empty, false if not * @return True if the mail queue is empty, false if not
* *
* @note This function may be called from ISR context. * @note You may call this function from ISR context.
*/ */
bool empty() const { bool empty() const {
return _queue.empty(); return _queue.empty();
@ -75,7 +75,7 @@ public:
* *
* @return True if the mail queue is full, false if not * @return True if the mail queue is full, false if not
* *
* @note This function may be called from ISR context. * @note You may call this function from ISR context.
*/ */
bool full() const { bool full() const {
return _queue.full(); return _queue.full();
@ -85,7 +85,7 @@ public:
@param millisec timeout value or 0 in case of no time-out. (default: 0). @param millisec timeout value or 0 in case of no time-out. (default: 0).
@return pointer to memory block that can be filled with mail or NULL in case error. @return pointer to memory block that can be filled with mail or NULL in case error.
@note This function may be called from ISR context if the millisec parameter is set to 0. @note You may call this function from ISR context if the millisec parameter is set to 0.
*/ */
T* alloc(uint32_t millisec=0) { T* alloc(uint32_t millisec=0) {
return _pool.alloc(); return _pool.alloc();
@ -95,7 +95,7 @@ public:
@param millisec timeout value or 0 in case of no time-out. (default: 0). @param millisec timeout value or 0 in case of no time-out. (default: 0).
@return pointer to memory block that can be filled with mail or NULL in case error. @return pointer to memory block that can be filled with mail or NULL in case error.
@note This function may be called from ISR context if the millisec parameter is set to 0. @note You may call this function from ISR context if the millisec parameter is set to 0.
*/ */
T* calloc(uint32_t millisec=0) { T* calloc(uint32_t millisec=0) {
return _pool.calloc(); return _pool.calloc();
@ -105,7 +105,7 @@ public:
@param mptr memory block previously allocated with Mail::alloc or Mail::calloc. @param mptr memory block previously allocated with Mail::alloc or Mail::calloc.
@return status code that indicates the execution status of the function. @return status code that indicates the execution status of the function.
@note This function may be called from ISR context. @note You may call this function from ISR context.
*/ */
osStatus put(T *mptr) { osStatus put(T *mptr) {
return _queue.put(mptr); return _queue.put(mptr);
@ -115,7 +115,7 @@ public:
@param millisec timeout value or 0 in case of no time-out. (default: osWaitForever). @param millisec timeout value or 0 in case of no time-out. (default: osWaitForever).
@return event that contains mail information or error code. @return event that contains mail information or error code.
@note This function may be called from ISR context if the millisec parameter is set to 0. @note You may call this function from ISR context if the millisec parameter is set to 0.
*/ */
osEvent get(uint32_t millisec=osWaitForever) { osEvent get(uint32_t millisec=osWaitForever) {
osEvent evt = _queue.get(millisec); osEvent evt = _queue.get(millisec);
@ -129,7 +129,7 @@ public:
@param mptr pointer to the memory block that was obtained with Mail::get. @param mptr pointer to the memory block that was obtained with Mail::get.
@return status code that indicates the execution status of the function. @return status code that indicates the execution status of the function.
@note This function may be called from ISR context. @note You may call this function from ISR context.
*/ */
osStatus free(T *mptr) { osStatus free(T *mptr) {
return _pool.free(mptr); return _pool.free(mptr);