home *** CD-ROM | disk | FTP | other *** search
/ ftp.alaska-software.com / 2014.06.ftp.alaska-software.com.tar / ftp.alaska-software.com / acsn / GetCol.txt < prev    next >
Text File  |  2003-11-20  |  2KB  |  88 lines
  1. ReadMe.txt for GETCOL
  2. =====================
  3.  
  4. Introduction:
  5. -------------
  6. GetCol is designed to extract the collation table of a Clipper
  7. application and create an include file for use in Xbase++.
  8.  
  9.  
  10. Usage:
  11. ------
  12. Compile GetCol with Clipper:
  13.    clipper getcol -n
  14.    
  15. Link the created getcol.obj with the collation of your choice:
  16.    rtlink fi getcol, ntxpl852
  17.    
  18. Run the created GetCol.exe with the name of the collation as
  19. parameter:
  20.    getcol polish
  21.    
  22. A new file called polish.ch will be generated. Include this
  23. file into your Xbase++ projects to enable the setting
  24.  
  25.    SET COLLATION TO <language>
  26.    
  27. In this case
  28.  
  29.    SET COLLATION TO POLISH
  30.    
  31. Now you can use the same collation in your Xbase++ application
  32. as you used it in your Clipper application.
  33.  
  34.  
  35. Sample:
  36. =======
  37. A sample is also included...
  38.  
  39. Run the commands listed in section Usage to build polish.ch
  40.  
  41. Now:
  42. compile test.prg with Clipper using the define __CREATE__
  43.    
  44.    clipper test -n -d__CREATE__
  45.  
  46. Link the polish collation to the project and rename the output
  47.    
  48.    rtlink fi test, ntxpl852 out cl_cre8
  49.  
  50. Run cl_cre8 to create a table using Clipper with all characters
  51. included in it.
  52.  
  53. Now compile test.prg in Xbase++ without any defines but debug information
  54.    
  55.    xpp /b test
  56.    
  57. Link it to an executable with debig info
  58.  
  59.    alink /de test
  60.    
  61. Now debug the sample
  62.  
  63.    xppdbg test.exe
  64.  
  65.    
  66. Step through it... The sample opens the table and seeks for every single
  67. key! And it finds all!
  68.  
  69. To get the proove, comment out the
  70.  
  71.    SET COLLATION TO POLISH
  72.    
  73. to set the collation to american again and compile and link the sample
  74. again. Now run it again and you will see that many key can not be found.
  75.  
  76. This is the proove!
  77.  
  78.  
  79. Limitations:
  80. ============
  81. GetCol only reads the collation, it can not handle lexical
  82. rules like the German umlauts ('Σ' -> 'ae').
  83.  
  84. Read the Online Documentation of Xbase++ for more Information
  85. about lexical rules and how to set them.
  86.  
  87.  
  88.