arc/detail/cold.hpp
Internal cold-path annotations.
Fit
- Use it when you are maintaining Arc internals and need the small support type behind a public module.
- Do not start here when application firmware is choosing a public API; start from the owning public header instead.
- Verification focus: keep direct use inside Arc code and preserve the public module contract that depends on this helper.
Arc Contract
- Header:
arc/detail/cold.hpp - Module group: Detail Headers
- CMake feature:
internal - Closest example:
.
This is Arc implementation support. Application firmware should enter through the public module that owns the behavior.
CMake And Include
Application code should not include this detail header directly. Keep direct includes inside Arc internals, tests, or a public wrapper that preserves the public contract.
Source Landmarks
Source landmarks: TimerSpec, BurstSpec, TraceSpec, TempSpec, CountSpec, UsbSpec, UartSpec, CaptureSpec, ScopeSpec, TimerAlarmCallback.
Start From Zero
- Find the public Arc module that uses this helper.
- Change the public wrapper or test first, then adjust the detail helper.
- Keep the helper small enough that application code still has a public entry point.
- Run the docs generator and host checks after the internal contract changes.
Owner Skeleton
The owner is the public Arc wrapper or test that reaches this helper. Do not add a new application-facing dependency on arc/detail/....
// Inside Arc internals or a focused test only.
#include "arc/detail/cold.hpp"Step-By-Step Check
- Name the public header that depends on this helper.
- Keep the helper hidden behind that public header.
- Add or update the host test that exercises the public behavior.
- Regenerate module pages so this detail page stays synchronized.
- Run the repository checks before publishing.
Build Or Example
Use host checks for this internal helper before any firmware build.
python3 tools/docs_module_pages_test.py
./tools/host-tests.shRuntime Check
This page does not create a user-facing runtime surface. Runtime proof belongs to the public module or example that owns the behavior using this helper.