note: this is the DOS text version of README.WP on the Conversion disk
      readme.wp is a WordPerfect 5.0 file

This disk contains the following files as of April 27, 1988:

convert.exe	convert documents to and from a variety of formats

standard.crs	file used to create *.CRS (conversion resource)
               files to properly convert 4.2 margins, page
               length, fonts, and sheet feeder bins into 5.0
               files.  Used during RETRIEVE and in the
               CONVERT.EXE program

graphcnv.exe	WordPerfect directly supports a number of graphic
               formats and can retrieve them into WordPerfect. 
               All of those formats, plus DXF format which is not
               available internally, can be accessed externally
               with this utility.  Files are converted into WPG
               format and do not need further conversion as WP
               retrieves them.

macrocnv.exe	convert the portions of 4.2 macros (*.MAC) into
               5.0 macros (*.WPM) that contain text, cursor
               keystrokes, and functions that haven't changed
               between the two versions.  All other functions
               turn into comments.  Chain to a new macro every
               4K.

cursor.com	change the shape of the cursor

charactr.doc	the names and values of all the characters in the
               WP character sets

charmap.tst	print this file when you want to see what special
               characters your printer supports with WP 5.0.

printer.tst	this file demonstrates WordPerfect 5.0 features. 
               Print this document to test your printer's
               capabilities with 5.0.

library.sty	Styles are stored with the document they are used
               with in the normal process of saving.  You may
               also save groups of styles to a filename without
               any text (from an option on the style menu) to be
               retrieved (also an option on the style menu) into
               another document.  On the SETUP key, under option
               LOCATION of AUXILIARY FILES, WordPerfect allows
               you to specify a directory and filename of a list
               of styles that you wish to be retrieved
               automatically into documents without styles of
               their own, when you press the style key.  This
               way, you can have a base of styles to use without
               having to retrieve them.  This file, LIBRARY.STY
               is simply an example of several useful styles.  It
               may be retrieved into any document, added to
               another list of styles, and or used as a style
               library filename.  If you choose to use this file
               to begin your "library of styles" and you place it
               in a directory called C:\WP50 you would specify:

	 		6 - Style Library Filename   C:\WP50\LIBRARY.STY
			on the SETUP LOCATION KEY.  We included the
               styles:

		Bibliography:	lets you enter multiple bibliographical
                         entries without having to press INDENT
                         MARGIN RELEASE before each one.  The
                         ENTER key turns the style off and begins
                         it again so you can enter as many as you
                         choose.
		Heading: 		creates a centered heading for a
                         chapter, numbered bolded, enlarged and
                         marked for a table of contents level 1.
		Subheading: 	creates a sub heading bolded and
                         numbered (paragraph level 2) and marked
                         for a table of contents level 2. 
		Right Par: 	create paragraph numbers right aligned 

*.WPK	These files are "keyboard macro files".  When you place
          them in your WP50 directory in the directory where
          SETUP is told to find macros and you select one with
          the SETUP KEYBOARD option, they become active and all
          the remapped keys and macros in them become active in
          memory.  We included the following keyboards to give
          you an idea of how programmable macros and remapped
          keyboards can be useful:

altrnat.wpk	three keys are remapped: F1 becomes help, F3
               becomes escape, and Esc becomes cancel.

enhanced.wpk	takes advantage of the additional function keys on
               the "enhanced" keyboard with such macros as: move
               down by paragraph, italics, copy block, move down
               by sentence, move left one column and so forth.

macros.wpk	this keyboard contains many useful macros such as
               calculator: an example of full screen remapping
               and attributes, this little calculator works only
               with integers but could be enhanced to do more;
               envelope: prints a documents' address to an
               envelope; document: helps you create standard
               forms for letters, memos, and itineraries.
                            Macros

The following is a temporary supplemental to the section on
MACROS in the 5.0 Reference manual.  It gives examples of some of
the programming commands beginning on page 427.  All of the
macros come from the named keyboard macros in the MACROS.WPK file
and can be examined in the context of the actual macro
environment they are used in. Additional functions are shown for
clarity.

Assign	From Ctrl-C:

		{ASSIGN}2~{VAR 2}*10~         

		Take variable 2 and multiply it by 10 and assign it to
          variable 2 again.

Call		From Ctrl-D:

		{CALL}name~
			:
		{Home}{Home}{Up}{Enter}{Enter}
			:
		{LABEL}name~
		{TEXT}9~EnterúAuthor'súName:ú~
		{RETURN}
                                
		Call a subroutine called "name".  Do operations there
          (fill variable 9 with an Authors name) and then return
          to continue after the point of the call.

