Documentation improvements only

- Prevent protected attributes from appearing on docs site.
- Standardize units of time (microsecond, millisecond).
- Improve example description.
pull/8412/head
RFulchiero 2018-10-12 13:21:18 -05:00
parent c356f1f9d4
commit a6a2852f13
1 changed files with 11 additions and 9 deletions

View File

@ -32,7 +32,7 @@ namespace mbed {
* *
* Example * Example
* @code * @code
* // Fade a led on. * // Gradually change the intensity of the LED.
* #include "mbed.h" * #include "mbed.h"
* *
* PwmOut led(LED1); * PwmOut led(LED1);
@ -118,8 +118,8 @@ public:
core_util_critical_section_exit(); core_util_critical_section_exit();
} }
/** Set the PWM period, specified in milli-seconds (int), keeping the duty cycle the same. /** Set the PWM period, specified in milliseconds (int), keeping the duty cycle the same.
* @param ms Change the period of a PWM signal in milli-seconds without modifying the duty cycle * @param ms Change the period of a PWM signal in milliseconds without modifying the duty cycle
*/ */
void period_ms(int ms) void period_ms(int ms)
{ {
@ -128,8 +128,8 @@ public:
core_util_critical_section_exit(); core_util_critical_section_exit();
} }
/** Set the PWM period, specified in micro-seconds (int), keeping the duty cycle the same. /** Set the PWM period, specified in microseconds (int), keeping the duty cycle the same.
* @param us Change the period of a PWM signal in micro-seconds without modifying the duty cycle * @param us Change the period of a PWM signal in microseconds without modifying the duty cycle
*/ */
void period_us(int us) void period_us(int us)
{ {
@ -148,8 +148,8 @@ public:
core_util_critical_section_exit(); core_util_critical_section_exit();
} }
/** Set the PWM pulsewidth, specified in milli-seconds (int), keeping the period the same. /** Set the PWM pulsewidth, specified in milliseconds (int), keeping the period the same.
* @param ms Change the pulse width of a PWM signal specified in milli-seconds * @param ms Change the pulse width of a PWM signal specified in milliseconds
*/ */
void pulsewidth_ms(int ms) void pulsewidth_ms(int ms)
{ {
@ -158,8 +158,8 @@ public:
core_util_critical_section_exit(); core_util_critical_section_exit();
} }
/** Set the PWM pulsewidth, specified in micro-seconds (int), keeping the period the same. /** Set the PWM pulsewidth, specified in microseconds (int), keeping the period the same.
* @param us Change the pulse width of a PWM signal specified in micro-seconds * @param us Change the pulse width of a PWM signal specified in microseconds
*/ */
void pulsewidth_us(int us) void pulsewidth_us(int us)
{ {
@ -197,6 +197,7 @@ public:
return read(); return read();
} }
#if !(DOXYGEN_ONLY)
protected: protected:
/** Lock deep sleep only if it is not yet locked */ /** Lock deep sleep only if it is not yet locked */
void lock_deep_sleep() void lock_deep_sleep()
@ -219,6 +220,7 @@ protected:
pwmout_t _pwm; pwmout_t _pwm;
bool _deep_sleep_locked; bool _deep_sleep_locked;
}; };
#endif
} // namespace mbed } // namespace mbed