.\" Process this file with
.\" groff -man -Tascii dbfcreate.1
.\"
.TH SHAPELIB 1 "OCTOBER 2004" "shapelib" "User Commands"
.SH NAME
dbfcreate \- Create an empty xBase DBF file
.SH SYNOPSIS
.B dbfcreate
.IR "filename" "[[\-s " "fieldname width" "] | [\-n " "fieldname width decimals" ]] ...
.SH DESCRIPTION
Creates an empty DBF file called
.I filename
with columns described by all the
.B \-s
and
.B \-n
options that follow.
.SH OPTIONS
.TP
.BI "\-s " "fieldname width"
adds a column named
.I fieldname
taking textual values of at most
.I width
characters.
.TP
.BI \-n\  fieldname\ width\ decimals
adds a column named
.I fieldname
taking numeric values of at most
.I width
digits and precision of at most
.I decimals
decimal places.  The number of digits of precision should be included in
.IR width .
.SH EXIT STATUS
.TP
.B 0
Successful program execution.
.TP
.B 1
Missing
.I filename
argument.
.TP
.B 2
Failed to create the file
.I filename
for writing.
.TP
.B 3
Missing 
.IR fieldname , width ", or " decimals
argument for a
.B \-s
or
.B \-n
option.
.TP
.B 4
Failed to add a column given by a
.B \-s
or
.B \-n
option.
.SH DIAGNOSTICS
The following diagnostics may be issued on stdout:
.TP
.RI DBFCreate( filename ") failed."
.TP
.RI DBFAddField( fieldname ",FTString," width ",0) failed."
.TP
.RI DBFAddField( fieldname ",FTDouble," width "," decimals ") failed."
.TP
.RI "Argument incomplete, or unrecognised: " arg
.SH AUTHORS
Frank Warmerdam (warmerdam@pobox.com) is the maintainer of the
.B shapelib
shapefile library.
Joonas Pihlaja (jpihlaja@cc.helsinki.fi) wrote this man page.
.SH "SEE ALSO"
.BR dbfadd (1),
.BR dbfdump (1),
.BR dbf_dump (1),
.BR shpadd (1),
.BR shpcreate (1),
.BR shpdump (1),
.BR shprewind (1)