SDCPP(1)

💖 SDCPP — bestie's guide to the C preprocessor for SDCC 💖

okay so this is the SDCPP(1) page from the General Commands Manual, and it's lowkey one of those pages that's like, tiny but also doing a LOT. grab a snack, we're getting into it ✨

🌸 NAME 🌸

sdcpp — C preprocessor for SDCC

🎀 SYNOPSIS 🎀

sdcppold [options] filename

(not me copying that exactly, yes the synopsis literally says sdcppold, that's what's on the page, i don't make the rules 🫶)

💅 DESCRIPTION 💅

So this manual page documents, briefly, the sdccp command. And like — girliepop transparency moment — this page was written for the Debian GNU/Linux distribution because the original program doesn't have a manual page at all. 🙈 Instead, you can read the documentation in /usr/share/doc/sdcc-doc.

And what even is SDCC? It's a Freeware, retargettable, optimizing ANSI-C compiler designed for 8 bit Microprocessors. yes. iconic behaviour. 💜

✨ OPTIONS ✨

okay this is the main character section, buckle up, there's like 64 of these and we're doing ALL of them, no skipping, we don't do that here 💖

• -include <file> — pulls in the contents of <file> before any other files. like a lil pre-game 🎀
• -imacros <file> — accepts the definition of macros found in <file>.
• -iprefix <path> — sets <path> as a prefix for the next two options. yes, the next two. look ahead, bestie 👀
• -iwithprefix <dir> — adds <dir> to the end of the system include path.
• -iwithprefixbefore <dir> — adds <dir> to the end of the main include path.
• -isystem <dir> — adds <dir> to the start of the system include path.
• -idirafter <dir> — adds <dir> to the end of the system include path.
• -I <dir> — adds <dir> to the end of the main include path.
• -I- — fine-grained include path control; see the info docs for the deets.
• -nostdinc — do NOT search system include directories. (heads up: dirs specified with -isystem will still be used, so it's not a total lockdown 💀)
• -nostdinc++ — do not search system include directories for C++.
• -o <file> — puts the output into <file>.
• -pedantic — issues all warnings demanded by strict ISO C. strict queen energy 👑
• -pedantic-errors — issues -pedantic warnings as errors instead. yeah. it's giving consequences.
• -trigraphs — support ISO C trigraphs.
• -lang-c — assumes the input sources are in C.
• -lang-c89 — assumes the input sources are in C89.
• -lang-c++ — assumes the input sources are in C++.
• -lang-objc — assumes the input sources are in ObjectiveC.
• -lang-objc++ — assumes the input sources are in ObjectiveC++.
• -lang-asm — assumes the input sources are in assembler.
• -std=<std name> — specifies the conformance standard. one of: gnu89, gnu99, c89, c99, iso9899:1990, iso9899:199409, iso9899:1999. pick your fighter ⭐
• -+ — allows parsing of C++ style features.
• -w — inhibits warning messages. silence. peace. 🦋
• -Wtrigraphs — warns if trigraphs are encountered.
• -Wno-trigraphs — does not warn about trigraphs.
• -Wcomment{s} — warns if one comment starts inside another.
• -Wno-comment{s} — does not warn about comments.
• -Wtraditional — warns about features not present in traditional C;
• -Wno-traditional — does not warn about traditional C;
• -Wundef — warns if an undefined macro is used by #if.
• -Wno-undef — does not warn about testing undefined macros.
• -Wimport — warns about the use of the #import directive.
• -Wno-import — does not warn about the use of #import.
• -Werror — treats all warnings as errors. every lil warning is a whole situation now 😭
• -Wno-error — does not treat warnings as errors.
• -Wsystem-headers — does not suppress warnings from system headers.
• -Wno-system-headers — suppresses warnings from system headers.
• -Wall — enables all preprocessor warnings. the full lineup, the whole ensemble ✨
• -M — generates make dependencies.
• -MM — same as -M, but ignores system header files.
• -MF <file> — writes dependency output to the given file.
• -MG — treats missing header files as generated files.
• -MP — generates phony targets for all headers.
• -MQ <target> — adds a MAKE-quoted target.
• -MT <target> — adds an unquoted target.
• -D<macro> — defines a <macro> with the string '1' as its value.
• -D<macro>=<val> — defines a <macro> with <val> as its value.
• -A<question> (<answer>) — asserts the <answer> to <question>.
• -A-<question> (<answer>) — disables <answer> to <question>.
• -U<macro> — undefines <macro>.
• -H — prints the name of header files as they are used.
• -C — does not discard comments. keep the receipts 📝
• -dM — displays a list of macro definitions active at end.
• -dD — preserves macro definitions in the output.
• -dN — same as -dD, except that only the names are preserved.
• -dI — includes #include directives in the output.
• -fpreprocessed — treats the input file as already preprocessed.
• -ftabstop=<number> — distance between tab stops for column reporting.
• -P — does not generate #line directives.
• -$ — does not allow '$' in identifiers.
• -remap — remaps file names when including files.
• -v or --version — displays the version number.
• -h or --help — shows a summary of options.

🫶 AUTHOR 🫶

This manual page was written by Aurelien Jarno <aurel32@debian.org>, for the Debian GNU/Linux system — but it may be used by others. (shoutout to Aurelien, thank you for your service, we love a documented command 🥹💖)

and that's the whole page bestie!! you read all 64 options, i'm so proud of you fr fr 🌈💅

🌸 signing off: this was the SDCPP(1) page, from the General Commands Manual — and if you were wondering about a date or a version number in the footer, the page as written only gives us SDCPP(1), so that's all we got. no cap. 💜

go forth and preprocess something iconic ✨🦋🎀