home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Source Code 1993 July / THE_SOURCE_CODE_CD_ROM.iso / gnu / recode-3.2.4 / README < prev    next >
Encoding:
Text File  |  1992-10-07  |  3.1 KB  |  88 lines
  1. README for recode - last revised 92-10-07.
  2. Copyright (C) 1990-92 Free Software Foundation, Inc.
  3. See file COPYING for copying conditions.
  4.  
  5. This is the 3.2.4 release of `recode', a tool whose purpose is
  6. recoding various character sets to one another.  Recoding is currently
  7. possible between any pair of these character sets:
  8.  
  9.   * usual 7-bit ASCII: without any diacritics, or else: using
  10.   backspace for overstriking; Unisys' ICON convention; TeX/LaTeX
  11.   coding; easy French conventions for electronic mail;
  12.  
  13.   * 8-bit extensions to ASCII: ISO Latin-1, IBM's code for the PC,
  14.   Apple's code for the Macintosh;
  15.  
  16.   * 6-bit escaped ASCII based on CDC display code: 6/12 code from NOS;
  17.   bang-bang code from Universite' de Montre'al;
  18.  
  19.   * non-ASCII codes: EBCDIC as seen by Perkin Elmer; EBCDIC as seen by
  20.   Control Data;
  21.  
  22. WARNING
  23. -------
  24.  
  25. *If* you got this package through shar files on UNIX, execute the
  26. command:
  27.  
  28.     touch configure merged.c recode.info
  29.  
  30. before proceeding any further.
  31.  
  32. INSTALLATION
  33. ------------
  34.  
  35. On various UNIXes, this program is distributed as a compressed tar
  36. archive.  Unpack, then follow the directions given in file INSTALL.
  37. The wise would peek first at the HINTS section, below.
  38.  
  39. On MSDOS, this program is distributed in zoo format.  To install,
  40. merely extract `recode.exe' from the zoo archive and copy it where you
  41. usually keep your executables.  To reconstruct `recode.exe' from the
  42. sources for some reason, type `make'.  I ported recode to MSDOS using
  43. Turbo C++ version 1.0 and the MSDOS port of GNU make.
  44.  
  45. If you develop new charsets, new methods, or anything along recode,
  46. let me know and send me the code.  If you modify or add an `.l' source
  47. file, you will need GNU awk (or mawk or nawk) and Flex 2.3 (or better)
  48. to reconstruct the file merged.c.
  49.  
  50. Mail suggestions and bug reports for this program (including
  51. documentation errors) to Francois Pinard <pinard@iro.umontreal.ca>.
  52.  
  53. HINTS
  54. -----
  55.  
  56. Here are a few hints which might help installing recode on some
  57. systems.  Most may be applied by temporary presetting environment
  58. variables while calling `sh configure'.  File INSTALL tells you more
  59. about how to do this.
  60.  
  61. * Some C compilers, like Apollo's, have a real hard time compiling
  62. merged.c.  If this is your case, avoid compiler optimization and use:
  63.  
  64.     DEFS=-DUSE_FPUTC sh configure
  65.  
  66. * For 80286 based systems, it has been reported that some compilers
  67. generate wrong code while optimizing for `small' models.  So, do:
  68.  
  69.     DEFS=-Ml LDEFS=-Ml sh configure
  70.  
  71. to force large memory model.  For 80286 Xenix compiler, the last time
  72. it was tried a while ago, one ought to use:
  73.  
  74.     DEFS='-Ml -F2000' LDEFS=-Ml sh configure
  75.  
  76. * Some smallish systems have poor `popen' support or trash heavily
  77. when processes fork's.  In this case, merely remove -DHAVE_POPEN and
  78. -DHAVE_PIPE from Makefile's DEFS, just before doing `make'.
  79.  
  80. * There was a bug, reported only for Xenix compiler, in which enum
  81. types where unusable if not declared int.  If you have this bug, do:
  82.  
  83.     DEFS=-DENUM_INT_BUG sh configure
  84.  
  85. If *you* have to define ENUM_INT_BUG, please contact me, so we can
  86. develop an autoconfigurable test for it.  If nobody reports about
  87. this, I will remove ENUM_INT_BUG in some subsequent version.
  88.