Category : Dbase (Clipper, FoxBase, etc) Languages Source Code
Archive   : DTF102.ZIP
Filename : DTF.DOC

 
Output of file : DTF.DOC contained in archive : DTF102.ZIP

















°ÛÛÛÛ °ÛÛÛÛÛÛ °ÛÛÛÛÛÛ
°Û °Û °Û°Û °Û °Û °Û
°Û °Û °Û °Û Û
°Û °Û °Û °ÛÛÛ
°Û °Û °Û °Û Û
°Û °Û °Û °Û
°ÛÛÛÛ °ÛÛÛ °ÛÛÛ

Dynamic Text Files (DTF) for Clipper(tm) v5.01
Release 1.02

October 17, 1991

Copyright (c) 1991 by Timothy W. Cook
All Rights Reserved


Timothy W. Cook þ 3001 Talos Drive þ Millington , Tn. 38053




Dynamic Text Files (DTF) is NOT Public Domain


Dynamic Text Files v1.02 Page 1 of 4
------------------------------------------------------------------------

DISCLAIMER/WARRANTY

Dynamic Text Files (DTF), is distributed without warranty of any
kind. Under NO circumstances will Timothy W. Cook or any of his
representatives be held liable for actions caused through use or
failure to be able to use this software product.

COPYRIGHT

Dynamic Text Files (DTF), is distributed as Shareware. This simply
means that you can try this product for 30 days. If you like it,
pay for it. See the registration form at the end of this document.
If you don't use it, keep the archived file around and upload it
to your favorite bbs's. Maybe one of your fellow developers has a
need for it.

DTF is the sole property of Timothy W. Cook and may not be
distributed by anyone else in any form not provided for in this
document.


LICENSE

You are hereby provided a license to evaluate DTF for a period of
thirty days. At the end of this thirty day period you must register
DTF or discontinue using it.



PURPOSE

Dynamic Text Files are intended as a replacement for the hard to
handle and bloated .DBT files created by Clipper(tm) when using
Memo fields. DTF's on the other hand, only consume the amount of
disk space necessary for the text and a SMALL pointer area. DTF
is not intended for use in applications where several hundred
large Memo fields are needed. There are commercial memo replacement
libraries available that are better suited, at a higher price, for
such instances. In most applications I've found that only a portion
of the records need more than a few lines of notes, and this is
where DTF fits in with the low cost approach of shareware.



FUNCTIONS

Below is a brief description of each function. Registered users
receive expanded documentation. DEMO.BAT will create DTFDEMO.EXE
to demostrate using DTF.

To use these functions in your own applications, include DTF.LIB
in your link script.

NOTE that ALL parameters are optional. DTF will default to the
current work area and record number where necessary.

Dynamic Text Files (DTF) Page 2 of 4
------------------------------------------------------------------------

Detailed Fucntion Listing
-------------------------


Function : F_INIT( [] )
Description : Create a Dynamic Text File (DTF).

Parameters : is the ALIAS of the .DBF file to attach the
DTF file to. Defualts to the current work area.

Returns : 0 = Operation Sucessfull
1 = A .DTF already exists for specified .DBF
2 = The specified .DBF doesn't exist
99 = Unknown Error. Contact Author
Comment : None

---

Function : F_Read( [] )
Description : Returns the DTF text for the current record.

Parameters : is the ALIAS of the .DBF file to use. Defaults
to the current work area.

Returns : Text associated with DBF record.
Comment : None

---

Function : F_Replace( [], [] )
Description : Replace the current record's DTF entry with

Parameters : is the ALIAS of the .DBF file to use. Defaults
to the current work area.
is character variable holding the text to write to
the DTF.

Returns : .T. is Sucessful, .F. if Unsucessful
Comment : None

---

Function : F_Delete( [], [] )
Description : Marks the DBF & DTF, record for deletion.

