Introduction to version 3.81 of WP2LaTeX. INTRODUCTION ------------ This program converts WordPerfect 1.x, MAC 2,3,4.x, PC 4.x, 5.x, 6(7,8,9).x, RTF, HTML, T602 and AbiWord document files to LaTeX input files. Please read the manual for the basic conditions under which a satisfying conversion is made. Currently, there are MS-DOS, Linux and Windows versions of the program available. The C++ sources are included in this package. Obsolette Pascal sources are placed inside separate package. Please read doc/wp2latex.tex for more information. New to this version are: + Conversion from MAC WP 1.x, 2.x, 3.x + Improved file format autodetection + Support for new formula format MTEF The things have to be done: - Decrease amount of TeX Errors in converted documents - Make tests of quality of the conversion - Add new foreigner characters - Add new features - Improve support for WPG l.2 and hybrid images (Raster+Line draw+Postscript) THE PACKAGE ----------- The home base for this package is http://www.penguin.cz/~fojtik/wp2latex/ HOW TO BUILD & INSTALL ---------------------- **********DOS/WINDOWS and GCC******** There is makefile prepared for GCC. It will work under both Linux and DJGPP. A, if you have bash run it and type ./configure B, or if you do not have bash type (it will return generic makefiles) make distclean type for building whole project: make all Automatic installation is not fully finished, but you might try: make install **********DOS/WINDOWS and Borland C******** Because there is freely available Borland C++ compiler, I also provide script for building wp2latex by BCC. (You could undo .configure script resulte by typing 'make distclean') change to directory win cd win execute bcc55.bat bcc55.bat **********DOS/WINDOWS and Microsoft Visual C++ 6******** (You could undo .configure script resulte by typing 'make distclean') Open MSVC/wp2latex.dsw inside your Visual C++ environment. Rebuild the target. The result of your build you will find in the MSVC/release/wp2latex.exe **********WINDOWS and MikTex******** mkdir "C:\Program Files\MiKTeX-2.8\tex\latex\wp2latex\" copy all files from wp2latex.353\styles.tex\ to "C:\Program Files\MiKTeX-2.8\tex\latex\wp2latex\" initexmf -u or click to "MikRex Options/General/Refresh FNDB" ********Linux build and instalation********* Under Linux you may type: ./configure make all make install For finishing instalation you should also store files wp2latex.sty, endnotes.sty, wncyr.sty, cyracc.def etc. to proper directory. These files are stored in the directory 'styles.tex'. The TeX translator should know about these files. It is solved by using a TEXINPUTS system variable. Suggestion from Roger for kpathsea LaTeX distribution: After 'make install' it is necessary to do this (as root): (1) in the tex tree, within the latex subdirectory, create a subdirectory called wp2latex. For example in my (web2c) installation I have /usr/share/texmf/tex/latex/wp2latex (2) Into this subdirectory copy the contents of the styles.tex subdirectory. (3) Invoke texhash. ******Generic Unix manual instalation******* Please ensure that your wp2latex is correctly build. Try: ./configure make When you succeed, you have half of a job done. If this fail, you could try: make generic make In some cases you will need to manually fiddle with compile options. I will assume that you have compiled wp2latex at this point. The "wp2latex" executable is produced. A name of executable for cygwin is "wp2latex.exe". copy YOUR_EXECUTABLE to /usr/local/bin/ mkdir /usr/share/texmf/tex/latex/wp2latex copy styles.tex/*.* to /usr/share/texmf/tex/latex/wp2latex/ copy doc/wp2latex.1 to /usr/local/man/man1/ copy doc/locale/*.* to /usr/share/locale/ run texthash (for kpathsea TeX distribution) ***********DOS installation*********** Currently you might also try to run make install Cross your fingers - it might perhaps work. Place a file wp2latex.exe (from directory dos\ or dos\real) to the directory which is referred by the PATH variable. Place all stuff from the directory 'styles.tex\' to the directory emtex\texinput\ . Optionally you can copy a file doc\locale\lc_messages\cs\wp2latex.mo to the directory $(DJDIR)\SHARE\LOCALE\LC_MESSA\CS\WP2LATEX.MO . For Borland C++ you should make another makefile. All code was tested and you cannot expect any problems. Do not omit to add files from directory .\atoms\ to your makefile. USAGE ----- The command line looks like : WP2LaTeX [arguments] [] [arguments] When not supplied [] , the LaTeX filename is composed by changing or adding `.tex' to the base name of WP-file. There are also a lot of other arguments, which are described in the included documentation or are available by executing 'wp2latex -?'. THANKS ------ I want to thank all previous authors of this package to bring some ideas. I try to gather them into my package. I thank to everybody who found a bug or sended me some notes about incorrect function of WP2LaTeX. COPYRIGHT --------- This program can be redistributed and/or modified under the terms of the GNU General Public License version 2 available from http://www.gnu.org/copyleft/gpl.html. If anybody makes any change to this package, I am asking him to explicitelly write that his package differs from original package. Current copyright could be obtained by typing wp2latex -copyright. WP2LaTeX contains several libraries, that have different licencing models. It is also possible to buy commercional version that is GPL free. DISCLAIMER ---------- Neither the author nor the Eindhoven University of Technology takes any responsibility for any damage or loss of data regarding to the use of the program. Usage of the program is for your own responsibility. BUG REPORTING ------------- Note:Before reporting anything 1,consult a file doc\bug.txt 2,Test latest version from: http://www.penguin.cz/~fojtik/wp2latex/ a,If you find a bug, which cause a data loss or program crash please send me a description, how to repeat this bug. Cut your WP file to shortest possible, which still cause this bug. Then send me this file. b,If you find a bug which causes TeX errors, send me a detailed description what was happen and idea how the convertor should work in this case. I know about many situation, when TeX reports errors and I don't know how to cope with them. c,If you cannot compile wp2latex please send me output of your make file. make >out.txt Be prepared that I will ask you for some analysis of the problem because on my computer it works fine. Please do not suspect me, that I missed some typo in the source code. Before every distribution I recompile wp2latex under several different compilers. I also welcome any suggestions obtained from porting wp2latex to another platforms. HOW TO CONTACT THE AUTHOR ------------------------- Because nobody of previous authors want to hear about this program, contact me: JaFojtik@seznam.cz Yours Sincerely, Jaroslav Fojtik