================================================================================
                        Texinfo converting Tools
                         Release 1.00  28.03.97
                       (c) 1996 by Andreas Kaiser
                    (c) 1997 by Karl Heinz Marbaise
================================================================================
             $Id: README 1.5 1997/03/28 21:13:33 KHM Exp $


    Informations about the Texinfo converting Tools:

      o All of the converters are based upon Andreas
        Kaiser's Texinfo to IPF(V1.20 which has never
        been released).
        I got the sources and the permission
        to redistribute this package with his
        friendly permission.
        Thanks Andreas.

        I have fixed many bugs in the Texinfo to IPF
        converter and added much stuff, but
        may be I have changed the behaviour of
        the converter(I hope I didn't).
        If you have problems to do a converting
        job with this new release which was done
        without problems with the old one (Texi2ipf V1.00)
        then please let me know that.


    Let me tell you about the reasons to create a converter
    to HTML:
    I know that there exist one. The texi2html.pl Perl script.
    But texi2html.pl-script has the disadvantage not to support
    all of the Texinfo commands(@def...@).
    But the main reason was that the copyright of the texi2html script
    is not GPL !!!


    Usage for all converters:

        texi2ipf [options] Texinfo-source-file IPF-source-file
      or
	texi2ipf [options] Texinfo-source-file online-doc-file  
      where
	IPF-source-file = *.IPF
	online-doc-file = *.INF

	Options:
		-Dflag	set Texinfo flag
		-Uflag	set Texinfo flag
		-i	create INF index
		-n	use @node to split into panels, not @chapter
                -o      Create output file depending on converter:
                         texi2ipf => .ipf
                         texihtml => .html on DOS .htm
                         texi2rtf => .rtf
		-?	display usage

      If the extension of the output filename is .INF, texi2ipf
      automatically invokes the IPFC program, which compiles the
      temporary .IPF file to .INF. The IPFC program is a
      component of the OS/2 toolkit. Any other extension
      specifies an IPF source file. If you run IPFC separately,
      use its option /W1 to avoid warnings.

      If you are using the texihtml or the texi2rtf then
      -n and -i options could be given, but the result?
      I didn't test it(This behaviour should be changed)

      Example:
         texi2ipf -o cfg.tex

      Produces cfg.ipf out of cfg.tex(info)

      Example:
         texihtml -o cfg.tex

      Produces cfg.html out of cfg.tex(info)


    Report bugs, registration, questions and suggestions:
        Karl Heinz Marbaise:
         e-mail:
             Internet: KHMarbaise@p69.ks.fido.de
             Fido-net: 2:2452/117.69

