v0.0.3

🚀 Features

New features and additions

• ✨Support doxygen-like filters. 6841950
• 💫Corpus ordered traverse. ed78539
• 🌟Info ExtractionMode. f0adca7
• ✨Info Attribute lists. d92629d
• 💫Template pre/post conditions are unordered lists. 0e3c9a8
• 🌟Template param direction. 963a387
• ✨Tranches include namespace aliases. 9662f27
• 💫Support glob patterns. 1b67a84
• ✨ Config YAML schema. 1e162bf (thanks @betterqualityassuranceuser)
• 💫 Support anonymous union members. 8d8a007
• 🌟 Uniform logging level control across CorpusImpl. 3f24987
• ✨ Html concept templates. 9dd2f6d
• 💫 Embedded option.¹ decaf3e
• 🌟 Output base directory support for relative paths. af97cfe (thanks @betterqualityassuranceuser)
• ✨ Tagfiles. (fix #650) be64902
• 💫 Asciidoc universal escaping. (substitutions: g based on passthroughs without universal escaping based on character substitutions: https://docs.asciidoctor.org/asciidoc/latest/subs/replacements/, fix #763) e2ae861 (thanks @anarthal)
  • 🌟 MRDOCS macro. 49849a5
  • ✨ use-system-libc option. (fix #731) 1579517
• Handlebars:
  • 💫 Support recursive partial blocks. 6f5bf3d
  • 🌟 Block whitespace control. 3b12ca3
  • ✨ Value constructor helpers. 739b8fb
  • 💫 Custom escape functions.² 59fe95d
  • 🌟 Options data provide root context. e545dfe
  • ✨ Concat helper variadic arguments. b11bdd6
• HandlebarsGenerator:
  • 💫 Common helper templates. 3cce490
  • 🌟 Overloads partial. bca5a46
  • ✨ Unify signature helpers. e33b47d
  • 💫 Unify symbol partials. 2da68d8
• 🌟 Builder: Relativize helper. 80b1116
• ✨ templates: Common signature entry partial. 3f0ddbd
• 💫 Config: Paths relative to secondary options. 4bbf7ec

🐛 Fixes

Bug fixes and error corrections

• Map translation units to global namespaces. 266f49c
• Friends use type declarator. 96c42d5
• Do not omit frame pointer in tests. 723f34f
• Infinite recursion when identifying SFINAE types. 5750b79
• Missing template parameters in asciidoc templates. a962db0
• Lazy object construct when atomic shared pointers are unsupported. efe0620
• Handlebars unit tests are unrelated to is_multipage. 9ef4c38
• Support SFINAE detection for compound types. cc08383
• Deduplicate inherited members. 91c6871
• HTML anchors are unescaped. 9312ffb
• Overload set overview is unescaped. 826295c
• Multipage section levels. 36a9eb8
• Uniform signature code blocks. 833dee2
• No relative asciidoc links.³ 8693504
• Adoc multipage wrapper includes relfileprefix. bcd8372
• Tables have no enumerator anchors. 0e36580
• Use arguments to \par if available. 03d1a75
• Path: Scoped temp directories use llvm's remove_directories. 691ce1d
• Handlebars:
  • Helper calls report errors. 29f4d4f
  • "or" helper returns first truthy value. f9e7af4
• HandlebarsGenerator:
  • Sync HTML helper templates. 12bbc1d
  • Escape reserved chars. a89e82f
  • Relative URLs. 6156756
• Generator: Propagate createDirectory error. ece7e7d

⚡️ Performance

Performance optimizations and enhancements

• OverlayObjectImpl: Fold empty overlays. 184448a
• Builder:
  • Render templates directly to ostream. 3d38f59
  • Load template layouts at construction. 9543810

♻️ Refactor

Code refactoring and restructuring

• Unify traverse functions. 938b673
• InfoTypeFor trait. f225a4f
• Info parent is not always namespace. 7d8de21
• Corpus qualified name returns void. f92f1f2
• Referenced-declarations default is never. 9edf3ab
• Drop bitcode support. e6205d5
• Options are quoted in messages. eaff684
• Split error message from source location in reports. (fix #672) 446a41d (thanks @akrzemi1)
• Version command includes build. f600633
• Compilation database ensures target. 9871794
• Compilation database ensures std. (fix #694) b5a36db
• Remove unused mergeInfos. c072007
• Remove BitField/BitFlag. c56dcae
• Temp directories use output path. 1aca304
• Info nodes configuration file. 9daf71f
• Lazy object mapping traits. (fix #696) 9d30ea1
• Public settings initialize relativeto.⁴ 59b3012
• Unify dom lazy array classes.⁵ e919a61
• Dom::Value tag_invoke. 2663199
• Dom::LazyObject tag_invoke. de7f589
• Custom ValueFrom for Info types. 4393f22
• Synchronize HTML templates. 0823b48
• Simplify handlebars generators.⁶ (Generator: main reason the HTML Generator is always behind the Adoc Generator: simple features were not duplicated in the HTML generator. This even justified #656, where we would temporarily remove the HTML generator., fix #656) e6ee971
• Deduction guides for CTAD warnings. efccb11
• Remove unused alias. df43d87
• Generator reports time. e24492d
• Single page references are fragments. 1d253d7
• No intermediary buffers for wrapper template. 5bc9f53
• Time report supports minutes. 5cd44bd
• Modular ASTVisitor. dee9fdf
• Platform: Support arm64. d92de4e
• generate-config-info: Normalization via visitor. a1fb8ec
• TestArgs: Reuse public config args. 3a22947
• test: Remove unused lambda capture. 70bff87
• LazyObject:
  • Header macros belong in LIB. 3ebf66d
  • Initialize result. 17a7212
• DomCorpus: Inline operators. 8d2948a
• Template: Remove unused parameter. 6639b8d
• Generator: Build member function. eb464a3
• HandlebarsGenerator:
  • ToString customization is virtual function. 7d7f949
  • Simplify build function.⁷ 5209438
  • Remove unused options. 5f9e5a1
  • Do not require symbol as hash parameter. fc43804
  • Single page HTML includes reference title. 75fdb49
• Handlebars: Distinguish ostream types. 1efcc2e
• Builder: Is_multipage does not require helper. 713b573
• Error: Error propagation uses Expected. 0b4d669
• Radix: No redundant static. fb7d6b9

📖 Documentation

Documentation updates and improvements

• Website build scripts set cxx_std_23. a8707b0
• Libc++ compiler requirements. 9648483
• Releases extension allows CI authentication and retries. 55214d7
• Generator DOM reference. f551db3
• Generator layout entry points. e052cb7
• Website panels use embedded HTML. 12ceade
• usage:
  • Cmake example uses TMP_CPP_FILE.⁸ d8b7fcf (thanks @betterqualityassuranceuser)
  • Include MrDocs workflow. 0e08458
• LazyObject: Update documentation. c521719
• Scope: Include lookups in documentation. b078bea
• generators:
  • Common templates. ac20c36
  • Use cases and trade-offs. 2307ca6
  • Template partials. c194416 (thanks @betterqualityassuranceuser)
• contribute: Workflow is partial. 555e2c4
• demos: Enable HTML demos. d38d3e1

🎨 Style

Code style and formatting changes

• Scope: Standardize indentation. 0b9f944
• Requires clauses on their own line. c6cc73c
• Declarators render unnamed symbols. 9ddac83

📦️ Build

Build system and configuration changes

• Generate yaml schema.⁹ 5bc071e

🧪 Tests

Test cases and testing-related changes

• Support file inputs. 75b1bc5
• Use snprintf. 279e37f
• Asciidoc golden tests. 2bc09e6
• Html golden tests. 9eece73
• Report level is error. c6076e9
• Config multipage is off. 8d9fa1e
• TestRunner: Check Expected values. 46a3152

🚦 Continuous Integration

Changes related to continuous integration

• Enable macos. (fix #558) 390159e
• Fix package asset uploads. d1c3566
• Demos artifact path is relative. 62736e4
• Coverage workflow. 1259131
• Check config schema is up to date. cb18b87
• Remove info node support warnings. 62f361f
• Enable html demos. c46c4a9
• Containers install git. 43e5f25
• Clang 18 uses ubuntu:24.04. b3ac35d
• Fix file count report. c376277
• Export SSH_AUTH_SOCK. 3470b10
• llvm-matrix: Filter uses Node.js 20. f3b33a4
• llvm-releases:
  • Handle empty llvm releases matrix. 5982cc7
  • Ssh uses relative user paths.¹⁰ a820ad7
• releases:
  • Test all releases. (fix #671) 9348766
  • Antora includes stacktraces. 5e0f628

🏗️ Chores

Routine tasks, maintenance, and housekeeping

• Bump LLVM commit hash to dd7a3d4 (#728). e41d780 (thanks @betterqualityassuranceuser)
• Version is 0.0.3. 54e75a7

1. Like the asciidoc option, this option can be used to generate pages without the surrounding tags to include them in other documentation pages, like the mrdocs website. ↩

2. Some applications might need custom escape functions either because the output format is not HTML or because the application requires more strict HTML escaping. ↩

3. See https://gitlab.com/antora/antora/-/issues/428. ↩

4. This fixes a warning when using initialization with designators. ↩

5. The DomCorpus uses multiple classes that represented lazy arrays. This commit simplifies the dom by unifying all of these array implementations. ↩

6. Apart from the DocVisitor, the Adoc and HTML generators are nearly 100% duplicated code.This commit unifies the standard code to remove duplicated code, simplify maintenance, and ensure that both generators always have access to the same features.In passing, many missing features in the HTML generator are now available. ↩

7. Unify code duplicated between build and buildOne. ↩

8. The Cmake example for header-only libraries compiles by replacing OUTPUT_FILE with TMP_CPP_FILE. ↩

9. Generate yaml schema as part of the custom target. ↩

10. The previously hard-coded paths only work on ubuntu. On windows and macOS, these paths don't exist, don't have the necessary permissions, or are ignored by ssh. ↩