home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 14 / CD_ASCQ_14_0694.iso / demoware / gestrec / grecdoc.us < prev    next >
Text File  |  1994-03-13  |  31KB  |  990 lines

  1.                              ┌────────────────┐
  2.                              │   GESTRECORD   │
  3.                              │   Version 1.   │
  4.                              │   15.01.1994   │
  5.                              └────────────────┘
  6.  
  7.                           (c)opyright January 1994
  8.                          Write by par JANNOTA PASCAL
  9.  
  10.  
  11.  
  12.  
  13. I am french and would ask you to excuse my far from good English.
  14.  
  15.  
  16.  
  17. This program can be freely used during 2 weeks. After, and if (evidently) you
  18. find it is an interesting program, you must pay me a licence.
  19.  
  20. You'll find in "LICENCE.US" file all useful information about it.
  21.  
  22. I hope GESTRECORD will give you the satisfaction expected and that I shall
  23. hear from you shortly.
  24. In the mean time, I wish you good work.
  25.  
  26.  
  27. Thanks to:
  28.   - Neil Rubenking, for his book "Le guide programmeur Turbo Pascal"
  29.     "DUNODTECH" editions.
  30.   - Thomas Lachand-Robert, for his book "Programmation orientée objet en
  31.     Turbo Pascal" "SYBEX" editions.
  32.   - Borland, for his language And for the various tools given with Turbo
  33.     Vision.
  34.   - My wife and my two children for their patience.
  35.  
  36.  
  37.  
  38. GestRecord has online help, but in this file you can find some
  39. supplementary explanations.
  40.  
  41. GestRecord is in Turbo Pascal 7., and use Turbo Vision application.
  42. Futur versions will contain multi key search, the
  43. possibility of managing more than 2 million of records, a version for
  44. window...
  45.  
  46.  
  47.  
  48.  
  49. GestRecord aims to reach a maximum of users: from the programer who
  50. wants to rapidly build file records and use them in his programs, or
  51. for the ordinary user wanting to make a directory, or a repertory...
  52.  
  53.  
  54.  
  55. Program setting up:
  56. ==================
  57.  
  58. On DOS prompt:
  59. ─────────────
  60.   If the files disk is compressed, you must uncompress it (in temp
  61.   directory, for example).
  62.   Go in its directory:
  63.     Ex: type on dos prompt: CD\TEMP
  64.   Type INSTALL
  65.  
  66. In Window:
  67. ─────────
  68.   After the files disk is uncompressed,
  69.     Open "File" menu,
  70.     Click on 'perform...',
  71.     In the 'command line' input line, type the acces way and
  72.     'INSTALLE.EXE'.
  73.       Ex: C:\TEMP\INSTALLE.EXE
  74.  
  75. The INSTALLE program will create:
  76.  1 root directory: GREC
  77.  3 sub-directorys: FDATAS
  78.                    FHEADER
  79.                    FTEMP
  80.  
  81. The GREC directory will contain: the execution file : GESTREC.EXE
  82.                                  the help file      : GRECHELP.HLP
  83.                                  the resource file  : GRECRES.TVR
  84.                                  its file           : GRECDOC.US
  85.                                  the licence file   : LICENCE.US
  86.                                  For Window:
  87.                                  An icon            : GRECIMAG.ICO
  88.                                  the PIF file       : GESTREC.PIF
  89.  
  90. The GREC\FDATAS directory will contain the data files wich will be created
  91. by GESTRECORD.
  92.  
  93. The GREC\FTEMP directory will contain the temporary files used by the
  94. program. Its files will always be deleted at the end of each session.
  95.  
  96. The GREC\FHEADER directory will contain the init files (.~DA and .C..)
  97. created by GestRecord.
  98.  
  99. WARNING: If you don't execute the INSTALLE program, GESTRECORD Will not
  100. run correctly.
  101.  
  102.  
  103.  
  104.  
  105.  
  106. Program Characteristics:
  107. =======================
  108.  
  109. (only If you have paid the licence)
  110.  
  111. If GestRecord has sufficient memory:
  112.  - 16380 records by file,
  113.    (only 50 for the demo program)
  114.  -   255 fields by record,
  115.  -     9 data types,
  116.  -   255 different record windows simultaneously displayed,
  117.  -   255 different field windows at the same time on the desk,
  118.  - various tools
  119.  - EMS memory mangment.
  120.  
  121. Minimum configuration:
  122. =====================
  123.  
  124.  - IBM PC/AT or 100% compatible (286 minimum),
  125.  - MS DOS 5.0 or latter,
  126.  - A mouse,
  127.  - EMS Memory (not essential but advantageous).
  128.  
  129.  
  130. Start Program:
  131. =============
  132.  
  133. On DOS prompt:
  134. ─────────────
  135. Type on dos prompt: cd\GREC,
  136. Then type GESTREC
  137.  
  138. In Window:
  139. ─────────
  140. Click in the GESTRECORD icon.
  141.  
  142.  
  143.  
  144.  
  145.  
  146.  ┌────────────────┐
  147.  │ PRINCIPAL MENU │
  148.  ├────────────────┘
  149.  │
  150.  ├─ File create
  151.  │   ├─ Treatment init
  152.  │   ├─ File name
  153.  │   ├─ Records types init
  154.  │   │     ├─ Number of fields
  155.  │   │     └─ Field types
  156.  │   ├─ Validation of types init
  157.  │   └─ What GestRecord does?
  158.  │
  159.  ├─ File Open
  160.  │   ├─ Commence funtion
  161.  │   ├─ File name
  162.  │   └─ What make GestRecord?
  163.  │
  164.  ├─ Build your file
  165.  │   ├─ Records
  166.  │   │      ├─ Modify
  167.  │   │      ├─ Add
  168.  │   │      ├─ Delete
  169.  │   │      ├─ Search
  170.  │   │      └─ Restore
  171.  │   └─ Fields
  172.  │          ├─ Modify
  173.  │          ├─ Add
  174.  │          ├─ Delete
  175.  │          └─ Search
  176.  │
  177.  ├─ Fields and records windows
  178.  │   ├─ Continuous record window
  179.  │   ├─ Window for one record
  180.  │   └─ Fields
  181.  │
  182.  ├─ File save
  183.  │   ├─ As the same name
  184.  │   ├─ as an another name, directory or drive
  185.  │   └─ close without save
  186.  │
  187.  ├─ Tools
  188.  │   ├─ Calculator
  189.  │   ├─ Calendar
  190.  │   ├─ Mouse
  191.  │   ├─ Convert
  192.  │   ├─ Bit test
  193.  │   ├─ Clock
  194.  │   └─ Memory view
  195.  │
  196.  ├─ Arrange the windows on the desk
  197.  │
  198.  └─ Quit GestRecord
  199.  
  200.  
  201.  
  202.  
  203.  
  204. PRINCIPAL MENU DESCRIPTION:
  205. ==========================
  206.  
  207. To move in the menus (and in the dialogue box), you can use the mouse or
  208. the keyboard:
  209.  - With the mouse, click on the menu command.
  210.  - With the keyboard, you can use the 'tab' key to select a menu
  211.                       and the arrows keys to choose a command,
  212.                       then type on <ENTER> key.
  213.  
  214. For any help you cannot find in this file, search in online help.
  215.  
  216.  
  217.  
  218.  
  219.  
  220. 1.1   |
  221.       ├─ File create
  222.       │   ├─ Treatment init
  223.       │   ├─ File name
  224.       │   ├─ Records types init
  225.       │   │     ├─ Number of fields
  226.       │   │     └─ Field types
  227.       │   ├─ Validation of types init
  228.       │   └─ What GestRecord does?
  229.       |
  230.  
  231.  
  232. 1.1.1) Treatment init:
  233.        ==============
  234.  
  235. In the 'Init' menu, choose the 'File' command.
  236. In the 'File managment' dialogue box, you'll be able to enter some
  237. file treatments parameters.
  238.  
  239. You can't choose this command if a file is open.
  240.  
  241.  
  242.  
  243.  1.1.1.1) ┌ Record size  ────┐
  244.           │  (∙) Constant    │
  245.           │  ( ) Variable    │
  246.           └──────────────────┘
  247.  By ticking/marking the appropriate box you will indicate to GestRecord wich
  248.  type of record you want to use.
  249.  
  250.   - Constant record: The fields of STRING type are written on the disc
  251.     according to the length of your entry in the init session (see 1.1.3).
  252.     If the size is of 100 characters, 100 characters will be saved on the
  253.     disc even if the field contains no more than 2 characters.
  254.     The fields with STRING type cannot be stretched.
  255.     Exemple:
  256.       If in the init session, you have entered a String size of 20 characters
  257.       and if later, after many many records, you have a String with
  258.       21 characters, you won't be able to enter the whole string.
  259.     To avoid this problem, choose the constant record for records which have
  260.     only fields with numeric types (byte,integer,word...).
  261.  
  262.  
  263.  
  264.  
  265.  - Variable records: The fields with STRING type are writing on the disc
  266.    according their real length and not for the init size in the init session.
  267.    This size is always of 132 characters (the maximum).
  268.    If a field contains only 2 characters, 2 characters will be saved on
  269.    the disc.
  270.    In addition, the field size can always be increased.
  271.  
  272.    WARNING: If you want GestRecord to save the STRING fields for their
  273.             real length, you must choose the 'Compress' option
  274.             (see 1.1.1.2).
  275.  
  276.  
  277.  1.1.1.2)  ┌ file managment ───┐
  278.            │  [ ] Header       │
  279.            │  [ ] Compres      │
  280.            │  [ ] Index        │
  281.            └───────────────────┘
  282.  
  283.  With these 3 Check boxes, you can define:
  284.   - a header: impossible for create files (see 2.1.1),
  285.  
  286.   - a compression: if you have chosen the variable records, your interest
  287.     is to mark this box.
  288.     With this option, the String fields will be saved on the disk for
  289.     their real length and the del records won't be save.
  290.     If you haven't a lot of place on your disq, mark this box.
  291.  
  292.   - Index: The records in GESTRECORD always contains an index. With it,
  293.     you'll be able to find a record very quickly.
  294.     But, if you want to init each record key or if you want GESTRECORD to
  295.     use a STRING field to build the index (see 1.1.1.4), mark this box.
  296.  
  297.     If you mark this box, you must indicate to GESTRECORD the
  298.     index field (see 1.1.1.4) or in the init session (see 1.2.1).
  299.  
  300.  
  301.  
  302.  
  303.  1.1.1.3)   ┌─Header size  ─────┐
  304.             └───────────────────┘
  305.  
  306.  You must indicate the header size only if you want 'open a file'
  307.  (see 2.1.1)and not 'create a file'.
  308.  
  309.  
  310.  
  311.  1.1.1.4)   ┌─Index field ─────┐
  312.             └──────────────────┘
  313.  
  314.  If the 'Index' check box is checked (see 1.1.1.2) you can enter in this
  315.  input line the field number which will init each record key.
  316.  
  317.  This field MUST be of STRING type.
  318.  
  319.  GESTRECORD will deduct  the 5 first letters (maximum) of the contents
  320.  field and will constitute the record index.
  321.  If the key already exists, GestRecord brings up a dialogue box to enter
  322.  a new key.
  323.  
  324.  
  325.  
  326.  1.1.1.5)   ┌ Language ──────┐
  327.             │  ( ) French    │
  328.             │  (∙) English   │
  329.             └────────────────┘
  330.  
  331.  If you want GESTRECORD use the english langage, check the English
  332.  radio-button.
  333.  
  334.  You can also enter, at the dos prompt the 'US' letter when you run
  335.  GESTRECORD.
  336.  Ex: GESTREC US
  337.  
  338. 1.1.2) File name:
  339.        =========
  340.  
  341. If you choose the File|Create command, you enter the file name
  342. in the file dialogue box.
  343. This file will be placed in C:\GREC\FDATAS Subdirectory with '.DAT'
  344. extension.
  345.  
  346. You can enter 8 characters maximum for the name.
  347.  
  348.  
  349.  
  350.  
  351. 1.1.3) Records types init:
  352.        ==================
  353.  
  354. GESTRECORD must have certain information in order to be able to create your
  355. file.
  356. This information will be saved in a file and you'll longer need to enter
  357. these.
  358.  
  359.  
  360.  
  361.  
  362.  1.1.3.1) Field number:
  363.           ============
  364.  A field is a part of record.
  365.  each record can contain 255 fields and each field can be of 9 different
  366.  types (voir 1.1.3.2).
  367.  
  368.  Records exemple:
  369.    Phone = Name       type STRING
  370.            First name type STRING
  371.            Number     type STRING
  372.    3 fields of STRING type.
  373.  (Recall: The index can be on the Name, First name or phone field: theses 3
  374.  fields are of STRING type).
  375.  
  376.    Patient   = Name    type STRING
  377.                Address type STRING
  378.                Number1 type LONGINT
  379.                Number2 type WORD
  380.    2 fields of STRING type,
  381.    1 field of LONGINT type,
  382.    1 field of WORD type.
  383.   (Recall: the index can be on Name and Address field (STRING type) but
  384.    on Number1 and number2 field).
  385.  
  386.  
  387.   To indicate the field number of your record to GESTRECORD, you'll be
  388.   able to enter in the 'field number' dialogue box, a number from 1 to
  389.   255.
  390.  
  391.  
  392.  1.1.3.2) Field types:
  393.           ===========
  394.  
  395.  The field type indicates its octet size and its valid limits.
  396.  You can find the informations in the table below.
  397.  
  398.  Note: A numeric field (byte, shortint, integer...) can't start
  399.        with a '0' value.
  400.        Ex: 0520 will be take by GESTRECORD for: 520.
  401.        You can't enter a value out of the valid limits.
  402.  
  403.  If you don't understand the types, choose the STRING type for all your
  404.  fields.
  405.  But, the STRING type has 2 disadvantages:
  406.   - It takes more place on the disc:
  407.     Ex: you must enter a number: 2 500 000.
  408.         If the field type is LONGINT, it take 4 octets on the disc.
  409.         If the field type is STRING, it take 8 octets on the disc
  410.         (7 octets for the number + 1 octet for the string length).
  411.   - GESTRECORD can't control the input value:
  412.     Ex: You have a field of BYTE type (numbers from 0 to 255),
  413.         if you select the BYTE type for its field, GESTRECORD can control
  414.         that you only enter valid numbers, with a value from 0 to 255,
  415.         but if you choose the STRING type, GESTRECORD can't control this.
  416.  
  417.  
  418.                          ╔════════════════════╗
  419.  ╔════════════╤══════════╣   TYPES  ARRAY     ╠═══════╤════════════════╗
  420.  ║            │          ╚══════════════════╤═╝       │                ║
  421.  ║ Type names │         Validite            │ Octets  │     Type       ║
  422.  ║ ───────────┼─────────────────────────────┼─────────┼────────────────║
  423.  ║  SHORTINT  │        -128 to +127         │   1     │   number       ║
  424.  ║ ───────────┼─────────────────────────────┼─────────┼────────────────║
  425.  ║  BYTE      │          0 to 255           │   1     │   number       ║
  426.  ║ ───────────┼─────────────────────────────┼─────────┼────────────────║
  427.  ║  INTEGER   │       -32768 to +32767      │   2     │   number       ║
  428.  ║ ───────────┼─────────────────────────────┼─────────┼────────────────║
  429.  ║  WORD      │          0 to 65535         │   2     │   number       ║
  430.  ║ ───────────┼─────────────────────────────┼─────────┼────────────────║
  431.  ║  LONGINT   │   -2147483648 to +2147483647│   4     │   number       ║
  432.  ║ ───────────┼─────────────────────────────┼─────────┼────────────────║
  433.  ║  REAL      │      -2.9E-39 to +1.7E38    │   6     │   number       ║
  434.  ║ ───────────┼─────────────────────────────┼─────────┼────────────────║
  435.  ║  CHAR      │     1 lettre or a number    │   1     │  Char-Number   ║
  436.  ║ ───────────┼─────────────────────────────┼─────────┼────────────────║
  437.  ║  STRING    │       to 132 caractères     │ 3 à 133 │  Char-Number   ║
  438.  ║ ───────────┼─────────────────────────────┼─────────┼────────────────║
  439.  ║  BOOLEAN   │      0 or 1/ True or False  │   1     │    number      ║
  440.  ╚════════════╧═════════════════════════════╧═════════╧════════════════╝
  441.  
  442.  
  443.  For the types init, GestRecord brings up a dialogue box in which you'll be
  444.  able to enter the name (10 characters maximum), the type of each
  445.  field and the string length (132 characters maximum) if the type field
  446.  is STRING.
  447.  See online help to use this dialogue box.
  448.  
  449.  
  450.  
  451. 1.1.4) Types init validation:
  452.        =====================
  453.  
  454. Once each field has been init, GestRecord brings up a validation window.
  455. It will show you the number, the name, the type and the size (in octets)
  456. of each record field.
  457. If you have made a mistake, you close its window with the 'CANCEL' button
  458. or with the close icon and the 'Init types dialogue box' will again appear
  459. and enable you to rectify the mistake.
  460.  
  461. Otherwise, close the window with the 'OK' button and the init session will
  462. terminate:
  463.   If the Index option (see 1.1.1.2) is checked, GestRecord will ask you the
  464.   field number you want to choose for the index.
  465. Then, you can work with your file.
  466.  
  467. Note: The field number can always be modified with the field|Add command or
  468.       with the field|del command but a field type cannot be modified
  469.       once the init types session is finished.
  470.       If you have made a mistake, you must delete the field and add it
  471.       again with the next type.
  472.  
  473.  
  474.  
  475. 1.1.5) What GESTRECORD does:
  476.        =====================
  477.  
  478. To remember your record structure, GestRecord also uses records.
  479.   You can find the stucture of these records and the init files in the
  480.   program source.
  481.  
  482.   Warning: GESTRECORD is sure of the information written in its init files
  483.   and does not accept alteration without warning.
  484.   If you modify its files (.~DA and .C..), GestRecord won't be
  485.   able to locate these and will destroy your file data.
  486.  
  487.  
  488. What GESTRECORD does is very simple:
  489.   For each field, the name, the type, the rank, the size, the position
  490.   of the next field and the field number is put in momory, and in the init
  491.   file (.~DA) when the file is closed.
  492.   For each record, the file position, the size, the key, the file record
  493.   rank and the file record number is put in memory, and in the init file
  494.   when the file is closed.
  495.  
  496.  
  497. 1.2)   |
  498.        ├─ File Open
  499.        │   ├─ Commence function
  500.        │   ├─ File name
  501.        │   └─ What make GestRecord?
  502.        |
  503.  
  504. 1.2.1) Commence function:
  505.        ==================
  506.  
  507. The commence function is the same for create file (see 1.1.1), except for
  508. the header and its size.
  509.  
  510. If your file was not created by GESTRECORD and if it has a header, you MUST
  511. inform GESTRECORD:
  512.   - Check the Header check box,
  513.   - Enter the header size in the 'Header size' input line.
  514.  
  515. If you don't do this, or if you enter an incorrect size, GESTRECORD won't be
  516. able to work with your file and, worst, it will destroy its header.
  517.  
  518. If you have created your file with GESTRECORD, some parameters will be init
  519. by themselves:
  520.   - the header size,
  521.   - the index and the index field,
  522.   - the record size (constant or variable).
  523.  
  524. But, if your file is a variable records file and if you haven't checked
  525. the 'compress' check box, GestRecord will ask you if you want its option.
  526.  
  527.  
  528.  
  529.  
  530. 1.2.2) File name:
  531.        =========
  532.  
  533. The same dialogue box as for file create be brought up, showing a list of
  534. file extentions '.DAT'.
  535.  
  536. Warning: To open an existant file, make sure you are in the directory
  537. containing the file. (Use the command File|Change Dir).
  538.  
  539.  
  540. 1.2.3) What GestRecord does:
  541.        =====================
  542.  
  543. After the file is opened, GestRecord performs the following tasks:
  544.  - read in the init file (~.DA):
  545.     - the version number,
  546.     - the file records number,
  547.     - the valid indexs number,
  548.     - the indexs number,
  549.     - the key number for each record (for futur versions),
  550.     - the header size,
  551.     - the treat parameters,
  552.     - the name, type.. of each field,
  553.     - the size and position of each record of your file.
  554.  - read the file '~C..' to build the keys collection,
  555.  - verify the header size,
  556.  - verify the records number in your file and the records number in the
  557.    init file.
  558.  That's all!
  559.  Then, you can work with your file.
  560.  
  561.  
  562.  
  563. 1.3)    |
  564.         ├─ Build your file
  565.         │   ├─ Records
  566.         │   │      ├─ Modify
  567.         │   │      ├─ Add
  568.         │   │      ├─ Delete
  569.         │   │      ├─ Search
  570.         │   │      └─ Restore
  571.         │   └─ Fields
  572.         │          ├─ Modify
  573.         │          ├─ Add
  574.         │          ├─ Delete
  575.         │          └─ Search
  576.         |
  577.  
  578. 1.3.1) Records:
  579.        =======
  580.  
  581. Recall: The records are a set of different fields saved on the disc
  582.         in the order of their creation.
  583.         A record can be of 2 types:
  584.           - Constant: voir 1.1.1.1,
  585.           - Variable: voir 1.1.1.2.
  586.         Working with variable records takes longer than with constant records,
  587.         but takes less space on the disc.
  588.  
  589.         Your file can contain all the records you want to save in it, but
  590.         (for instant), GestRecord can treat only 16380 records by file.
  591.  
  592.         Its number is the maximum of pointers that a collection can be
  593.         contained in a memory segment:
  594.          1 Turbo pascal segment = 65520 octets
  595.          1 Turbo pascal pointer = 4 octets
  596.          65520/4 = 16380 pointers.
  597.  
  598.          In further versions, GestRecord will be able to handle more than
  599.          this number.
  600.  
  601.  
  602.   1.1.1.1) Modify:
  603.            ======
  604.  
  605.  Click on the Record|Change command will bring up a dialogue box which allows
  606.  you:
  607.   - to modify each field value,
  608.   - to delete a record,
  609.   - to add a record,
  610.   - to search a record or a field,
  611.   - to restore a record.
  612.  
  613.  See the online help for the use of its dialogue box.
  614.  
  615.  
  616.  
  617.  1.3.1.2) Add:
  618.           ===
  619.  
  620.  Clicking on the Record|Add command add an empty record at the end of your
  621.  file. The key index will be init with a default value and later, you'll
  622.  be able to modify it.
  623.  
  624.  
  625.  1.3.1.3) Delete:
  626.           ======
  627.  
  628.  Clicking on the Record|Delete command will bring up a dialogue box in which
  629.  you'll be able to enter the record rank or the index rank or the
  630.  index key you want to delete.
  631.  
  632.  Then, GestRecord will verify the validity of the entry value and will mark
  633.  the record but won't delete it.
  634.  
  635.  Further, if you want to restore it, this can be done with the
  636.  Record|Restore command (see 1.3.1.5) except:
  637.   - if GestRecord has used it with the Record|Add command,
  638.   - if the 'compress' option (see 1.1.1.2) is checked in wich case, the
  639.     record will be scrubbed when the file is closed.
  640.  
  641.  
  642.   1.3.1.4) Search:
  643.            ======
  644.  
  645.   The same dialogue box as for the Record|Delete command will ask you to
  646.   enter the record rak or the index rank or the index key of record you
  647.   want to delete.
  648.  
  649.   Once GestRecord has verified the entry value, a message box will show
  650.   you the record rank AND the index rank AND the index key.
  651.  
  652.   If you have checked the box 'Window' in 'Search record dialogue box',
  653.   a 'One record Window' (see 1.4.2) will appear on the desk.
  654.  
  655.  
  656.  
  657.   1.3.1.5) Restore:
  658.            =======
  659.  
  660.   With Record|restore command, you can restore a record you have deleted
  661.   (see 1.3.1.3) unless if GestRecord has used it or if you have saved the
  662.   file with the compress option.
  663.  
  664.   A dialogue box will show you the records wich can still be restored and
  665.   will ask you to enter the rank index of the record to be restored.
  666.   If you choose one, its record will restore.
  667.  
  668.   If GestRecord can't restore the index key of this record, a default key
  669.   will be allocated, a key you can always modify later.
  670.  
  671.  
  672.  
  673.  1.3.2) Fields:
  674.         ======
  675.  
  676. Recall: A fields can be of 9 different types (see 1.1.3.2) and each record
  677.         can contain up to 255 fields.
  678.  
  679.  
  680.   1.3.2.1) Modify:
  681.            =======
  682.  
  683.   With the Fields|change command, GestRecord brings up a 'fields managment
  684.   dialogue box' in wich you can modify the field values (voir 1.3.1.1).
  685.  
  686.  
  687.   1.3.2.2) Add:
  688.            ===
  689.  
  690.   If you want to add a field, the structure of all your records will be
  691.   modified.
  692.  
  693.   After a confirmation, GestRecord will ask you to init the additional
  694.   field (name, type, string length if the type field is STRING) (see 1.1.3.2).
  695.   Its fields will be added to each record of your file.
  696.  
  697.   All record and field windows and the 'fields managment dialogue box'
  698.   will be destroyed.
  699.   You can reconstruct these once the field add session is finished.
  700.  
  701.  
  702.   1.3.2.3) Delete:
  703.            ======
  704.  
  705.   As with Adding a field, you will must confirm your choice.
  706.   But, this time, GestRecord delete the field chosen in all your records.
  707.   Warning: GestRecord can't restore a deleted field and all deleted field
  708.            data will be lost.
  709.  
  710.   So, Before deleting a field, remember that it is often better to keep a
  711.   useless field than lose all the data it contains.
  712.  
  713.   As with the Field|Add command, all field and record windows and the
  714.   'fields managment dialogue box' will be destroyed.
  715.  
  716.  
  717.   1.3.2.4) Search:
  718.            =======
  719.  
  720.   Its command brings up a dialogue box it containing the name of each
  721.   field of your record.
  722.   GestRecord can only find a field by its name. So remember to
  723.   give your fields a precise name in the init session (see 1.1.3.2).
  724.  
  725.   Once GestRecord has found the field, it brings up a message box
  726.   who show you the name, the rank and the type of the search field.
  727.  
  728.  
  729.  
  730. 1.4)  |
  731.       ├─ Fields and records window
  732.       │   ├─ Continuous records window
  733.       │   ├─ Window for one record
  734.       │   └─ Fields
  735.       |
  736.  
  737.  
  738.  1.4.1) Continuous records window:
  739.         =========================
  740.  
  741.  The Continuous records window is really only usefull if you work with
  742.  the 'fields managment dialogue box'.
  743.  
  744.  With each record change this window will show you the current record.
  745.  If you modify the field values of current record, the continuous
  746.  window will be updated.
  747.  
  748.  This window can be recognised by its pale blue color.
  749.  
  750.  
  751.  
  752.  1.4.2) Window for ONE record:
  753.         =====================
  754.  
  755.  As opposed to the previous window, this one constructed only for one
  756.  specific record wich you will have indicated either by its index record
  757.  number or its index key.
  758.  
  759.  This window is only updated once you have modified one of the field
  760.  records attached to it in the 'Fields Managment dialogue box'.
  761.  
  762.  Its color is blue.
  763.  
  764.  
  765.  
  766.  1.4.3) Fields:
  767.         ======
  768.  
  769.  The Fields Window shows you one field for all your records.
  770.  You enter the field rank in the dialogue box and GestRecord brings up
  771.  this window.
  772.  With any change in the 'Fields Managment dialogue box', the contents of
  773.  its window is updated.
  774.  
  775. You can create:
  776.   1 Continuous records window,
  777.   255 Windows for ONE record,
  778.   255 fields window.
  779.  
  780. Note: If you have a lot of windows on the desk, the progam may run
  781. considerably more slowly, remember that the window contents is updated
  782. for each change in the 'Fields managment dialogue box'.
  783.  
  784.       GestRecord works in real mode, and you must supervised your memory if
  785.       you don't want appears a 'out of memory' message!
  786.  
  787.  
  788. The fields and records windows are destroyed by GESTRECORD if:
  789.  - you close the current file,
  790.  - you add or delete a field,
  791.  - you add or restore a record (only for the continuous window),
  792.  - you delete a record (for the continuous window and for One record
  793.    window).
  794.  
  795. You can create these windows at any point in the program provided GestRecord
  796. has sufficient memory.
  797. If you want to create 2 windows for the same record, GestRecord
  798. raises the existing window to the top of the desk.
  799.  
  800.  
  801.  
  802.  
  803. 1.5)   |
  804.        ├─ File save
  805.        │   ├─ As the same name
  806.        │   ├─ as an another name, directory or drive
  807.        │   └─ close without save
  808.        |
  809.  
  810.  
  811.  1.5.1) As the same name:
  812.         ================
  813.  
  814.  Choose the File|save command if you want to save the current file as
  815.  the same name.
  816.  GestRecord will:
  817.   - save your data,
  818.   - close the current file,
  819.   - save the init and the keys,
  820.   - close the '.~Da' and '.C..' files,
  821.   - destroy the temporary file.
  822.  
  823.  You'll then be able to open  another file or quit the promgram.
  824.  
  825.  1.5.2) as another name, directory or drive:
  826.         ===================================
  827.  
  828.  Choose the fiel|save as command.
  829.  
  830.  GestRecord will ask you to enter the new name file. If this file already
  831.  exist, GestRecord will ask you if you want to crush it.
  832.  
  833.  The remainder of the process is the same as for Save a file (see 1.5.1).
  834.  
  835.  Note: The data won't be saved in the old file.
  836.  
  837.  
  838.  1.5.3) Close without save:
  839.         ==================
  840.  
  841.  If you choose the file|no save command, GestRecord closes your file
  842.  (init and data) without saving the latest modifications, and these will
  843.  be lost.
  844.  
  845.  
  846.  
  847. 1.6)   |
  848.        ├─ Tools
  849.        │   ├─ Calculator
  850.        │   ├─ Calendar
  851.        │   ├─ Mouse
  852.        │   ├─ Convert
  853.        │   ├─ Bit test
  854.        │   ├─ Clock
  855.        │   └─ Memory view
  856.        |
  857.  
  858.  
  859. The calculator, the calendar, the mouse, the clock and the memory view
  860. are Borland's tools. They are offered with Turbo vision.
  861. I think these tools are very interesting and they can be very useful.
  862.  
  863. To use these tools, see online help.
  864.  
  865.  1.6.1) Calculator:
  866.         ==========
  867.  
  868.  Its a simple calculator allowing you 4 basic opérations. Once created,
  869.  it remains on the desk until you close it with the aid of its closing icon.
  870.  
  871.  
  872.  1.6.2) Calendar:
  873.         ========
  874.  
  875.  The calendar displays the current month and current day, and can
  876.  provide information on past or future years.
  877.  It remains on the desk until you close it.
  878.  
  879.  
  880.  1.6.3) Mouse:
  881.         =====
  882.  
  883.  The mouse tool allows you to change the double-click speed and invert
  884.  the right and left button.
  885.  This tool can't stay on the desk.
  886.  
  887.  
  888.  
  889.  1.6.4) Convert:
  890.         =======
  891.  
  892.  This tool is of my own creation and it allows you to convert a number
  893.  in decimal, hexa or binary format.
  894.  It can stay on the desk.
  895.  
  896.  
  897.  1.6.5) Bit test:
  898.         ========
  899.  
  900.  This tool allows you to test if a particular bit, or a group of bits is
  901.  set in a number.
  902.  Bit test and Convert tools can stay open on the desk.
  903.  
  904.  Ex: You have a decimal number of WORD type and you want to know if the bit
  905.      7 is posed:
  906.      2 solutions:
  907.       - Convert tool:
  908.         1) You enter the number: for ex. 559,
  909.         2) You click the Decimal => binary radio button,
  910.         3) you click the 'OK' button,
  911.         4) in the result line the result appears in binary format:
  912.              0000001000110000
  913.         Then, you can see all the bits is posed: 4,5 and 9°.
  914.         Recall: in binary format, the bit '0' is on the right hand side of the
  915.                 number, then the bit 7 is in reality the 8th bit.
  916.                 Then the bit 7 isn't posed.
  917.  
  918.       - Bit test tool:
  919.          1) you enter the number: 559,
  920.          2) you enter the bit rank: 7,
  921.          3) you press the 'Bit' button,
  922.          4) In the result line appears the result:
  923.               'Bit not posed'.
  924.    For a group of bits, you enter this in the 'Mask input line', in
  925.    decimal or binary format and then, click the Mask button.
  926.  
  927.  
  928.  
  929.  1.6.6) Clock:
  930.         =====
  931.  
  932.  The clock is on the upper right hand corner of the desk and shows you the
  933.  system time.
  934.  This tool can't be selected and can't be modified in GestRecord program.
  935.  
  936.  
  937.  1.6.7) Memory view:
  938.         ===========
  939.  
  940.  The memory that GestRecord has available is on the lower right corner of the
  941.  desk and shows you the size of the largest memory block available.
  942.  
  943.  Then, you can check the memory capacity before creating a window.
  944.  
  945.  This tool does not take the the EMS memory into consideration.
  946.  
  947.  
  948.  
  949. 1.7)  |
  950.       ├─ Arrange the windows on the desk
  951.       |
  952.  
  953. The Window menu allows you to arrange your desk.
  954. With its command you can Tile, cascade, close the different open windows.
  955.  
  956. See online help to use this command.
  957.  
  958. Recall: If you open a lot of windows, GestRecord may run more slowly.
  959. Remember to close useless windows.
  960.  
  961.  
  962.  
  963. 1.8)  |
  964.       └─ Quit GestRecord
  965.  
  966. You can quit GestRecord only once the current file is closed.
  967.  
  968. To do this, choose the File|Quit command.
  969.  
  970. GestRecord will be destroyed and removed from your memory.
  971.  
  972.  
  973.  
  974. 2.)
  975.   I am open to all criticism (as well as to compliments) ro indeed to all
  976.   requests for improvments to GESTRECORD.
  977.   You can reach me by mail at the address in the LICENCE.US file (the same
  978.   address for the payment of the licence - don't forget me!).
  979.  
  980.   Perhaps GESTRECORD isn't perfect, (which is why I plan to make future
  981.   versions), but GestRecord has been made and tested for your pleasure and
  982.   to offer you a maximum of ease in use.
  983.  
  984.   The future versions can only be made if each user pays me their licence
  985.   fee.
  986.   Without it, I won't be able to continue to program.
  987.   The ShareWare is an affair of trust and non payment of the licence fee
  988.   for the use of the program will inevitably result in its death.
  989.  
  990. Thanks.