Skip to content

Commit b0cf967

Browse files
Fixing minor issues
1 parent 8b29b29 commit b0cf967

2 files changed

Lines changed: 11 additions & 11 deletions

File tree

‎.github/workflows/gen_docs.yml‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ jobs:
2020
- name: run-doxygen
2121
uses: mattnotmitt/doxygen-action@v1.9.8
2222
with:
23-
working-directory: docs
23+
working-directory: doc
2424
- name: deploy-pages
2525
uses: peaceiris/actions-gh-pages@v4
2626
with:

‎README.md‎

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,40 +1,40 @@
1-
# `wait-queue` is a header-only C++ 20 MPMC (multiple producer / multiple consumer) thread-safe queue for passing data between threads.
1+
# Wait Queue, a Header-Only C++ 20 MPMC Thread-Safe Queue
22

3-
# Unit Test and Documentation Generation Workflow Status
3+
### Unit Test and Documentation Generation Workflow Status
44

55
![GH Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/connectivecpp/wait-queue/build_run_unit_test_cmake.yml?branch=main&label=GH%20Actions%20build,%20unit%20tests%20on%20main)
66

77
![GH Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/connectivecpp/wait-queue/build_run_unit_test_cmake.yml?branch=develop&label=GH%20Actions%20build,%20unit%20tests%20on%20develop)
88

99
![GH Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/connectivecpp/wait-queue/gen_docs.yml?branch=main&label=GH%20Actions%20generate%20docs)
1010

11-
# Overview
11+
## Overview
1212

13-
`wait_queue` is a multi-reader, multi-writer FIFO queue for transferring data between threads. It is templatized on the type of data passed through the queue as well as the queue container type. Data is passed with value semantics, either by copying or by moving (as opposed to a queue that transfers data by pointer or reference). The wait queue has both wait and no-wait pop semantics. A fixed size container (e.g. a `ring_span`) can be used, eliminating any and all dynamic memory management (useful in embedded or deterministic environments). Similarly, a circular buffer that only allocates on construction can be used, which eliminates dynamic memory management when pushing or popping values on or off the queue.
13+
`wait_queue` is a multi-reader, multi-writer FIFO queue (often called MPMC for multiple producer / multiple consumer) for transferring data between threads. It is templatized on the type of data passed through the queue as well as the queue container type. Data is passed with value semantics, either by copying or by moving (as opposed to a queue that transfers data by pointer or reference). The wait queue has both wait and no-wait pop semantics. A fixed size container (e.g. a `ring_span`) can be used, eliminating any and all dynamic memory management (useful in embedded or deterministic environments). Similarly, a circular buffer that only allocates on construction can be used, which eliminates dynamic memory management when pushing or popping values on or off the queue.
1414

1515
A graceful shutdown can be performed using the `request_stop` method (modeled on the C++ 20 `request_stop` from `std::stop_source`). This allows waiting reader threads to be notified for shutdown. Alternatively a `std::stop_token` can be passed in to the `wait_queue` constructor, allowing shutdown from outside of the `wait_queue` object.
1616

1717
`wait_queue` is inspired by code from Anthony Williams' Concurrency in Action book, although heavily modified.
1818

1919
Additional documentation can be found dkfjlkjdlkjklj
2020

21-
# Generated Documentation
21+
## Generated Documentation
2222

2323
The generated Doxygen documentation for `wait_queue` is [here](https://connectivecpp.github.io/presentations/).
2424

25-
# Dependencies
25+
## Dependencies
2626

2727
The `wait-queue` header file does not have any third-party dependencies. It uses C++ standard library headers only. The unit test code does have dependencies as noted below.
2828

29-
# C++ Standard
29+
## C++ Standard
3030

3131
`wait-queue` uses C++ 20 features, including `std::stop_token`, `std::stop_source`, `std::condition_variable_any`, `std::scoped_lock`, and `concepts` / `requires`.
3232

33-
# Supported Compilers
33+
## Supported Compilers
3434

3535
Continuous integration workflows build and unit test on g++ (through Ubuntu), MSVC (through Windows), and clang (through macOS).
3636

37-
# Unit Test Dependencies
37+
## Unit Test Dependencies
3838

3939
The unit test code uses [Catch2](https://github.com/catchorg/Catch2). If the `WAIT_QUEUE_BUILD_TESTS` flag is provided to Cmake (see commands below) the Cmake configure / generate will download the Catch2 library as appropriate using the [CPM.cmake](https://github.com/cpm-cmake/CPM.cmake) dependency manager. If Catch2 (v3 or greater) is already installed using a different package manager (such as Conan or vcpkg), the `CPM_USE_LOCAL_PACKAGES` variable can be set which results in `find_package` being attempted. Note that v3 (or later) of Catch2 is required.
4040

@@ -45,7 +45,7 @@ The unit test uses two third-party libraries (each is a single header-only file)
4545

4646
Specific versions and / or branches for the dependencies are in `test/CMakeLists.txt`.
4747

48-
# Build and Run Unit Tests
48+
## Build and Run Unit Tests
4949

5050
To build and run the unit test program:
5151

0 commit comments

Comments
 (0)