Quoth Anton Shepelev:
What is the covenstional way of documenting a set of C functions with -man? Have you any recommendations or examples about typesetting function declaraions, their return types and aruguments in a classic man-page? The .SY macro does not seem to work well for C, because its function declarations start with the return type.
Do take a look at .SY, but also note that it’s possible to do something like this.
.TH MMAP 2
.SH NAME
mmap \- map pages of memory
.SH SYNOPSIS
.ad l
#include <sys/mman.h>
.HP
void *mmap(\
void\ *addr,
size_t\ len,
int\ prot,
int\ flags,
int\ filedes,
off_t\ off);
.HP "\w'void *mmap('u"
void *mmap(\
void\ *addr,
size_t\ len,
int\ prot,
int\ flags,
int\ filedes,
off_t\ off);
.ad
