- Added short description for control files
[infodrom/dtaus] / dtaus.1
1 .\" dtaus - Converter for DTAUS files
2 .\" Copyright (c) 1998  Martin Schulze <joey@infodrom.north.de>
3 .\"
4 .\" This program is free software; you can redistribute it and/ormodify
5 .\" it under the terms of the GNU General Public License as published by
6 .\" the Free Software Foundation; either version 2 of the License, or
7 .\" (at your option) any later version.
8 .\"
9 .\" This program is distributed in the hope that it will be useful,
10 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
11 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12 .\" GNU General Public License for more details.
13 .\"
14 .\" You should have received a copy of the GNU General Public License
15 .\" along with this program; if not, write to the Free Software
16 .\" Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111, USA.
17 .\"
18 .TH DTAUS 1 "5 July 1998" "" ""
19 .SH NAME
20 dtaus \- Converter for DTAUS files
21 .SH SYNOPSIS
22 .B dtaus
23 .RB [ " \-d "
24 .IR dtaus " ]"
25 .RB [ " \-c "
26 .IR control " ]"
27 .RB [ " \-b "
28 .IR begleit " ]"
29 .RB [ " \-o "
30 .IR kontroll " ]"
31 .BR -dtaus " | " -control
32 .SH DESCRIPTION
33 This program can read and write german DTAUS files.  DTAUS is an
34 acronym for 
35 .BR D aten T räger AUS tausch.
36 It is used by german credit institutes in order to manage money
37 exchanges between accounts and credit institutes.
38
39 .SH OPTIONS
40 You have to specify at one of
41 .BR \-dtaus " or " \-control .
42
43   -dtaus        Erzeugt eine Bankdatei
44   -control      Liest eine Bankdatei und erzeugt die Kontrolldateien
45
46   -d <dtaus>    Bankdatei [dtaus0.txt]
47   -c <control>  Steuerdatei [dtaus0.ctl]
48   -b <begleit>  Begleitzettel für die Bank dtaus0.doc]
49   -o <kontroll> Kontrolldatei zum Abheften [dtaus0.sik]
50
51 .SH "CONTROL FILE"
52 The control file has a very simple format.  Empty lines and those
53 beginning with a hash mark are ignored.  The remainder is splitted
54 into three parts, one BEGIN record, several regular records and one
55 END record, which is being ignored and created by the program.
56
57 For a complete description please refer to
58 .I dtaus.txt
59 from this distribution.  Here's a short example for a control file:
60
61   BEGIN {
62     Art   LK
63     Name  Martin Schulze
64     Konto 123545
65     BLZ   2004002
66   }
67
68   {
69     Transaktion Einzug
70     Name   Martha Schulze
71     Konto  98832
72     BLZ    2004003
73     Betrag 20.00
74     Zweck  Gebühr Wohnheimnetz
75     Text   Anschluss u. 11+12.97
76   }
77
78   ...
79
80 If you think this description suxx or isn't enough please sit down for
81 some hours and write something better.  I'll get included if it's
82 appropriate.
83
84 .SH "RETURN VALUES"
85 On success, zero is returned.  On error, 1  is  returned.
86
87 .SH "SEE ALSO"
88 DTAUS files use a special but simple and freely documented format.
89 It is included in the distribution of dtaus as dtaus.txt.