docs: wording, table of contents, and misc changes
This commit is contained in:
@@ -1,11 +1,21 @@
|
|||||||
<h1 align="center">
|
<h1 align="center">
|
||||||
<b>seallib</b>
|
<b>🦭seallib🦭</b>
|
||||||
</h1>
|
</h1>
|
||||||
|
|
||||||
<p align="center">
|
<p align="center">
|
||||||
A modular and tiny C++20 powered library collection of random stuff I've needed for other projects.
|
A <b>modular and tiny C++20</b> powered library collection of random stuff I've needed for other projects.
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
|
## Table of Contents
|
||||||
|
* [Installation & Integration](#installation--integration)
|
||||||
|
* [Build Options](#build-options)
|
||||||
|
* [Modules](#-modules)
|
||||||
|
* [Logging](#1-logging)
|
||||||
|
* [Assert](#2-assert)
|
||||||
|
* [Events](#3-events)
|
||||||
|
* [VFS](#4-vfs)
|
||||||
|
* [Running tests](#-running-tests)
|
||||||
|
|
||||||
## Installation & Integration
|
## Installation & Integration
|
||||||
|
|
||||||
### 1. Requirements
|
### 1. Requirements
|
||||||
@@ -49,6 +59,7 @@ target_link_libraries(your_project PRIVATE seallib)
|
|||||||
---
|
---
|
||||||
|
|
||||||
## Build Options
|
## Build Options
|
||||||
|
Toggle features by setting these variables to ``ON`` or ``OFF`` in your CMake configuration.
|
||||||
| Option | Description | Default |
|
| Option | Description | Default |
|
||||||
| :--- | :--- | :--- |
|
| :--- | :--- | :--- |
|
||||||
| SEALLIB_ASSERT | Enable Assertion utility | OFF |
|
| SEALLIB_ASSERT | Enable Assertion utility | OFF |
|
||||||
@@ -59,9 +70,8 @@ target_link_libraries(your_project PRIVATE seallib)
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## Module Instructions
|
## Modules
|
||||||
|
|
||||||
<a name="module-logging"></a>
|
|
||||||
### 1. Logging
|
### 1. Logging
|
||||||
The Log module uses a Sink architecture. You create a Logger, attach an ILogSink, and log messages using std::format syntax.
|
The Log module uses a Sink architecture. You create a Logger, attach an ILogSink, and log messages using std::format syntax.
|
||||||
|
|
||||||
@@ -91,11 +101,9 @@ int main() {
|
|||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
<a name="module-assertion"></a>
|
|
||||||
### 2. Assert
|
### 2. Assert
|
||||||
(Documentation pending implementation)
|
(Documentation pending implementation)
|
||||||
|
|
||||||
<a name="module-events"></a>
|
|
||||||
### 3. Events
|
### 3. Events
|
||||||
The Events module provides a thread and type safe signal/slot mechanism. It allows you to define custom events with any number of parameters and subscribe to them using callbacks.
|
The Events module provides a thread and type safe signal/slot mechanism. It allows you to define custom events with any number of parameters and subscribe to them using callbacks.
|
||||||
#### Basic Usage
|
#### Basic Usage
|
||||||
@@ -131,7 +139,6 @@ int main() {
|
|||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
<a name="module-vfs"></a>
|
|
||||||
### 4. VFS
|
### 4. VFS
|
||||||
The VFS (Virtual File System) module provides a unified interface for file operations by mapping virtual paths to user defined providers.
|
The VFS (Virtual File System) module provides a unified interface for file operations by mapping virtual paths to user defined providers.
|
||||||
|
|
||||||
@@ -214,7 +221,7 @@ int main() {
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## Running Tests
|
## Running tests
|
||||||
|
|
||||||
### Windows (PowerShell + Visual Studio)
|
### Windows (PowerShell + Visual Studio)
|
||||||
A script is provided to automate generation and open the solution in Visual Studio:
|
A script is provided to automate generation and open the solution in Visual Studio:
|
||||||
|
|||||||
Reference in New Issue
Block a user