examples.doc (c)Copyright Sequiter Software Inc., 1992-1993.
      All rights reserved.
      
      ---------------------------------------------------------------
      
           CODEBASE 5.1 EXAMPLES INFORMATION
      
      I.   Example Files Provided
      
      II.  General Example Information
      
      ----------------------------------------------------------------
      
      I.   Example Files Provided


      USER'S MANUAL EXAMPLES:

      D4EXAMPL.C:      See User's Manual, page 11.

      SHOWDATA.C:      See User's Manual, page 34.

      CUSTLIST.C:      See User's Manual, page 41.
                       Requires DATA1.DBF database and DATA1.??? memo
                       file--compile and execute NEWLIST2.C to create.

      NEWLIST.C:       See User's Manual, page 47.

      DELETION.C:      See User's Manual, page 58.

      DATAINFO.C:      See User's Manual, page 63.

      COPYDATA.C:      See User's Manual, page 70.

      NEWLIST2.C:      See User's Manual, page 74.

      SHOWDAT2.C:      See User's Manual, page 82.

      SHOWLST2.C:      See User's Manual, page 86.
                       Requires DATA1.DBF database and DATA1.??? memo
                       file--compile and execute NEWLIST2.C to create.

      SEEKER.C:        See User's Manual, page 92.
                       Requires DATA1.DBF database and DATA1.??? memo
                       file--compile and execute NEWLIST2.C to create.

      DESCEND1.C:      See User's Manual, page 100.
                       Requires DATA1.DBF database and DATA1.??? memo
                       file--compile and execute NEWLIST2.C to create.

      DESCEND2.C:      See User's Manual, page 105.
                       For Clipper format only.

                       Requires DATA1.DBF database and DATA1.??? memo
                       file--compile and execute NEWLIST2.C to create.

      NOGROUP1.C:      See User's Manual, page 114.
                       For Clipper or dBASE III formats only.
                       Requires DATA1.DBF database and DATA1.??? memo
                       file--compile and execute NEWLIST2.C to create.

      NOGROUP2.C:      See User's Manual, page 116.
                       For Clipper or dBASE III formats only.
                       Requires DATA1.DBF database and DATA1.??? memo
                       file--compile and execute NEWLIST2.C to create.

      COPYDAT2.C:      See User's Manual, page 119.

      RELATE1.C:       See User's Manual, page 131.

      RELATE2.C:       See User's Manual, page 139.

      RELATE3.C:       See User's Manual, page 145.

      RELATE4.C:       See User's Manual, page 148.

      DATE.C:          See User's Manual, page 154.

      LIST1.C:         See User's Manual, page 163.

      LIST2.C:         See User's Manual, page 169.

      MULTI.C:         See User's Manual, page 187.

      APPEND.C:        See User's Manual, page 195.


      ADDITIONAL EXAMPLES:
      
      D4LOW.C          Example program that tests low-level file4..()
                       functions.  Useful for determining correct low-level
                       operation on non-supported operating sytems.

      D4SWITCH.C       Example program source code.  This program will  
                       check for proper CodeBase 'define switch' usage.  
                       Useful for switch debugging.

      FILETEST.C       Example program source code.  Checks for data file,
                       index or memo file corruption using d4check().  Useful
                       for checking the integrity of existing database, 
                       index and memo files.

      D4LIST.C         Example program source code.  Opens and lists the
                       contents of DATAFILE.DBF, using the FoxPro or dBASE IV
                       production index file.
                       
      DATAFILE.DBF     Example database file used with program 'D4LIST.C'.
      

      DATAFILE.MDX     Example index file used with program 'D4LIST.C'.
      DATAFILE.CDX 
      
      D4ASCII.C        Example program source code.  Creates a database
                       file from an ASCII text file.  Uses file 
                       'INVENTOR.ASC'.
      
      INVENTOR.ASC     Example ascii data file used with program 'D4ASCII.C'.
      
      D4EX2.C          Example source file.  Creates a database and index
                       file, 'EXAMPLE', appends some records, and lists
                       those records using two different tag orders.
      
      D4EXMEMO.C       Example source file.  Enhancement of D4EX2.C, 
                       including the use of a memo field, and CodeBase 
                       formatting routines.
      
      D4EX_WIN.C       Example Windows source file.  Similar in operation to
                       D4EXAMPL.C.
      

      NOTE:  Brief program descriptions can be found at the beginning of 
      many source files.
      
      ---------------------------------------------------------------
      
      II.  General Example Information
      
         The purpose of the example programs is to provide a general
      programming, compiling, linking and executing guide to CodeBase
      application construction. New CodeBase users are encouraged to
      use the examples as an introduction to the process of building
      an application.  Also, users with unsupported compilers or users
      who change compiler options should use the example programs to
      test the compile, link and execute process.  In this way, users
      can be sure that any problems encountered are due to the compilation
      or linking process, and not because of errors in the source code. 
         Before beginning any actual compiling or linking, it is recommended
       that the 'INTRODUCTION' and 'CODEBASE OVERVIEW' sections in
      the CodeBase manual be read and understood.  
      
         Some of the examples require linking with the 'curses' library
      when compiling with the CodeBase 5.1 Multi-Platform version under UNIX.
      These examples have an '#include <curses.h>' directive at the top
      of the file.  If using these examples under UNIX, add the following
      to the END of your compile line:
            
                   cc . . .     -lcurses

         Generally, the example code can be compiled and linked using
      the provided batch files.  The batch file names are discussed
      in the Users Guide.
      
            -------------------  END  ---------------------