Share Gallery 1/share_gal_1.zip/share_gal_1/WP/WP060.ZIP/README.WPS

Text File | 1991-05-03 | 12KB | 274 lines

                WPSTYLE  -  WordPerfect Style Converter
                                v. 1.02

                  Copyright (C) 1991, Michael J. Huft



GENERAL NOTES ON THE PROGRAM
============================

     WPSTYLE is a program that converts all instances of a type style,
such as BOLD, UNDERLINE, or ITALIC, in a WordPerfect 5.0 or 5.1
document file to another style, or to normal text.

     This is a task that is not easily accomplished within WordPerfect
itself.  Either you must laboriously go through the text and convert
each instance of the desired change individually, or write a macro that
will work only in simplified cases (for example, if all phrases that are
underlined consist of only a single word, or are not followed
immediately by a punctuation mark, unless consistently so).  And, of
course, a different macro would have to be written for each of the 81
different conversions that WPSTYLE is capable of.

     WPSTYLE, on the other hand, can effortlessly make the conversion
quickly (within several seconds for even a fairly large file).  WPSTYLE
is run as a stand-alone program from the DOS command-line and does not
operate inside of WordPerfect.  In this way, it is much like the CONVERT
utility that comes with WordPerfect to convert a file from one Word
Processing format to another.

     Even in a situation where you want to convert most, but not all,
instances of one style to another, making the conversion with WPSTYLE
and reconverting by hand those few instances that were not to have been
converted, can be far less work than making all the changes directly
within WordPerfect.

     WPSTYLE will not overwrite the original file, but instead will
create a new file with a new name of your choice.  This insures a
measure of safety, as well as allowing you to make alternate copies of a
document, for example, one version destined for a laser printer that can
handle italics, strikeout, and other styles, and another version
destined for a daisy-wheel or dot-matrix printer that requires
underlining for "italicized" phrases.


INSTALLATION
============

     Unless you are going to use WPSTYLE directly from the floppy
distribution disk, first copy it to your hard disk.  It is most useful
if you place it in a directory that is in the path statement in your
AUTOEXEC.BAT file, so that you can use the program from whatever
directory you happen to be in.


                            -  Page 2  -

     Once you are in the directory where you want the program to reside,
just type

           COPY A:WPSTYLE.EXE C:

at the DOS prompt, then press the <ENTER> or <RETURN> key; otherwise,
type

           COPY A:WPSTYLE.EXE C:\DOS

if you want the WPSTYLE to reside in the \DOS subdirectory, for
example, or use whatever subdirectory name is appropriate in your case.
Copy the sample file, SAMPLE.WPS, and the documentation file, README.WPS
in the same way, if you want them on your hard disk.  You may also use
the DOS wildcard '*' to copy all three with a single command:

           COPY A:*.*  C:

     Note:  Substitute B: for A: in the above if you are copying from
the distribution disk in the B drive.  Substitute D: (or higher letter)
for C: if you intend to place WPSTYLE.EXE on the D (or higher) drive.


OPERATION OF WPSTYLE
====================

     Start WPSTYLE by typing WPSTYLE on the DOS command line and
pressing the Enter key.  Once the program starts, you will be asked to
provide the name of the original document file to be converted; you may
include a path specification (such as \WP5\MYFILE.TXT) if the file is
not in the current directory.  If the file does not exist on the path
specified, you will receive the message "Cannot Open <Filename>", where
<Filename> is the name you have entered, and you will be prompted to
re-enter a filename.  If the file you have specified is not in
WordPerfect 5.0 or 5.1 format, an appropriate message will be displayed
and you will be returned to the filename entry prompt.

     Once a WordPerfect file has been selected, you will be asked to
provide a name for the new, converted file.  You will be warned if it
will overwrite an existing file, so that you can back out, if necessary,
and give another name.  You will also be prompted, with the message
"Cannot Open <Filename>", to re-enter the filename if the name you have
chosen is not a proper DOS filename.

     You will then be asked to indicate one of the nine styles to be
converted from.  These are:



                            -  Page 3  -


            1. Bold
            2. Underline
            3. Double Underline
            4. Italic
            5. Outline
            6. Shadow
            7. Small Caps
            8. Redline
            9. Strikeout

and are selected by entering the number of the chosen style.  Then you
will be asked to select, in the same way, the style to be converted to.
Note that one additional choice exists for this step:

            0. Normal Text.

By selecting this choice, any text that is in the style to be converted
from will simply appear in whatever style the surrounding text has.

     After this step, conversion will begin automatically, and the
progress can be seen on the progress line near the bottom of the screen.

     At any point during operation of the program prior to the time
