Changeset View
Changeset View
Standalone View
Standalone View
share/man/man9/style.9
Show First 20 Lines • Show All 209 Lines • ▼ Show 20 Lines | |||||
for implementing application interfaces. | for implementing application interfaces. | ||||
.Pp | .Pp | ||||
The names of | The names of | ||||
.Dq unsafe | .Dq unsafe | ||||
macros (ones that have side effects), and the names of macros for | macros (ones that have side effects), and the names of macros for | ||||
manifest constants, are all in uppercase. | manifest constants, are all in uppercase. | ||||
The expansions of expression-like macros are either a single token | The expansions of expression-like macros are either a single token | ||||
or have outer parentheses. | or have outer parentheses. | ||||
Put a single tab character between the | Put a single space or tab character between the | ||||
.Ic #define | .Ic #define | ||||
and the macro name. | and the macro name. | ||||
jhb: I would probably drop the "try to". | |||||
If a macro is an inline expansion of a function, the function name is | If a macro is an inline expansion of a function, the function name is | ||||
all in lowercase and the macro has the same name all in uppercase. | all in lowercase and the macro has the same name all in uppercase. | ||||
.\" XXX the above conflicts with ANSI style where the names are the | .\" XXX the above conflicts with ANSI style where the names are the | ||||
.\" same and you #undef the macro (if any) to get the function. | .\" same and you #undef the macro (if any) to get the function. | ||||
.\" It is not followed for MALLOC(), and not very common if inline | .\" It is not followed for MALLOC(), and not very common if inline | ||||
.\" functions are used. | .\" functions are used. | ||||
Right-justify the | Right-justify the | ||||
backslashes; it makes it easier to read. | backslashes; it makes it easier to read. | ||||
▲ Show 20 Lines • Show All 717 Lines • Show Last 20 Lines |
I would probably drop the "try to".