home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 22 gnu / 22-gnu.zip / gnurecod.zip / README < prev    next >
Text File  |  1994-11-05  |  3KB  |  63 lines
  1. GNU `recode' converts files between character sets and usages.  When
  2. exact transliterations are not possible, it may get rid of the
  3. offending characters or fall back on approximations.  This program
  4. recognizes or produces nearly 150 different character sets and is able
  5. to transliterate files between almost any pair.  Most RFC 1345
  6. character sets are supported.
  7.  
  8. GNU `recode' has been written by Franc,ois Pinard.  It is an evolving
  9. product, and specifications might change in future releases.
  10.  
  11. Note that `-f' is not completely implemented.  If you modify or add
  12. an `.l' source file, you need `mawk', GNU `awk' or `nawk', and Flex
  13. 2.4.6 or better for remaking `merged.c'.  Finally, see further down,
  14. below, for various installation hints on special systems.
  15.  
  16. See file `BACKLOG' for a summary of pending mail and articles.
  17. See file `COPYING' for copying conditions.
  18. See file `INSTALL' for compilation and installation instructions.
  19. See file `NEWS' for a list of major changes in the current release.
  20. See file `README.DOS' for notes about the MSDOS port.
  21. See file `THANKS' for a list of contributors.
  22. Use file `File-Latin1' to play with recode, if you feel like it.
  23.  
  24. Your feedback will help us to make a better and more portable
  25. product.  Mail suggestions and bug reports (including documentation
  26. errors) for this program to `bug-gnu-utils@prep.ai.mit.edu'.  If you
  27. develop new charsets, new methods, or anything along `recode', let
  28. me know and share your findings, at `pinard@iro.umontreal.ca'.
  29.  
  30. .-------.
  31. | Hints |
  32. `-------'
  33.  
  34. Here are a few hints which might help installing `recode' on some
  35. systems.  Most may be applied by temporary presetting environment
  36. variables while calling `./configure'.  File `INSTALL' explains this.
  37.  
  38. * You may override DEFAULT_CHARSET while configuring.  For example, on
  39. an AtariST using `bash', one could do:
  40.  
  41.     DEFAULT_CHARSET=AtariST ./configure
  42.  
  43. * Some C compilers, like Apollo's, have a real hard time compiling
  44. merged.c.  If this is your case, first avoid compiler optimization.
  45. From within the Bourne shell, you may use:
  46.  
  47.     CPPFLAGS=-DUSE_FPUTC CFLAGS= ./configure
  48.  
  49. * For 80286 based systems, it has been reported that some compilers
  50. generate wrong code while optimizing for *small* models.  So, from
  51. within the Bourne shell, do:
  52.  
  53.     CFLAGS=-Ml LDFLAGS=-Ml ./configure
  54.  
  55. to force large memory model.  For 80286 Xenix compiler, the last time
  56. it was tried a while ago, one ought to use:
  57.  
  58.     CFLAGS='-Ml -F2000' LDFLAGS=-Ml ./configure
  59.  
  60. * Some smallish systems have poor `popen' support or trash heavily
  61. when processes do fork.  In this case, just before doing `make', edit
  62. `config.h' and ensure HAVE_POPEN and HAVE_PIPE are *not* defined.
  63.