mirror of
https://github.com/wpilibsuite/allwpilib
synced 2026-06-22 01:11:42 +00:00
[docs] Fix Doxygen warnings, add CI docs lint job (#3639)
The CI docs lint build is configured to fail on Doxygen warnings.
This commit is contained in:
@@ -15,7 +15,9 @@
|
||||
|
||||
namespace wpi {
|
||||
|
||||
// Base class for SafeThreadOwner threads.
|
||||
/**
|
||||
* Base class for SafeThreadOwner threads.
|
||||
*/
|
||||
class SafeThread {
|
||||
public:
|
||||
virtual ~SafeThread() = default;
|
||||
@@ -29,7 +31,9 @@ class SafeThread {
|
||||
|
||||
namespace detail {
|
||||
|
||||
// Non-template proxy base class for common proxy code.
|
||||
/**
|
||||
* Non-template proxy base class for common proxy code.
|
||||
*/
|
||||
class SafeThreadProxyBase {
|
||||
public:
|
||||
explicit SafeThreadProxyBase(std::shared_ptr<SafeThread> thr);
|
||||
@@ -41,8 +45,11 @@ class SafeThreadProxyBase {
|
||||
std::unique_lock<wpi::mutex> m_lock;
|
||||
};
|
||||
|
||||
// A proxy for SafeThread.
|
||||
// Also serves as a scoped lock on SafeThread::m_mutex.
|
||||
/**
|
||||
* A proxy for SafeThread.
|
||||
*
|
||||
* Also serves as a scoped lock on SafeThread::m_mutex.
|
||||
*/
|
||||
template <typename T>
|
||||
class SafeThreadProxy : public SafeThreadProxyBase {
|
||||
public:
|
||||
@@ -52,7 +59,9 @@ class SafeThreadProxy : public SafeThreadProxyBase {
|
||||
T* operator->() const { return static_cast<T*>(m_thread.get()); }
|
||||
};
|
||||
|
||||
// Non-template owner base class for common owner code.
|
||||
/**
|
||||
* Non-template owner base class for common owner code.
|
||||
*/
|
||||
class SafeThreadOwnerBase {
|
||||
public:
|
||||
void Stop();
|
||||
|
||||
Reference in New Issue
Block a user