develop

🚀 Features

New features and additions

• undefined:
  • ✨ Configurable see-below and implementation-defined namespaces. () c476746
  • 💫 Support @n command. () 0d821e2
  • 🌟 Add 'select' handlebars helper. () 8c20d25
  • ✨ Render explicit-specifier in asciidoc output. () 3122db0
  • 💫 Allow multiple implementation-defined and see-below namespaces. () 2753767
  • 🌟 Warnings for duplicates. (closes cppalliance#266, cppalliance#350) a691052
  • ✨ Detect types implementing SFINAE idiom. () bb7d201
  • 💫 Overload folding on a single page. (fix cppalliance#647) e8840f3
  • 🌟 Support concepts and constraints (cppalliance#649). () abf42ae
  • ✨ Support CMAKE_ROOT. () 9060f86
  • 💫 Reproducible standard library outputs. () ce34057
  • 🌟 Config YAML schema. () 1e162bf
  • ✨ Support anonymous union members. () 8d8a007
  • 💫 Uniform logging level control across CorpusImpl. () 3f24987
  • 🌟 Html concept templates. () 9dd2f6d
  • ✨ Embedded option.¹ () decaf3e

🐛 Fixes

Bug fixes and error corrections

• undefined:
  • Escape names of overload set members. () 161b6f4
  • Test bug report messages refer to mrdocs. () ab29a11
  • Source-root is always normalized. () e96bd59
  • ToolArgs initialization is ordered. () 0dd9414
  • Merging of parameter names. () f19eb95
  • Global namespace is always created. () 81318c8
  • Identification of duplicate @returns (cppalliance#638). () 057778c
  • Ct_mft_expl_inline.xml USR is updated. () 53b46cb
  • ASTVisitor.cpp indexes are unsigned. () f8cc81e
  • No multiple titles in single-page Asciidoc. () e460d86
  • 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
• Path: Scoped temp directories use llvm's remove_directories. () 691ce1d

♻️ Refactor

Code refactoring and restructuring

• undefined:
  • Info tables. (fix cppalliance#549, cppalliance#553) 3456ba5
  • Config tables. () 340b978
  • Character set is base36. (closes cppalliance#376) 71ab1e6
  • East-const declarations. () 6c684c6
  • Simplify golden test reports. () c82e452
  • Config options target. () eea9026
  • Drop bitcode support. () e6205d5
  • Options are quoted in messages. () eaff684
  • Split error message from source location in reports. (fix cppalliance#672) 446a41d
  • Version command includes build. () f600633
  • Compilation database ensures target. () 9871794
  • Compilation database ensures std. (fix cppalliance#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 cppalliance#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 cppalliance#656, where we would temporarily remove the HTML generator., fix cppalliance#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
• 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
• Handlebars: Distinguish ostream types. () 1efcc2e
• Builder: Is_multipage does not require helper. () 713b573

📖 Documentation

Documentation updates and improvements

• undefined:
  • UI header and footer are clean. () 359d017
  • Simplified home page. () 83ff42c
  • Demos page has direct links. () 0d52577
  • Install page releases extension. () d04e10f
  • Complete usage examples. () 6e1ee8a
  • Commands page include examples. () 678b724
  • Complete config file reference. (fix cppalliance#525) a3fd0ce
  • Design notes includes rationale and philosophy. (fix cppalliance#154, cppalliance#615) 608a925
  • Complete contributor guide. () 42d32a4
  • README.adoc refers to documentation. () bd4cbad
  • Website landing page. () 05400c3
  • Landing page download link. () 8fba202
  • Unify author mode playbook. () 999ea4f
  • Simplify demos table. () 4d884f4
  • Config options reference extension. () a20d6e7
  • 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
• contribute: All directories are at section level 4. () d70ae7e
• usage: Cmake example uses TMP_CPP_FILE.⁶ () d8b7fcf
• LazyObject: Update documentation. () c521719
• Scope: Include lookups in documentation. () b078bea

🎨 Style

Code style and formatting changes

• Scope: Standardize indentation. () 0b9f944

📦️ Build

Build system and configuration changes

• undefined: Capitalized duktape package has precedence. () 05938ab

🧪 Tests

Test cases and testing-related changes

• undefined:
  • Golden tests print diff. () 073d85b
  • Golden tests output file. () c7d2920
  • Use snprintf. () 279e37f
  • Asciidoc golden tests. () 2bc09e6
  • Html golden tests. () 9eece73
  • Report level is error. () c6076e9
  • Config multipage is off. () 8d9fa1e

🚦 Continuous Integration

Changes related to continuous integration

• undefined:
  • Template consistency checks. () 380eb00
  • Secure known_hosts permissions with chmod 600. () ce04a1b
  • Demo variants via command line. () 0ea641b
  • HTML demos are restored. () 4552d29
  • Split test targets. () 3fa59db
  • Build-type is RelWithDebInfo. () 619d216
  • LLVM install falls back to binaries. () 76ff85d
  • Demos command is single-line. () 7f12879
  • Actions/checkout v4. () 691d8a6
  • No fallback for GHA LLVM cache. () 4c14e87
  • Unify release workflows. () 99f4608
  • Llvm releases.⁷ () 63c958a
  • Update llvm releases required workflows. () 58119e0
  • Llvm workflow installs curl. () 5dc3884
  • Optimized debug workflow. () 3500877
  • Unify llvm parameters. () bd54dc7
  • Intermediary steps use actions. () 3d92071
  • Resolve llvm-root for cache@v4. () 8537d3d
  • Enable macos. (fix cppalliance#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
• compare_templates: No empty warnings. () b8deda9
• 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 cppalliance#671) 9348766
  • Antora includes stacktraces. () 5e0f628

🏗️ Chores

Routine tasks, maintenance, and housekeeping

• undefined:
  • Link names in overload sets. () ca13ce1
  • Show full nested-name-specifiers of declarations in titles. () 131419b
  • Remove symbol kind from titles. () f033ec3
  • Rename 'safe names' to 'legible names'. () cac1bc8
  • Generate safe names for section ids. () 7353d63
  • Asciidoc and HTML Template Synchronization. () c8b9e8f
  • Mrdox requires x64. (closes cppalliance#309, cppalliance#473) cdc6b9b
  • Version is 0.0.2. () 217ad91
  • Update LLVM commit hash. () 75a2785

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. This fixes a warning when using initialization with designators. ↩

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

4. 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. ↩

5. Unify code duplicated between build and buildOne. ↩

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

7. Update the workflow to upload the LLVM release built in CI whenever there's a new version. ↩

8. 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. ↩