.. role:: code(strong)
.. role:: file(literal)

=======================================
README file for :file:`recode/contrib/`
=======================================

.. contents::
.. sectnum::

Hi, people!
===========

The :file:`contrib/` directory of the Recode distribution contains a few
miscellaneous tools, ports, or such things, which have been collected
here and there, a bit randomly, for your possible entertainment or use.

Beware that nothing here is supported by the Recode maintainer, you
might have to contact the authors directly to get support.  There is no
guarantee that any file in this directory will still exist in subsequent
releases.  Finally, there is no guarantee either that I will accept to
include contributions, unless I find them very good or very small.  But
I'm quite willing to give URL pointers to other tools, right here!

Included files
==============

To the best of my knowledge, all included files are free, and already
available widely by other means.  I did not collect any kind legalistic
papers proving that the contained material is indeed free.  In case of a
dispute, or at the mere request of the author, I'll quickly remove any
dubious material.  So, do not consider the files here as being as *safe*
as the things you usually get from the Free Software Foundation.

Please drop me a note about what you found to be useful, in here, to
help me at deciding what should be kept and what should go away.

+ :file:`utf8.el`

  This tool helps Emacs users at inserting UTF-8 encoded ISO-10646 or
  Unicode characters in an Emacs buffer.  Submitted by Gary Houston
  <ghouston@actrix.gen.nz> to :code:`gnu.emacs.sources`, 1994-10.

+ :file:`recode.el`

  This is a miscellaneous collection of tools, documented in French,
  for using Recode from Emacs, when Latin-1 is in use.  Submitted by
  François Pinard <pinard@iro.umontreal.ca>, 1994-12.

+ :file:`djgpp-README`
+ :file:`djgpp-diffs`

  These files represent a port of version 3.4.1 of Recode to DJGPP,
  submitted by Wojciech Galazka <wgalazka@chem.uw.edu.pl>, 1997-11.

+ :file:`Makefile.amiga`
+ :file:`Makefile.amiga-lib`

  These makefiles allow building Recode 3.4k on Amiga.  Submitted by
  Stefan Haubenthal, 1998-11.

+ :file:`recode.spec1`

  RPM spec file to prepare Recode 3.5c on RedHat.  Submitted by David
  Lebel, 2000-06.

+ :file:`recode.spec2`

  RPM spec file to prepare Recode 3.5d on RedHat.  Submitted by Bennett
  Todd, 2002-01.  Bennett writes (more or less):

    This spec file allows portable building.  Users could download the
    tar archive and simply ``rpm -ta`` it to build themselves source and
    binary :code:`rpm`\ s.  If they had their :code:`rpm` directory,
    they could even do it while not being ``root``.  For example, my
    :file:`~/.rpmmacros` reads::

      %_topdir    /home/bet/rpm

    without a leading tab. Hence my :file:`/usr/src/redhat/` is still
    ``root:root``, and yet I can do my :code:`rpm` building as myself.

External pointers
=================

Documentation
-------------

+ IETF references

  + Character Mnemonics & Character Sets

    + ftp://nic.ddn.mil/rfc/rfc1345.txt

    Keld Simonsen <keld@dkuug.dk>, 1992-06.

  + UTF-7 - A Mail-Safe Transformation Format of Unicode

    + ftp://nic.ddn.mil/rfc/rfc1642.txt

    David Goldsmith <david_goldsmith@taligent.com> and Mark Davis
    <ark_davis@taligent.com>, 1994-07.

  +  UTF-8, a transformation format of Unicode and ISO 10646

     + ftp://nic.ddn.mil/rfc/rfc2044.txt

     François Yergeau <yergeau@alis.com>, 1997-10.

+ Various references

  + Unicode charset mappings

    + ftp://ftp.unicode.org:/Public/MAPPINGS/

    The Unicode consortium makes available plenty of charset mappings
    for converting "legacy" charsets to Unicode.

  +  Normalisation et internationalisation: Inventaire et prospectives des
     normes clefs pour le traitement informatique du français.  (392p.)

     This is a report, written in French, discussing charset issues and many
     other topics as well.  Laurent Bourbeau <bourbeau@progiciels-bpi.ca>
     and François Pinard <pinard@iro.umontreal.ca>, 1995-10.

     + ftp://ftp.iro.umontreal.ca/pub/contrib/pinard/accents/oqil-tome1.ps.gz
     + http://www.ceveil.qc.ca/Normes

