mirror of
https://github.com/Ed94/metadesk.git
synced 2026-08-03 14:18:45 +00:00
update gen_c11 & gen_cpp17 docs
This commit is contained in:
@@ -1,3 +1,21 @@
|
||||
# gen_c11
|
||||
|
||||
[gen_c11.c](./gen_c11.c) generates both *segregated* and *single-header* varients of the metadesk library utilizing [gencpp_c11](../third_party/gencpp_c11/).
|
||||
|
||||
Generated content will be place in a subdirectory called `/gen`.
|
||||
|
||||
[gen_common.h](./gen_common.h) contains implementation that will eventually be utilized by [gen_cpp17](../gen_cpp17/).
|
||||
|
||||
The prefix `md_` or `MD_` (depending on type of symbol) will be prepended to the symbols of the library using [refactor.exe](../bin/refactor.exe) which is from the [refactor repo](https://github.com/Ed94/refactor).
|
||||
|
||||
[c11.refactor](./c11.refactor) is the script defining all the rename mappings
|
||||
|
||||
[.clang_format](../bin/.clang_format) is used to cleanup library's formatting on some files post-refactor.
|
||||
|
||||
The generation takes a few seconds due to how slow both clang-format and refactor.exe are. Eventually I wish to make refactor a c11 library to offset it that problem but I don't have a good solution to clang_format yet.
|
||||
|
||||
If using the powershell script [build.ps1](../bin/build.ps1); Use the following command:
|
||||
|
||||
```ps1
|
||||
.\build gen_c11 <debug> <msvc>
|
||||
```
|
||||
|
||||
@@ -1,3 +1,5 @@
|
||||
# gen_cpp17
|
||||
|
||||
Eventually this will generate a more ergonomic version of metadesk for C++17 usage.
|
||||
|
||||
For now however the goal is just to get the c11 library variants working with the old tests and exmaples.
|
||||
|
||||
Reference in New Issue
Block a user