c914f03d66
* docs: add local full-text search and a contributor README Add @easyops-cn/docusaurus-search-local to the Docusaurus site so the docs get an offline search bar (index built at build time, no external service). English and zh-CN pages are both indexed, and matched terms are highlighted on the target page. Add docs/README.md describing the Docusaurus setup, local dev/build commands, search behavior, directory layout, and gotchas; exclude it from the published site alongside CLAUDE.md. Point the root README's docs/ entry at it. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01TSzcESzU9947zkGzQ6SMmE * docs: remove dead framework leftovers, fix index generation, complete the nav Delete the VitePress (.vitepress/) and Jekyll (_layouts/, css/) leftovers, the one-shot migration scripts (fix_md_header.py, fix_seealso.py), and the stale keywords.json snapshot; prune the matching .gitignore entries and docusaurus exclude patterns. Rewrite gen_index.py for Docusaurus: it emitted dead .html links and legacy 'layout: doc' frontmatter, choked on non-markdown entries, and dropped nested categories — regenerating an index would have broken it. It now emits the extension-less links the site actually uses, links nested category indexes (restoring apply/* on the zh-CN index), and refuses to run on the docs root. Fix update_index.sh's copy-paste titles (zh-CN efun/build were titled 'APPLY'), stop it clobbering the hand-written lpc/index.md, and cover cli/. Regenerated indexes pick up the missing driver/ffi-plan entry. add_missing_efuns.py now takes the keywords.json path as an argument instead of requiring a stale copy. Move CNAME and the Google site-verification file into static/ so they actually reach the published build output. Complete the sidebar: link the CLI category to cli/index and add the missing portbind/symbol/generate_keywords pages, and expose the previously orphaned stdlib section under Reference. Promote onBrokenLinks to 'throw' now the build is warning-free, and drop the empty Demo section from the landing page. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01TSzcESzU9947zkGzQ6SMmE * docs: strip legacy 'layout: doc' frontmatter from all pages Mechanical sweep removing the Jekyll-era 'layout: doc' line from every doc page's frontmatter (Docusaurus ignores it), and the matching line from the templates in docs/CLAUDE.md so new pages don't reintroduce it. No content changes. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01TSzcESzU9947zkGzQ6SMmE --------- Co-authored-by: Claude <noreply@anthropic.com>
2 KiB
| title |
|---|
| preprocessor |
The LPC preprocessor
A preprocessor directive is a line whose first non-whitespace character
is #. Directives are not statements: they instruct the compiler while
it reads the file. A directive owns its whole logical line; ending a
line with a backslash (\) continues the directive onto the next line,
and comments may appear on directive lines.
Preprocessing in FluffOS is integrated into the compiler's single scan of the source — there is no separate preprocessing pass — but the semantics are the conventional C-family ones described here.
Directives
| Directive | Purpose |
|---|---|
#define |
Define an object-like or function-like macro. |
#undef |
Remove a macro definition. |
#include |
Splice another file into the compile. |
#if / #elif / #else / #endif |
Conditional compilation over constant expressions. |
#ifdef / #ifndef |
Conditional compilation on whether a macro is defined. |
#pragma |
Toggle per-file compiler flags. |
#error text |
Abort the compile with text as the error message. |
#warn text |
Emit text as a compiler warning; does not fail the compile (and is suppressed by #pragma no_warnings). |
#echo text |
Print text to the driver's stderr during the compile. |
#line N ["file"] |
Override the reported line number (and optionally file name) for subsequent diagnostics. # N is accepted as a synonym. |
An unknown directive is a compile error.
Predefined macros
The driver predefines macros describing itself and its configuration:
__FILE__, __LINE__, __DIR__, FLUFFOS, MUDOS, MUD_NAME,
__VERSION__, MAX_INT, MIN_INT, MAX_FLOAT, MIN_FLOAT,
__ARCH__, plus one __PACKAGE_NAME__-style macro per compiled-in
package and one __FEATURE__-style macro per enabled option, among
others. Predefined macros are immutable: both #define and
#undef of a predefined name are compile errors.