* updating for mkdocs generation
* updated look
This commit is contained in:
Kjell Hedström. We are hiring @ Ganaz 2022-05-28 21:38:45 -06:00 committed by GitHub
parent 0e3fef50bb
commit fec09b2bba
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
5 changed files with 230 additions and 233 deletions

View File

@ -47,7 +47,7 @@ jobs:
# Initializes the CodeQL tools for scanning. # Initializes the CodeQL tools for scanning.
- name: Initialize CodeQL - name: Initialize CodeQL
uses: github/codeql-action/init@v1 uses: github/codeql-action/init@v2
with: with:
languages: ${{ matrix.language }} languages: ${{ matrix.language }}
# If you wish to specify custom queries, you can do so here or in a config file. # If you wish to specify custom queries, you can do so here or in a config file.
@ -58,7 +58,7 @@ jobs:
# Autobuild attempts to build any compiled languages (C/C++, C#, or Java). # Autobuild attempts to build any compiled languages (C/C++, C#, or Java).
# If this step fails, then you should remove it and run the build manually (see below) # If this step fails, then you should remove it and run the build manually (see below)
- name: Autobuild - name: Autobuild
uses: github/codeql-action/autobuild@v1 uses: github/codeql-action/autobuild@v2
# Command-line programs to run using the OS shell. # Command-line programs to run using the OS shell.
# 📚 https://git.io/JvXDl # 📚 https://git.io/JvXDl
@ -72,4 +72,4 @@ jobs:
# make release # make release
- name: Perform CodeQL Analysis - name: Perform CodeQL Analysis
uses: github/codeql-action/analyze@v1 uses: github/codeql-action/analyze@v2

View File

@ -1,9 +1,19 @@
***PULL REQUEST DESCRIPTION*** # PULL REQUEST DESCRIPTION
`ADD CONTENT HERE TO DESCRIBE THE PURPOSE OF THE PULL REQUEST` `ADD CONTENT HERE TO DESCRIBE THE PURPOSE OF THE PULL REQUEST`
**Testing Advice** # Testing
- [] This new/modified code was covered by unit tests.
- [] (insight) Was all tests written using TDD (Test Driven Development) style?
- [] The CI (Windows, Linux, OSX) are working without issues.
- [] Was new functionality documented?
- [] The testing steps 1 - 2 below were followed
_step 1_ _step 1_
@ -18,13 +28,3 @@ _step 2: use one of these alternatives to run tests:_
- Cross-Platform: `ctest` - Cross-Platform: `ctest`
- or `ctest -V` for verbose output - or `ctest -V` for verbose output
- Linux: `make test` - Linux: `make test`
***CHECKLIST TO COMPLETE***
- [ ] **TDD**: New/modified code must be backed down with unit test - preferably _Test Driven Development_ style development)
- [ ] **Documentation**: All new/modified functionality should be backed up with API documentation (API.markdown or README.markdown)
**Cross-Platform Testing**
- [ ] CI GitActions: (Linux, OSX) + AppVeyor-CI (Windows)\
- [ ] Local/VM testing, at least one of the following: Windows, Linux, OSX

View File

@ -1,4 +1,4 @@
# How to use G3log # How to use g3log
G3log is an asynchronous logger with dynamic sinks G3log is an asynchronous logger with dynamic sinks
@ -10,7 +10,7 @@ LOG(INFO) << "streaming API is as easy as ABC or " << 123;
LOGF(WARNING, "Printf-style syntax is also %s", "available"); LOGF(WARNING, "Printf-style syntax is also %s", "available");
``` ```
## <a name="what-g3log-is">What G3Log is</a> ## <a name="what-g3log-is">What g3Log is</a>
* ***G3log*** is the acting name for the third version of g2log and it stands for **g3log with dynamic sinks** * ***G3log*** is the acting name for the third version of g2log and it stands for **g3log with dynamic sinks**
* G3log is an asynchronous, "crash-safe" logger. You can read more about it here [[g2log version]]( * G3log is an asynchronous, "crash-safe" logger. You can read more about it here [[g2log version]](
@ -44,7 +44,7 @@ CHECK(less > more) << "CHECK(false) triggers a FATAL message";
Please look at [API.md](API.md) for detailed API documentation Please look at [API.md](API.md) for detailed API documentation
## <a name="benefits-with-g3log">Benefits you get when using G3log</a> ## <a name="benefits-with-g3log">Benefits you get when using g3log</a>
1. Easy to use, clean syntax and a blazing fast logger. 1. Easy to use, clean syntax and a blazing fast logger.
2. All the slow log I/O disk access is done in a background thread. This ensures that the LOG caller can immediately continue with other tasks and do not have to wait for the LOG call to finish. 2. All the slow log I/O disk access is done in a background thread. This ensures that the LOG caller can immediately continue with other tasks and do not have to wait for the LOG call to finish.
@ -68,11 +68,11 @@ The logger will catch certain fatal events *(Linux/OSX: signals, Windows: fatal
## <a name="g3log-with-sinks">G3log with sinks</a> ## <a name="g3log-with-sinks">G3log with sinks</a>
[Sinks](http://en.wikipedia.org/wiki/Sink_(computing)) are receivers of LOG calls. G3log comes with a default sink (*the same as G3log uses*) that can be used to save log to file. A sink can be of *any* class type without restrictions as long as it can either receive a LOG message as a *std::string* **or** as a *g3::LogMessageMover*. [Sinks](http://en.wikipedia.org/wiki/Sink_(computing)) are receivers of LOG calls. G3log comes with a default sink (*the same as g3log uses*) that can be used to save log to file. A sink can be of *any* class type without restrictions as long as it can either receive a LOG message as a *std::string* **or** as a *g3::LogMessageMover*.
The *std::string* comes pre-formatted. The *g3::LogMessageMover* is a wrapped struct that contains the raw data for custom handling in your own sink. The *std::string* comes pre-formatted. The *g3::LogMessageMover* is a wrapped struct that contains the raw data for custom handling in your own sink.
A sink is *owned* by the G3log and is added to the logger inside a ```std::unique_ptr```. The sink can be called though its public API through a *handler* which will asynchronously forward the call to the receiving sink. A sink is *owned* by the g3log and is added to the logger inside a ```std::unique_ptr```. The sink can be called though its public API through a *handler* which will asynchronously forward the call to the receiving sink.
It is <a name="crazy-simple">crazy simple to create a custom sink</a>. This example show what is needed to make a custom sink that is using custom log formatting but only using that It is <a name="crazy-simple">crazy simple to create a custom sink</a>. This example show what is needed to make a custom sink that is using custom log formatting but only using that
for adding color to the default log formatting. The sink forwards the colored log to cout for adding color to the default log formatting. The sink forwards the colored log to cout

View File

@ -1,2 +0,0 @@
## wrong file 1

View File

@ -1,6 +1,5 @@
site_name: G3log, an asynchronous "crash-safe" logger site_name: G3log, an asynchronous "crash-safe" logger
site_author: 'Kjell Hedström' site_author: 'Kjell Hedström'
docs_dir: docs/
repo_name: 'KjellKod/g3log' repo_name: 'KjellKod/g3log'
repo_url: 'https://github.com/KjellKod/g3log' repo_url: 'https://github.com/KjellKod/g3log'
theme: theme: