code_style.txt: Document staticfn and NEARDATA.

This commit is contained in:
nhkeni
2024-03-16 16:41:09 -04:00
parent 54c3dd35ac
commit 9f37ba849c
+13 -1
View File
@@ -170,6 +170,19 @@ Variable names to avoid
processors with segmented architectures may treat processors with segmented architectures may treat
those as keywords. It is safest to just avoid them. those as keywords. It is safest to just avoid them.
NEARDATA Some data is marked with this define; the Amiga port uses
it to mark data items to be used with a short addressing mode.
You don't need to use this.
static vs staticfn
------------------
The staticfn macro evaluates to either "static" or to nothing (see config.h).
If possible, functions in src/*.c that would otherwise be marked static should
be marked staticfn so platforms that do not name static functions in their
stack traces can be forced to do so; this means function names cannot be
reused. Never use staticfn with data.
Spaces in Expressions Spaces in Expressions
--------------------- ---------------------
@@ -240,7 +253,6 @@ the final newline for every file, prior to release if not always maintained
day-to-day. The name at the end can still be worthwhile when editing or day-to-day. The name at the end can still be worthwhile when editing or
browsing multiple files. browsing multiple files.
Vim Configuration Vim Configuration
================= =================