skills.rest
z88dk
z88dkOFFICIAL
Explore all skills by this author →
Website𝕏@z88dkGitHub

tool-ucpp

Diagnoses C preprocessing issues in z88dk builds via the z88dk-ucpp preprocessor.

1.1k|206|Updated Mar 16, 2016
Search Tags:#cross-compilation#zcc#macro expansion#z88dk#z80#c preprocessor#ucpp
One-click install
npx skills add https://github.com/z88dk/z88dk --skill tool-ucpp-z88dk
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: tool-ucpp
Source: https://github.com/z88dk/z88dk/tree/main/.agents/skills/tool-ucpp
Command: npx skills add https://github.com/z88dk/z88dk --skill tool-ucpp-z88dk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When C compilation for Z80 targets fails due to macro expansion, include path, or conditional compilation problems, developers need a way to inspect what the preprocessor actually produces. This Skill provides reference knowledge for the z88dk-ucpp preprocessor so you can diagnose preprocessing issues without guessing. ## Core Features & Use Cases - Preprocessor Diagnostics: Explains how to inspect preprocessed output using zcc -E and pass options through -Cp rather than invoking ucpp directly. - Toolchain Context: Clarifies that z88dk-ucpp is normally driven by the zcc front end and is not intended for direct manual invocation. - Use Case: A macro is not expanding as expected in a Z80 C project. Use this Skill to run the compilation through zcc -E, inspect the preprocessed source, and adjust -Cp flags to resolve the issue. ## Quick Start Ask the assistant to show the preprocessed output of your z88dk C source file using zcc -E and explain any macro expansion problems.

Frequently Asked Questions about tool-ucpp

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I see preprocessed C output in z88dk?▼

Run the zcc front end with the -E flag to emit preprocessed source instead of compiling. This routes through z88dk-ucpp internally and shows exactly how macros and includes are expanded.

How do I pass options to the z88dk preprocessor?▼

Use the -Cp option on the zcc command line to forward flags to the ucpp preprocessor stage. Invoking z88dk-ucpp directly is discouraged since zcc manages the toolchain configuration.

Should I run z88dk-ucpp directly from the command line?▼

No, z88dk-ucpp is normally not invoked by hand. The recommended approach is fixing preprocessing issues via zcc -E or -Cp, which keeps configuration and include paths consistent with the rest of the build.

Why is my macro not expanding in a z88dk C project?▼

Macro expansion failures usually stem from missing defines, include path problems, or conditional compilation guards. Inspect the preprocessed output with zcc -E to see what the preprocessor actually produced before the compiler ran.

What tools relate to preprocessing diagnostics in z88dk?▼

The zcc driver front end is the primary entry point for preprocessing control. Related tooling includes measurement methodology and the ticks emulator for downstream verification of compiled output.

Related Skills

Explore More Software Engineering Skills→
xiaoliwanshuixiaoliwanshui
21

flutter-setting-up-on-linux

Configure a Linux environment with Flutter toolchains and system dependencies.

Community
Intermediate
lzwei196lzwei196
1

ROMS

Automate ROMS simulations from grid generation to post-processing diagnostics.

Community
Advanced
ZurybrZurybr

make-doom-for-mips

Cross-compiles complex C programs like Doom for custom MIPS virtual machines and emulators with freestanding compilation flags and custom syscalls.

Community
Advanced
joelklabojoelklabo

markdowntown-workbench

Resolve Workbench UI/state mismatches with the export/compile pipeline.

Community
Intermediate