home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 5 Edit / 05-Edit.zip / txict100.zip / texicvt1.00 / readme < prev    next >
Text File  |  1997-03-31  |  3KB  |  87 lines
  1. ================================================================================
  2.                         Texinfo converting Tools
  3.                          Release 1.00  28.03.97
  4.                        (c) 1996 by Andreas Kaiser
  5.                     (c) 1997 by Karl Heinz Marbaise
  6. ================================================================================
  7.              $Id: README 1.5 1997/03/28 21:13:33 KHM Exp $
  8.  
  9.  
  10.     Informations about the Texinfo converting Tools:
  11.  
  12.       o All of the converters are based upon Andreas
  13.         Kaiser's Texinfo to IPF(V1.20 which has never
  14.         been released).
  15.         I got the sources and the permission
  16.         to redistribute this package with his
  17.         friendly permission.
  18.         Thanks Andreas.
  19.  
  20.         I have fixed many bugs in the Texinfo to IPF
  21.         converter and added much stuff, but
  22.         may be I have changed the behaviour of
  23.         the converter(I hope I didn't).
  24.         If you have problems to do a converting
  25.         job with this new release which was done
  26.         without problems with the old one (Texi2ipf V1.00)
  27.         then please let me know that.
  28.  
  29.  
  30.     Let me tell you about the reasons to create a converter
  31.     to HTML:
  32.     I know that there exist one. The texi2html.pl Perl script.
  33.     But texi2html.pl-script has the disadvantage not to support
  34.     all of the Texinfo commands(@def...@).
  35.     But the main reason was that the copyright of the texi2html script
  36.     is not GPL !!!
  37.  
  38.  
  39.     Usage for all converters:
  40.  
  41.         texi2ipf [options] Texinfo-source-file IPF-source-file
  42.       or
  43.     texi2ipf [options] Texinfo-source-file online-doc-file  
  44.       where
  45.     IPF-source-file = *.IPF
  46.     online-doc-file = *.INF
  47.  
  48.     Options:
  49.         -Dflag    set Texinfo flag
  50.         -Uflag    set Texinfo flag
  51.         -i    create INF index
  52.         -n    use @node to split into panels, not @chapter
  53.                 -o      Create output file depending on converter:
  54.                          texi2ipf => .ipf
  55.                          texihtml => .html on DOS .htm
  56.                          texi2rtf => .rtf
  57.         -?    display usage
  58.  
  59.       If the extension of the output filename is .INF, texi2ipf
  60.       automatically invokes the IPFC program, which compiles the
  61.       temporary .IPF file to .INF. The IPFC program is a
  62.       component of the OS/2 toolkit. Any other extension
  63.       specifies an IPF source file. If you run IPFC separately,
  64.       use its option /W1 to avoid warnings.
  65.  
  66.       If you are using the texihtml or the texi2rtf then
  67.       -n and -i options could be given, but the result?
  68.       I didn't test it(This behaviour should be changed)
  69.  
  70.       Example:
  71.          texi2ipf -o cfg.tex
  72.  
  73.       Produces cfg.ipf out of cfg.tex(info)
  74.  
  75.       Example:
  76.          texihtml -o cfg.tex
  77.  
  78.       Produces cfg.html out of cfg.tex(info)
  79.  
  80.  
  81.     Report bugs, registration, questions and suggestions:
  82.         Karl Heinz Marbaise:
  83.          e-mail:
  84.              Internet: KHMarbaise@p69.ks.fido.de
  85.              Fido-net: 2:2452/117.69
  86.  
  87.