
                           WPFLOP User's Guide

	This document describes the operation of the word processing to OS/8
conversion program, WPFLOP.

USAGE

	WPFLOP is used to transfer documents from word processing floppy
disks to OS/8 media or from OS/8 media to word processing diskettes. The
WPS floppy is accessed using the COS compatible floppy handlers included
in this package. There are various modes of conversion which will be
explained later.

OPERATION

WPS->OS/8

Before using WPFLOP to access a WPS floppy, one must know the number
of the document which is to be read from the WPS floppy. For example, in
the sample index below, the column labeled "Document number" is the
number that WPFLOP uses to reference a document.

-- DOCUMENT INDEX --

Drive: 3, Name: DOC3  , # of Docs: 3, Blocks left: 621 (of 627)
-------------------------------------------------------------------------------
Document					Elapsed Time
Number  Name	Created	Modified	Size	Version	Last	Total
-------------------------------------------------------------------------------
  3	Floppy Index
		12/7/79 	NO/DA/TE	 3	  1	0:00	0:00

  2	WPFLOP User's Guide
		12/7/79 	12/7/79 13:09	 2	  1	0:07	0:07

  1	
		12/3/79 	12/7/79 13:10	 1	  4	0:00	0:00


The document "WPFLOP User's Guide" (this file) is document number 3.
This is the number that WPFLOP uses to access the file.

Before running WPFLOP, the COS mode floppy handlers must be install
ed in your OS/8 system. See the BUILD chapter in the OS/8 System Ref
erence Manual for details on using BUILD. See the document "COSHAN.DC"
for further information on the handlers. This document assumes that the
handlers have been installed with names of "RXB0:" for drive zero, and
"RXB1:" for drive one.

To copy the document "WPFLOP User's Guide" to a file on the OS/8
system device called WPFLOP.DC, use the following commands:

		.R WPFLOP		(User input underlined)
		*WPFLOP.DC<RXB0:2$	(Assumes WPS floppy in drive 0. $=ESC,
					 ALT or SEL, depending on the terminal.)

If no OS/8 output file is specified, the program assumes that the
user wants the output on the console terminal (TTY:). Therefore, to
print the same document on the console:

		.R WPFLOP
		*RXB0:2$		The "2" here is the number of the WPS 	
					document which is to be transferred.


The general WPS->OS/8 command syntax is as follows:

	*[dev:file.ex]<wdev:docn[/S][/S...][$]
	      |     |	     |	   |   |		        |
	      |     |	     |	   |   |		        |_ALT or ESC to exit when done.
	      |     |	     |	   |   |
	      |     |	     |	   |   |_ Optional switches
	      |     |	     |	   |
	      |     |	     |	   |_ WPS Document number
	      |     |	     |
	      |     |	     |_ Name for the OS/8 handler for the WPS floppy
	      |     |
	      |     |_ OS/8 Output file specification
	      |
	      |_ OS/8 output device


The asterisk (*) is printed by the OS/8 command decoder. The items
enclosed in braces [] are optional. For example, if no OS/8 output file
is specified, TTY: is assumed. If the command line ends with an altmode,
the program returns to OS/8 when it is finished. If it does not, the
program responds with another "*" and inputs another command string.

There are two options accepted when transferring from WPS to OS/8.
These are the version switch (/V) and the compatibility switch (/C). If
the version switch is in the command line, WPFLOP prints its version
number before executing the command. If the compatibility mode switch is
present, WPFLOP transfers the WPS document in a form compatible with
OS/8 system programs. In this mode, underlines, dead keys, and bolding
are ignored, but tabs are converted to tabs (ASCII 11). Also, the file
is not justified. In normal mode, the output file contains overprinting
as necessary to duplicate the WPS file.

Compatibility mode is used to transfer a WPS file to OS/8 in a form
that can be used by, for example, OS/8 BASIC. This allows WPS to be used
to enter and edit a BASIC program. To do this, create the file under WPS
and transfer it to OS/8 using compatibility mode. If there are any
errors, transfer it back to WPS, edit it there, and then back to OS/8,
etc.

OS/8->WPS

To transfer an OS/8 File to WPS, use the following syntax:

	*wdev:<dev:file.ex/O[/S][$]

Note that this is similar to the above example. The most important
differences are the output switch (/O) and the fact that no WPS document
number is given in the command line. WPFLOP will use the next available
document for the new file. The number that WPFLOP uses will be reported
as a message of the form:

"Creating document number:n"

 Where "n" is the number of the document created.

The /O switch is required to specify to WPFLOP that the output file
is on the WPS floppy. Without this switch the program will assume that
the input file is the WPS file.

The other switch allowed is the /W (word-wrap) switch. If this
switch is specified, the returns in the OS/8 file will be converted to
word-wrap returns. If there are two returns in a row, hard returns are
used. Normally, all the returns in the OS/8 file are converted to hard
returns.

The document created on the WPS device is not totally compatible
with WPS as it is initially created. The most obvious problem is that
tabs are output as only one space. To correct this, the WPS editor must
be allows to scroll thru the document. The initial ruler MUST be changed
in order for the editor to correct the document. To facilitate this, the
ruler that WPFLOP creates has tabs at locations 8 and 9. The first tab,
at location 8, is incorrect. It is included to be deleted in order for
the WPS editor to re-tabluate the document. Therefore, the correction
sequence is:

	1.Create the WPS document from OS/8
	2.Call the WPS editor to correct the document
	3.At the top of the document, type GOLD Ruler.
	4.Space to column 8 with ADVANCE WORD.
	5.Type the space bar. The first of the adjacent T's will disappear.
	6.Type RETURN to embed the new ruler.
	7.Type GOLD ADVANCE to scroll thru the document and correct it.
	8.Type GOLD File to re-file the corrected document.

RESTRICTIONS

The ruler created for the WPS document has a ragged ruler with a
width of 80 columns and tabs every eight columns. This is the only ruler
that can be created. However, you can change the ruler under WPS after
the conversion.

The WPS to OS/8 code does not support bolded dead keys. The dead key
sequence prints properly, but the sequence is not bolded.

The document created on the WPS device does not have an index entry.
It will show up in the index as just the document number. To give the
file a name, edit the index document,(document 1) to include an entry
for the document. For example, if you created document 4, and want it to
be called "Foobar", include the following line in the index:

<n>Foobar <#>4<>

The form used is:
<n>Name space <#>doc#<>

The n in the <> must be lower case, and the name must end with a space.



