.\" man-3 -- template for unix section 3 man pages
.\"
.\" $Id$
.\" Carlos Duarte, 980420/980514
.\"
.TH function-name 3 "dd long-month yyyy" source "Unix Programmer Manual"
.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
.SH NAME
function \- short description
.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
.SH SYNOPSIS
.nf
.B "#include <stdio.h>"
.B "#include <stdlib.h>"
.sp
.\" everything at bold, except args, that came in italics
.BI "int foo(int " x ", int " y "); "
.fi
.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
.SH DESCRIPTION
The 
.B foo()
function, processes
.I x
and 
.I y
and do something...
.PP
Details on operation and arguments. 
.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
.SH "RETURN VALUE"
What is returned... how and when also. 
.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
.SH EXAMPLES
.PP
Description of next example.
.PP
.RS	
.nf
.ft C 	
example itself ...
.ft R 	
.fi
.RE
.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
.SH FILES
.TP 20
.I /etc/conf
.br
configuration file.
.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
.SH ERRORS
.TP 
.B FOO_BAD_XY
x or y are invalid
.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
.SH "CONFORMING TO"
BSD x.y, POSIX, ANSI, ... 
.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
.SH "SEE ALSO"
.BR bar (3), 
.BR foo (2). 
.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
.SH BUGS
Any bug or imperfection.