.\" 
.\" Text-to-Doc converter for Palm Pilots
.\" doc.4
.\" 
.\" Copyright (C) 1998  Paul J. Lucas
.\" 
.\" 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.
.\" 
.\" 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.
.\" 
.\" 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.
.\" 
.\" ---------------------------------------------------------------------------
.\" define code-start macro
.de cS
.sp
.nf
.RS 5
.ft CW
.ta .5i 1i 1.5i 2i 2.5i 3i 3.5i 4i 4.5i 5i 5.5i
..
.\" define code-end macro
.de cE
.ft 1
.RE
.fi
.sp
..
.\" ---------------------------------------------------------------------------
.TH "\f3DOC\f1" "4" "06. August 2005" "txt2pdbdoc" ""
.SH "NAME"
DOC \- (Pilot Standard Textdocument) Dateiformat
.SH "\[:U]BERSICHT"
.nf 
.ft CW
.ta 5 12 26
struct doc_record0 {	/* 16 bytes total */
	Word	version;	/* 1 = Klartext, 2 = komprimierter Text */
	Word	reserved1;    /* beim Erstellen auf Null setzen */
	DWord	doc_size;	/* unkomprimierte Gr\[:o]\[ss]e in Bytes */
	Word	num_recs;	/* Anzahl der Text\-Bl\[:o]cke (nicht Header) */
	Word	rec_size;	/* max. Blockgr\[:o]\[ss]e in Bytes: normal 4096 (4K) */
	DWord	position;     /* aktuelle Leseposition im Text */
};
.ft 1
.fi 
.SH "BESCHREIBUNG"
Das
.BR "Doc" \-Dateiformat
ist das Standardformat f\[:u]r Textdokumente, das in allen
Palm Pilots verwendet wird.
Eine
.BR "Doc" \-Datei
ist eine
.BR "pdb(4)" \-Datei,
diese Manpage behandelt daher nur Teile, die speziell f\[:u]r
.BR "Doc" \-Dateien
zutreffen.
.PP 
Eine
.BR "Doc" \-Datei
besteht aus 0 bis \f(CWnum_recs\f1 Bl\[:o]cken;
Block 0 ist der Kopf (Header) des Dokuments.
(Dieser Header unterscheidet sich vom
.BR "pdb(4)" \-Header.)
Der Eintrag \f(CWposition\f1 wird nicht von allen Leseprogrammen benutzt.
Die restlichen Bl\[:o]cke enthalten Text, entweder Klartext oder
komprimierten, das h\[:a]ngt ab vom Wert der \f(CWversion\f1.
.SS Wortgr\[:o]\[ss]e
In der \[:U]BERSICHT oben werden die Typen ``\f(CWWord\f1'' und ``\f(CWDWord\f1''
verwendet.
Der Typ ``\f(CWWord\f1'' ist 16 Bit lang;
der Typ ``\f(CWDWord\f1'' ist 32 Bit lang.
Beide im Big\-Endian\-Format.
.SS Kompressionsformat
Ein Zeichen ``\f(CWc\f1'' in einem komprimierten Block entspicht einer von vier
Klassen:
.TP 10
\f(CW01\-08\f1
Kopiere die folgenden ``c'' Bytes unver\[:a]ndert
.TP
\f(CW00,09\-7F\f1
weiterreichen, so wie es ist
.TP
\f(CW80\-BF\f1
kopiere eine Folge eines vorhergehenden Teils des Blockes
.TP
\f(CWC0\-FF\f1
Ein Leerzeichen plus das ASCII\-Zeichen ``\f(CWc xor 0x80\f1''
.RE
.SH "SIEHE AUCH"
txt2pdbdoc(1), html2pdbtxt(1), pdbtxt2html(1), pdb(4)
.PP
Christopher Bey and Kathleen Dupre.
.I "Palm File Format Specification" ,
Document Number 3008\-003,
Palm, Inc.,
May 16, 2000.
.PP
Rob Tillotson.
.I "The Doc Format",
http://www.pyrite.org/doc_format.html
.SH "AUTOR"
Paul J. Lucas
.RI < pauljlucas@mac.com >
.br
Deutsche \[:U]bersetzung: Erik Schanze
.RI < schanzi_@gmx.de >