conversion begins, you can obtain on-line help by pressing the F1
key.  There are two successive screens of succinct directions for use of
WPSTYLE.  Return to the program at the end of the second screen by
pressing any key.

     You can also quit WPSTYLE at any time prior to the conversion by
pressing the ESCape key.

     It is important to note that only those styles that have been
entered into the original WordPerfect document file by selecting the
FONT/APPEARANCE function (Ctrl-F8, followed by 2), or by the UNDERLINE
(F8) or BOLD (F6) keys, can be converted.  Attributes chosen with the
BASE FONT function (Ctrl-F8, followed by 4) will not be converted, since
in that case a rather complicated code for a specific font will have
been entered into the text which cannot be recognized by WPSTYLE.

     For example, suppose the prevailing text in a particular passage is
in Times Roman 10-point typeface, but a few words within that text are
in italics.  You want to convert all words or phrases that are in
italics in the file to underline.  If the font itself has been changed
for each instance of italicization to Times Roman 10-point Italic, then
those instances will not be affected by WPSTYLE.  However, if the style
has been chosen by pressing Ctrl-F8, followed by 2 (Attribute), then
selecting 4 (Italic) before typing in the italicized text, then entering
Ctrl-F, followed by 3 (Normal), to end the italicization (or
alternately, by marking a block, then changing the block to italics with
Ctrl-F8, 2, 4), WPSTYLE will work as intended.

                            -  Page 4  -

     If WPSTYLE is run with the command-line parameter, or switch, "/W"
(that is, by entering WPSTYLE /W on the DOS command line), then the
program will bypass the check of the original file to see if it is a
WordPerfect 5.0 or 5.1 file.  This is to insure that WPSTYLE will still
operate, even if some future release of WordPerfect changes the
characteristics by which WPSTYLE recognizes a WordPerfect file.  No
guarantee is made, however, that the results will be satisfactory,
because the embedded code for the various styles may also change, as
they did between releases 4.2 and 5.0.  This is why WPSTYLE will not
work on WordPerfect files prior to release 5.0, even with the "/W"
command-line switch.  Be aware that if run with "/W", WPSTYLE will
accept any file for conversion, even if it has not the remotest relation
to a WordPerfect file, and the resulting file may be corrupted in
unpredictable ways (if it contains byte sequences that are the same as
the embedded WordPerfect codes for the various styles).


SAMPLE FILE
===========

     A sample file in WordPerfect 5.0 format has been provided on the
distribution diskette.  This file, SAMPLE.WPS contains a list of plant
names (for those who are interested, the plants are mostly tropical
members of the flowering plant family Euphorbiaceae, a research
interest of the author of this program).  Each plant name is underlined
and is followed by the author of the species, not underlined.  It is
provided so that you may practice using WPSTYLE during the
evaluation period without having to make your own file.

-------------------

WordPerfect is a registered trademark of WordPerfect Corporation.


                            -  Page 5  -

REGISTRATION AND SUPPORT
========================

     WPSTYLE is distributed as shareware; it is neither free nor in the
public domain.  You are free to copy and distribute it as often as you
like.  If, however, you continue to use the program after an initial
evaluation, you must register it by sending $10 to

                            Michael J. Huft
                            20 Park Drive
                            Glenview, IL 60025

Any comments, suggestions, or questions are welcome.

     I would also greatly appreciate your telling me the source from
which you received this program when you register.

     Registration will entitle the user to receive the current version
at no additional cost (if the version registered is not the current
version), notice of upgrades and other products as they become
available, and to receive mail or telephone support for the product
registered.  I am available for telephone support at [phone]
evenings and weekends, or leave a message.

     If more than one copy of WPSTYLE is installed for use on different
computers, each copy must be registered, unless there is no possibility
of their being used simultaneously, for example, copies installed on the
home and office computers of an individual who is the only user of both
machines.

     The form on the following page may be printed and filled in for
easy registration.


                      WPSTYLE REGISTRATION FORM


Name _____________________________________________________________________

Company __________________________________________________________________

Position _________________________________________________________________

Address __________________________________________________________________

City ______________________________________ State _______ ZIP ____________

Telephone(s) _____________________________________________________________

Version (run   WPSTYLE VER   to find out) ____________

Number of copies of WPSTYLE registered                             _______
                                                                 X  $10.00

Total enclosed                                                     _______


Please indicate the source of your copy of WPSTYLE:

_____ Distributor: __________________________________________________

_____ Bulletin Board (BBS): _________________________________________

_____ Club or users' organization: __________________________________

_____ Friend or acquaintance.  [name not requested]


Please mail this form to:  Michael J. Huft
                           20 Park Dr.
                           Glenview, IL 60025


Comments and suggestions are always welcome.