61 lines
2.8 KiB
Markdown
61 lines
2.8 KiB
Markdown
# "quick"/"easy" fixes
|
|
|
|
- for global initialization cycles, report also starting and ending lines
|
|
|
|
# milestones
|
|
|
|
1. manual c function interop
|
|
- separate calling convention, implementation, linkage, and link name
|
|
- allow bodyless `c func` declarations with exact external symbol names
|
|
- require concrete types in foreign signatures; inferred `int` is invalid
|
|
- emit LLVM `declare` for referenced foreign functions
|
|
- compile and link additional c sources, object files, and libraries through CLI options
|
|
- preserve bodyful, mangled, demand-monomorphized `c func` behavior
|
|
- verify end-to-end with an integer-only c function
|
|
|
|
2. interop type foundation
|
|
- unsigned integers, floats, and target-dependent c scalar types
|
|
- keep binding mutability (`::` / `=`) separate from element or pointee mutability (`mut`)
|
|
- arrays and indexing
|
|
- `[N]T`: array with `N` logical elements
|
|
- `[N;S]T`: array with `N` logical elements followed by sentinel `S`
|
|
- pointers
|
|
- `@T` / `@mut T`: non-null single-item pointer without arithmetic
|
|
- `*T` / `*mut T`: non-null many-item pointer with arithmetic
|
|
- optional pointers represent nullable pointers
|
|
- slices and slicing
|
|
- `[]T`: pointer and length
|
|
- `[;S]T`: pointer and length with a sentinel invariant
|
|
- ordinary slices do not guarantee null termination
|
|
- string literals as immutable sentinel slices backed by static arrays
|
|
- character literals
|
|
- optionals with trapping unwrap and fallback operations
|
|
- native structs with compiler-controlled layout
|
|
- pointer-only `c struct` support with target c layout
|
|
- `Some :: c struct { ... }`: defined c-layout struct
|
|
- `Some :: c struct`: opaque c-layout struct
|
|
- defer passing c structs by value until target ABI classification exists
|
|
|
|
3. restricted c header imports
|
|
- treat an imported header as a synthetic, file-local package namespace
|
|
- `import "relative/path/to/header.h"`
|
|
- `other :: import "relative/path/to/header.h"`
|
|
- import functions, typedefs, scalar types, and pointers to opaque records
|
|
- keep implementation linking separate from header imports
|
|
- cache imports by canonical header path and target/include/define configuration
|
|
- diagnose unsupported declarations when referenced
|
|
- research libclang's c API behind a replaceable c importer boundary
|
|
|
|
4. c variadic calls
|
|
- represent c variadics as a fixed parameter count plus a variadic flag
|
|
- apply c default argument promotions at call sites
|
|
- emit LLVM c-variadic declarations and calls
|
|
- keep native brolang variadics and tuple design separate
|
|
|
|
5. advanced c interop
|
|
- by-value records and unions
|
|
- function pointers and callbacks
|
|
- external variables
|
|
- macros and static inline functions
|
|
- exporting brolang functions to c
|