Parameters : is the ALIAS of the .DBF file to use. Defaults to
the current work area.
is the record number. Defualts to the current
record number.

Returns : .T. if Sucessful, .F. if Unsucessful
Comment : None

Dynamic Text Files (DTF) v1.02 Page 3 of 4
------------------------------------------------------------------------

Detailed Function Listing
-------------------------


Function : F_Recall( [], [] )
Description : UnMarks the DBF & DTF, record for deletion.

Parameters : is the ALIAS of the .DBF file to use. Defualts to
the current work area.
is the record number. Defaults to the current
record number.

Returns : .T. if Sucessful, .F. if Unsucessful
Comment : None

---

Function : F_Append( [] )
Description : Add a record to DBF & DTF

Parameters : is the ALIAS of the DBF file to use. Defaults to
the current work area.

Returns : .T. if Sucessful, .F. if Unsucessful
Comment : ** This Record Becomes Active **

---

Function : F_Clean( [] )
Description : Remove text from all DTF records marked for deletion.

Parameters : is the ALIAS of the DBF file to use. Defaults to
the current work area.

Returns : .T. if Sucessful, .F. if Unsucessful
Comment : NO pack is done on the database. Record recycling is a
much better way to handle records no longer needed.

---

Function : F_Zap( [] )
Description : Remove all text in DTF.

Parameters : is the ALIAS of the DBF file to use. Defaults to
the current work area.

Returns : .T. if Sucessful, .F. if Unsucessful
Comment : Does not delete the file.


Dynamic Text Files (DTF) v1.02 Page 4 of 4
------------------------------------------------------------------------

SUPPORT

Registered users receive telephone support. If you have questions
or comments about this shareware version you can address them to
Tim Cook on RIME or FIDO Clipper echos. I check these daily.
Sysops who carry these conferences may send for their FREE copy

of DTF_R. You must include the name and phone number of the BBS.
If you want this free copy to present to a "star user" on your BBS,
please include his/her information as the registered user and we'll
mail it directly to them with your compliments.


CREDITS

I must especially thank my wife Carol, for understanding the life
of a Clipper Widow and allowing me to do that which I love to do.

A special thanks to Mark Lussier, to whom I owe the demo program.
Not to mention his workover of this documentation and clockwork
phone calls at all hours of the day and night.

A note of thanks also to all of the contributors to Nanforum LIB.
It's a great piece of work and has inspired me many times in the
quest to conquer 5.01.


******************** DTF PROFESSIONAL ******************

DTF Professional includes all the benefits of the registered
shareware version plus:

o DTFIMPORT.EXE A utility to convert your .dbt's to .dtf's
o DTF Professional is network aware.
o DTF Professional allows multiple .dtf entries per record.
o DTF Professional supports FULL Data Encryption/Decryption
o 90 days free telephone support.



REGISTRATION

Registered users receive expanded, printed documentation and a copy of
DTF on diskette without the "Evaluation Copy" notice. 30 days free
telephone support. License to use DTF in your own applications.




Dynamic Text Files (DTF) v1.02 Registration Form
------------------------------------------------

Name : ___________________________________________

Address: ________________________________________

City : ________________________ State _______ ZipCode _____________

Country: ________________________

Phone #: Day _____________________ Evening _______________________

Media Type: ___ 3.5" ___ 5.25" (You must check one.)

(Sysops Only)
BBS Name : __________________________________

BBS Phone: ______________________________


Version name Copies Price Extended


DTF_R (registered) .................... _____ $ 19.95 _______

DTF_P (professional) .................. _____ 49.95 _______

DTF_R (Sysop Copy) .................... _____ 0.00 _______


Tn. residents add 7.75% sales tax ........................ _______

Shipping and Handling .................................... $ 5.00

TOTAL ................................................... $ _______

Please mail check, cash or money order payment in US Dollars with
this registration form to:

Timothy W. Cook
3001 Talos Dr.
Millington, Tn. 38053