LUMIERA.clone/admin
Ichthyostega 109d682408 Buildsystem: generate a compilation database for clangd (closes: #1436)
Knowledge-Technology(Claude Opus 5) used
 - to assess the situation and present implementation avenues
 - for discussion while shaping the solution
 - for generating code and validating results

Clang based tooling is used frequently for code analysis and navigation.
This requires however that the exact flags and invocation is captured for
each possible translation unit in the code base. That knowledge exists solely
in the build system, and the established way to hand it over is the
LLVM "JSON Compilation Database".

SCons has provided a `CompilationDatabase` builder since 4.0, and it fits
our setup well: it installs an emitter on the object builders and captures
each command line while the dependency graph is constructed. Hence nothing
is compiled -- generating takes about two seconds -- and the result always
describes the complete build graph as declared, rather than the target
actually requested on this invocation.

This feature is provided as ''opt-in'', either through the sticky option
`COMPILEDB=yes` or by direct invocation with `scons compiledb`

The `compile_commands.json` is generated into the build output `target/' dir
For configuration, a `.clangd` in project root instructs the language server
where to find this file.

__Note__ the ordering constraint recorded in `CompileDB.py`:
the emitter must be installed only after `Platform.configure()` has run,
or it also captures the `conftest_*` compilations of the configure checks.
That is why this is a plain helper invoked from the `SConstruct` -- similar to
Setup, Options, Platform -- and not a tool loaded from the `LumieraEnvironment`.
2026-10-01 01:08:23 +02:00
..
git_hooks removed 'pushing' from the post commit hook 2008-12-16 23:59:00 +01:00
scons Buildsystem: generate a compilation database for clangd (closes: #1436) 2026-10-01 01:08:23 +02:00
buildVersion.py Bugfix: setVersion.py -- ability to handle suffixes 2025-11-13 22:06:06 +01:00
deb.lumiera.org.PUB.gpg Release: general washdown 2025-11-30 21:22:23 +01:00
DIR_INFO make some DIR_INFO's nicer 2007-06-21 03:15:52 +02:00
README.deb.lumiera.org.PUB.gpg Copyright: clarify and simplify the file headers 2024-11-17 23:42:55 +01:00
rfc.sh clean-up: trifles 2025-06-07 23:59:57 +02:00
rsync_docs_to_lumieraorg.sh Merge from backend: wikis, admin-scrits, test.sh 2008-04-12 02:07:16 +02:00
setVersion Release: rework and update the changelog 2025-11-22 23:51:21 +01:00
testfilter.sh Add two test tools to admin 2010-07-16 07:59:30 +02:00
treeinfo.sh Fix treeinfo.sh sorting order 2011-05-12 19:30:36 +02:00
vg-run.sh Install: change organisation of target and output directory variables 2011-01-29 14:10:19 +01:00
vgsuppression_gen.sh Merge from backend: wikis, admin-scrits, test.sh 2008-04-12 02:07:16 +02:00

This is the Public Key of the Package signing GPG key
used for building of Debian DEB packages on Lumiera.org

Fingerprint: 11FD F5D2 DBD7 BBD7 F4D9  D9C4 2CF2 5392 6238 2557
UID: Ichthyo (DEB-Package) <deb@ichthyostega.de>