summaryrefslogtreecommitdiffstats
path: root/src/OSSupport
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--src/OSSupport/CriticalSection.h4
-rw-r--r--src/OSSupport/GZipFile.h8
-rw-r--r--src/OSSupport/Queue.h39
3 files changed, 25 insertions, 26 deletions
diff --git a/src/OSSupport/CriticalSection.h b/src/OSSupport/CriticalSection.h
index a95a9a0cd..236a7d203 100644
--- a/src/OSSupport/CriticalSection.h
+++ b/src/OSSupport/CriticalSection.h
@@ -37,7 +37,7 @@ private:
-/// RAII for cCriticalSection - locks the CS on creation, unlocks on destruction
+/** RAII for cCriticalSection - locks the CS on creation, unlocks on destruction */
class cCSLock
{
cCriticalSection * m_CS;
@@ -64,7 +64,7 @@ private:
-/// Temporary RAII unlock for a cCSLock. Useful for unlock-wait-relock scenarios
+/** Temporary RAII unlock for a cCSLock. Useful for unlock-wait-relock scenarios */
class cCSUnlock
{
cCSLock & m_Lock;
diff --git a/src/OSSupport/GZipFile.h b/src/OSSupport/GZipFile.h
index 286c98aff..d1728fd8e 100644
--- a/src/OSSupport/GZipFile.h
+++ b/src/OSSupport/GZipFile.h
@@ -27,16 +27,16 @@ public:
cGZipFile(void);
~cGZipFile();
- /// Opens the file. Returns true if successful. Fails if a file has already been opened through this object.
+ /** Opens the file. Returns true if successful. Fails if a file has already been opened through this object. */
bool Open(const AString & a_FileName, eMode a_Mode);
- /// Closes the file, flushing all buffers. This object may be then reused for a different file and / or mode
+ /** Closes the file, flushing all buffers. This object may be then reused for a different file and / or mode */
void Close(void);
- /// Reads the rest of the file and decompresses it into a_Contents. Returns the number of decompressed bytes, <0 for error
+ /** Reads the rest of the file and decompresses it into a_Contents. Returns the number of decompressed bytes, <0 for error */
int ReadRestOfFile(AString & a_Contents);
- /// Writes a_Contents into file, compressing it along the way. Returns true if successful. Multiple writes are supported.
+ /** Writes a_Contents into file, compressing it along the way. Returns true if successful. Multiple writes are supported. */
bool Write(const AString & a_Contents) { return Write(a_Contents.data(), static_cast<int>(a_Contents.size())); }
bool Write(const char * a_Data, int a_Size);
diff --git a/src/OSSupport/Queue.h b/src/OSSupport/Queue.h
index afbde1b0d..00d21c49b 100644
--- a/src/OSSupport/Queue.h
+++ b/src/OSSupport/Queue.h
@@ -16,19 +16,18 @@ To create a queue of type T, instantiate a cQueue<T> object. You can also
modify the behavior of the queue when deleting items and when adding items
that are already in the queue by providing a second parameter, a class that
implements the functions Delete() and Combine(). An example is given in
-cQueueFuncs and is used as the default behavior.
-*/
+cQueueFuncs and is used as the default behavior. */
-/// This empty struct allows for the callback functions to be inlined
+/** This empty struct allows for the callback functions to be inlined */
template <class T>
struct cQueueFuncs
{
public:
- /// Called when an Item is deleted from the queue without being returned
+ /** Called when an Item is deleted from the queue without being returned */
static void Delete(T) {}
- /// Called when an Item is inserted with EnqueueItemIfNotPresent and there is another equal value already inserted
+ /** Called when an Item is inserted with EnqueueItemIfNotPresent and there is another equal value already inserted */
static void Combine(T & a_existing, const T & a_new)
{
UNUSED(a_existing);
@@ -54,7 +53,7 @@ public:
~cQueue() {}
- /// Enqueues an item to the queue, may block if other threads are accessing the queue.
+ /** Enqueues an item to the queue, may block if other threads are accessing the queue. */
void EnqueueItem(ItemType a_Item)
{
cCSLock Lock(m_CS);
@@ -63,7 +62,7 @@ public:
}
- /// Enqueues an item in the queue if not already present (as determined by operator ==). Blocks other threads from accessing the queue.
+ /** Enqueues an item in the queue if not already present (as determined by operator ==). Blocks other threads from accessing the queue. */
void EnqueueItemIfNotPresent(ItemType a_Item)
{
cCSLock Lock(m_CS);
@@ -81,8 +80,8 @@ public:
}
- /// Dequeues an item from the queue if any are present.
- /// Returns true if successful. Value of item is undefined if dequeuing was unsuccessful.
+ /** Dequeues an item from the queue if any are present.
+ Returns true if successful. Value of item is undefined if dequeuing was unsuccessful. */
bool TryDequeueItem(ItemType & item)
{
cCSLock Lock(m_CS);
@@ -97,7 +96,7 @@ public:
}
- /// Dequeues an item from the queue, blocking until an item is available.
+ /** Dequeues an item from the queue, blocking until an item is available. */
ItemType DequeueItem(void)
{
cCSLock Lock(m_CS);
@@ -113,7 +112,7 @@ public:
}
- /// Blocks until the queue is empty.
+ /** Blocks until the queue is empty. */
void BlockTillEmpty(void)
{
cCSLock Lock(m_CS);
@@ -125,7 +124,7 @@ public:
}
- /// Removes all Items from the Queue, calling Delete on each of them.
+ /** Removes all Items from the Queue, calling Delete on each of them. */
void Clear(void)
{
cCSLock Lock(m_CS);
@@ -137,8 +136,8 @@ public:
}
- /// Returns the size at time of being called.
- /// Do not use to determine whether to call DequeueItem(), use TryDequeueItem() instead
+ /** Returns the size at time of being called.
+ Do not use to determine whether to call DequeueItem(), use TryDequeueItem() instead */
size_t Size(void)
{
cCSLock Lock(m_CS);
@@ -146,8 +145,8 @@ public:
}
- /// Removes the item from the queue. If there are multiple such items, only the first one is removed.
- /// Returns true if the item has been removed, false if no such item found.
+ /** Removes the item from the queue. If there are multiple such items, only the first one is removed.
+ Returns true if the item has been removed, false if no such item found. */
bool Remove(ItemType a_Item)
{
cCSLock Lock(m_CS);
@@ -187,16 +186,16 @@ public:
}
private:
- /// The contents of the queue
+ /** The contents of the queue */
QueueType m_Contents;
- /// Mutex that protects access to the queue contents
+ /** Mutex that protects access to the queue contents */
cCriticalSection m_CS;
- /// Event that is signalled when an item is added
+ /** Event that is signalled when an item is added */
cEvent m_evtAdded;
- /// Event that is signalled when an item is removed (both dequeued or erased)
+ /** Event that is signalled when an item is removed (both dequeued or erased) */
cEvent m_evtRemoved;
};