summaryrefslogtreecommitdiff
path: root/support/wp2latex/wp2latex.doc.htm
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
committerNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
commite0c6872cf40896c7be36b11dcc744620f10adf1d (patch)
tree60335e10d2f4354b0674ec22d7b53f0f8abee672 /support/wp2latex/wp2latex.doc.htm
Initial commit
Diffstat (limited to 'support/wp2latex/wp2latex.doc.htm')
-rw-r--r--support/wp2latex/wp2latex.doc.htm1453
1 files changed, 1453 insertions, 0 deletions
diff --git a/support/wp2latex/wp2latex.doc.htm b/support/wp2latex/wp2latex.doc.htm
new file mode 100644
index 0000000000..278104d244
--- /dev/null
+++ b/support/wp2latex/wp2latex.doc.htm
@@ -0,0 +1,1453 @@
+ <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"
+ "http://www.w3.org/TR/REC-html40/loose.dtd">
+<HTML>
+<META NAME="GENERATOR" CONTENT="TtH 2.33">
+
+<title> {\rm W \kern-.38em\hbox{P}\kern-.2em\lower.7ex\hbox{2}\kern-.07em\hbox{\LaTeX }}\\
+ \hspace{1cm}\\
+ User's Guide</title>
+
+<H1 align=center></b>W P2L<sup>A</sup>T<sub>E</sub>X <br>
+ <br>
+<p>
+ User's Guide </H1>
+
+<H3 align=center>R.C. Houtepen<a href="#tthFtNtAAB" name="tthFrefAAB"><sup>1</sup></a><br>
+ Jaroslav Fojt&#237; k </H3>
+
+<p>
+ <H2><A NAME="tth_sEc0.1">
+1</A>&nbsp;&nbsp;Introduction</H2>
+
+<p>
+There is another version of </b>W P2L<sup>A</sup>T<sub>E</sub>X written from scratch
+by the original author R. C. Houtepen at TUE-Eindhoven. This version
+differs completely from the package in your hand. Please check it on
+your nearest CTAN host at:
+
+<p>
+
+<pre>
+ tex-archive/support/wp2latex/* .
+</pre>
+
+<p>
+The version there has the disadvantage, that there isn't any source code
+available. The source code in the subdirectories is very old. I tried
+hardly to contact the author but failed. So I took the latest available
+sources (which based on these in the subdirectories mentioned above)
+and corrected some errors. I never checked the other version. I apologize
+everybody to compare both versions and tell me the conclusion.
+
+<p>
+</b>W P2L<sup>A</sup>T<sub>E</sub>X was originally designed to translate WordPerfect 5.0 documents
+into L<sup>A</sup>T<sub>E</sub>X&nbsp;2.09. Later some code was added to translate also WordPerfect 5.1
+documents. Now the preamble is designed for L<sup>A</sup>T<sub>E</sub>X&nbsp;2e (by changing the
+preamble by hand it runs also under L<sup>A</sup>T<sub>E</sub>X&nbsp;2.09 of course).
+
+<p>
+The programming language used was Turbo Pascal 7.0 and C++. The pascal version
+will be no longer supported from me. Only severe bugs will be corrected.
+C++ code has been ported to OS/2, DOS DJGPP and Linux operation
+systems.
+
+<p>
+The projection from one paradigm (WordPerfect = word processing) to another
+(L<sup>A</sup>T<sub>E</sub>Xtypesetting) requires some cooperation on the part of the user.
+Because the use of L<sup>A</sup>T<sub>E</sub>X&nbsp;is tied to strict rules, one must take these rules
+into consideration when using WordPerfect, if the WordPerfect 5.0 document is
+to be converted as accurately as possible. This guide discusses those rules.
+
+<p>
+ <H3><A NAME="tth_sEc0.1.1">
+1.1</A>&nbsp;&nbsp;Some general remarks</H3>
+
+<p>
+
+<OL type="1">
+<li> Don't expect a better looking result only caused by converting text
+ from WordPerfect to L<sup>A</sup>T<sub>E</sub>X. You HAVE TO edit the resulting L<sup>A</sup>T<sub>E</sub>X&nbsp;files.
+ The reason is, that wordprocessors didn't give the structure
+ of the text (sections, itemizations, labels, ...) but only
+ the formatting (boldface, underline (uurgh), italic, ...).
+
+<p>
+
+<li> See next section for conversion abilities
+
+<p>
+
+<li> Don't expect any miracles from this program.
+</OL>
+<p>
+ <H3><A NAME="tth_sEc0.1.2">
+1.2</A>&nbsp;&nbsp;Authorship history</H3>
+
+<p>
+</b>W P2L<sup>A</sup>T<sub>E</sub>X was written in Turbo Pascal by R. C. Houtepen at TUE-Eindhoven.
+It was converted into C using p2c, and modified, by Glenn Geers (Sydney U).
+It was further modified by Michael Covington (U of Georgia).
+Modified to be used in unix/linux environment by Claudio Porfiri.
+The parsing of formulas was added by Dirk Lellinger (U Halle/Germany).
+The splitting of code into several files and the documentation
+was done by Andreas Tille.
+J Fojtik developed original version from R. C. Houtepen at TUE-Eindhoven
+and then tried to give all available versions together.
+
+<p>
+ <H2><A NAME="tth_sEc0.2">
+2</A>&nbsp;&nbsp;Conversion possibilities</H2>
+<A NAME="capabilities">
+</A>
+
+<p>
+Because the capabilities of WordPerfect and L<sup>A</sup>T<sub>E</sub>X&nbsp;differ strongly, it is
+not possible to convert all of WordPerfect's `features'.
+
+<p>
+
+<H3>The conversions which are performed by </b>W P2L<sup>A</sup>T<sub>E</sub>X (when converting WP4.x
+documents) are:</H3>
+
+<p>
+
+<UL>
+<li> Center page
+
+<li> Comment
+
+<li> Contents
+
+<UL>
+<li> Mark To Contents
+
+<li> Table of Contents
+ </UL>
+<p>
+
+<li> Date Code
+
+<li> Endnotes
+
+<li> Extended characters (one charset 256 with chars)
+
+<li> Flush-right text
+
+<li> Footnotes
+
+<li> Headers and footers
+
+<li> Hard page breaks
+
+<li> Hard returns
+
+<li> Hyphenation &nbsp;&nbsp; On/Off
+
+<li> Indenting :
+
+<li> Index
+
+<UL>
+<li> Mark To Index
+
+<li> Table of Indices (makeindex is required)
+ </UL>
+<p>
+
+<li> Justification :
+
+<UL>
+<li> right
+
+<li> center
+
+<li> full
+ </UL>
+<p>
+
+<li> Language
+
+<li> Marks ToContents
+
+<li> Newspaper-style columns (experimental max only 2)
+
+<li> Overstriking
+
+<li> Page number positioning
+
+<li> Page numbers
+
+<li> Page number set
+
+<li> Soft Hyphen
+
+<li> The following Typefaces :
+
+<UL>
+<li> Superscript
+
+<li> Subscript
+
+<li> Bold
+
+<li> Underlined
+
+<li> Double-underlined
+
+<li> RedLine (Only L<sup>A</sup>T<sub>E</sub>X 20e)
+ </UL>
+<p>
+
+<li> Widow Orphan &nbsp;&nbsp; On/Off
+</UL>
+<p>
+
+<H3>The conversions which are performed by </b>W P2L<sup>A</sup>T<sub>E</sub>X (when converting WP5.x
+documents) are:</H3>
+
+<p>
+
+<UL>
+<li> Advances
+
+<li> Center page
+
+<li> Comment
+
+<li> Contents
+
+<UL>
+<li> Mark To Contents
+
+<li> Table of Contents
+ </UL>
+<p>
+
+<li> Cross-references
+
+<li> Date Code
+
+<li> Endnotes
+
+<li> Equations
+
+<li> Extended characters (foreign language/accented, math, Greek)
+
+<li> Flush-right text
+
+<li> Footnotes
+
+<li> Headers and footers
+
+<li> Hard page breaks
+
+<li> Hard returns
+
+<li> Hyphenation &nbsp;&nbsp; On/Off
+
+<li> Indenting :
+
+<UL>
+<li> left
+
+<li> left and right
+ </UL>
+<p>
+
+<li> Index
+
+<UL>
+<li> Mark To Index
+
+<li> Table of Indices (makeindex is required)
+ </UL>
+<p>
+
+<li> Justification :
+
+<UL>
+<li> left
+
+<li> right
+
+<li> center
+
+<li> full
+ </UL>
+<p>
+
+<li> Labels
+
+<li> Language
+
+<li> Marks ToContents
+
+<li> Newspaper-style columns (using <tt>multicol.sty</tt>)
+
+<li> Outlining
+
+<li> Overstriking
+
+<li> Page number positioning
+
+<li> Page numbers
+
+<li> Page number set
+
+<li> Soft Hyphen
+
+<li> Tab Settings
+
+<li> Tabs :
+
+<UL>
+<li> setting
+
+<li> left tabs
+
+<li> center tabs
+
+<li> right tabs
+ </UL>
+<p>
+
+<li> Tables
+
+<li> Table boxes
+
+<li> Table of contents
+
+<li> Text boxes
+
+<li> The following Typefaces :
+
+<UL>
+<li> Extra large
+
+<li> Very large
+
+<li> Large
+
+<li> Small
+
+<li> Fine
+
+<li> Superscript
+
+<li> subscript
+
+<li> Bold
+
+<li> Italic
+
+<li> Overstrike
+
+<li> Small caps
+
+<li> Underlined
+
+<li> Double-underlined
+
+<li> RedLine (Only L<sup>A</sup>T<sub>E</sub>X 20e)
+ </UL>
+<p>
+
+<li> Widow Orphan &nbsp;&nbsp; On/Off
+</UL>
+<p>
+<b>Not</b> converted are :
+
+<UL>
+<li> margin settings
+
+<li> top and bottom margins
+
+<li> graphics boxes
+
+<li> the calculations in tables
+
+<li> and many other WP features ...
+</UL>
+<p>
+
+<H3>The conversions which are performed by </b>W P2L<sup>A</sup>T<sub>E</sub>X (when converting WP6.x
+documents) are:</H3>
+
+<p>
+
+<UL>
+<li> Center page
+
+<li> Colors (Only L<sup>A</sup>T<sub>E</sub>X 20e)
+
+<li> Comment (also nested ones)
+
+<li> Cross-references
+
+<li> Endnotes
+
+<li> Extended characters (foreign language/accented, math, Greek - not linedrawing),
+ but some of them badly.
+
+<li> Filename
+
+<li> Flush-right text
+
+<li> Footnotes
+
+<li> Hard page breaks
+
+<li> Hard returns
+
+<li> Headers and footers
+
+<li> Indenting
+
+<li> Newspaper-style columns (using <tt>multicol.sty</tt>)
+
+<li> Page number set
+
+<li> Page numbers
+
+<li> Tables
+
+<li> Table boxes
+
+<li> Table of contents
+
+<li> Text boxes
+
+<li> Typefaces list follows:
+
+<UL>
+<li> Extra large
+
+<li> Very large
+
+<li> Large
+
+<li> Small
+
+<li> Fine
+
+<li> Superscript
+
+<li> subscript
+
+<li> Italic
+
+<li> Small caps
+
+<li> Bold
+
+<li> Underlined
+
+<li> Double-underlined
+
+<li> RedLine (Only L<sup>A</sup>T<sub>E</sub>X 20e)
+ </UL>
+<p>
+
+<li> Widow Orphan &nbsp;&nbsp; On/Off
+</UL>
+<p>
+ <b>Not</b> converted are all other features for this case.
+
+<p>
+ <H2><A NAME="tth_sEc0.3">
+3</A>&nbsp;&nbsp;The program</H2>
+
+<p>
+The program is invoked with the command:
+
+<p>
+
+<pre>
+ WP2LATEX [/? | /-help]
+ [WP-filename.WP [TeX-filename.TEX]] [/L language]
+ [ /cp895 | /cp852 | /cp1250 ] [/s] [/safemode] [/forceWP4]
+ [ /texchars] [ /charset1 | /charsetCZ ] [/noerase-strip]
+ [ /i WP-filename.WP] [/o TeX-filename.TEX] [/l Log-filename.TXT]
+</pre>
+
+<p>
+<p><br><p><br>Following Unix-like call style is also possible:
+
+<p>
+
+<pre>
+ WP2LATEX [-? | --help]
+ [WP-filename.WP [TeX-filename.TEX]] [-L language]
+ [ -cp895 | -cp852 | -cp1250 ] [-s] [-safemode] [-forceWP4]
+ [ -texchars] [ -charset1 | -charsetCZ ] [-noerase-strip]
+ [ -i WP-filename.WP] [-o TeX-filename.TEX] [-l Log-filename.TXT]
+</pre>
+
+<p>
+ <H3><A NAME="tth_sEc0.3.1">
+3.1</A>&nbsp;&nbsp;Description of command line arguments</H3>
+
+<p>
+ The parameter <tt>WP-filename.WP</tt><a href="#tthFtNtAAC" name="tthFrefAAC"><sup>2</sup></a> is optional.
+The program starts with an opening screen and asks for the WordPerfect
+filename. The default filename is printed inside square brackets
+(<tt>[ ]</tt>) and is the parameter which was optionally included in
+the initial invocation of <tt>WP2LATEX</tt>. The user can at this point type
+in another WordPerfect filename, or he can hit return to choose the default
+filename. The program next requests the name of the generated L<sup>A</sup>T<sub>E</sub>X&nbsp;document. The default given within brackets is the name of the
+WordPerfect file, with the extension <tt>.TEX</tt> or
+<tt>TeX-filename.TEX</tt> passed as second argument. Once again the user
+may accept this name or enter another<a href="#tthFtNtAAD" name="tthFrefAAD"><sup>3</sup></a>. Once the filenames are given, the
+following error messages may appear :
+
+<p>
+
+<UL>
+<li> The given WordPerfect file does not exist.
+
+<li> An invalid path was given in the name
+ of one of the files.
+
+<li> The given WordPerfect
+ file was not created in WordPerfect 5.x
+
+<li> The documents written in WP 6.0 are handled badly, because code is not finished. If you want
+ to do this, contact me.
+</UL>
+<p>
+Arguments <tt>/cp895</tt> ; <tt>/cp1250</tt> or <tt>/cp852</tt> are used for 8. bit T<sub>E</sub>X, which is able
+to process some of these code pages. The codepage <tt>/cp895</tt> is called as
+Kamenict&#237; and is often used in central Europe. The codepage
+<tt>/cp895</tt> (ISO8) is preferred in DOS for central Europe and
+the codepage <tt>/cp1250</tt> is designed for central Europe Windows.
+
+<p>
+If you try to convert documents from WP version 4.x then tis program normally
+says that you have no WP file. The reason is that WP 4.x format gives no chance
+for autodetection. If you are sure that you have a WP 4.x file turn the
+switch <tt>-forceWP4</tt> on.
+
+<p>
+There are available several types of coding accented characters.
+It is too bad. I guess that coding char set 1 is most common.
+Thus switch <tt>/charset1</tt> is default set.
+If user wants to switch to the another coding, he should add switch
+<tt>/charsetCZ</tt>. But I have no available description of this coding
+and only several characters will be converted properly.
+
+<p>
+Switch <tt>/L language</tt> turns on the translation features. These features
+are based on the gettext library, which must be properly installed.
+This means, that the system variable <tt>LOCALEDIR</tt> should be properly
+set. If not, then the program <tt>wp2latex</tt> looks for the file referred in
+the <tt>DJGPP</tt> and attempts to find the description of <tt>LOCALEDIR</tt>.
+The system variable <tt>LANGUAGE</tt> has same meaning, but the
+command line switch has stronger influence.
+
+<p>
+Switch <tt>/noerase-strip</tt> is intended for debugging purposes. The program
+do not erase all temporary files so you can analyze them later.
+
+<p>
+If you turn the switch <tt>-safemode</tt> on, you can convert even corrupted WP
+wiles which hang WordPerfect well. All internal objects are tested and
+corrupted ones are digged out. If you don't want this feature then omit this
+switch. Do not expect better conversion from this feature.
+In most cases it only slow down a conversion. But if your documents are really
+corrupted, the conversion results may be better due to fixing errors.
+
+<p>
+Switch <tt>/texchars</tt> allows using WordPerfect as a T<sub>E</sub>X&nbsp;editor. If this switch
+is active, then controlling T<sub>E</sub>X&nbsp;sequences are not distorted and
+you can add for example new equation (in the WP equation editor),
+which will be converted.
+
+<p>
+If you want to use some switch very often, it is possible to set a system variable
+<tt>wp2latex</tt>. This variable is read before a command line is processed.
+For example you may want to set output codepage 895 and language
+CS. <tt>wp2latex=-cp985 -L cs</tt>.
+
+<p>
+ <H3><A NAME="tth_sEc0.3.2">
+3.2</A>&nbsp;&nbsp;Program Behaviour</H3>
+
+<p>
+The conversion takes place in two passes. In the first pass the WordPerfect
+input-file is read in, byte by byte. On the basis of that are created two
+files, <tt>WP-filename.STR</tt> and <tt>WP_filename.TBL</tt>.
+<tt>WP-filename.STR</tt> contains the characters, tab settings and changes of
+typefaces; <tt>WP-filename.TBL</tt> holds information regarding the various
+L<sup>A</sup>T<sub>E</sub>X&nbsp;environments that must be opened and closed. In the second pass these
+files are assimilated into a single L<sup>A</sup>T<sub>E</sub>X&nbsp;file. After a successful
+conversion the files <tt>WP-filename.STR</tt> and <tt>WP-filename.TBL</tt> are
+automatically deleted.
+
+<p>
+Invoking </b>W P2L<sup>A</sup>T<sub>E</sub>X to convert the WordPerfect 5.0 document
+<tt>C:\WPTEST\TEST.WP5</tt> will cause the following screen to appear:
+
+<p>
+
+<pre>
+
+ Conversion program : From Wordperfect 5.0 to LaTeX Version 2.41 (WP2LATEX)
+
+ (c) TUE-Eindhoven ---- Made by R.C.Houtepen ---- Date : 24 Jan 1990
+ (c) CVUT Prague ---- Made by J.Fojtik ---- Date : 1996 - 1998
+
+
+WordPerfect-filename [ ] : c:\wptest\test.wp5
+LaTeX-filename [c:\wptest\test.TEX] :
+
+Converting ...
+
+First pass :
+Converting-percentage : 100%
+
+Second pass :
+Converting-percentage : 100%
+
+Conversion completed.
+
+</pre>
+
+<p>
+The first line of the generated L<sup>A</sup>T<sub>E</sub>X&nbsp;file, in the case of the file
+<tt>C:\WPTEST\TEST.TEX</tt>, will look as follows:
+
+<p>
+
+<pre>
+ \documentstyle[11pt,wp2latex]{report}
+</pre>
+
+<p>
+When calling L<sup>A</sup>T<sub>E</sub>X&nbsp;to typeset the converted document, the style file
+<tt>WP2LATEX.STY</tt> should be in the current directory or in the style-file
+directory (e.g., <tt>\PCTEX\TEXINPUT</tt>).
+This style file defines a number of macros and environments which are
+regularly used in the generated L<sup>A</sup>T<sub>E</sub>X&nbsp;files. Examples include the command
+<tt>\vspace{\baselineskip}</tt> and the <tt>indenting</tt> environment. <tt>\vspace{\baselineskip}</tt> generates a
+hard carriage return after the end of a L<sup>A</sup>T<sub>E</sub>X-environment. The
+<tt>indenting</tt> environment is used in the conversion of WordPerfect's
+<tt>[</tt><font face=symbol>®</font
+><tt>Indent]</tt> command (see &#167;&nbsp;).
+
+<p>
+ <H2><A NAME="tth_sEc0.4">
+4</A>&nbsp;&nbsp;How to install</H2>
+
+<p>
+ <H3><A NAME="tth_sEc0.4.1">
+4.1</A>&nbsp;&nbsp;Under DOS and OS/2</H3>
+
+<p>
+You should place properly four files: <tt>wp2latex.exe</tt>, <tt>wp2latex.sty</tt>
+<tt>endnotes.sty</tt> and <tt>wp2latex.mo</tt>.
+
+<p>
+Place the file <tt>wp2latex.exe</tt> somewhere into your path. The good solution
+is to place it to <tt>c:\emtex\</tt> etc.
+
+<p>
+The path for files <tt>wp2latex.sty</tt> and <tt>endnotes.sty</tt> should be
+available in the system variable <tt>texinput</tt>. A good solution is to place them
+to <tt>c:\emtex\texinput\</tt>.
+
+<p>
+The last step is not required for proper behaviour of the program <tt>wp2latex</tt>.
+It the last file is not placed, then your program will not be abble to translate
+output messages to your language (if the translation is available of course).
+Merge the directory e.g. <tt>c:\gnu\share\locale\</tt> with <tt>doc\locale\</tt>.
+Or you may have translations in the directory referred in the system
+variable <tt>localedir</tt>.
+
+<p>
+ <H3><A NAME="tth_sEc0.4.2">
+4.2</A>&nbsp;&nbsp;Under Linux</H3>
+
+<p>
+The installation is very easy. Change to the directory sources.cc and type
+<tt>make install</tt>. It is all.
+
+<p>
+ <H2><A NAME="tth_sEc0.5">
+5</A>&nbsp;&nbsp;Discussion about conversion reliability</H2>
+
+<p>
+When I started to contribute to this convertor, I have read that after
+conversion somebody must use several filters and special program to make a nice
+L<sup>A</sup>T<sub>E</sub>X&nbsp;output.
+<font size="-2"> <i>I have translated a huge WP file (about 1MB text) with a lot of
+footnotes but no tables and formulas. To get a nice LaTeX format I wrote about 5 C-programs and about
+40 sed-lines to convert some ugly formattings. After this I spend some time with manual editing.
+At last I wrote a LaTeX-style for a nice looking document.
+The whole procedure took me three days.</i></font>
+It was too bad! I hope, that this is not true with a current release.
+
+<p>
+So I expect that the conversion should be done better. Thus I started to
+improve convertor. Now it is something like AI (Artificial Intelligence)
+project and the results are not excellent. Why?
+
+<p>
+
+<OL type="1">
+<li> Conversions performed by </b>W P2L<sup>A</sup>T<sub>E</sub>X are only partial and some features
+ are ignored.
+
+<li> In WordPerfect document are some unwanted
+ codes (such as [Tab], [Tab Set], [indent] instead [Tab] etc.) I advise you
+ to use [Tab] as small as possible.
+
+<li> Word Perfect allow anybody to do some terrible
+ thinks which are in L<sup>A</sup>T<sub>E</sub>X&nbsp;prohibited. For example
+ <tt>\section{Some sect\tableofcontents ion}</tt>. Many of them have been founded
+ and fixed but I guess that number of such situations is very big.
+</OL>
+<p>
+But don't worry so much. If your document is simple, you can use converted
+L<sup>A</sup>T<sub>E</sub>X&nbsp;file immediately with only minor changes. If your document become
+complex, then you must check conversion results more carefully.
+It is a good idea to print a converted file and compare it with original one.
+
+<p>
+If you expect, that something is removed from your document you can
+try <tt>-l logfile.txt</tt> option to see a list of all WP objects.
+
+<p>
+ <H2><A NAME="tth_sEc0.6">
+6</A>&nbsp;&nbsp;Guidelines</H2>
+
+<p>
+ <H3><A NAME="tth_sEc0.6.1">
+6.1</A>&nbsp;&nbsp;Tabbing</H3>
+
+<p>
+Tab settings allow the exact placement of pieces of text, e.g., for creating
+tables. There are two sorts of commands involved here. First, there is the
+setting of tabs; this defines <em>where</em> subsequent tab-stop commands will
+place text. Then there are the tabs themselves, which force a <em>jump</em> to
+one of the previously-defined positions. In L<sup>A</sup>T<sub>E</sub>X , however, tabs
+are enabled only within a <tt>tabbing</tt> environment. </b>W P2L<sup>A</sup>T<sub>E</sub>X takes
+care of that by invoking a <tt>tabbing</tt> environment only for those lines
+where one or more tabs appear.
+
+<p>
+Within WordPerfect, a line containing tabs must terminate with a hard
+carriage return. If this is not the case, the tab positions in the generated
+L<sup>A</sup>T<sub>E</sub>X-document will not be fixed. L<sup>A</sup>T<sub>E</sub>X&nbsp;will incorrectly typeset the
+spacing of such lines.
+
+<p>
+The following WordPerfect text will be incorrectly converted:
+
+<p>
+
+<pre>
+ Text1 [Tab] text2 [Tab] text3 [SRt]
+ text4 [Tab] text5. [HRt]
+</pre>
+
+<p>
+The following is better:
+
+<p>
+
+<pre>
+ Text1 [Tab] text2 [Tab] text3 [HRt]
+ text4 [Tab] text5. [HRt]
+</pre>
+
+<p>
+A tab-setting in the middle of a line holds for the entire line in the
+converted document (unlike in WordPerfect). It is
+therefore advisable to set tabs at the beginning of or prior to the
+pertinent line.
+
+<p>
+<p><br><b>Few restrictions:</b>
+
+<p>
+L<sup>A</sup>T<sub>E</sub>X&nbsp;endows such commands as <tt>\'</tt>, <tt>\`</tt> and <tt>\=</tt> with special
+meanings within a <tt>tabbing</tt> environment. Outside a <tt>tabbing</tt>
+environment, these commands are used for the placement of accents; within
+one, however, they must be replaced by <tt>\a'</tt>, <tt>\a`</tt> and <tt>\a=</tt>,
+respectively. </b>W P2L<sup>A</sup>T<sub>E</sub>X does not perform this replacement, so it is
+left to the user to do it after the conversion.
+
+<p>
+WordPerfect 5.0 allows up to 40 tabstops to be set. L<sup>A</sup>T<sub>E</sub>X&nbsp;can set at most
+14 of them. As a result, if tabs are to be converted properly, the user may
+set no more than 14 tabstops within WordPerfect, either. If more than 14
+tabs are set, processing by L<sup>A</sup>T<sub>E</sub>X&nbsp;will result in a number of error messages,
+and ultimately one or more tabs may be lost.
+
+<p>
+ <H3><A NAME="tth_sEc0.6.2">
+6.2</A>&nbsp;&nbsp;Indenting</H3>
+<A NAME="indent">
+</A>
+
+<p>
+Indenting is used to alter the margins of pieces of text (paragraphs).
+Possible conversions with regard to indenting commands are :
+
+<p>
+<p><br>Examples :
+
+<p>
+<tt> [</tt><font face=symbol>®</font
+><tt>Indent]</tt><sup>*</sup><tt> </tt>&#175;
+ <tt>An indented paragraph which [SRt]</tt> <br>
+ &nbsp;<tt>extends over several lines and [SRt]</tt> <br>
+ &nbsp;<tt>is closed with a hard carriage [SRt]</tt> <br>
+ &nbsp;<tt>return. [HRt]</tt> <br>
+
+<p>
+<tt> label [</tt><font face=symbol>®</font
+><tt>Indent]</tt><sup>*</sup><tt> </tt>
+ &#175; <tt>We see here the possibility of [SRt]</tt> <br>
+ &nbsp;<tt>placing a `label' in front of [SRt]</tt> <br>
+ &nbsp;<tt>indented text. [HRt]</tt> <br>
+
+<p>
+<tt> [</tt><font face=symbol>®</font
+><tt>Indent]</tt><sup>*</sup><tt> label [</tt>
+<font face=symbol>®</font
+><tt>Indent]</tt><sup>*</sup><tt> </tt>
+ &#175; <tt>It is also possible to place [SRt]</tt> <br>
+ &nbsp;<tt>an `indented label' in front [SRt]</tt> <br>
+ &nbsp;<tt>of indented text. [HRt]</tt> <br>
+
+<p>
+ where <tt>[</tt><font face=symbol>®</font
+><tt>Indent]</tt><sup>*</sup> indicates one or more
+<tt>[</tt><font face=symbol>®</font
+><tt>Indent]</tt> commands.
+
+<p>
+ The indenting consists from three commands:<br>
+<tt>\testlastline</tt><br>
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; This T<sub>E</sub>X command replaces a <tt>\par</tt> command. But
+moreover it measure the length of the last paragraph line.
+
+<p>
+A command <tt>\zerolastline</tt> assumes that the size of the last
+paragraph line is zero.
+
+<p>
+A L<sup>A</sup>T<sub>E</sub>X environment <tt>indenting</tt> is used to indent a text.
+In current release the limitation of two indents is broken, but
+you cannot combine indents and tabs together.
+
+<p>
+ <H3><A NAME="tth_sEc0.6.3">
+6.3</A>&nbsp;&nbsp;Combinations of tabbing and indenting</H3>
+
+<p>
+In practice it is evident that tabbing and indenting commands are often
+used together. The effect of that within WordPerfect is often identical:
+words come out on the page where one wishes, on the screen as well
+as on paper (What You See Is What You Get).
+
+<p>
+In L<sup>A</sup>T<sub>E</sub>X, however, the difference between tabs and indents is fundamental.
+It is important that the WordPerfect-user take this into account. Thus only
+the <tt>[Tab]</tt> command may be used for tabbing and only the
+<tt>[</tt><font face=symbol>®</font
+><tt>Indent]</tt> command for indenting. If both tabbing and
+indenting commands are used within a single line, only the type which is
+encountered first will be converted.
+
+<p>
+An example:
+
+<tt> [Tab] tom [Tab] dick [</tt><font face=symbol>®</font
+><tt>Indent] harry [HRt]</tt> <br>
+
+<p>
+The tab command in this line comes before the indenting command. The
+interpretation by </b>W P2L<sup>A</sup>T<sub>E</sub>X is then:
+
+<tt> [Tab] tom [Tab] dick harry [HRt]</tt>
+
+<p>
+The indent-command is eliminated. The line should instead look as follows:
+
+<tt> [Tab] tom [Tab] dick [Tab] harry [HRt]</tt>
+
+<p>
+ <H3><A NAME="tth_sEc0.6.4">
+6.4</A>&nbsp;&nbsp;Footnotes &amp; Endnotes</H3>
+
+<p>
+Within a footnote only carriage returns and typefaces (see
+&#167;&nbsp;<A href="#capabilities">0.2</A>) are converted. A footnote number may
+consist only of numerals.
+
+<p>
+Footnotes within lines which contain tab settings will not appear at the bottom
+of the page; L<sup>A</sup>T<sub>E</sub>X, in contrast to WordPerfect, does not process them. This
+is a limitation (read: bug) of L<sup>A</sup>T<sub>E</sub>X.
+
+<p>
+Endnotes are processed similarly as footnotes. Moreover an additional style
+<tt>endnotes.sty</tt> must be present in T<sub>E</sub>X&nbsp;path for styles.
+If you don't use endnotes in your WP document, the style
+<tt>endnotes.sty</tt> is not required.
+
+<p>
+ <H3><A NAME="tth_sEc0.6.5">
+6.5</A>&nbsp;&nbsp;Headers and footers</H3>
+
+<p>
+Within a header or footer a number of converted features is
+reduced (see &#167;&nbsp;<A href="#capabilities">0.2</A>).
+
+<p>
+One can split a header or footer into three pieces :
+
+<UL>
+<li> left-aligned
+
+<li> centered
+
+<li> right-aligned
+</UL>
+<p>
+ These three parts are separated within WordPerfect by using the centering
+command (Shift F6) and the flush-right command (Alt F6).
+
+<p>
+The effect of the WordPerfect commands in the header
+
+<p>
+
+<pre>
+ Left[Cntr]Middle[C/A/Flrt][Flsh Rt]Right[C/A/Flrt]
+</pre>
+
+<p>
+will, after conversion to L<sup>A</sup>T<sub>E</sub>X&nbsp;format, be interpreted as is shown in
+figure&nbsp;. Choosing a new setting for the placement
+of header or footer text on only even (or only odd) pages does not affect
+the alternate pages' previous setting.
+
+<p>
+
+<p><A NAME="tth_fIg0.1">
+</A> <center><br>Picture Omitted<br> <center> Figure 1: headers</center>
+<A NAME="fig:header">
+</A>
+</center><p>
+<p>
+ <H3><A NAME="tth_sEc0.6.6">
+6.6</A>&nbsp;&nbsp;Page number positioning</H3>
+
+<p>
+The WordPerfect document is converted to a single-sided document. This
+means that page number positions 4 and 8 are not converted. The page
+number positions which </b>W P2L<sup>A</sup>T<sub>E</sub>X will convert are reproduced in
+figure&nbsp;.
+
+<p>
+
+<p><A NAME="tth_fIg0.2">
+</A> <center><br>Picture Omitted<br> <center> Figure 2: page number positions</center>
+<A NAME="fig:pagnr">
+</A>
+</center><p>
+<p>
+ <H3><A NAME="tth_sEc0.6.7">
+6.7</A>&nbsp;&nbsp;WordPerfect default values</H3>
+
+<p>
+The conversion program generates, independently of the WordPerfect settings,
+a L<sup>A</sup>T<sub>E</sub>X&nbsp;document with a left margin of 1 inch (2.54cm). This is because
+L<sup>A</sup>T<sub>E</sub>X&nbsp;enforces left and top margins of at least 1 inch (see
+figure&nbsp;). </b>W P2L<sup>A</sup>T<sub>E</sub>X therefore assumes that the margins
+in the WordPerfect document are also set to 1 inch and that they do not
+change.
+
+<p>
+Tabs are set every inch by default (14 tab stops). A different default
+tab-setting can be placed at the first line. If the standard, one-inch
+default settings are not used, however, processing by L<sup>A</sup>T<sub>E</sub>X&nbsp;may produce
+error messages. This has more to do with the manner in which WordPerfect
+positions tab-stops than it does with L<sup>A</sup>T<sub>E</sub>X (see figure&nbsp;).
+L<sup>A</sup>T<sub>E</sub>X&nbsp;positions tab stops relative to the left margin, which, as mentioned
+above, is a minimum of 1 inch wide. In WordPerfect the left margin and the
+tab settings are independent of each other.
+
+<p>
+
+<p><A NAME="tth_fIg0.3">
+</A> <center><br>Picture Omitted<br> <center> Figure 3: tab settings in WordPerfect and L<sup>A</sup>T<sub>E</sub>X </center>
+<A NAME="fig:tabs">
+</A>
+</center><p>
+<p>
+ <H3><A NAME="tth_sEc0.6.8">
+6.8</A>&nbsp;&nbsp;Spaces</H3>
+
+<p>
+Because WordPerfect works well as tool for the visual design of a document,
+users often have the tendency to use spaces to produce an acceptable layout.
+Multiple spaces within L<sup>A</sup>T<sub>E</sub>X, however, have the same effect as a single
+space. Therefore, in converting a WordPerfect document, multiple spaces are
+changed into `hard' L<sup>A</sup>T<sub>E</sub>X-spaces.
+
+<p>
+For example:
+
+<p>
+
+<TaBle border>
+<tr><td>WordPerfect </td><td>L<sup>A</sup>T<sub>E</sub>X </td>
+<tr><td><tt>word1 word2</tt> </td><td><tt>word1 ~~~word2</tt> </td></TaBle>
+
+
+<p>
+When these come at the beginning of a line, however, they have no effect.
+Moreover, the layout which existed in the WordPerfect environment will seldom
+be properly achieved in L<sup>A</sup>T<sub>E</sub>X, because of the different typographic rules,
+typefaces and text-spacing that the latter handles.
+
+<p>
+<b>Note:</b> This feature produces typografically incorrect things and
+thus it is implicitly turned off. If you want to turn it on, then use switch
+<tt>-fix-spaces</tt>.
+
+<p>
+ <H3><A NAME="tth_sEc0.6.9">
+6.9</A>&nbsp;&nbsp;Equations</H3>
+
+<p>
+Because of the philosophy of typing an equations in WP is very similar
+to T<sub>E</sub>X &nbsp;conversion is not so difficult. The Math is written in both cases
+in text notation, but in WP is enveloped into the object [Equ Box:nn;;].
+This convertor is also able to translate Greek characters, symbols and
+matrixes included in equations.
+ The convertor normally generates environment <b>displaymath</b>.
+If it is not possible (e.g. in the case of tables), then it generates
+environment $ $. Sometimes you should correct equations manually.
+
+<p>
+<p><br>Example (of some simple equation):
+
+<p>
+WP equation string:
+<p><br>
+" a= 1/4+{4^5} over {2+x^5} + 1 over {2 + 3 over {4+y}}
+ 5 SQRT {68+x^e over 5} &#126; + &#126; NROOT {r+6}{8} "
+
+<p>
+<p><br>T<sub>E</sub>X equation string:
+" a= 1/4+<tt>\</tt>frac{{4^5}}{{2+x^5}} +<tt>\</tt>frac{1}{{2
+ + <tt>\</tt>frac{3}{{4+y}}}} - 5 <tt>\</tt>sqrt {{68+x^
+ <tt>\</tt>frac{e}{5}}} &#126; + &#126; <tt>\</tt>sqrt [ {r+6} ] { 8} "
+
+<p>
+<p><br>And correctly displayed equation follows:
+
+<centEr><table border=0 align=center><tr><td>
+<Table align=left><tr><td nowrap align=center>
+a = 1/4+</td><td nowrap align=center>
+4<sup>5</sup><hr NOSHADE>2+x<sup>5</sup><Br></td><td nowrap align=center>
++</td><td nowrap align=center>
+1<hr NOSHADE><tabLe border=0><tr><td nowrap align=center>
+2 +</td><td nowrap align=center>
+3<hr NOSHADE>4+y<Br></td></tabLe></td><td nowrap align=center>
+- 5 </td><td align=left class="cl"><br><font face=symbol size="+2">Ö</font><br>&nbsp;<br></td><td nowrap align=center>
+<hr NOSHADE>68+x<sup><sup>e</sup>/<sub>5</sub></sup><Br>&nbsp;<br></td><td nowrap align=center>
+&nbsp; + &nbsp; </td><td align=right class="cr">
+<font size="-3">r+6 </font><font face=symbol size="+0">æ<br>Ö <br>
+</font></td><td nowrap align=center>
+<hr NOSHADE>8<Br>&nbsp;<br></td><td nowrap align=center>
+</td></Table>
+</td></table></centEr>
+
+
+
+<p>
+ <H3><A NAME="tth_sEc0.6.10">
+6.10</A>&nbsp;&nbsp;Tables</H3>
+
+<p>
+The </b>W P2L<sup>A</sup>T<sub>E</sub>X is also able to convert a tables. It converts
+style of centering of columns. It do not recognize
+all WP features such as special dotted cells, and double lines somewhere.
+Thus an line art from tables will not be converted well.
+A size of columns is not converted.
+
+<p>
+<p><br>Table looking like this in WP:
+
+<pre>
+[Tbl Def:I;3,5.31cm,5.31cm,5.31cm]
+[Row] [Cell] Left Centered [Cell] Center [Cell] Right Centered
+[Row] [Cell] 111 [Cell] 222 [Cell] 333 Centered
+[Tbl Off]
+</pre>
+
+<p>
+<p><br>Is converted to:
+
+
+<TaBle border>
+<tr><td>Left centered </td><td align="center">Center </td><td align="right">Right centered </td>
+<tr><td>111 </td><td align="center">222 </td><td align="right">333 </td></TaBle>
+
+
+<p>
+ <H2><A NAME="tth_sEc0.7">
+7</A>&nbsp;&nbsp;Warning and Error messages</H2>
+
+<p>
+This section discusses all warning runtime output messages.
+
+<p>
+Errors:
+
+<UL>
+<li> This is a bug. Please report.
+
+<li> The given WordPerfect file does not exist.
+
+<li> You probably port this program to another compiler. Some variables
+ must have a unique size and thus you should fix it in the file
+ types.h.
+
+<li> An error occured while writing a .LOG file. This may be a device
+ error e.g. device is full.
+
+<li> The given WordPerfect file was not created in the WordPerfect 5.x
+ or WordPerfect 6.0.
+
+<li> There are two possible problems. Eighter your WordPerfect file is
+ corrupted or some object is not recognized correctly. If you are sure
+ that your file is healthy report this may be a bug.
+
+<li> An invalid path was given in the name of one of the files.
+
+<li> This is a bug. Please report.
+</UL>
+<p>
+Warnings:
+
+<UL>
+<li> The log file cannot be opened. The program will continue normally
+ without logging anything.
+
+<li> This is a problem of your document. Found [Tab] is useless and is
+ ruled out.
+
+<li> The documents written in WP 6.0 are handled badly, because code is not finished. If you want
+ to do this, contact me.
+
+<li> You passed something wrong on your command line. Read this manual more carefully.
+</UL>
+<p>
+ <H2><A NAME="tth_sEc0.8">
+8</A>&nbsp;&nbsp;The package</H2>
+
+<p>
+The </b>W P2L<sup>A</sup>T<sub>E</sub>X package contains the following files :
+
+<p>
+
+<DL compact> <dt><b></b></dt>
+ <dd> <tt>MAKEFILE</tt> (The root makefile for wp2latex package.)
+ <dt><b></b></dt>
+ <dd> <tt>README.1ST</tt> (The file with basic instructions- abbreviated description of this program.)
+ <dt><b></b></dt>
+ <dd> <tt>README.TXT</tt> (The main readme file for advertising this program.)
+ <dt><b></b></dt>
+ <dd> <tt>WP2LATEX.FAQ</tt> (File with ansvers to frekvently asked questions.)
+ <dt><b></b></dt>
+ <dd> <tt>WP2LATEX.TEX</tt> (This user's guide.)
+
+<p>
+ <dt><b></b></dt>
+ <dd>
+
+<p>
+ <dt><b></b></dt>
+ <dd> <tt>STYLES.TEX\BoxedEPSF.TEX</tt> (Additional style for including PS images.
+)
+ <dt><b></b></dt>
+ <dd> <tt>STYLES.TEX\ENDNOTES.STY</tt> (Additional style for processing endnotes in L<sup>A</sup>T<sub>E</sub>X\.)
+ <dt><b></b></dt>
+ <dd> <tt>STYLES.TEX\CYRACC.DEF</tt> (Additional package for including cyrillic characters
+ into L<sup>A</sup>T<sub>E</sub>X&nbsp;document.)
+ <dt><b></b></dt>
+ <dd> <tt>STYLES.TEX\CYRILLIC.STY</tt> (Additional style for including cyrillic characters
+ into L<sup>A</sup>T<sub>E</sub>X&nbsp;document - uses CYRACC.DEF.)
+ <dt><b></b></dt>
+ <dd> <tt>STYLES.TEX\InputPS.STY</tt> (Additional style for including PS images.
+)
+ <dt><b></b></dt>
+ <dd> <tt>STYLES.TEX\WP2LATEX.STY</tt> (Style file needed by L<sup>A</sup>T<sub>E</sub>X&nbsp;for processing.)
+ <dt><b></b></dt>
+ <dd> <tt>STYLES.TEX\WASYFONT.STY</tt> (Additional style for including characters from wasy2 font into L<sup>A</sup>T<sub>E</sub>X\.)
+
+<p>
+ <dt><b></b></dt>
+ <dd>
+
+<p>
+ <dt><b></b></dt>
+ <dd> <tt>SOURCES.CC\</tt> (The directory with C++ sources.)
+ <dt><b></b></dt>
+ <dd> <tt>SOURCES.CC\FORMULAS.CC</tt> (Procedures for converting formulas.)
+ <dt><b></b></dt>
+ <dd> <tt>SOURCES.CC\CHARACTR.CC</tt> (Procedures for converting extended WP characters.)
+ <dt><b></b></dt>
+ <dd> <tt>SOURCES.CC\IGETTEXT.CC</tt> (Procedures for initialize gettext translation features.)
+ <dt><b></b></dt>
+ <dd> <tt>SOURCES.CC\MAKEFILE</tt> (Makefile for C++ version under both DJGPP and Linux.)
+ <dt><b></b></dt>
+ <dd> <tt>SOURCES.CC\PASS1.CC</tt> (common procedures needed for all WP convertors during 1st pass.)
+ <dt><b></b></dt>
+ <dd> <tt>SOURCES.CC\PASS1_4.CC</tt> (procedures for PASS1 for WP version 4.x)
+ <dt><b></b></dt>
+ <dd> <tt>SOURCES.CC\PASS1_5.CC</tt> (procedures needed for PASS1 for WP version 5.x.)
+ <dt><b></b></dt>
+ <dd> <tt>SOURCES.CC\PASS1_6.CC</tt> (procedures for PASS1 for WP version 6.x (and also 7.x) )
+ <dt><b></b></dt>
+ <dd> <tt>SOURCES.CC\PASS2.CC</tt> (procedures for PASS2)
+ <dt><b></b></dt>
+ <dd> <tt>SOURCES.CC\WP2LATEX.CC</tt> (main part of </b>W P2L<sup>A</sup>T<sub>E</sub>X)
+ <dt><b></b></dt>
+ <dd> <tt>SOURCES.CC\WP2LATEX.H</tt> (main include file for all components of </b>W P2L<sup>A</sup>T<sub>E</sub>X.)
+ <dt><b></b></dt>
+ <dd> <tt>SOURCES.CC\ATOMS\INCLUDE\COMMON.H</tt> (Include file with some compiler specific commands.)
+ <dt><b></b></dt>
+ <dd> <tt>SOURCES.CC\ATOMS\LISTS.CC</tt> (Collection of procedures for operations with lists of text.)
+ <dt><b></b></dt>
+ <dd> <tt>SOURCES.CC\ATOMS\INCLUDE\LISTS.H</tt> (The include file for tool LISTS.CC.)
+ <dt><b></b></dt>
+ <dd> <tt>SOURCES.CC\ATOMS\SETS.CC</tt> (Collection of procedures for operations with sets.)
+ <dt><b></b></dt>
+ <dd> <tt>SOURCES.CC\ATOMS\INCLUDE\SETS.H</tt> (The include file for tool SETS.CC.)
+ <dt><b></b></dt>
+ <dd> <tt>SOURCES.CC\ATOMS\STRINGS.CC</tt> (Collection of procedures for operations with strings.)
+ <dt><b></b></dt>
+ <dd> <tt>SOURCES.CC\ATOMS\INCLUDE\STRINGS.H</tt> (The include file for tool STRINGS.CC.)
+ <dt><b></b></dt>
+ <dd> <tt>SOURCES.CC\ATOMS\STRUCT.CC</tt> (Procedures for endian conversion of multi-byte numbers.)
+ <dt><b></b></dt>
+ <dd> <tt>SOURCES.CC\ATOMS\INCLUDE\TYPES.H</tt> (This include file provides fixed size numbers like BYTE, WORD, DWORD.)
+
+<p>
+ <dt><b></b></dt>
+ <dd>
+
+<p>
+ <dt><b></b></dt>
+ <dd> <tt>SOURCES.PAS\</tt> (The directory with the original Turbo Pascal 7.0 sources)
+ <dt><b></b></dt>
+ <dd> <tt>SOURCES.PAS\COMMON.PAS</tt> (Commonly used procedures)
+ <dt><b></b></dt>
+ <dd> <tt>SOURCES.PAS\FORMULAS.PAS</tt> (Unit for converting of formulas)
+ <dt><b></b></dt>
+ <dd> <tt>SOURCES.PAS\PASS1.PAS</tt> (procedures for PASS1)
+ <dt><b></b></dt>
+ <dd> <tt>SOURCES.PAS\PASS1_6.PAS</tt> (experimental procedures for PASS1 for WP version 6.0)
+ <dt><b></b></dt>
+ <dd> <tt>SOURCES.PAS\PASS2.PAS</tt> (procedures for PASS2)
+ <dt><b></b></dt>
+ <dd> <tt>SOURCES.PAS\WP2LATEX.PAS</tt> (main part of </b>W P2L<sup>A</sup>T<sub>E</sub>X)
+
+<p>
+ <dt><b></b></dt>
+ <dd>
+
+<p>
+ <dt><b></b></dt>
+ <dd> <tt>DOS\WP2LATEX.EXE</tt> (the conversion program DOS executable)
+ <dt><b></b></dt>
+ <dd> <tt>OS2\WP2LATEX.EXE</tt> (the conversion program OS/2 executable)
+ <dt><b></b></dt>
+ <dd> <tt>LINUX\WP2LATEX</tt> (the conversion program Linux ELF executable)
+ <dt><b></b></dt>
+ <dd> <tt>WIN\WP2LATEX.EXE</tt> (the conversion program MS Windows executable)
+
+<p>
+ <dt><b></b></dt>
+ <dd> <tt>DOC\</tt> (The directory with documentation texts.)
+ <dt><b></b></dt>
+ <dd> <tt>DOC\BUG.TXT</tt> (The description of known bugs. Please consult this file first before you
+ will report anything.)
+ <dt><b></b></dt>
+ <dd> <tt>DOC\WP2LTX.TEX</tt> ( Dutch (original) version of the user's guide - now obsolete)
+ <dt><b></b></dt>
+ <dd> <tt>DOC\WP2LATEX.1</tt> (Man page for WP2LATEX program.)
+
+<p>
+ <dt><b></b></dt>
+ <dd> <tt>TEST\</tt> (The directory with testing WordPerfect files.)
+ <dt><b></b></dt>
+ <dd> <tt>TEST\TEST.WP</tt> (WP test file with mix of features)
+ <dt><b></b></dt>
+ <dd> <tt>TEST\CHARACTR.WP</tt> (WP test file with all WP charsets)
+</DL>
+<p>
+Four executable files are supported. One for real mode MSDOS, second
+for MSWindows, third for Linux and fourth for protected DOS DJGPP.
+All versions work in text mode. Using of DPMI (protected mode) version is not
+advised, because the memory requirements of this program are too small
+to do this.
+
+<p>
+ <H3><A NAME="tth_sEc0.8.1">
+8.1</A>&nbsp;&nbsp;Re-compilation of the code</H3>
+
+<p>
+Because the </b>W P2L<sup>A</sup>T<sub>E</sub>X is distributed with source code you can solve to recompile
+all code. Recompilation is easy for supported systems: DJGPP and Linux.
+(May be Solaris, but I tested it only several times.)
+
+<p>
+<p><br><p><br>Enter a command <tt>make</tt> in the source directory <tt>sources.cc</tt>
+
+<p>
+<tt>prompt:&#62;make</tt> Enter
+
+<p>
+After this command all source code should be completelly rebuild.
+The program is without syntaktical bugs because I will never release
+new code without testing it.
+
+<p>
+
+<H4>Support for gettext library</H4>
+
+<p>
+This feature allows to internationalize programs by translating their
+messages into your native language. The code of </b>W P2L<sup>A</sup>T<sub>E</sub>X was modified
+to support this library. If you do not have it, comment the line
+<tt>GETTEXT=-D__gettext__</tt> in the <tt>makefile</tt>. Othervise you will
+not abble to succesfully compile.
+
+<p>
+
+<pre>
+# Uncomment next line for allowing a gettext multilanguage translation features
+# This feature is not required for succesfull run of WP2LaTeX.
+GETTEXT=-D__gettext__
+</pre>
+
+<p>
+
+<H4>Debugging version of </b>W P2L<sup>A</sup>T<sub>E</sub>X</H4>
+
+<p>
+If you have problems with run of the </b>W P2L<sup>A</sup>T<sub>E</sub>X you can solve to
+create debugging version. The comment in makefile should be
+clear for explanation.
+
+<p>
+
+<pre>
+# Uncomment next line for compile a debugging version of WP2LaTeX
+# DEBUG=-DDEBUG -g
+</pre>
+
+<p>
+The debugging version logs all function calls so that big .LOG file can
+be created. Use this feature only if you really want to debug because
+it slows down all code.
+
+<p>
+ <H2><A NAME="tth_sEc0.9">
+9</A>&nbsp;&nbsp;Conclusion</H2>
+
+<p>
+The 100%-correct conversion of a WordPerfect-document is not guaranteed.
+Error messages can always appear during processing by L<sup>A</sup>T<sub>E</sub>X. Some
+adjustments to the generated L<sup>A</sup>T<sub>E</sub>X&nbsp;file will in many cases be necessary.
+
+<p>
+The following were given the highest priority :
+
+<UL>
+<p>
+
+<li> preventing the loss of text
+
+<li> avoiding program crashes
+</UL>
+<p>
+ Because the sources are included (Turbo Pascal 5.0 format) it should not be
+too difficult modifying the program to convert Wordperfect 5.1 documents,
+provided the WordPerfect file formats are known.
+
+<p>
+The file formats we used for our program were found in the WordPerfect
+5.0 Developer's Toolkit. Most likely such a toolkit is available for version
+5.1 of WordPerfect.
+
+<p>
+If you have remarks or comments regarding the program, you can send them
+to:
+
+<p>
+ Jaroslav Fojt&#237;k<br>
+Email:fojtik@vision.felk.cvut.cz<br>
+ or:fojtik@cmp.felk.cvut.cz
+
+<p>
+<p><br>Post Address:
+Jaroslav Fojtik
+Dvouramenna 13
+Praha 4 - Podoli
+140 00
+Czech Republic
+
+<p>
+<p><br>Before doing this please visit my www page and test recent version:<br>
+<a href="http://www.penguin.cz/~fojtik/">
+http://www.penguin.cz/&#126;fojtik/</a>
+
+<p>
+I have found that these address are not currently valid:<br>
+
+<p>
+R.C. Houtepen <br>
+Brusselstraat 150 <br>
+4826 NK Breda <br>
+The Netherlands <br>
+Tel: 076-714777
+
+<p>
+ or
+
+<p>
+<div align=right>R.L.M. Helwig <br>
+Eindhoven University of Technology <br>
+P.O. BOX 513<br>
+5600 MB Eindhoven<br>
+The Netherlands <br>
+Tel: 040 - 472724<br>
+
+<p>
+uucp : rcronh@urc.tue.nl<br>
+bitnet : rcronh@heitue5
+</div>
+<p>
+
+<center>(This page is intentionally left blank for notes.)
+</center>
+<p>
+ <hr><H3>Footnotes:</H3>
+
+<p><a name="tthFtNtAAB"></a><a href="#tthFrefAAB"><sup>1</sup></a> Translated from the Dutch by G. R. Roelofs
+<p><a name="tthFtNtAAC"></a><a href="#tthFrefAAC"><sup>2</sup></a> This may be a WordPefect 5.0
+document with an extension other than <tt>.WP</tt>
+<p><a name="tthFtNtAAD"></a><a href="#tthFrefAAD"><sup>3</sup></a> This may be a file with an
+extension other than <tt>.TEX</tt>
+<p><hr><small>File translated from T<sub><font size="-1">E</font></sub>X by <a href="http://hutchinson.belmont.ma.us/tth/">T<sub><font size="-1">T</font></sub>H</a>, version 2.33.<br>On 4 Aug 1999, 12:34.</small>
+</HTML>