Programs
--------

+ :code:`libiconv`

  This comprehensive charset converter library revolves around Unicode,
  and support Asian encodings among many others.  Even Recode uses it!

  + http://www.gnu.org/software/libiconv/

  Bruno Haible <haible@ilog.fr>

+ :code:`tcs`

  Here is the main recoding tool from the Plan9 project.

  + ftp://research.att.com/dist/tcs.shar.Z

+ :code:`yuedit`

  This GUI editor handles many encodings, among which UTF-8.  It also
  installs uniconv, a recoding program, and uniprint, a printing tool.

  + ftp://sunsite.unc.edu/pub/Linux/apps/editors/X/yudit-1.2.tar.gz

  Gaspar Sinai <gsinai@iname.com>, 1999-01.

+ :code:`ucs-fonts`

   These 6x13 fonts, covering Unicode characters besides the Asian sets,
   merely replace the Linux fixed 6x13 font.  Works nicely with yudit.

   + http://www.cl.cam.ac.uk/~mgk25/download/ucs-fonts.tar.gz

   Markus Kuhn <Markus.Kuhn@cl.cam.ac.uk>, 1998-11.

+ :code:`MtRecode`

  This charset converter is oriented towards SGML text manipulation.  It
  may be freely downloaded for non-commercial, non-military use from:

  + http://www.lpl.univ-aix.fr/projects/multext/MtRecode/

  Pointer given by Jean Véronis <veronis@univ-aix.fr>, 1996-06.

+ :code:`sp`

  This quite nice SGML structure analyser contains internal C++ modules
  for handling many charsets.

  + ftp://ftp.jclark.com/pub/sp/sp-1.3.tar.gz

  James Clark <jjc@jclark.com>

+ :code:`b2c`

  This program is able to generate interpreted
  character dumps, but properly embedded within complete C header files.

  + http://research.de.uu.net:8080/~gnu/b2c/b2c-2.1.tar.gz

  Jörg Heitkötter <Joerg.Heitkoetter@de.uu.net>, 1997-11.

+ :code:`PyRecode`

  This wrapper provides Recode functionality to Python programs.

  + http://www.suxers.de/PyRecode.tgz

  Andreas Jung <ajung@server.python.net>

  Also see:

  + http://www.vex.net/parnassus/apyllo.py?find=recode
  + http://www.suxers.de/python/pyrecode.htm

Non-Unix ports or alikes
========================

Please mailto:recode-bugs@iro.umontreal.ca if you are aware of various
ports to non-Unix systems not listed here, or for corrections.  Please
provide the goal system, a complete and stable URL, the maintainer name
and address, the Recode version used as a base, and your comments.

+ IBM/PC (MSDOS)

  + + ftp://ftp.simtel.net/pub/simtelnet/gnu/djgpp/v2gnu/rcode34b.zip
    + ftp://ftp.simtel.net/pub/simtelnet/gnu/djgpp/v2gnu/rcode34s.zip
    + ftp://ftp.simtel.net/pub/simtelnet/gnu/djgpp/v2gnu/rcode34d.zip

    (for binaries, sources and docs respectively) maintained by Wojciech
    Galazka <wgalazka@chem.uw.edu.pl> Based on Recode 3.4.1.

  + + http://www.simtel.net/simtel.net/
    + http://www.leo.org/pub/comp/platforms/pc/gnuish (Germany)
    + ftp://ftp.simtel.net/simtelnet/gnu
    + ftp://ftp.leo.org/pub/comp/platforms/pc/gnuish

    maintained by Darrel Hankerson <hankedr@mail.auburn.edu> You get
    many GNU tools, not only Recode.  The GNUish project is described in
    :file:`gnuish_t.htm`.
