1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
|
.\"
.\" 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 >
|
