Adjusted a missing space
[infodrom/dtaus] / dtaus.5
diff --git a/dtaus.5 b/dtaus.5
index a6d9810..64f7f29 100644 (file)
--- a/dtaus.5
+++ b/dtaus.5
@@ -1,5 +1,5 @@
 .\" dtaus - Converter for DTAUS files
-.\" Copyright (c) 2000,1  Martin Schulze <joey@infodrom.org>
+.\" Copyright (c) 2000,1,3  Martin Schulze <joey@infodrom.org>
 .\"
 .\" This program is free software; you can redistribute it and/ormodify
 .\" it under the terms of the GNU General Public License as published by
 .\" along with this program; if not, write to the Free Software
 .\" Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111, USA.
 .\"
-.TH DTAUS 5 "11 November 2001" "" ""
+.TH DTAUS 5 "17 November 2001" "" ""
 .SH NAME
 dtaus \- Converter for DTAUS files
 .SH DESCRIPTION
 The
 .BR dtaus (1)
-program reads and writes German DTAUS files.  DTAUS is an acronym for
+program reads and writes German DTAUS files.  DTAUS is an semi-acronym for
 .BR D aten T räger AUS tausch.
 It is used by German credit institutes in order to implement money
 exchanges between accounts and credit institutes.  These files are
 always called
-.IR dtaus0.txt .
+.IR DTAUS0.TXT .
 
 Since they are shipped in a weird ascii format that is not quite
-readable and writable for humans a special control format was
-implemented.  The
+readable and writable for human beings a special control format was
+invented.  The
 .BR dtaus (1)
 program reads and writes such a control file and generates a proper
-DTAUS file if requested.
-
+DTAUS file if requested or decodes one.
 .SH "CONTROL FILE"
-The control file implements a very simple format.  Empty lines and
-those beginning with a hash (`#') mark are ignored.  The remaining
-file is splitted into three major parts: one BEGIN record, several
-regular records and one optional END record, which is ignored when the
-file is read but is extracted from the
-.I dtaus0.txt
-file.
+The control file implements a very simple format which was invented
+only for use with the
+.BR dtaus (1)
+program.  Like with many *nix configuration files empty lines and
+those beginning with a hash mark (``#'') are ignored.  The remaining
+file is splitted into three major parts: one BEGIN record
+(representing the A record), several regular records (representing C
+records) and one optional END record (representing the E record),
+which is ignored when the control file is read but is extracted from
+the bank file if one is decoded.
 
 Here's a short sample for a control file:
 
   BEGIN {
-    Art   \fI<type>\fR
+    Art   \fItype\fR
     Name  Martin Schulze
     Konto 123545
     BLZ   2004002
+    Ausfuehrung 23.12.2001
+    Euro
   }
 
   {
-    Transaktion \fI<transaction>\fR
+    Transaktion \fItransaction\fR
     Name   Martha Schulze
     Konto  98832
     BLZ    2004003
@@ -65,13 +69,31 @@ Here's a short sample for a control file:
 
   ...
 
-You may use up to 62 fields entitle
+Please note that several field names are used in both the BEGIN and
+the regular record.  When used in the BEGIN record they denote your
+name and your bank account.  When used in a regular record they are
+affiliated with your customers data.
+
+You may use up to 15 fields entitled as
 .BR Text .
 They will be recorded one by one and stored into additional data
-records.  This way you could add a detailed description of the type of
-money transfer if you like.
+records using the same order.  This way you could add a detailed
+description of the type of money transfer if you like.  The contents
+of the field
+.B Zweck
+are most probably what the customer will see on their bank statements.
 
-.SS <type>
+The field
+.B Ausfuehrung
+is optional and denotes the day when the entire transaction should be
+processed.  The date has to be given as DD.MM.YYYY and will be
+translated into the resulting bank file literally.  It may not be
+younger than the creation date of the file which will automatically be
+inserted by
+.BR dtaus (1).
+The processing date also may not be more than 15 years later than the
+creation date.
+.SS Explanation of type
 One of the following:
 .TP
 .I LK
@@ -84,28 +106,68 @@ Gutschrift Kundenseitig
 Lastschrift Bankseitig
 .TP
 .I GB
-Gutschrift Bangseitig
-
-.SS <transaction>
+Gutschrift Bankseitig
+.SS Explanation of transaction
 One of the following:
 .TP
-.I Lastschrift
+.I Einzug
 Bankeinzug
 .TP
 .I Gutschrift
 Überweisung
-
-.SS Character Encoding
-German Umlauts are converted to 7-bit on the fly so you don't need to
-care about them.  Since the
-.I dtaus0.txt
+.TP
+.IR Vermögen " [JJJJ]"
+Vermögenswirksame Leistung mit Sparzulage.  Als Argument kann das Jahr
+angegeben werden, für das diese Leistung gilt.  Wenn es weggelassen,
+wird, verwendet
+.B dtaus
+das aktuelle Jahr.  Vom Jahr wird nur die letzte Ziffer verwendet, es
+muß daher auch nicht vollständig angegeben werden.
+.TP
+.IR Vermoegen " [JJJJ]"
+Wie
+.IR Vermögen ,
+jedoch ohne Umlaut.
+.TP
+.I E-Cash
+Lastschrift aus Verfügung im elecctronic Cash-System
+.TP
+.I E-Cash-A
+Lastschrift aus Verfügung im elecctronic Cash-System mit ausländischer Karte.
+.PP
+You may only use one of these for the entire file.  You are not
+allowed to switch between Einzug and Gutschrift within the same file.
+If you require the credit institute to process both types, you'll have
+to provide two separate diskettes.
+.SS "Support for Euro"
+From January 1st 2002 the currency in many European countries, Germany
+is among these, changes to Euro.  Hence, money transfer changes from DM
+(formerly known as ``Deutsche Mark'') to Euro.  The format
+specification of DTAUS was meant for DM but was modified in 2001 to
+support Euro as well.  The current version of
+.BR dtaus (1)
+supports both currencies.  It defaults to using Euro, however.  To
+switch to DM, simply add the keyword
+.B DM
+(or
+.B Euro
+respectively if this version was compiled without Euro support as default)
+to the BEGIN record.  If no currency keyword is given, the compiled in
+decides (upstream source defaults to Euro).
+.SS "Character Encoding"
+German Umlauts are converted into two 7-bit characters on the fly so you
+don't need to care about them.  Since the
+.I DTAUS0.TXT
 file only uses uppercase letters every text is also converted to
 uppercase.
 
 Except for the way records are delimited the format should be self
 explanatory.
-
 .SH "SEE ALSO"
-DTAUS files use a special but simple and freely documented format.
-It is included in the distribution of dtaus as
+.BR dtaus (1).
+
+DTAUS files use a special but simple and publically documented format.
+It is included in the distribution of
+.BR dtaus (1)
+as
 .IR dtaus.txt .