═══ 1. Introduction ═══

Table is combination of an ASCII character code chart and a tool to convert and 
display binary, decimal, octal, hexadecimal and ascii representations of a 
string. 

This program does not need any install procedure and does not change your 
system files (CONFIG.SYS and system INI files). 

If you want to create program object on Desktop, run Install.cmd Rexx script 
with parameter I. 

To destroy program object on Desktop, run Install.cmd Rexx script again with 
parameter U. 


═══ 2. Usage ═══

If you want to copy system clipboard contents to entry field on start, run 
Table with parameter 1 (Table.exe 1). 

To copy single character to Clipboard, select it in the list on the left side 
and double-click 1st mouse button or press Enter. 
To copy single character to entry area (append to existing string), select it 
in the list and press f5. button. 

To convert string: 

   1. Select source format (select radio button: BIN, DEC, OCT, HEX or ASC). 
   2. Enter string you want to convert, or paste it from Clipboard (press Paste 
      button). When you enter string in BIN, DEC, OCT or HEX format, there MUST 
      be space between character representations. 
   3. Press Convert button. In Result window you can see  binary, decimal, 
      octal, hexadecimal and ascii representations of a string. To copy result 
      to Clipboard, press button on the right side. 

 Valid entries for various representations of string are: 

 BIN       Binary - valid entry is string composed of characters: 01 between 0 
           and 11111111. 
 DEC       Decimal - valid entry is string composed of characters: 0123456789 
           between 0 and 255. 
 OCT       Octal - valid entry is string composed of characters: 01234567 
           between 0 and 377. 
 HEX       Hexadecimal - valid entry is string composed of characters: 
           0123456789AaBbCcDdEeFf between 00 and FF. 
 ASC       ASCII (American National Standard Code for Information Interchange) 
           - valid entry is any character. 

 Note:  NULL byte ['00'x] is displayed as BLANK ['FF'x] in ASCII format. 

 You can also save result to file. Press Write button to set output options: 

     file name and directory (default is file table.txt in working directory), 
     number of characters per line (program will calculate line length), 
     display (or not) spaces between characters in  binary, decimal, octal and 
      hexadecimal representations of a string, 
     representations of a string to display (binary, decimal, octal, 
      hexadecimal and/or ascii). 

 If you have two prepared system code pages you can switch between them and 
 convert and display string. Read more about code pages. 

 Note:  Source code for Table is included - to modify source, you need 
        DrDialog, a visual programming environment for REXX.


═══ 3. Customization ═══

You can customize Table: 

     Font: open Font Palette, drag and drop font on the character list 
      (recommended is monospaced font: Courier, System Monospaced or System 
      VIO) 
     Show all, or only selected characters in the list 
     Save position of Table window (you can not change size of Table window) 

 Table will save changes on exit. 

 Note:  If you want to use default settings (font 10.System VIO, show all 
        characters in the list), delete file TABLE.INI and start program. 


═══ 4. Source code ═══

Source code for Table is included - unzip file source.zip to extract files. 

Thanks to BjФrn SФderstrФm who translated Table to Swedish. 

To modify source (Table.RES), you need DrDialog, a visual programming 
environment for REXX. 
You can download DrDialog from Hobbes. 

To modify help file (Table.ipf), you need any text editor and IPF Compiler to 
write INF file. 

Note:  If you modify source, I would appreciate a copy of any changes. 


═══ 5. Copyright and license ═══

 Author         Goran Ivankovic 
 Address        Ulica Josipa Poduje 8 
                HR-52100 Pula 
                Croatia 
 email          duga1@pu.hinet.hr 
 Home page      http://www.os2world.com/goran/ 

 This program is provided free under the terms of the GPL. You can use it, 
 modify it and distribute it. If you modify or distribute it the new source 
 must accompany the distribution. I would appreciate a copy of any changes. 
 You may not distribute Table 1.2.0 in any way which leads to your making a 
 profit from it. 

 The author makes no representations about the accuracy or suitability of this 
 material for any purpose. It is provided "as is", without any express or 
 implied warranties. The author will assume no liability for damages either 
 from the direct use of this product or as a consequence of the use of this 
 product. 

     OS/2 is Trademark of International Bussines Machines Corporation 
     DrDialog is Copyright of International Bussines Machines Corporation