An example often is easier to understand than a longuish manpage, so
[infodrom/dtaus] / dtaus.1
1 .\" dtaus - Converter for DTAUS files
2 .\" Copyright (c) 1998,2001  Martin Schulze <joey@infodrom.org>
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 "11 November 2001" "" ""
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 and
60 .BR dtaus (5)
61 from this distribution.
62
63 .SH "RETURN VALUES"
64 On success, zero is returned.  On error, 1  is  returned.
65
66 .SH "SEE ALSO"
67 .BR dtaus (5).
68
69 DTAUS files use a special but simple and freely documented format.
70 It is included in the distribution of dtaus as dtaus.txt.