home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 5 Edit / 05-Edit.zip / word2x0a.zip / README < prev    next >
Text File  |  1997-04-12  |  6KB  |  150 lines
  1. $Id: README,v 1.7 1997/04/13 02:59:59 dps Exp $
  2.  
  3. Installing word2x
  4.  
  5. You need a C++ compiler and a version of make that does understands
  6. how to make .o files from .cc files, for example GNU make. Ideally you
  7. have getopt_long already in your C library but you might not. If this
  8. applies set GETOPT to gopt.o in the Makefile. getopt_long is the
  9. version supplied by the free software foundation in glibc-1.09
  10.  
  11. If your make does not know then add a rule. for GNU make the rule is
  12.  
  13. %.o: %.cc
  14.     $(CPP) $(CPPFLAGS) -c -o $@ $<
  15.  
  16. Please note that a warning about a contravariance violation is normal.
  17.  
  18. As this is program only recently escaped, YMMV. The main reason for
  19. its escape was incessant irration that comp.os.linux.misc posters
  20. manage about word .doc files (IMHO this is justified). I had wrote
  21. this program for myself and my word problem; I let it run wild in the
  22. hope that is it useful for others. [I now know is it is helping some
  23. people]
  24.  
  25. Further information on other converters is avialable in the list of
  26. converters avialble via <http://www.kfa-juelich.de/isr/1/texconv.html>
  27. (word2x seems to have a monopoly on converters from word to latex not
  28. requiring word and avialable on non-MS platforms).
  29.  
  30. The program has been compiled on (the first two by me personally):
  31.  
  32. Linux 2.1.30 (Unix)
  33. SunOS (Unix)
  34. DEC Alpha AXP under OSF/1 (Unix) 
  35. IBM SP/2 (RS6000) under AIX (Unix) [SP/2s are heavy computing power...]
  36.  
  37. It is known not compile with
  38.  
  39. Borland C++ 3.1 (PC version).
  40.  
  41. If any manages to compile on a PC version, please tell
  42. Duncan Simpson <dps@duncan.telstar.net> and
  43. W.Hennings <W.Hennings@kfa-juelich.de>
  44.  
  45. Limited flat (linear) memory might be lethal, esp. if your system
  46. lacks alloca. If have not learned to steal what is free then you can
  47. send money (prefably UK funds), postcards, etc to the author at
  48.  
  49. Frax House, Kingston Bagpuize, OXON OX13 5AW
  50.  
  51. or for the next couple of years
  52.  
  53. Flat 6, 93 Westridge Road, Southampton
  54.  
  55. I neither suggest that you do donate nor that you do not donate.
  56.  
  57.  
  58. SunOS
  59.  
  60. Can be problematic. Setting LD to ./sunos_link and defining add
  61. produced a binary that worked for me with one warning about
  62. strncasecmp. I guess SUN's ld is incompatible with g++ or something;
  63. using ar and ranlib, aka the sunos_link shell script, works. The
  64. configuration script hopefuk does this stuff for you.
  65.  
  66.  
  67. Reported bugs
  68.  
  69. On some platforms it misses the first 3/4 of a page. If you are
  70. afflicted get out your copy of hexdump and adjust the start offset in
  71. word2x to the correct value.
  72.  
  73. Even better write some code that reliably finds the offset by itself
  74. and send me a patch...
  75.  
  76.  
  77. Copyright
  78.  
  79. This program is(c) D.P.Simson 1997. The program is licenced under the
  80. GPL version 2, or any later version (at your option). This means DOS
  81. people must distribute source as per the GPL.
  82.  
  83. The stuff I did not write is:
  84.  
  85. config.guess and config.sub come from GNU autoconf and are thus
  86. (c) The Free Software Foundation.
  87.  
  88. getopt.c, getopt1.c and getopt.h are (c) The Free Software Foundation.
  89. I am fairly sure the LGPL requires these files to be distributed as
  90. well.
  91.  
  92. alloca.c is almost certaintly also (c) The Free Sofwtware Foundation.
  93.  
  94. install-sh is probably (c) The X consortium
  95.  
  96.  
  97. Introductory proganda
  98.  
  99. Despite the fact that open formats like rtf are good and widely
  100. avialable far too many idiots seem to insist on using word .doc
  101. format. This program is an attempt to limit the damage this causes
  102. users of non-microsoft systems and text processing systems, for
  103. example LaTeX.
  104.  
  105. It is designed to be retargetable and avoid some of the travesties of
  106. proper typsetting comitted by word, which is hobbled by the lack of
  107. litagures in TrueType fonts (and the lack of different design sizes to
  108. some extent). There is quite a large amount of guesswork from context
  109. to reduce the impact of my lack of understanding a document the way
  110. word does. One even sees interesting things like
  111. <Paragraph mode> 550* <eqn> \F(foo, bar) <end eqn> * 42 * (pixels per em)
  112. <End paragraph>
  113. which is not too good! There may be multiple bits of alternating roman
  114. and equation, multiple items of text in brackets, etc.
  115. etc. Fortunately the reader converts these, in two stages, to a single
  116. maths insert. Maths inserts with embedded newlines get rendered as
  117. eqnarray* in LaTeX mode. All maths is just deleted in text mode (would
  118. someone like to add this support?).
  119.  
  120. LaTeX mode sees the equation example above as <eqn insert> 550
  121. * \F(foo, bar * baz) * 42 * (pixels per em) <end eqn insert> and
  122. renders it as
  123. % Some comments omited for brevity
  124. $$550 \times {\text{foo} \over \text{bar} \times \text{baz} } \times 42
  125. \times \text{(pixels per em)}$$
  126. which looks a lot better than word's own version, which uses awful
  127. stars instead of proper times signs.
  128.  
  129. Text mode implements tables with real columns, unlike catdoc. Long
  130. entries are folded automatically and there is some semi-intelligent
  131. width reduction.  Hypenation is not supported so if someone instists
  132. on using supercalifragilistic... then an overlong line might result
  133. (anyone care to fix this? I thought it was just overkill to implement
  134. the hypenation algorithm along with all the rest).
  135.  
  136. Apart from the pictures and a little trailing junk the code does a
  137. good job on the TrueType documents. The readme generates some error
  138. messages about extra ^Us amoung other things due to a lack of
  139. understanding of some of the inserts used in some documents. Anyone
  140. who can decode more types of insert, please tell me about it and
  141. preferably send a patch so I can avoid extra programming (got too much
  142. real work to be doing).
  143.  
  144. If someone wishes to contribute *roff output I would include it. Extra
  145. understanding of equations also gratefully recieved as the examples in
  146. the TrueType docs are rather limited. Bibliography and any other you
  147. can tell me about also grateful listened to.
  148.  
  149. Duncan (-:
  150.