home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d9xx / d956 / ddbase.lha / DDBase / docs / ddbase.doc next >
Text File  |  1993-11-27  |  31KB  |  1,001 lines
  1. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  2.                             DISCLAIMER
  3. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  4. DDBASE is provided "as is", without warranty of  any  kind.   In no event 
  5. will  the  author  be liable  for any  direct  or indirect damage or loss 
  6. resulting from the use or  misuse of  this  program.  By   using   DDBASE, 
  7. you are accepting the above.
  8.  
  9.  
  10. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  11.                            USEAGE
  12. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  13.  
  14. The copyright stays with me ©Peter Hughes {MadCap-Software} and is not 
  15. transferable by any means.You only have permission to use this software
  16. and freely copy and distribute it only if all the files are in tact.
  17.  
  18. You may freely copy DDBASE and all the supporting files as long as only
  19. a minimal fee is charged for copying. [No more than £2.00]
  20.  
  21.      
  22.                            DDBASE Version 3.0
  23.                            ~~~~~~~~~~~~~~~~~~
  24.  
  25.                             ©MADCAP-SOFTWARE
  26.                             ~~~~~~~~~~~~~~~~
  27.  
  28.  
  29.  
  30.  
  31. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  32. Contents
  33. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  34. Chapter 1        What you Need
  35.                       
  36. Chapter 2        Getting Started
  37.  
  38. Chapter 3        Introduction
  39.  
  40. Chapter 4        Main Gadgets
  41.  
  42. Chapter 5        Print Section
  43.  
  44. Chapter 6        Organise
  45.  
  46. Chapter 7        Epilogue
  47.  
  48. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  49.  
  50.  
  51. Documentation.
  52. ~~~~~~~~~~~~~~
  53.  
  54. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  55. Chapter 1                    What you need:-  
  56. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  57.  
  58. A 1MB Amiga running OS2.04 or higher
  59.  
  60. The Program DDBASE
  61.  
  62. The File ddbase.hlp in the same directory as DDBASE 
  63.  
  64. LIBRARIES you will need:
  65.  
  66. Reqtools.library
  67. ILBM.library
  68.  
  69. If you haven't got either of these libraries already in your Libs Directory
  70. then copy them from the DDBASE disk (or the Directory).
  71.  
  72. You will also need the AmigaGuide.library to view the DDBASE.GUIDE. For those
  73. with WorkBench 2.1 or higher this will be on your workbench disks.
  74.  
  75. As AmigaGuide is Copyright to Commodore I am unable to release it with this
  76. program.
  77.  
  78. Actually I got AmigaGuide and AmigaGuide.library from a Magazine Coverdisk
  79. so those with OS 2.04 keep your eyes peeled.
  80.  
  81. If you wish for the complete ILBM/Reqtools release then contact your local
  82. PD Library for the most recent release.
  83.  
  84. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  85. Chapter 2                     Getting Started
  86. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  87. Use a program like SID or OPUS etc to copy the Reqtools.library and the
  88.  ILBM.library to your libs directory.You will find them on the DDBASE disk.
  89.  
  90. OR:- Use the supplied program to copy Reqtools.library,ILBM.library and
  91. DDBASE to your Hard Disk or Floppy disk.
  92.  
  93. Just boot using your Workbench disk {copy} and open a cli or shell. Insert
  94. the disk that has DDBASE on in df0: or df1: type - cd df0:ddbase and press
  95. return.To make sure you are in the correct directory type dir.
  96. Next - type copyddbase and press return,please DO NOT RUN copyddbase.
  97. You will be asked if you wish to copy Reqtools.library to your libs
  98. Directory, if you haven't already got Reqtools.library then type `y' and
  99. press return.Do the same with the ILBM.library.
  100. Next you will be asked to enter the destination where you want ddbase to be
  101. copyed.Just type the destination ie df0:database or dh0:database/.
  102. Copyddbase will now copy
  103.                            DDBASE
  104.                            DDBASE.info
  105.                            ddbase.hlp
  106.                            ddbase.guide
  107.                            All the example databases
  108.  
  109. To your destination. Next you will be asked if you want to create a Prefs
  110. file. If you do press `y' and press return.This will write a small prefs
  111. file called `ddbase.prefs' in the ram:env/sys drawer.
  112.  
  113. It is Imperitive {most important} that Ram:env/sys, and Prefs/Env-Archive
  114. exists. If they don't look in your workbench manual to see how to create
  115. them.
  116.  
  117. This is only temporary so test DDBase by running it from its new home, then
  118. select Prefs and if your happy with the settings select Save.
  119.  
  120. If you had a problem and did not create the ddbase.prefs then just run DDBASE
  121. from its new home.You will see a requester stating that DDBASE could not 
  122. find then Help file.Select either options.Next you will be in DDBASE main 
  123. display,select Prefs and then select Path gadget.Enter the path press return
  124. then select Save+Use. You will not have any more problems. If you do take
  125. 2 Aspirins and lay down in a dark room for two hours with a damp cool towel
  126. over your head singing `Nee Neeee'.
  127.  
  128. WARNING:- Some possible problems!!
  129.  
  130.  
  131. {1}   Memory
  132.  
  133. If you run DDBASE several times you may get a problem{ A GURU } This is
  134. because DDBASE takes about 500K of ram: to store all the data etc.When 
  135. you exit DDBASE this ram: is passed back to the system. The problem is
  136. that programs like DDBASE need contiguous memory {all in one block} but
  137. after a program has passed the ram: back the memory gets fragmented and
  138. so even when you see displayed enough ram: to run DDBASE there may not
  139. be enough contiguous memory. If you are ever unsure then just reset your
  140. Amiga .I would like to say that this is not my fault but its just the way
  141. the Amiga handles memory Allocation.
  142.  
  143. {2} The Waiting Game
  144.  
  145. DDBASE does not like waiting for anyone and this one IS my fault.If you
  146. try to Multi-Task things get mighty slow.
  147.  
  148. ANSWER- If you want to load any other program first select About gadget
  149. this produces a Reqtools Requester which puts DDBASE to sleep,or you
  150. could select the Snap Gadget etc.
  151. If you import data be careful with any Date Fields. If you import a file
  152. from Superbase it may be a good ideah to use a string field if you find
  153. any problems.
  154.  
  155. {3} The- Dating Game
  156.  
  157. If you have already created and entered data and then you edit a field to
  158. a Date Field this may trash any existing data you have entered.
  159.  
  160. If you find that it does trash the data then you can either add a new field
  161. as a date field and then Update each existing record. Or you can export the 
  162. data and then edit the field to a Date Field after which select New and
  163. Delete Data. This will leave you with just the fields so you can import the
  164. data back into the database.
  165.  
  166. {4} The Import  Game
  167.  
  168. Always make sure when you wish to import data ascii or Superbase that you
  169. have selected the same amount of fields that was exported.DDBASE is not
  170. very forgiving and may produce a error requester that will mean early
  171. retirement from DDBASE. A most infuriating thing.
  172.  
  173. In future releases this may not be such a problem.
  174.  
  175.  
  176. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  177. Chapter 3     Introduction
  178. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  179. One of the features of DDBASE is the on line help  ,  so  if  you  get
  180. stuck just press the Help key and then click on the  gadget  you  need
  181. the help with.
  182.  
  183. Overall I think DDBASE is quite  simple  to  use,  while  being  quite
  184. powerful in its operations.I know that is easy for  me to  say  as  I
  185. wrote the program.So if you like the program but get a bit  stuck  on
  186. things, give me a call.
  187.  
  188.  
  189. DDBASE uses the ReqTools Library  ©Nico  Francios  and uses  emulated
  190. GadTools Gadgets. Uses Gadtools BevelBoxes and FlippedBevelBoxes.
  191. Also used is the ILBM Library to display IFF Pictures.
  192.  
  193. If you use GFABasic ©Data    Media (UK) Ltd,  and would like to know  how
  194. you can use Gadtools   BevelBoxes  and Reqtools or ILBM Libraries send me
  195. 2 disks  with  a stamped addressed envelope and I will send you the code.
  196. One  disk  you  will  get  back  and  the   other  one  I  will  keep  as 
  197. payment  for  my electricity and time etc.
  198.  
  199.  
  200.    FEATURES
  201.    ~~~~~~~~
  202.    On Line Help -   Just press the Help Key and click a Gadget.
  203.    
  204.    ASCII field -    Display any ASCI file.The External field is
  205.                     displayed as a Gadget.
  206.   
  207.    IFF Field -      Display any non HAM/AGA ILBM IFF.When I get an A1200
  208.                     this will change.   
  209.  
  210.    Position Fields -Position any field anywhere you like on screen
  211.                     you can always reposition them at any time.
  212.    
  213.    Field Types  -  STRING   Enter any type of data.
  214.                    DATE     Date format -DD/MM/YY
  215.                    NUMERIC  Be able to sort properly
  216.                    BBOX     TEXT in a BevelBox
  217.                    FBOX     TEXT in a FlipBox 
  218.                    TEXT     TEXT.
  219.                    ASCII    ASCII File.(See above)
  220.                    IFF      Display ILBM IFF Graphic.
  221.    
  222.    Edit Fields     Move,Edit,Add,or Delete fields.
  223.    
  224.    Export/Import   Export to ASCI or SuperBase ©Precision Software,
  225.                    format.Import ASCI or Superbase format.
  226.                    
  227.    Fast Sort       Uses a Shell Metzner Sort
  228.    
  229.    Snap            Saves current record in T:snap[n].ddb 
  230.    
  231.    Reqtools        Uses ReqTools ©Nico Francois Requesters
  232.    
  233.    GadTools        Uses Gadtools Bevel/Flip Boxes
  234.    
  235.    Draw Box        Draw BevelBoxes,FlipBoxes,RBoxes, and Circles
  236.                    Upto 10 allowed.
  237.                    
  238.    LOOKS           Totally WB2 look.All functions accessed by Gadgets
  239.                    and keyboard shortcuts.Press 'h' to see current
  240.                    shortcut.
  241.                    
  242.    Capacity        Upto 1500 Records (Keep an eye on the memory displayed
  243.                    on the Window Title Bar).
  244.                    Upto 20 Fields.
  245.                    Draw upto 10 boxes.
  246.                    
  247.                    
  248. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  249. Chapter 4     Main Display Gadgets
  250. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  251.  
  252.  Create
  253.  
  254.        Synopsis:  Creates a database.
  255.  
  256.        ShortCut-  c  (LowerCase)
  257.  
  258.      Enter How many fields you wish to have.Next enter the field  name
  259.      ,see Field Types, next enter the length.You will  then  be  asked
  260.      for the 'Field Type'.
  261.  
  262.      SELECT: STRING | DATE | INTEGER | BBOX | FBOX | TEXT
  263.  
  264.       Field Types.
  265.       ~~~~~~~~~~~~
  266.  
  267.       STRING   Input Data any Format
  268.       DATE     Input data as Date DD/MM/YY
  269.       INTEGER  Input Data as Numeric.
  270.       BBOX     Displays as text in a BevelBox
  271.       FBOX     Displays as text in a Flipped Box
  272.       TEXT     Displays as text.
  273.       ASCII    Will display ASCI file in field definition. 
  274.       IFF      Will display IFF Picture
  275.       
  276.      After you have defined your fields you now have to position  them
  277.      on the screen using the Mouse. When the field is in  the  desired
  278.      position press the left mouse button. After you  have  positioned
  279.      all of your fields you will then be able to add data as you wish.
  280.      However If you have made a mistake this can be  easily  rectified
  281.      by using the functions found in Organise.
  282.      
  283.      EXTERNAL - Any external field will be displayed as a Gadget.To
  284.      access the file just click the gadget.To display the contents of the 
  285.      field select Snap.You can edit the field as usual.A ASCII Field Gadget
  286.      has a broken  blue border whereas a IFF Field Gadget has a solid blue
  287.      border.
  288.      
  289.      Iff
  290.  
  291.        Synopsis: Displays ILBM IFF Pictures
  292.        
  293.        ShortCut  p
  294.        
  295.        Similar to External but displays a IFF File instead.
  296.        
  297.        See ASCII
  298.        
  299. ****************************************************************************       
  300. *ASCII Gadget                                                           *
  301. *                               *
  302. *   Synopsis: To display a ASCII Field                                *
  303. *                                                                        *
  304. *   Shortcut  Non                                                        *
  305. *                                                                        *
  306. *   A gadget that when pressed will display a ASCII file that has the    *
  307. *   Path and Name stored in the Field.To see the Name and Path of a      *
  308. *   External field select Snap.A External field Gadget can be identified *
  309. *   by a blue broken border.                                             *
  310. *                                                                          *
  311. *      See External, Snap.                                                 *
  312. *                                                                          *
  313. *                                                                          *
  314. *Iff Gadget                                                                *
  315. *                                                                          *
  316. *     Synopsis: To Display a IFF Picture                                   *
  317. *                                                                          *
  318. *     ShortCut Non                  *
  319. *                                                                          *
  320. *     A gadget when pressed will display a IFF Picture that has the name   *
  321. *     and path stored in the field.A IFF Gadget can be identified by a     *
  322. *     blue Border.Just to see the contents of the field select Snap.       *
  323. *                              *
  324. *     See IFF, Snap                                                        *
  325. *                     *
  326. ****************************************************************************
  327.  
  328.  See Organise Add Field/Delete Field/Edit Field/Move Field
  329.  
  330.  
  331.  
  332. Field Definitions:
  333. ----------------------------------------------------------------------
  334. String
  335.  
  336.         Synopsis: Field Definition- String Field
  337.         
  338.         ShortCut s (LowerCase)
  339.         
  340.         Defines the current field to input strings {Alpha/Numeric}
  341.         
  342.  
  343. Date
  344.  
  345.         Synopsis: Field Definition- Date Field
  346.         
  347.         ShortCut d {LowerCase}
  348.         
  349.         Defines the current field for a Date input. The only date input
  350.         allowed is DD/MM/YY. IE. 21 of June 1994 = 21/06/94
  351.         NOTE You are expected to have two charaters for the month.
  352.         
  353. Integer
  354.  
  355.         Synopsis: Field Definition- Numeric Data Input
  356.         
  357.         ShortCut i {LowerCase}
  358.         
  359.         Input Numeric data.
  360.         
  361.         
  362. BBox
  363.  
  364.         Synopsis: Field Definition- Display Field
  365.       
  366.         ShortCut b {LowerCase}
  367.         
  368.         Displays field title only. The field title is embodied in a
  369.         BevelBox .NOTE You need only set the field length to 1.
  370.         
  371.  
  372. Text
  373.  
  374.         Synopsis: Field Definition- Display Field
  375.         
  376.         ShortCut t {LowerCase}
  377.         
  378.         Displays field title only.
  379.         NOTE You need only set the field length to 1.
  380.         
  381.         
  382.  
  383. FBox
  384.  
  385.         Synopsis: Field Definition- Display Field
  386.         
  387.         ShortCut f {LowerCase}
  388.         
  389.         Displays field title embodied in a flipped bevel box.
  390.         NOTE You need only set the field length to 1.
  391.  
  392.  
  393. ASCII
  394.  
  395.   Synopsis: A Field Gadget that when depressed will display a
  396.       ASCII file whose path and name is stored in the field.
  397.       
  398.   Shortcut  Non
  399.   
  400.   
  401. IFF
  402.  
  403.   Synopsis:A Field Gadget that when depressed will display a
  404.       IFF file whose path and name is stored in the field.
  405.       
  406.   Shortcut Non
  407.   
  408. -------------------------------------------------------------------
  409.  
  410.  
  411.  
  412.  
  413. Delete
  414.  
  415.        Synopsis:  Deletes current record
  416.  
  417.        ShortCut-  D  (UpperCase)
  418.  
  419.      Selecting this will result in LOSS OF DATA make sure that you
  420.      have backed up your data before using this function.
  421.  
  422. Sort
  423.  
  424.        Synopsis:  Sorts Records
  425.  
  426.        ShortCut-  S  (UpperCase)
  427.  
  428.      This function allows you to sort your data by  any      field.You
  429.      can also sort numerically as well by string. After   you select
  430.      this function  the  select  field requester  appears.  The  sort
  431.      routine   is very fast and is case insensitive. In case you  were
  432.      wondering DDBASE uses a type of Shell Metzner sort routine.
  433.  
  434.  
  435.  
  436. Load
  437.  
  438.        Synopsis:  Loads a previously saved file.
  439.  
  440.        ShortCut-  l  (LowerCase)
  441.  
  442.      This function does what it says- loads data from disk.  The  file
  443.      requester has a pattern matching to '.ddb', this is added to  all
  444.      files saved with DDBASE.This makes  finding  and  loading a   lot
  445.      easier. (Nico Francois is worth his weight in gold)
  446.  
  447.  
  448. Add
  449.  
  450.        Synopsis:  Adds a record to the database
  451.  
  452.        ShortCut-  Cr  (CarriageReturn)
  453.  
  454.      To add data just press the return key and then just type in your
  455.      data and then select Accept or Cancel. Easy isn't it.
  456.     
  457.      Also if you have any external fields you can choose the ASCI/IFF file
  458.      from a File Requester (Reqtools of course) ,so if you have more than
  459.      one external field it might make sense to keep all your external files
  460.      in the same directory.
  461.      
  462. Edit
  463.  
  464.        Synopsis: Edits current record
  465.  
  466.        ShortCut-  e   (Lowercase)
  467.  
  468.  
  469. Search
  470.  
  471.      Synopsis: Search Database    (Case Insensitive)
  472.  
  473.  
  474.      Shortcut  =
  475.  
  476.     With this function you can search the database using  any  of  the
  477.     fields.Any field that you do not want to use just leave blank. You
  478.     can use '^' '=' '|' (thats shift + \).
  479.  
  480.     Using '^' {In String}  You would use this :- ^fred -:  this  would
  481.     search that field for any occurances of 'fred' in the field.
  482.  
  483.     Using '|' {Left String} You would use this :- |fred -: this  would
  484.     search that field for the left  part  of  the  field  that equals
  485.     'fred'.
  486.  
  487.     Using '=' {Exact Match} You would use this :- =fred -: this  would
  488.     search that field for an exact match.
  489.  
  490.     See ? Quick Search
  491.  
  492.  
  493. Quick Search
  494.  
  495.      Synopsis: Quick Search  (Case Insensitive)
  496.  
  497.      Shortcut ?
  498.  
  499.     This function will search all fields  for  any  occurance  of  the
  500.     search word. Example :- If you entered 'fred' it would try to find
  501.     any occurance  of  fred  in  any  of the   fields.   This   is
  502.     case insensitive.
  503.  
  504.  
  505. |«  Cursor Down
  506.  
  507.  
  508.     Synopsis: Move to start of Database
  509.  
  510.     Shortcut Cursor Down
  511.  
  512.     When a database has been open it moves to the start.
  513.  
  514.  
  515. ««  Cursor Left
  516.  
  517.     Synopsis: Moves to the previous record
  518.  
  519.     Shortcut  Cursor Left
  520.  
  521.      Displays the previous record.
  522.  
  523.  
  524.  
  525. º Space - GoTo
  526.  
  527.      Synopsis: Goto Line No
  528.  
  529.      Shortcut  Space
  530.  
  531.      Allows you to Jump to any Line No.
  532.  
  533.  
  534.  
  535. »»  Cursor Right
  536.  
  537.      Synopsis: Displays the next record
  538.  
  539.      Shortcut  Cursor Right
  540.  
  541.      Displays the next record.
  542.  
  543. »|   Cursor Up
  544.  
  545.      Synopsis: Moves to Last record
  546.  
  547.      Shortcut  Cursor Up
  548.  
  549.      Moves to the last record.
  550.  
  551.  
  552. About
  553.  
  554.      Synopsis: Tells you all about me!
  555.  
  556.      Shortcut  A (Uppercase)
  557.  
  558.      What can I say!!!!
  559.  
  560.  
  561.  
  562.  
  563. Print
  564.  
  565.        Synopsis:  Allows user to print using various output.
  566.  
  567.        ShortCut-  p  (LowerCase)
  568.  
  569.     See Help in Print Section.
  570.  
  571.  
  572. Save As
  573.  
  574.        Synopsis: Saves DataBase
  575.  
  576.        ShortCut s (LowerCase)
  577.  
  578.     Produces a ReqTools File Requester so you can choose what name to
  579.     save the database with.
  580.  
  581. Snap
  582.  
  583.        Synopsis: Takes a snapshot of current record
  584.  
  585.        ShortCut  P (UpperCase)
  586.  
  587.     Those of you who have not heard of the  utility  'SNAP'  ©  Mikael
  588.     Karlsson, may find this quite strange. When selected  the  program
  589.     will save the current record to T: as snap{nn}.ddb. NN is  updated
  590.     for each record you Snap so after for instance you Snap 2  Records
  591.     the directory T: would look something like this:
  592.  
  593.    1.Ram Disk:> dir t:
  594.     snap1.ddb
  595.     snap2.ddb
  596.    1.Ram Disk:>
  597.  
  598.     The reason why the current record is displayed in a  Requester  is
  599.     quite simple SNAP © by Mikael Karlsson does not work  due  to  the
  600.     BevelBoxs.
  601.  
  602.  
  603. New
  604.  
  605.        Synopsis:Deletes the whole database or data
  606.  
  607.        ShortCut  n (LowerCase)
  608.  
  609.     You have the option Kill! | Data | Cancel. Selecting  Kill!  will
  610.     delete the data and  the  data  structure  (fields  etc).  Whereas
  611.     Delete Data will only clear the data leaving the data structure in
  612.     tact.
  613.  
  614. Save
  615.  
  616.        Synopsis: Save data direct without the option of a File
  617.        Requester.
  618.  
  619.        ShortCut v (LowerCase)
  620.  
  621.     Save will only work if their is a database that  has  either  been
  622.     loaded or has previously been saved.In other  words  if  the  file
  623.     path and name is null ("") it will not work
  624.  
  625.  
  626.  
  627. Organise
  628.  
  629.        Synopsis: To alter fields and Import and Export Data
  630.  
  631.        ShortCut  o   (LowerCase)
  632.  
  633.     I believe that these functions make DDBASE stand  out  from  other
  634.     Database programs. To be  able  to alter  the  fields   and  their
  635.     position to Add fields or delete them with ease.
  636.  
  637. Prefs
  638.  
  639.      Synopsis: Allows the user to alter some operations of DDBASE
  640.      
  641.      Shortcut f (LowerCase)
  642.      
  643.      LOAD      Set On/Off. When On DDBASE will attempt to load the file
  644.                Defined in the FileName Gadget
  645.      
  646.      FILENAME  Select the 'R' Gadget (short for Requester) and then select
  647.                a file from the File Requester.
  648.                
  649.      PRINT     This option sets the page Length for output to a printer.
  650.                 SEE the Print section.
  651.                 
  652.      SEPERATOR This allows you to enter the field seperator.This is useful
  653.                when you are exporting or importing data from SuperBase.
  654.                {SuperBase ©Precision Software}
  655.                
  656.      CALCULATE Calculate when searching [=].Will open a window and display
  657.                all the selected fields.{See Calculations}
  658.                
  659.      PATH      Set the Path for DDBASE.Keep all your files here.
  660.      
  661.      GUIDE     Use Amigaguide for Help. AmigaGuide needs to be in the C
  662.                directory and ddbase.guide in the Path directory.
  663.                
  664.      DATE      Use DD/MM/YY or DD MMM YYYY (12/06/93 or 12 Jun 1993)
  665.      
  666.      SAVE      This saves the preference settings.
  667.      
  668.      USE       This saves the preference settings to Ram:env/sys/.
  669.      
  670.      USE+SAVE  Take a guess at this one... Thats correct it saves the
  671.                Preference Settings to the current prefs (env:sys/) and to
  672.                prefs/Env-Archive/sys/.
  673.  
  674. Guide
  675.  
  676.      Synopsis:Use AmigaGuide when Help Key is pressed.
  677.      
  678.      Shortcut  Non
  679.      
  680.      Instead of pressing Help and then clicking the gadget you need help
  681.      with, a Help file in AmigaGuide is used.
  682.      
  683.      This gives more information overall but shares the same information
  684.      about the gadgets.
  685.  
  686.  
  687. Path
  688.  
  689.      Synopsis: The path for the system files.IE. Help files etc
  690.      
  691.      Shortcut Non
  692.      
  693.      This enables you to put DDBASE in any directory on a Hard Disk or
  694.      floppy and the Help files - DDBASE.HLP and DDBASE.GUIDE anywhere
  695.      you wish,DDBASE will know how to find them.
  696.      
  697.      Ideally you would put DDBASE and the supporting files in a directory
  698.      along with the database files you create and then set the path to
  699.      this directory. IE Path == 'DH0:Database/' .
  700.  
  701.  
  702. Calculate
  703.  
  704.     Synopsis:When set will calculate selected fields
  705.     
  706.     Shortcut Non
  707.     
  708.     When set it will display the fields,either all the fields or the fields
  709.     you have selected {see Organise Select Fields}.
  710.     
  711.     If you have selected the fields you wish to use {See Organise Set-Calc}
  712.     when you use Search  or Quick Search the Sum of the fields will be 
  713.     calculated.
  714.     
  715.  
  716.                
  717.         
  718. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  719. Chapter 5   Print Section
  720. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  721.  
  722.  
  723. Print While Searching
  724.  
  725.        Synopsis: Will send data to printer when you use the
  726.        search function.
  727.  
  728.        ShortCut- p  (LowerCase)
  729.  
  730.    Selecting this function any data output from the next  search  will
  731.    be output to the screen and to the printer in the format  you  have
  732.    selected, Table View or Record View.
  733.  
  734. Envelope
  735.  
  736.        Synopsis:Will output the selected fields to a Label or
  737.       Envelope.
  738.  
  739.        ShortCut-   e  (LowerCase)
  740.  
  741.  
  742.    You will be asked for the tab position and then it will print
  743.    the current record (Selected Fields)
  744.  
  745.  
  746. All Records
  747.  
  748.        Sysnopsis: Prints all the records.
  749.  
  750.        ShortCut-  a  (LowerCase)
  751.  
  752.    This function will print all the records in the format that
  753.    you have selected.
  754.  
  755. Current Record
  756.  
  757.        Synopsis: Prints Current Record
  758.  
  759.        ShortCut-  c  (LowerCase)
  760.  
  761.    Prints Current Record in the format you have chosen
  762.  
  763. Table View
  764.  
  765.        Synopsis: Print Format
  766.  
  767.        ShortCut  t  (LowerCase)
  768.  
  769.    Prints  selected  fields  horizontally  accross  the  Paper.  After
  770.    reaching 65 lines you will be asked to insert a new sheet of paper.
  771.    If you use tractor feed then set your printer to  the  top  of  the
  772.    next page.
  773.  
  774. Record View
  775.  
  776.        Synopsis: Print Format
  777.  
  778.        ShortCut  r  (LowerCase)
  779.  
  780.    Prints Selected fields vertically down the paper.
  781.  
  782.  
  783. Form View
  784.  
  785.        Synopsis: Print Format
  786.  
  787.        Shortcut f (LowerCase)
  788.  
  789.     Prints all fields as they appear on the screen. Saying that it will
  790.     not display Bevel Boxes etc just the field Text and Data.
  791.  
  792.  
  793. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  794. Chapter 6     Organise
  795. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  796.  
  797. Set Calc'
  798.  
  799.   Synopsis: Select fields you wish to Calculate the Sum of.
  800.   
  801.   Shortcut Non (At the Moment)
  802.   
  803.   Choose  Select|Cancel. To select fields  click on select and enter how
  804.   many fields you wish to use.Then with the Mouse select the fields from
  805.   the requester.
  806.   
  807.  
  808. Select Fields
  809.  
  810.        Synopsis:Select the fields you wish to print
  811.  
  812.        ShortCut s (LowerCase)
  813.  
  814.    You have the option to select All | Select | Cancel.  By  selecting
  815.    All this will enable   you to print all the fields.With  Select you
  816.    can choose the fields that you want printed and their length. Enter
  817.    how many fields you wish to use. The field requester will appear on
  818.    the right and a list of chosen fields on the left.
  819.  
  820. Export DATA*
  821.  
  822.        Synopsis: Exports data with out the field information.
  823.    ASCI or SuperBase Format
  824.  
  825.        ShortCut x (LowerCase)
  826.  
  827.    ASCI
  828.  
  829.    The selected fields will be output to a file. This will  be useful
  830.    to transfer data from one database to another or for a  mail  merge
  831.    file for use with a word processor.
  832.  
  833.    SuperBase
  834.  
  835.    The data will be output in a format that SuperBase can Import. Also
  836.    you will find a  second  file  with a  '.hlp'  suffix,  this   file
  837.    contains the field name and length of the records.To use  the  data
  838.    in SuperBase you will first need to create a database that has  the
  839.    same amount of fields and the correct length.To find out how to  do
  840.    this look in the SuperBase manual.
  841.  
  842.  
  843. Import DATA*
  844.  
  845.        Synopsis: Merges Data ASCI or SuperBase Format
  846.  
  847.        Shortcut  i (LowerCase)
  848.  
  849.    Merges data to database.Their must be the same amount for fields in
  850.    the file to be  imported  otherwise all  sorts   of problems  will
  851.    occur.However the actual length of the fields on  the  file to   be
  852.    imported is not important,BE WARNED if the fields are  longer  than
  853.    the current database then they will be trimmed to the size  of  the
  854.    current field lengths.
  855.  
  856.   Import SuperBase
  857.  
  858.    Will import data that has been previously exported from Superbase
  859.    Enter the field seperator ie ',' or '*' whatever you set in Superbase
  860.    SuperBase ©Precision Software.
  861.  
  862.  
  863.  
  864. Edit Field
  865.  
  866.        Synopsis: Allows you to edit any field.Also change the length.
  867.  
  868.        Shortcut  e  (LowerCase)
  869.  
  870.    Displays the Select Field requester.After selecting the  field  you
  871.    can change or alter the field name.After pressing  return  you  can
  872.    change the field length.Also you can change the Field Type.
  873.  
  874.    See Create
  875.  
  876.  
  877. Move Field
  878.  
  879.        Synopsis: Allows you to move any field to a new position.
  880.  
  881.        ShortCut  m (LowerCase)
  882.  
  883.    You have the option to change   all the   fields or select
  884.    field. Change  all  fields  is  the same procedure  you   went
  885.    through  with Create after defining your fields.
  886.  
  887.    However if you  choose  to  select  the  field  that  you  wish  to
  888.    move,choose Select.After  selecting the  field  from   the  Field
  889.    Requester, all the existing fields will be displayed.All  you  have
  890.    to do is to move your new field to the correct position  and  press
  891.    the left mouse button.
  892.  
  893.  
  894.  
  895. Add Field
  896.  
  897.        Synopsis: Add field
  898.  
  899.        ShortCut a (LowerCase)
  900.  
  901.    Allows you to Add another field.A string requester appears for  you
  902.    to enter the name of the new field.Then you enter the  length.  You
  903.    then have to select the Field Type. After this you position the new
  904.    field using the mouse, when it is in the desired position press the
  905.    left mouse button.
  906.  
  907.  
  908. Delete Field
  909.  
  910.        Synopsis: Deletes a field
  911.  
  912.        ShortCut d (LowerCase)
  913.  
  914.    After selecting this option a Select Field requester allows you  to
  915.    choose the field to delete.It must be noted that deleting  a  field
  916.    not only deletes the specified field  but  also  the  corresponding
  917.    data in the database.
  918.  
  919.  
  920.  
  921. Statistics
  922.  
  923.      Synopsis: Displays Information about your Database
  924.  
  925.      Shortcut =  S  (UpperCase)
  926.  
  927.      Will display a requester displaying how many records,fields and
  928.      displaying all the fields with their length and Field Types.You
  929.      can also print the information.
  930.  
  931.  
  932. Draw Box
  933.  
  934.      Synopsis: Draw Flip / Bevel Boxes
  935.  
  936.      Shortcut = b (LowerCase)
  937.  
  938.      Select BEVEL|FLIP|RBOX|CIRCLE|DELETE|CANCEL
  939.  
  940.      BEVEL  Draws a bevelbox {GADTOOL}
  941.      FLIP   Draws a flipbox {GADTOOL} (DDBASE will not run on OS1.3)
  942.      RBOX   Draws a rounded box.(Best on Square Boxes or small ones)
  943.      CIRCLE Draws a circle.
  944.      DELETE Deletes Last Box Drawn
  945.      CANCEL Exits from the routine.
  946.  
  947.      Position pointer to the top left corner of the box that you wish
  948.      to draw, then press the left mouse button.
  949.      Move the pointer to the bottom right corner, you will notice the
  950.      rubber banding effect. When the box is to your desired size press
  951.      the left mouse button.
  952.  
  953.      If you are drawing a circle start from the centre and work to the
  954.      Right.
  955.  
  956.      NOTE: You can only go from Left to Right and not Right to Left.
  957.  
  958.  
  959.  
  960. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  961. Chapter 7      Epilogue
  962. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  963.  
  964. If you like DDBASE and use it you  might  like to  consider  a  small
  965. donation to the author of this breathtaking database.  Or  some  blank
  966. disks or PD software, or a postcard but you are not obliged to do  so
  967. although I would like any bug reports or  any  suggestions  (Please  No
  968. rude ones). 
  969.  
  970. I can be contacted by Telephone -  Hastings(0424) 854608
  971.  
  972.  
  973. Or by Mail
  974.  
  975.   Peter Hughes
  976.   168 Wishingtree Road
  977.   St Leonards on Sea
  978.   East Sussex
  979.   TN38 9LB
  980.  
  981. This is Version 3.0
  982.  
  983. If you want a copy of the latest version (if there is one) send 2
  984. Blank disks and a stamped addressed envelope.
  985.  
  986. DDBASE    ©MADCAP-SOFTWARE 26 November 1993
  987. ReqTools  ©Nico Francois
  988. GFABASIC  ©GFA Data Media (UK) Ltd
  989. SuperBase ©Precision Software (Or at least my version is!)
  990. Gadtools  ©Commodore
  991. SNAP      ©Mikael Karlsson
  992. ILBM      ©Jeff Glat.
  993.  
  994.  
  995.  
  996.        The End
  997.        ~~~~~~~
  998.  
  999.  
  1000.  
  1001.