.\" $HeadURL$ $LastChangedRevision$
.TH IOFDBM 1 "ADE_APP_TOKEN_RELEASE_DATE_MAN"
.SH NAME
iofdbm \- menu-driver front-end for iofdb
.br
.ne 5
.SH SYNOPSIS
.B iofdbm
[
.B \-V
|
.B \-\-version
] [
.B \-v
|
.B \-\-verbose
|
.B \-d
.I level
|
.B \-\-debug=\fIlevel\fR 
] [
.B \-h
|
.B \-\-help
] [
.B \-p
|
.B \-\-list\-paths
] 
.br
.ne 5
.SH DESCRIPTION
.B Iofdbm
is a menu-driven interactive front-end for
.B iofdb\fR(1).
Its main menu lists the commands that can be entered and their effect.
.br
.ne 5
.SH CONFIGURATION
None.
.br
.ne 5
.SH OPTIONS
.TP 25
.B \-d \fIlevel\fR, \fB\-\-debug=\fIlevel\fR
Determines how verbose
.B iofdbm
will be. The message types displayed for the different values of 
.I level
are as follows:
.RS 25
.TP 5
.B 0
internal errors only
.TP
.B 1
internal errors and normal errors 
.TP
.B 2
internal errors, normal errors and warnings
.TP 
.B 3
internal errors, normal errors, warnings and informational messages
.TP 
.B >3
all the above plus application-specific debug messages.
.RE
.TP
.B \-h\fR, \fB\-\-help
Displays a brief usage message.
.TP
.B \-p\fR, \fB\-\-list\-paths
List the compiled-in paths of various files and directories that
.B iofdbm
uses.
.TP 
.B \-v\fR, \fB\-\-verbose
Equivalent to
.B \-d 3\fR.
.TP
.B \-V\fR, \fB\-\-version
Print the program's version number and exit.
.br
.ne 5
.SH EXIT STATUS
On success
.B iofdbm
returns zero. On failure it returns non-zero and displays a diagnostic
message.
.br
.ne 5
.SH FILES
None.
.br
.ne 5
.SH ENVIRONMENT VARIABLES
None.
.br
.ne 5
.SH EXAMPLES
Once configured (see 
.B iofdb\fR(1)),
the following user input will create two accounts, declare holdings
in each, get their current values and calculate and display the
balance:
.IP
.nf
.fam C
\fBiofdbm                          \fR#  start iofdbm
\fBoa                              \fR#  open account
\fBHSBC Current Account            \fR#  name of account
\fBc                               \fR#  it's a currency account
\fBUSD                             \fR#  currency is US dollar
\fB                                \fR#  ENTER to return to menu
\fBoa                              \fR#  open another account
\fBICI Shares                      \fR#  name of account
\fBl                               \fR#  it's a listed stock
\fBUK:ICI                          \fR#  EPIC code for this stock
\fBGBP                             \fR#  usual currency of stock quotes
\fB                                \fR#  ENTER to return to menu
\fBuh                              \fR#  update holdings interactively
\fB123.45                          \fR#  how many dollars in HSBC current account?
\fB100                             \fR#  how many shares in ICI Share account?
\fB                                \fR#  ENTER to return to menu
\fBup                              \fR#  update prices from internet
\fB                                \fR#  ENTER to return to menu
\fBub                              \fR#  update balance by calculation
\fB                                \fR#  ENTER to return to menu
\fBdb                              \fR#  display balance
\fB                                \fR#  ENTER to return to menu
\fBq                               \fR#  quit
.fam T
.fi
.br
.ne 5
.SH CAVEATS
None.
.br
.ne 5
.SH STANDARDS
This manual page documents version ADE_APP_TOKEN_RELEASE_ID of
.B iofdbm\fR.
.br
.ne 5
.SH SEE ALSO
iofdb(1)
.br
.ne 5
.SH AUTHOR
ADE_APP_TOKEN_AUTHOR_NAME <ADE_APP_TOKEN_AUTHOR_EMAIL>
.br
.ne 5
.SH COPYRIGHT & DISTRIBUTION POLICY
Copyright (C) 2003-ADE_APP_TOKEN_RELEASE_YEAR ADE_APP_TOKEN_AUTHOR_NAME
.PP
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
.PP
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.
.PP
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.