@database DocDatatypes.guide
@$VER: docdatatypes.guide_English 39.25 (26.05.2000)
@(C) "©2000 A.S.Munde."
@author "A.S.Munde."
@smartwrap

@node MAIN
@title "DocDatatypes®"
@{JCENTER}
Docdatatypes v39.25@{PAR}
Copyright (©)2000 by A.S.Munde@{PAR}
@{JLEFT}
@{PARI -5}
@{LINDENT 5}
@{PAR}
I.   @{" Disclaimer " link Disclaimer}@{PAR}
II.  @{" Copyright " link Copyright}@{PAR}
III. @{" Introduction " link Intro}@{PAR}
IV.  @{" Installation " link Installation}@{PAR}
V.   @{" DocDatatypes FAQ " link FAQ}@{PAR}
VI.  @{" Acknowlegments " link Acknowledgments}@{PAR}
VII. @{" Author " link Author}@{PAR}
IIX. @{" Registration " link Registration}@{PAR}
IX.  @{" History " link History}@{PAR}
X.   @{" Todo " link Todo}@{PAR}
@{PARD}@{PAR}
@endnode

@node Index "DocDatatypes®: Index"
@{JCENTER}
Under Construction....@{PAR}
@{PARD}@{PAR}
@endnode

@node Copyright "DocDatatypes®: Copyright"
This package is Copyright (©)2000 by @{" A.S.Munde. " link Author}@{PAR}
Distribution of this software package is not allowed.@{PAR}
This software must be @{" Registered " link Registration} for full use.@{PAR}
Distribution on CD-ROMs, disks series or cover disks requires permission
of the @{" Author " link Author}.@{PAR}@{PAR}
If any datatypes author wishes to use the supplied installer script please
contact the @{" Author. " link Author}@{PAR}
@endnode

@node Disclaimer "DocDatatypes®: Disclaimer"
The author takes no responsibility for any results from the use of this
program. This software is provided "AS IS" and there is no warranty of
any kind, use this software at your own risk.@{PAR}
@endnode

@node Intro "DocDatatypes®: Introduction"
Amiga OS Release 3 the Amiga has the concept of datatypes classes, which
allow specific file types to be categorized and groups of operations can
be done on them via a uniform API(such as viewing, converting and printing).
MultiView is an application that utilizes these datatypes and handles any
file for which you have a datatypes class installed.@{PAR}@{PAR}
DocDatatypes is a set of datatypes classes for documents. It's a subclass
of the text.datatype.@{PAR}@{PAR}
The datatype msdoc.datatype currently supports the reading of the following
data formats:
@{PARI -5}
@{LINDENT 5}
@{PAR}
I.   DosWord 4 , 5 and 5.5@{PAR}
II.  WinWord 1, 2, 6, 95, 97, 2000@{PAR}
III. Write 3.1@{PAR}
IV.  MacWord 4 , 5, 98@{PAR}
V.   MS Works 3, 4@{PAR}
VI.  OS 2 Word@{PAR}
@{PARD}@{PAR}
The datatype lotusdoc.datatype currently supports the reading of the
following data formats:
@{PARI -5}
@{LINDENT 5}
@{PAR}
I.   AmiPro 1, 2, 3@{PAR}
@{PARD}@{PAR}
The datatype wordstardoc.datatype currently supports the reading of the
following data formats:
@{PARI -5}
@{LINDENT 5}
@{PAR}
I.   WordStar 3, 4, 5, 6, 7@{PAR}
II.  WordStar 2000 1, 2, 3@{PAR}
@{PARD}@{PAR}
The datatype wpdoc.datatype currently supports the reading of the following
data formats:
@{PARI -5}
@{LINDENT 5}
@{PAR}
I.   WordPerfect 5, 6, 7@{PAR}
II.  Amiga WordPerfect 4.1@{PAR}
III. WordPerfect Notebook@{PAR}
IV.  WordPerfect Program Editor/Ed Editor@{PAR}
V.   WordPerect Macro Editor@{PAR}
VI.  Plan Perfect@{PAR}
VII. DataPerfect@{PAR}
IIX. Mail@{PAR}
IX.  LetterPerfect@{PAR}
@{PARD}@{PAR}
The datatype rtfdoc.datatype currently supports the reading of the
following data formats:
@{PARI -5}
@{LINDENT 5}
@{PAR}
I.   RTF Format Version 1@{PAR}
@{PARD}@{PAR}
The datatype xywritedoc.datatype currently supports the reading of the
following data formats:
@{PARI -5}
@{LINDENT 5}
@{PAR}
I.   xyWrite III@{PAR}
@{PARD}@{PAR}
@endnode