Case		From ALT-F9:

		{CASE}{VAR 0}~5~end~l~end~L~end~~
		{CALL}getchar~

		Test variable 0.  Move to subroutine called "end" if it
          contains a "5", an "l" or an "L".  Notice that the case
          requires its own tilde resulting in a double tilde at
          the end of the CASE command. If variable 0 contains
          anything different go to the next command (call
          "getchar" subroutine). 

Char		From Ctrl-D:

		{CHAR}1~
			{^]}1{^Q}ú{^V}M{^Q}emo;ú
			{^]}2{^Q}ú{^V}L{^Q}etter;ú
			{^]}3{^Q}ú{^V}I{^Q}tinerary:ú
			{^]}0{Left}~
		{CASE CALL}{VAR 1}~
			1~memo~m~memo~M~memo~
			2~letter~l~letter~L~letter~
			3~itin~i~itin~I~itin~
			~

		Display a menu (complete with bold numbers and mnemonic
          letters) and pause waiting for the user to press a key. 
          Store whatever the user presses in variable 1.  Use the
          CASE CALL command to call subroutines to execute the
          options.  Note the test for both upper and lower case
          letters as well as the numbered options.

IF		From Ctrl-C:

		{IF}{VAR 2}<0~
			{ASSIGN}2~{VAR 2}-{ORIGINAL KEY}~
		{ELSE}
			{ASSIGN}2~{VAR 2}+{ORIGINAL KEY}~
		{END IF}
		{RETURN}
                                
		Test the expression "Variable 2 is less than 0."  If
          this is true then subtract the key from variable 2.  If
          it is false fall through to the ELSE and add the key to
          variable 2. 

IF EXISTS	From Ctrl-E:

		{LABEL}Wait~
		{WAIT}1~
		{LOOK}0~
		{IF EXISTS}0~
		{ELSE}
			{GO}wait~
		{END IF}	                     

		This portion of the macro is waiting in the printer
          control screen for the user to press a "G" for go, or
          some other key.  We don't want the macro to continue
          until the user presses a key.  So LOOK looks to see if
          something was pressed.  If it was, it assigns it to
          variable 0.  Then we ask if variable 0 is empty with IF
          EXIST 0.  If they typed anything, variable 0 does
          exist, if not we go back to the label wait and LOOK
          again and repeat.

ON ERROR	From Alt-G:

		{ON ERROR}{CALL}restore~~  {;}Keepútheúwordúifúunknown~
		{DISPLAY OFF}
		{Block}{Word Left}{Macro Commands}a1
		{Goto}{Goto}{Block}{Word Left}{Backspace}y
		{CALL}{VAR 1}~
			:
		{LABEL}restore~
		{Cancel}1
		{RETURN}

		This macro will look at the current word in the
          document, assign it to variable 1, delete the word, and
          call a subroutine depending on the text that was found. 
          If the text does not match a subroutine name, an error
          is generated.  The ON ERROR statement causes a
          subroutine to be called which will restore the old text
          in the document.


ON NOT FOUND	From Ctrl-F8:

		{ON NOT FOUND}~ 
		{Font}fs{Left}
		{Font}{DISPLAY ON}f{PAUSE}{Enter}

		It is important to use ON NOT FOUND in list managers,
          so if a search fails you can tell WP what to do (In
          this case, we don't want the macro to stop since the
          user is totally in control). In list managers, like
          font menus, if you use name search and the entry is not
          there you have a NOT FOUND situation.)  Here the
          routine INSERT goes into the FONT menu and lets the
          user pick a font from the base font screen.  But first
          it defines that nothing will be done if a search fails. 
          

Prompt	From Ctrl-E:

		{DISPLAY ON}
		{PROMPT}{^Q}MoveútheúcursorútoútheústartúofútheúLabelú
			--úPressú{^]}Enter{^\}~
		{PAUSE}
		{DISPLAY OFF}

		The prompt is used to instruct the user during the
          pause operation.

State	From ALT-E:

		{IF}{STATE}&4~
			{IF}{STATE}&8~
				{Exit}			{;}Header/Note/Style~
			{ELSE}{IF}{STATE}&64~
				{^Q}              	{;}Merge~
			{ELSE}{IF}{STATE}&128~
				{Block}
			{ELSE}{IF}{STATE}&256~
				{Typeover}		
			{ELSE}{IF}{STATE}&512~
				{Reveal Codes}

		This macro is used to detect the state of WP and leave
          menus or turn off features until WP is at the main
          editing screen with the screen that normally comes up
          when WP is loaded.

Text		From Ctrl-D:

		{TEXT}9~EnterúAuthor'súName:ú~

		Display the message "Enter Author's Name:" and pause. 
          Store the text typed before the user presses ENTER as
          variable 9.

