home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Interactive Guide / c-cplusplus-interactive-guide.iso / c_ref / csource1 / program4 / read.me < prev    next >
Encoding:
Text File  |  1993-02-25  |  5.5 KB  |  117 lines
  1.  
  2.    Clide  ( Clipper IDE ) still has many rough edges so it may be worth
  3.    reading this document which is intended to get you up and running as quickly
  4.    as possible.
  5.  
  6.    Overview:
  7.    1. If a Clide menu item isn't hooked up it just does nothing.  So it is OK
  8.       to try any menu item.  Note: many menus in Clide were built with the menu
  9.       section.
  10.  
  11.    2. The main screen that you see on startup is saved as an array under the
  12.       catalog name with the extension .cat.  The default name is untitled.cat.
  13.  
  14.  
  15.    DATA Section:
  16.    1. To get to the index section use the key Alt-1,  Alt-1 will toggle you
  17.       back and forth. Alt-A adds a field, Allt-Y deletes a field and
  18.       amazingly enough Alt-M moves a field. The numbers under the WAS column
  19.       keep track of the field location in the old dbf.  This way you can
  20.       change the description of a field and change it's location without losing
  21.       data.  MEMO FIELDS have NOT been tested, so be careful, data may be lost!
  22.       Oh, and build your date indexes at the bottom. DTOS() is not automatically
  23.       inserted if you indicate an index to the right of the field.
  24.  
  25.    2. When you save or update a file, a dbf called dictdbf.dbf will be built or
  26.       appended to.  This file holds the index information for all indexes in
  27.       the application. The fields are dbf, index, expr, remarks.  The DBF field
  28.       holds the name of the associated database.  INDEX holds the index file
  29.       name and the EXPR field holds the index expression.  The REMARKS field is
  30.       used as a message in a browse when you change indexes on the fly. There
  31.       are 2 programs included with the registered version that can be used to
  32.       open the database file and all associated indexes.  The prgs are
  33.       dbfopen.prg and dictopen.prg.  They are very similar to Art Fuller's prgs
  34.       in his old book "Dynamics of Clipper".
  35.  
  36.    3. When you browse a dbf, you can change columns, resize the window,
  37.       order records by index, seek an index key, forward locate, and freeze
  38.       columns on the left.
  39.  
  40.    QUERIES Section
  41.    1. This was done last.  All it does at the persent time is group dbf's so
  42.       that you can work with more than 1 dbf when you build forms or reports.
  43.  
  44.  
  45.    MENUS Section
  46.    1. This builds a group of pull down menus.  Each line is a menu item.
  47.       The top menu is built first.  On the pull down menus a  '-' will put
  48.       a line across. A '-Dept' will look like this ──── Dept ────.  And a
  49.       blank line will be a skipped menu line.  This section builds 2 files.
  50.       The file name with the extension .mnu is an array that  saves  the
  51.       image for clide.  The extension .ext is the name of the file to use in
  52.       your applications.  Like this;  include "Ar_menu.ext".  There are 2 menu
  53.       prgs that come with the registered copy that are used to implement the
  54.       menus you build. They are tmenu.prg (t for top), pmenu.prg
  55.       (p for pull down).  My library will also be included in the registered
  56.       copy.  This is because the prgs call the BoxSave and BoxRest function.
  57.  
  58.    2. After you type the prompts for a menu group, Alt-X will post and run
  59.       the menu that you have just built.  If you want a submenu just hit
  60.       ENTER and build it.  When you are done F10 will give you a way to exit.
  61.  
  62.    3. Note: the menu programs are very similar to the ones found in
  63.       Rick Spence's book Clipper Programming Guide.
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.    FORMS Section
  73.    1. This builds input screens.  The  F6, F7, and F8 keys work.  Alt-A adds a
  74.       line, even in the middle of a box.  Alt-Y Deletes a line.  Alt-A and
  75.       Alt-Y are my conventions.  Wouldn't it be nice to buy the source so you
  76.       could use your conventions?  Note, Tab and End also work.
  77.  
  78.    2. Two files are built.   The file with the extension .scr saves the array
  79.       for Clide.  The second file has the extension .prg.  Be careful both
  80.       Forms and Reports use the extension .prg
  81.  
  82.    3. A line can be built using the box menu selection.  Don't worry if the
  83.       Line or box disappears when the file is built.  The box is temporarly
  84.       taken out so that the prg will use a box command and not build the box
  85.       with dash literals.
  86.  
  87.  
  88.    REPORTS Section
  89.    1. Builds a report using the same keystroke combinations as the forms section
  90.    2. Two files are built.  The file with the extension .rpt saves the array
  91.       for clide.  The second file has the extension .prg.
  92.    3. When you build an expression, ENTER gives you fields to choose from.
  93.       (good English, huh?) Use Arrow Down or Ctrl-End to get out.
  94.    4. The prg needs to be passed a codeblock to operate. An example of how to
  95.       call a report (rpt_call.smp) is provided for your convenience.
  96.    5. If you want to use multiple dbfs to build a report, then first group them
  97.       using the query section.
  98.    6. You will need to include "wat.ch" to build the reports.  The prg named
  99.       pushdbf.prg will also need to be compiled with your report.
  100.    7. A PARAMETERS group was added so you can pass variables to the report,
  101.       like the current date of the report, or the subsidiary name.  PARAMETERS
  102.       can not take an array.
  103.  
  104.  
  105.    PROGRAMS Section
  106.    1. Just a holding area at the present time.
  107.  
  108.    Legal Stuff
  109.    There are no warranties express or implied.
  110.  
  111.    Historical note:
  112.    This program was build in the evenings and on weekends to help me build
  113.    applications.  I thought that others might like to use it.  Hope you find
  114.    it helpful.   Bill Tettemer   (WAT = William A. Tettemer) ID 74720,1357
  115.  
  116.  
  117.