Skip to content

Commit

Permalink
Update README.md (#527)
Browse files Browse the repository at this point in the history
TEST
  • Loading branch information
KjellKod authored May 23, 2024
1 parent 3f6213c commit ab52ec0
Show file tree
Hide file tree
Showing 7 changed files with 14 additions and 8 deletions.
1 change: 1 addition & 0 deletions .github/workflows/buildAndRunTests.yml
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,7 @@ on:
- docs/**
- '**.md'
- '**.markdown'
- '**.yml'
branches: [ master ]
pull_request:
paths-ignore:
Expand Down
1 change: 1 addition & 0 deletions .github/workflows/codeql-analysis.yml
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,7 @@ on:
- docs/**
- '**.md'
- '**.markdown'
- '**.yml'
branches: [ master ]
pull_request:
paths-ignore:
Expand Down
1 change: 1 addition & 0 deletions .github/workflows/ctest.yml
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ on:
- docs/**
- "**.md"
- "**.markdown"
- '**.yml'
branches:
- master
env:
Expand Down
8 changes: 5 additions & 3 deletions .github/workflows/docs.yml
Original file line number Diff line number Diff line change
@@ -1,11 +1,13 @@
name: Publish docs via GitHub Pages to https://kjellkod.github.io/g3log/
name: doc_publish
# Publish docs via GitHub Pages to https://kjellkod.github.io/g3log/
on:
push:
branches:
- master
paths:
- "**.md"
- "mkdocs.yml"
- "**.yml"
- docs/**


jobs:
Expand All @@ -16,7 +18,7 @@ jobs:
- uses: actions/setup-python@v5
with:
python-version: 3.x
- run: pip install mkdocs-material
- run: pip install mkdocs && pip install mkdocs-material
- name: Build site
run: mkdocs build
- name: Deploy
Expand Down
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ G3log is an asynchronous logger with three main features:

The super quick introduction to g3log can be seen in the steps 1 - 9 below.

For more in-depth information please see the full usage description in [g3log_usage.md](docs/g3log_usage.md).If you want to understand better the internals of g3log, then plase look at the [API.md](docs/API.md) for both high-level and deep-dive insights.
For more in-depth information please see the full usage description in [g3log_usage.md](docs/g3log_usage.md). If you want to understand better the internals of g3log, then plase look at the [API.md](docs/API.md) for both high-level and deep-dive insights.


## Experiment and try-out g3log in Github Codespaces
Expand All @@ -28,7 +28,7 @@ Avoid deep dependency injection complexity and instead get access to the logger


## 2. Access to streaming and print_f log call syntax
Both streaming syntax `LOG` and print_f `LOGF` syntax are available.
Both streaming syntax `LOG` and print_f `LOGF` syntax are available

```
LOGF(INFO, "Hi log %d", 123);
Expand Down
2 changes: 1 addition & 1 deletion docs/API.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
[introduction](index.md) | [detailed information](g3log_usage.md) | [Configure & Build](building.md) | [**API description**](API.md) | [Custom log formatting](API_custom_formatting.md)

# High Level Description of g3log
The `g3log` logger is an asynchronous, crash-safe logging library designed for C++ applications. It allows for logging messages to various sinks without blocking the main application thread. Below is a high-level overview of how the `g3log` logger works:
The `g3log` logger is an asynchronous, crash-safe logging library designed for C++ applications. It allows for logging messages to various sinks without blocking the main application thread. Below is a high-level overview of how the `g3log` logger works.

## Asynchronous Logging
The logger operates on a separate thread, ensuring that the main application thread is not blocked by I/O operations when logging messages. This is achieved by using a background worker ([`LogWorker`](../src/g3log/logworker.hpp)) that queues log messages and processes them asynchronously.
Expand Down
5 changes: 3 additions & 2 deletions mkdocs.yml
Original file line number Diff line number Diff line change
@@ -1,10 +1,11 @@
site_name: G3log, an asynchronous "crash-safe" logger
site_author: 'Kjell Hedström'
theme:
name: material
plugins:
- search
docs_dir: docs/
theme:
name: material

nav:
- Introduction to G3log: index.md
- G3log usage: g3log.md
Expand Down

0 comments on commit ab52ec0

Please sign in to comment.