.\"	@(#) port.4 
.\"
.TH port 4 "11 Aug 1906"
.AT 3
.SH NAME
port  databases
.SH DESCRIPTION
The 
.I port
program uses a textual database with much the same format as the
old Opcom "score" program.  
.PP
Lines in the databse beginning with '%' will be copied from
the database to teh outout unchanged. This is to allow
inserting notes on prerequisites.
In addition, an ERRNO field tag is added to the ones supported by jscore.

The fields are as follows:
.nf
.nj
#
# strncpy --report on strncopy, and optionally strncat and sprintf
#
NAME:strncpy
WEIGHT: 5
BEGIN_COMMENT
Strncpy will happily create a non-null-terminated string if
the source is the same size (!) or larger than the target.
Use strlcpy(target, source, sizeof(target))
END_COMMENT
BEGIN_EXAMPLE
END_EXAMPLE
.fi
.ju
.SH NAME:
The name field contains an interface or variable name.
.SH WEIGHT:
The weight fiels contains a relative difficulty indicator,
where 1 is trivial, 5 is easy, 25 requires thought and
100 requires writing and testing a replacement function.
.SH ERRNO:
This indicates the interface is 
.I only 
an issue if errno
is in scope and is used. Many issues involve errno but
are not conditional on errno. This is most often seen in
Linux or GNU-related databases.
.SH BEGIN_COMMENT
This marks the beginning of the descriptive text, which ends
in END_COMMENT
.SH BEGIN_EXAMPLE
This marks the beginning on example code, which ends with END_EXAMPLE