gencpp/gen_singleheader/Readme.md

## Navigation

# base

[Top](../Readme.md)

* [docs](../docs/Readme.md)

# Singleheader

Creates a single header file version of the library using `singleheader.cpp`.
Follows the same convention seen in the gb, stb, and zpl libraries.

If using the library's provided build scripts:

```ps1
.\build.ps1 <compiler> <debug or omit> singleheader
```
Large updates to docs 2024-12-10 19:31:50 -05:00			`## Navigation`

			`# base`

			`[Top](../Readme.md)`

			`* [docs](../docs/Readme.md)`

Progress towards bootstrap/singleheader generation I will most likely need to refactor some of the components & dependencies files to get the desired gneration implementation the way I want. Specficially I want to be able to eliminate macros I'm using for enums and common patterns for implmeentation of the data structures. When it comes to the cpp files, I may leave those alone as the macros largely help ith readability. Replacing those macros is expensive and most likely not worth it. The macros under consideration with replacing using the library bootstrap are: * Define_Types * Define_Operators * Define_Specifiers * GEN_Define_Attribute_Tokens * Define_CodeType * Using_Code * Define_TokType * def_constant_spec ? * Helper Macros for def_*_body functions ? AST unallowed types case macros? (The last three I'm unsure about as they work fine, and neeeding the debugger steps there is a rare scenario...) The enums could be manually generated and have its fields derived from a CSV (which is what genc is currently doing). This would allow the user to specify custom attribute macros as well with greater ease. I may maually inline ProcessModuleFlags, as its not even necessary as any specific symbol with a module flag will only use the export value. Import is only used on modules themselves (from what I can tell). The Parser::lex function could be offloaded to its own file in case the user wants to swap the entire thing out. (Most likely may want to for various purposes) The problem with extracting any definitions out of a component file currently is that will lead to splintering that componnet to multiple other components. This is necessary as the proper scanner is not implemented yet (only a reduimentary scan_file proc is made so far). 2023-07-24 22:19:21 -04:00			`# Singleheader`

dir restructuring just making it more organized (gen_ prefix for library generation meta-programs) 2024-11-30 16:50:53 -05:00			Creates a single header file version of the library using `singleheader.cpp`.
Updated single-header based on last cs and also docs 2023-08-28 23:52:44 -04:00			`Follows the same convention seen in the gb, stb, and zpl libraries.`
Large updates to docs 2024-12-10 19:31:50 -05:00
			`If using the library's provided build scripts:`

			```ps1
			`.\build.ps1 <compiler> <debug or omit> singleheader`
Update undef.macros.h 2024-12-11 14:08:34 -05:00			```