1. Foo
General description that will appear in the overview page and in the HTML reference and man page.
1.1. Foo definitions and functions
The foo(3) module ... in-depth description here (does not appear in the man page) ...
Foo definitions
Synopsis
#include <foo.h>
struct foo {
int n; /* members must be indented by a tab */
};
Description
Description of Foo definitions (does not appear in the man page) ...
The foo_bar function
Synopsis
#include <foo.h>
int foo_bar(struct foo *foo, int n);
Description
The foo_bar function ...
Returns
The foo_bar function returns 1 or 0 to indicate ...
Copyright 2004 Your Name Here <userid domain.com>