CSConv environment                                          workspace(5)


NAME

     workspace - workspace of code set converter


DESCRIPTION

     src/lib/CSConv
          the root directory of CSConv.  csconv() and other external
          interfaces are defined in the directory.

     src/lib/CSConv/converter
          most csconv encoding converters are defined in the directory.

     src/lib/CSConv/converter/compoundtext
          csconv encoding converters related to CompoundText are defined
          in the directory.

     src/lib/CSConv/converter/compoundtext/ct_conf
          configuration files for csconv encoding converters related to
          CompoundText.

     src/lib/CSConv/doc
          documentations are placed in the directory.

     src/lib/CSConv/iconv
          iconv(3) dummy routine for systems which do not support
          iconv(3) library function.

     src/lib/CSConv/test
          test programs are placed in the directory.


HOW TO ADD CONVERTERS

     To add converters to csconv, follow this procedure.


     1. edit src/lib/CSConv/csconv.conf and src/lib/CSConv/encoding.norm
        to insert definitions for the new converter.

     2. Create the converter in src/lib/CSConv/converter.

     3. Edit src/lib/CSConv/converter/Makefile.in to compile the
        converter.

     4. If you build internal encoding converter (linked with other
        converters), edit src/lib/CSConv/converter/csc_entry_internal.c
        and src/lib/CSConv/converter/csc_entry_internal.h to insert a
        definition of the converter.
