Skip to content

Document --ast-dump option for diagnostic purposes#957

Merged
ForNeVeR merged 2 commits into
ForNeVeR:mainfrom
pkazakov-dev:feat/document-ast-dump
Feb 17, 2026
Merged

Document --ast-dump option for diagnostic purposes#957
ForNeVeR merged 2 commits into
ForNeVeR:mainfrom
pkazakov-dev:feat/document-ast-dump

Conversation

@pkazakov-dev

Copy link
Copy Markdown
Contributor

Resolves #955

Comment thread README.md Outdated
- `NetModule`: is a rudiment from Cecil, not supported
- `-c`: will produce a JSON-based object file imitation in the output file. This mode is supposed to be used when using Cesium compiler as a C compiler for an existing toolset.
- `-c`: will produce a JSON-based object file imitation in the output file. This mode is supposed to be used when using Cesium compiler as a C compiler for an existing toolset
- `-ast-dump`: prints the Abstract Syntax Tree (AST) of the output file. No output assembly is generated. For diagnostic use only.

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It seems to be --ast-dump, though? Double dash?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe we should clarify in this same PR that when using -c, we use the --out parameter to write the “object file imitation” in JSON. In this case, no executable is generated.
Also, --ast-dump prints the result to the console, and no executable is generated either.

@ForNeVeR

Copy link
Copy Markdown
Owner

Thanks!

@ForNeVeR ForNeVeR merged commit e312968 into ForNeVeR:main Feb 17, 2026
8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

When running Cesium.Compiler with "--ast-dump" then output file is not generated

2 participants