@node Installation "DocDatatypes®: Instalation"
If you wish to keep this datatypes archive copy it to your harddisk. If you
are a beginner it is reccomended you use the supplied installer.@{PAR}@{PAR}
For minimal installation(just system files) use the installer provided
or do the following if you know what you are doing:@{PAR}@{PAR}
Copy the "Classes/Datatypes/#?" into the "SYS:Classes/DataTypes"
drawer. The files in the "Devs/Datatypes/" and their info files should be
placed in the "DEVS:DataTypes" drawer. In order to use the datatype you
should issue an "adddatatypes refresh" command.@{PAR}@{PAR}
@endnode

@node FAQ "DocDatatypes®: Frequently asked questions"
@{PARI -3}@{LINDENT 3}
Q: Why does the datatype save as text from Multiview Save As?@{PAR}
A: The Multiview Save As.. menu option sends a save message as a
save mode of DTWM_RAW which is infact supposed to be the datatypes internal
format which is not supported in this version of the datatype.
Saving in the superclass format is supported and this format is IFF-FTXT
the same as for the Clipboard.@{LINE}
Most datatypes that do not support writing in the datatype format do not
support writing in its native format and just pass the writing to its
superclass which just dumps the datatype buffer as a file, this does not
follow the datatypes definition, these datatypes should be updated.@{LINE}
At the moment this datatype saves as text if DTWM_RAW is specified.@{PAR}@{PAR}
Q: What about Macro Viruses?@{PAR}
A: Currently the datatypes do not support executing macros so you do not
have to worry about Macro Viruses.@{PAR}@{PAR}
Q: Will support of formatting of documents be supported?@{PAR}
A: To retain formatting of the documents a document.datatype class is
needed, and soon as this is available(I might have to program one myself)
the docdatatypes will be updated since support of formatting is included
in the docdatatypes but the formatting is ignored.@{PAR}@{PAR}
Q: How do I add support for text datatypes in my own programs@{PAR}
A: Have a look at the file @{" loaddttext.c " link loaddttext.c/main} as this shows that adding datatype
support in your own programs is very easy. If you have any problems just
email @{" me. " link Author}@{PAR}@{PAR}
@{PARD}
@endnode

@node Acknowledgments "DocDatatypes®: Acknowledgments"
This datatype was written entirely from scratch using DCC 3.15 and all the
required information on how to create a datatype were obtained from sample
source code by David N. Junod found in the 3.1 NDK.@{PAR}
@endnode

@node Author "DocDatatypes®: Author Information"
This software is written by:@{PAR}
Amarpreet Singh Munde.@{PAR}
email: docdatatypes@yahoo.com@{PAR}
www: http://go.to/docdatatypes@{PAR}@{PAR}
Any bug reports must be sent to the above email address with the subject
line containing the words "BUG REPORT" and the document that caused the bug
can also be sent as an attachment if possible.@{PAR}
@endnode

@node Registration "DocDatatypes®: Registration"
The datatypes in the unregistered archive will only translate up to the
first 1000 characters of a document.@{PAR}
The datatypes must be registered by sending a 5 pound sterling cash
to the @{" Author " link Author}. To obtain the address please e-mail
docdatatypes@yahoo.com.@{PAR}
The registration must contain the following information:@{PAR}
Name:@{PAR}
Address:@{PAR}
City:@{PAR}
State:@{PAR}
Zip/Post Code:@{PAR}
Country:@{PAR}
E-Mail:@{PAR}
WWW:@{PAR}
Upon which you shall be e-mailed the docdatatypes archive in lzx format.@{PAR}
@endnode

@node History "DocDatatypes®: History"
@{PARI -21}
@{LINDENT 21}
@{PAR}
39.10 (01/01/2000) - first public release.@{PAR}@{PAR}
39.20 (01/04/2000) - added rtfdoc and xywritedoc datatypes and bug fixed
other datatypes.@{LINE}
The WordPerfect and Lotus datatypes handle more control characters.@{LINE}
The Microsoft datatype also now handles headers and footers and endnotes
(these are displayed at the end of the texts).@{LINE}
Added the loaddttext.c code to the main archive which shows the easy usage
of the datatypes functions to load text files.@{PAR}@{PAR}
39.25 (26/05/2000) - fixed bug in all datatypes that were accessing non
allocated memory in object creation.@{PAR}@{PAR}
@{PARD}
@endnode

@node Todo "DocDatatypes®: Todo"
Add support for more filetypes. Here a user can help by sending me
information on any file format they would like supported.@{PAR}
Add support for preferences for user defined character set translation.@{PAR}
Improve support for MS Word Fastsaves which are not handled correctly.@{PAR}
Support encrypted documents for MS-Word 95 and 97.@{PAR}
Support for document summary information.@{PAR}
Support the full character set for AmiPro.@{PAR}
As soon as a document.datatype superclass is available these datatypes
will be improved to support all document formatting(most of them already
have preliminary support for all document formatting) and the support of
a write mode(eg save MSWord Documents).@{PAR}
@endnode