═══ 1. Introduction ═══ This program provides a What You See Is What You Get (WYSIWYG) word processor for the OS/2 Presentation Manager interface. It does not attempt to go head-to-head with the large professional word processors available for OS/2 PM or Windows, but rather tries to provide a more modest set of functions. Normal text formatting is provided for, plus the program has the ability to handle embedded graphics. All installed ATM fonts are supported, in all the native formats and in a wide range of sizes. Printer support is strictly through the OS/2 PM interface, providing output on any printer supported by that interface. In fact, I have heard of one user outputting direct to a FAX from this program. ■Startup and Shutdown ■Loading and Saving Documents ■Editing Documents ■Printing Documents ■Window Management ■A Few Cautions ■Registration ═══ 2. Startup & Shutdown ═══ Startup Once Pluma has been installed, there are three ways to start it up. The first method is to simply double-click on the program object that was created during installation. In this case, the word processor will start up and create an empty document window for immediate use. The second method is to drag a document file over to the program object and drop it there. The document file will be opened and displayed in the work area, ready for editing. The third method is with the START command. Normally, this will only work if your current directory is the directory to which you installed Pluma. If you include that directory in the PATH, HELP and LIBPATH statements of your CONFIG.SYS file, then you can use the START command from anywhere on your system. Shutdown To exit Pluma, you can double-click on the program's system menu (the mini- icon to the extreme upper-left of the program window), or you can press the F3 key. If you have any documents open that have been changed but have not yet been saved, you will be asked if you wish to save them first before exiting. The exit process can be aborted at any of these confirmation messages. ═══ 3. Loading & Saving Documents ═══ Loading Documents can be loaded into the word processor two ways. The first is at program startup. By dropping a document file object on the word processor's program object with the mouse, you can start the word processor for that document. Unfortunately, if you drop multiple document file objects on the program object, multiple copies of the word processor get loaded. If you load the word processor with the START command, then you give the document names on the command line after START PLUMA. If you specify multiple documents in this way, only one copy of the word processor gets loaded. Once the word processor is started, you may open documents with the Open menu option. You are presented with the system's standard file selection dialog. It is preset to 'see' only files marked as having been created with this word processor, but you may select 'All Files', or 'Plain Text' files also. You may select as many files as you like for loading, and after you finish the list, all will be loaded in the background. At the start of the load, all the currently open document windows are iconized, and the first document to complete loading becomes the current document. All the others will be automatically iconized as they complete loading. Saving There are two ways to save a document to disk: Save and Save As.... If the document was loaded from disk or previously saved, it already has a disk file name and can be saved over its former self with the Save command. If no changes have been made to the document since it was last loaded or saved, this command is disabled and will just beep at you. If the document is new, and hasn't been saved to disk yet, or if you wish to save the document to a different file name, you must use the Save As command. When you do so, the standard file selection dialog is presented, but with the file selection list disabled. You need to select the drive and directory to which you want the file saved, and type in the file's new name. After you enter this information, and press the ENTER key, the file will be saved under its new name. If a file by that name already exists, you will be asked if you really want to overwrite the existing file. If you do not want to, the save process is aborted. If you accept the overwrite, the file will be saved, replacing the old one. If you try to close a document window that has been changed and not saved, you will be asked if you want to save the document first. Likewise, if you try to exit the word processor while you still have open, changed documents, you will be asked if you want to save the documents before exiting. You will be asked about each open and changed document. ═══ 4. Editing Documents ═══ Navigation For movement within the document window, the following keys have been defined: ■Left Arrow - Move to previous character/token. ■Right Arrow - Move to next character/token. ■Up Arrow - Move to previous line. ■Down Arrow - Move to next line. ■Page Up - Move to previous page. ■Page Down - Move to next page. ■Home - Move to start of line. ■End - Move to end of line. ■Ctrl+Home - Move to start of document. ■Ctrl+End - Move to end of document. ■Ctrl+LeftArrow - Move to previous word. ■Ctrl+RightArrow - Move to next word. In addition, you may use the mouse to directly position the cursor anywhere in the visible document. You may use the mouse with the scroll-bars, providing you have them set visible, to reposition the page view horizontally or vertically. Also, four special mouse buttons have been provided at the lower-right of the document window. These buttons provide the Top, Page Up, Page Down and Bottom functions, the same as those provided by the Ctrl+Home, PageUp, PageDown and Ctrl+End keys. As you move about the document, remember that function codes to set margins, fonts, sizes, etc. are considered as full tokens in the data stream and the cursor will stop at each of them as you use the left/right arrows to go back and forth through the document. Text Text may be entered into the document by simply typing it in. As you enter text, the text is formatted in place. If a word grows too long for the current line to hold it, it is moved down to the next line. If you type too fast, your keystrokes are accumulated and inserted as groups to catch up with you. Once you have entered text into the document, you may move the cursor back into the text to change it. Normally, your cursor is set for insertion, and has a vertical bar as the cursor. When you start typing into the middle of already existing text, the new text is inserted into the old, and the document is reformatted to suit. If you wish to replace text instead, then press the INSERT key. Your cursor will change to a block covering the current character/token, and whatever you type will replace what is under the cursor. Be careful with this. If the cursor is placed over a font or size change code, or other type of special function code, whatever you type will replace it, just as regular text would be replaced. Text can be selected by positioning the cursor to the start of the block you wish to select, then pressing down the SHIFT key and holding it down, and then repositioning the cursor to the end of the block. Another way is to position the cursor with the mouse, then, holding the left mouse button down, moving to the end of the block to be selected. Once you have selected a block of text, that block can be moved or copied, cut from the document, copied to the system clipboard, or replaced with whatever is on the system clipboard. Also, if you have text selected, and you start typing, the selected block is deleted and replaced with the new input. Selected text can be moved or copied with the mouse. You must click the right mouse button on the selected area, then drag the mouse until the cursor is positioned at the text block's new position. When you release the mouse button, the move will take place. If you want to copy instead of move, hold down the Control key as you release the mouse button. If you do not move the mouse, but simply release the mouse button, then a context menu will appear containing all the available commands which can be used on a selected block of text. Text Attributes At any point in the document, there is a specific set of text style and formatting attributes in effect. The margins are set to a particular position, the tabs are at a certain location, the font is set a certain way. Any of these attributes can be changed from the current location onwards, or over a selected area. If you set the font to Times Roman, and no text was selected at the time, then the new font will take effect from the cursor location onwards, until another font command is encountered in the text. If text was selected, however, all other font commands will be removed from the selected area and Times Roman will take effect over the entire selected area. The font that was in effect after the selected area remains in effect there. All text attributes are handled in this way, be they margins, tabs, indentation, font, font size, font style, colors . . . all of them. Graphic Images Graphics images may be placed into a document from the system clipboard. For the time being, you have to provide your own means to get the images on to the clipboard. There are a number of image capture and conversion utilities that will do the job nicely, but do not attempt to use the system's Icon Editor to do this. Though the Icon Editor cuts and pastes nicely for itself, it does so with a private clipboard format which is not publicly documented. All Pluma sees is a black rectangle when Icon Editor puts the graphic on the clipboard. Once the image is on the system clipboard, you may use the Paste Graphic command to put the image into your document. You may place the graphic at any place on the page, at any size and at any degree of horizontal or vertical stretching. With the graphic placed into the document, you can move it, copy it or resize it at any time. To move the graphic, click the right mouse button on the body of the graphic and drag the graphic to its new position. To copy it, do the same, except that while you release the right mouse button, hold down the Control key. To resize a graphic, click the right mouse button on the white space immediately next to the graphic. A sizing border will appear and guide you as you adjust the graphic's size. ═══ 5. Printing Documents ═══ There are two document printing options currently available: Print All and Print Page. Print All causes the currently active document to be printed entirely. You can also do this by pressing the Control key and the 'P' key. Print Page prints the current page of the currently active document. This can also be done by press the Alt key and the 'P' key together. ═══ 6. Window Management ═══ You can have many document windows open at a time. Each time you open a new document window, all the currently open document windows are iconized and arranged across the bottom of the work area. The new document window will then occupy as much space as it can, leaving enough space so that the iconized documents are all visible. To restore a document window to normal, simply double-click on it as you would any system icon. The window will return to whatever size and location it had before it was iconized. If you restore a number of documents to normal, they will doubtlessly obscure parts of each other. There are two menu commands available to straighten things out: Tile and Cascade. Tiling the windows will arrange all the document windows not currently iconized so that none obscures any other. The effect is the same as when the system tiles windows on the desktop. Cascading the windows will arrange all the document windows not currently iconized so that they form a stack, like a deck of cards. They are arranged so that their title-bars are all visible. The currently active document window gets placed on top of the stack. One additional window arrangement tool is provided: Arrange Icons This menu command will neatly arrange all the iconized document windows across the bottom of the work area. Just in case a document window is completely obscured, the Windows menu contains a list of all the currently open documents. You may select any of the windows there and make it the active window. If necessary, the document window will be restored from the minimized state. ═══ 7. A Few Cautions ═══ ■This program does not yet handle any other document formats but its own, or Plain Text. Attempting to load a document formatted by another word processor and not saved in Text format will most likely fail, or the program may appear to lock up. ■Though the program's design does not restrict the size of the document you can build, the method used to represent the document requires a lot of memory. For this reason I do not yet recommend using this word processor for documents over 3-4 pages in length. I am working on the solution and hope to release it in revision 1.10. ■Having a lot of fonts on the Font menu looks neat, but OS/2 does not release the fonts from memory until you shut down and reboot the system. This can cause your swap file to grow by several megabytes. ■Some ATM fonts available on electronic bulletin boards are not completely verified and can cause your system to hang. Be careful with newly installed third-party ATM fonts, though you shouldn't have to worry about fonts purchased from IBM or Adobe. ■Graphics embedded into documents can be quite large. When you imbed a large graphic into the document, but shrink it on the document page, do not be fooled into thinking that the graphic takes any less space. It is still the same graphic as before. ═══ 8. Registration ═══ This program is shareware. Feel free to distribute unmodified copies of the program to anyone interested. If you find the program useful, and decide to keep the program for use, then you must pay for it. To register this product, send a check or money order payable for $30 U.S. dollars to Rick Papo, plus your name, your mailing address, the revision number and date of your current copy of Pluma, and, if possible, your electronic mail address, to: Pluma Registrations c/o Rick Papo 38290 Avondale Westland, MI 48185-3830 USA If you reside in any of the republics which were formerly of the Soviet Union or of the Warsaw Pact, you may register for $5. Upon receiving your registration, you will be sent the latest revision of the word processor on diskette. If you already have the latest revision, you will be sent a confirmation of your registration and you will receive the next revision, when it becomes available. Printed documentation is not yet available, but once it is, all registered users of the word processor will receive a copy. If you would like later upgrades on diskette, they will cost $10 U.S. dollars ($5 for the ex-USSR). ═══ 9. File Menu ═══ From the File Menu the following commands are available: ■New ■Open... ■Recall ■Merge... ■Save ■Save As... ■Save and Close ■Close ■Print ■General Preferences... ■Document Defaults... ■Exit ═══ 9.1. New (Menu Option) ═══ This menu option creates a new document window with nothing in it. The document margins, font and other attributes are those that were set the last time the Document Preferences dialog was used without any active document windows present. Any previously open windows are minimized to the bottom of the workspace and the new window occupies as much of workspace as it can. ═══ 9.2. Open... (Menu Option) ═══ When this menu option is selected, the system standard File dialog is presented. You may select one or more documents to be opened. After you press ENTER, or click on the OK button, all the files you selected will be opened. A red loading status indicator will be shown in the right portion of the main program title bar. Each load, once complete, will result in a separate document window being created. The first to complete will become the active document, and will be maximized within the program's client area. All further documents will be iconized. They can be called forward from the Windows menu, or by double-clicking on their icons with the mouse. The short-cut key for this function is Ctrl+O. See Open/Merge/SaveAs... (Dialog) for more information. ═══ 9.3. Open/Merge/SaveAs... (Dialog) ═══ You have selected the Open, Merge or SaveAs menu option, and as a result you now have this dialog before you. It is the standard File dialog provided by the operating system, and follows the rules given in the system documentation. These special notes apply:  You will notice that the 'Type of File' field is initially set to 'Pluma'. At first, only such files as were created with the word processor are visible. This is intended as a convenience, so you are not presented with extraneous files that are not correctly formatted for use by the word processor. You can change this setting to '' or to 'Plain Text' if you wish, upon which all files of the selected type in the current directory will be shown in the file list.  When selecting files to open, you may select as many files from the file list as you wish.  When selecting a file to merge, you may only select one file.  When doing a Save As, you are not allowed to select a file name from the file list. The list serves for reference only. You must enter the name of the file you wish to save into the entry field.  The directory selected from this dialog becomes the new current directory for the program. The next time you call up the Open, Merge or SaveAs dialogs, they will start in this directory. Note: Files are marked as Pluma documents as they are saved to the disk. This marking is done via Extended Attributes, and as such the marking is lost when you save the document to diskette or archive the document with a program (like PKZIP) which does not handle EAs. There are newer archiving programs available which preserve this information. ═══ 9.4. Recall (Submenu) ═══ This menu option calls up a submenu wherein the most recently opened ten documents are listed. To reopen one of those documents as a new window, select one of them with the arrow keys and press ENTER, or click on one of them with the mouse. ═══ 9.5. Merge... (Menu Option) ═══ When this menu option is selected, the system standard File dialog is presented. From this dialog you may select a single file to be merged into the currently active document at the cursor position. See Open/Merge/SaveAs... (Dialog) for more information. ═══ 9.6. Save (Menu Option) ═══ This command causes the currently active document to be saved to its current file name. If no changes have been made to the document, this menu option is disabled. The short-cut key for this function is F2. ═══ 9.7. Save As... (Menu Option) ═══ When this menu option is selected, the system standard File dialog is presented. Using this dialog, you may enter the name the currently active document will be saved under, and you may select the directory to which it will be saved. See Open/Merge/SaveAs... (Dialog) for more information. ═══ 9.8. Save & Close (Menu Option) ═══ This option provides a quick means to save and close the current document. The short-cut key for this function is F4. ═══ 9.9. Close (Menu Option) ═══ This command causes the currently active document to be closed. If there are unsaved changes in the document, you will be asked if you wish to save it. If you click on the YES button, or press Y, the document will be saved to its current file name. If you click on the NO button, or press N, the document window will close without having saved any changes. If you click on the CANCEL button, or press the ESCAPE key, the close command will be aborted and the document window will remain active. ═══ 9.10. Print  (Submenu) ═══ This submenu gives access to the various print commands. At this time, two commands are available: ■Print All ■Print Page ═══ 9.11. Print All (Menu Option) ═══ The currently active document is printed after you select this menu option. A red status window is displayed while the document is being sent to the system spooler, but that is for your information only. You may return to working on the document immediately after submitting the print command. The document will be printed as it was the instant you requested it printed. The short-cut key for this command is CTRL+P. ═══ 9.12. Print Page (Menu Option) ═══ The current page of the currently active document is printed after you select this menu option. A red status window is displayed while the document is being sent to the system spooler, but that is for your information only. You may return to working on the document immediately after submitting the print command. The document will be printed as it was the instant you requested it printed. The short-cut key for this command is ALT+P. ═══ 9.13. General Preferences... (Menu Option) ═══ See General Preferences (Dialog) for more information. ═══ 9.14. General Preferences (Dialog) ═══ This dialog allows you to configure the appearance and behavior of Pluma in ways which apply to the word processor itself, and not to the documents it processes. The options currently available are: Animate This option, if set, causes the word processor to animate its main window open and close process, just as the system folders do. As with the system folders, however, animation must be enabled from the System object in the System Setup folder. Show Rulers If this item is checked, then all document windows will have horizontal and vertical rulers provided next to the document window. Show Scroll Bars If this item is checked, then all document windows will include horizontal and vertical scroll bars for use in scrolling the document text with the mouse. Show Complete Filenames If this item is checked, then the complete file name of each document will show in the document window's title-bar. Otherwise, the drive and directory portion of the document file name will not be shown. Initial Zoom From this group of buttons you may select the initial document window zoom. When you open new document windows or load documents from disk, the chosen zoom method will be used to display the window when it is first displayed. You may choose from any of the following zoom types: ■Zoom 100% ■Zoom Full Width ■Zoom Full Height ■Zoom Margins ■Zoom All Once the settings are satisfactorily adjusted, press the ENTER key or click on the OK button for the program to continue. The changes will take effect on all new documents created. If you wish to abort the dialog and leave the current defaults as they are, press the ESC key or click on the escape button. ═══ 9.15. Document Defaults... (Menu Option) ═══ This command invokes a dialog from which it is possible to alter the initial printer, form, font, point size, color, font attributes and text justification (horizontal and vertical) for the document. See Document Defaults (Dialog) for more information. ═══ 9.16. Document Defaults (Dialog) ═══ This dialog allows you to change the initial attributes of documents. The attributes apply to the currently active document, or, if you have no documents open at the moment, the new attributes are saved for use in creating new documents. The attributes that may be changed through this dialog are: Printer This item allows you to select which printer (if you have several) the document will be printed to. You may choose any printer currently defined in the system. Printer Settings Clicking on this button will call up the current printer's job settings dialog. This dialog varies according to which type of printer you have selected, and cannot be documented here. Refer to the help information provided by the dialog. After you return from the dialog, the currently selected form and that form's size are updated in the area immediately below the pushbutton. Font This will be the initial font for the document. You may choose from any outline font currently installed on your system. Size This will be the initial size used for the font. You may choose any of the sizes in the list provided. Color This will be the initial color used for the text in the document. You may choose any of the colors in the list provided. Justification This defines the type of horizontal justification to be used. The available types are Left, Center, Right and Full. Left justification aligns all text to the left margin of the page. Center justification centers all text between the left and right margins, but does not attempt to alter the default spacing between words. Right justification aligns all text to the right margin of the page. Full justification aligns text to both the left and right margins of the page, altering the spacing between words appropriately. Bold If this box is checked, the initial text will be made bold. If the selected font has a special bold font available, it will be used. Otherwise, the system will construct a bold font for use. Italic If this box is checked, the initial text will be made italic. If the selected font has a special italic font available, it will be used. Otherwise, the system will construct an italic font for use. Underscore If this box is checked, the initial text will be underscored. Strikeout If this box is checked, the initial text will be struck out. Outline If this box is checked, the initial text will be outlined, but not filled in. Caps If this box is checked, the initial text will be capitalized. Center Page If this box is checked, the document will start out with vertical centering of all pages. Metric If this box is checked, the document will use metric units for all measurements. The horizontal and vertical rulers will use centimeters as their units of measurement. Margins These four entry fields are used to set the initial page margins, inches or centimeters, according to your current setting. The margins cannot be set wider than the currently selected form's clipped size. Tab Spacing This entry field allows you to set the default tab spacing to be used at the start of the document. If you enter 0.500 here, then you will initially have tabs placed every half inch or centimeter, starting at the left margin and continuing to the right margin. Line Spacing This box contains the available default line spacing options. Option 1.0 sets normal 100% vertical spacing. Option 1.5 sets 150% vertical spacing, and option 2.0 sets 200%. Date Format This field shows the current default date format to be used with the Current Date and Today's Date functions. See Date Format for more information. Once the settings are satisfactorily adjusted, press the ENTER key or click on the OK button for the program to continue. If no documents are currently open, or you have checked the Global Save box, then the new settings will take effect for all new documents created from this point on. If there is a document window currently open, the new defaults will take effect for that document as well. No other documents are affected. If you press the APPLY button, the new defaults settings are applied to the currently active document at once, and become the new defaults. If you wish to abort the dialog and leave the current defaults as they are, press the ESC key or click on the escape button. Changes made by the APPLY button are not discarded. ═══ 9.17. Exit (Menu Option) ═══ Selecting this menu option will terminate the program. ═══ 10. Edit Menu ═══ From the Edit Menu the following commands are available: ■Cut ■Copy ■Paste ■Clear ■Clear Clipboard ■Paste Graphic ■Zoom ═══ 10.1. Cut (Menu Option) ═══ This command causes the currently selected text to be removed from the document and placed into the system clipboard. The short-cut key is defined to be Shift+Delete. ═══ 10.2. Copy (Menu Option) ═══ This command causes the currently selected text to be copied from the document and placed into the system clipboard. The short-cut key is defined to be Ctrl+Insert. ═══ 10.3. Paste (Menu Option) ═══ This command causes the contents of the system clipboard to either replace the currently selected text (in replace mode) or to be inserted following the cursor (in insert mode). The short-cut key is defined to be Shift+Insert. ═══ 10.4. Clear (Menu Option) ═══ This command causes the currently selected text to be cleared from the document without altering the system clipboard. This command is equivalent in every way to pressing the Delete key. ═══ 10.5. Clear Clipboard (Menu Option) ═══ This command clears the system clipboard, releasing all items stored there. ═══ 10.6. Paste Graphic (Menu Option) ═══ If a bitmapped image has been placed on the system clipboard, this menu option enables you to paste that image into your document. After you have selected this option, you must point to one of the corners of the area where you want the image pasted. Select that corner by moving the mouse pointer there, then pressing the left mouse button. Keeping the mouse button pressed, move to the opposite corner of the area where the image will be placed. A rectangle will form as you move the mouse. Once you are satisfied with the size and position of the rectangle, release the mouse button. The image will be pasted into the rectangle, and will be stretched or compressed as necessary in both height and width. ═══ 10.7. Zoom (Submenu) ═══ This menu option calls up a submenu of the different document viewing zoom commands. The following commands are available for use: ■Zoom 100% ■Zoom Full Width ■Zoom Full Height ■Zoom Margins ■Zoom All ■Zoom Window ■Zoom Set... ═══ 10.8. Zoom 100% (Menu Option) ═══ This command sets the current display scale to 100%. What you see displayed should print at exactly the same size, providing the system scaling factors (out of my control) are set properly. ═══ 10.9. Zoom Full Width (Menu Option) ═══ This command sets the current display scale so that the page will occupy the full width of its display window. This may reduce or enlarge the document scale, depending on how large you've got the display window set up to be. ═══ 10.10. Zoom Full Height (Menu Option) ═══ This command sets the current display scale so that the page will occupy the full height of its display window. This will normally reduce the document scale, causing it to display smaller than it will really print out as. ═══ 10.11. Zoom Margins (Menu Option) ═══ This command sets the current display scale so that the portion of the document within the horizontal margins will occupy the full width of its display window. This will normally enlarge the document scale, depending on how large you have set the display window to be. ═══ 10.12. Zoom All (Menu Option) ═══ This command sets the current display scale to the smaller of the Zoom Full Height and the Zoom Full Width scales. This is done so the entire document will appear in the window, no matter how small or misshapen the document window is. ═══ 10.13. Zoom Window (Menu Option) ═══ This command allows you to select a rectangular portion of the currently active document and zoom in on it. Once the portion has been selected, the current document will be have a new zoom factor applied to it and it will be repositioned so that the portion you have selected is visible at the largest possible magnification. ═══ 10.14. Zoom Set... (Menu Option & Dialog) ═══ This command and dialog allow the user to set the viewing zoom factor to any value desired. Use the up and down arrows to change the zoom factor, or enter the value directly, then press the ENTER key or click on the OK button to make the new zoom factor take effect. To apply the zoom factor without dismissing the dialog, click on the APPLY button. Zooms applied in this manner remain in effect after the dialog is dismissed, even if the ESCAPE key is used. To escape from the dialog without effecting any further change, press the ESCAPE key or click on the ESCAPE button. Changes made by the APPLY button are not discarded. ═══ 11. Layout Menu ═══ From the Layout Menu the following commands are available: ■Margins... ■Tabs... ■Indent... ■Line Spacing  ■Justification  ■Page Center ■Page Break ■Insert Date  ■Date Format... ═══ 11.1. Margins... (Menu Option) ═══ This command invokes a dialog from which it is possible to set all four printing margins (top, bottom, left, right). See Margins (Dialog) for more information. ═══ 11.2. Margins (Dialog) ═══ Through this dialog you can set the left, right, top and bottom printing margins. These margins are specified in the currently selected measurement system, and are the distances from the left and bottom edges of the form. As you enter new values for the margins, the horizontal and vertical rulers for the currently active document are adjusted accordingly, though the document itself is not reformatted. Enter the distances and press the ENTER key or click on the OK button. If the margins will not work with the currently selected form, you will get an error message and be allowed to try again. If you press the APPLY button, the new margin settings are applied to the currently active document at once, and become the new margins. To abort the dialog and discard the changes entered, press the ESC key or click on the 'Escape' button. Changes made by the APPLY button are not discarded. Note: The new left and right margins will take effect with the next line, unless the margin command was inserted into the document at the very beginning of a new line. The new top and bottom margins will take effect with the next page, unless the margin command was inserted into the document at the very beginning of a new page. ═══ 11.3. Tabs... (Menu Option) ═══ This command invokes a dialog from which it is possible to alter the document's tab settings. The new settings will take effect from the cursor location onwards. See Tabs (Dialog) for more information. ═══ 11.4. Tabs (Dialog) ═══ This dialog permits you to enter the position of a tab and either set the tab, or clear it. Your changes are immediately visible on the active window's horizontal ruler. To set a tab, enter the tab position in the entry field, then push the 'Set' pushbutton. To clear a tab, enter the tab position in the entry field, then push the 'Clear' pushbutton. Once you have entered all the changes you wish to make to your document's tab settings, you must select the OK button and press ENTER, or you can click the OK button with the mouse. The changes you have entered take effect from the current cursor position onwards. If you press the APPLY button, the new tab settings are applied to the currently active document at once, and become the new tabs. To abort the dialog and discard the changes entered, press the ESC key or click on the 'Escape' button. Changes made by the APPLY button are not discarded. ═══ 11.5. Indent... (Menu Option) ═══ This menu option calls forth a dialog from which you can specify the indent distance to be used in starting each new paragraph. See Paragraph Indent (Dialog) for more information. ═══ 11.6. Paragraph Indent (Dialog) ═══ From this dialog it is possible to set the paragraph indention distance to be used from the document's current position onwards. You may enter the new indention distance, then click the OK button to save the new value. The currently active document will be reformatted appropriately. If you press the APPLY button, the new indention distance is applied to the currently active document at once, and becomes the new indention. To escape the dialog without saving any more changes, then click the ESCAPE button. Changes made by the APPLY button are not discarded. ═══ 11.7. Line Spacing (Menu Option) ═══ This submenu presents the different vertical line spacing options that are available. They include the following: ■1.0 ■1.5 ■2.0 ═══ 11.8. Line Spacing 1.0 (Menu Option) ═══ If no text is currently selected, this menu option establishes normal (100%) line spacing from the current location onwards, until changed by another command. If text has been selected, then this menu option establishes 100% line spacing over the selected area, no more. ═══ 11.9. Line Spacing 1.5 (Menu Option) ═══ If no text is currently selected, this menu option establishes one and a half (150%) line spacing from the current location onwards, until changed by another command. If text has been selected, then this menu option establishes 150% line spacing over the selected area, no more. ═══ 11.10. Line Spacing 2.0 (Menu Option) ═══ If no text is currently selected, this menu option establishes double (200%) line spacing from the current location onwards, until changed by another command. If text has been selected, then this menu option establishes 200% line spacing over the selected area, no more. ═══ 11.11. Justification (Menu Option) ═══ This submenu presents the different horizontal text justification options that are available. They include the following: ■Left Justify ■Center Justify ■Right Justify ■Full Justify ═══ 11.12. Left Justify (Menu Option) ═══ This menu option inserts a command into the document to left justify the document text, starting with the next line, unless the command was inserted at the very beginning of a new line, in which case it will take effect immediately. ═══ 11.13. Center Justify (Menu Option) ═══ This menu option inserts a command into the document to center justify the document text, starting with the next line, unless the command was inserted at the very beginning of a new line, in which case it will take effect at once. ═══ 11.14. Right Justify (Menu Option) ═══ This menu option inserts a command into the document to right justify the document text, starting with the next line, unless the command was inserted at the very beginning of a new line, in which case it takes effect immediately. ═══ 11.15. Full Justify (Menu Option) ═══ This menu option inserts a command into the document to full justify the document text, starting with the next line, unless the command was inserted at the very beginning of a new line, in which case it takes effect at once. The sizes of spaces in fully justified text are adjusted to make the left and right margins of the text turn out even. Lines terminated with a carriage return or page break are treated as left justified. ═══ 11.16. Page Center (Menu Option) ═══ This menu option inserts a command into the document to center pages vertically, starting with the next page, unless the command was inserted at the very beginning of a new page, in which case it takes effect at once. Note: This function cannot be used together with graphics, and is disabled by the presence of graphics on the page. ═══ 11.17. Page Break (Menu Option) ═══ This command, when selected, inserts a page break into the document at the cursor location. The cursor will advance to the start of the new page. The short-cut key for this function is CTRL+ENTER. ═══ 11.18. Insert Date  (Menu Option) ═══ This sub-menu gives you access to the date insertion functions. Currently, there are two options: ■Today's Date ■Current Date ═══ 11.19. Today's Date (Menu Option) ═══ This menu option, when selected, inserts the current date into the document text as a string of characters. The date text is generated according to the format specified in the Date Format... dialog. Once the date has been inserted into the document, it may be edited like any other text. It does not change automatically if you change the current date format. ═══ 11.20. Current Date (Menu Option) ═══ This function inserts a special object into the document which shows the current date, always. It is always the current date when the document is displayed or printed, not the date when the object was inserted into the document. As an object, it cannot be edited. When you move past it with the cursor, it will behave as a single character or token. The format with which the date is shown can be altered from the Date Format... dialog, though you must alter the format upstream from the object, since the object uses the format in effect at its location in the document. ═══ 11.21. Date Format... (Menu Option) ═══ This menu option, when selected, calls up the Date Format... dialog, which is used to alter the format used for generation of dates. ═══ 11.22. Date Format... (Dialog) ═══ From this dialog it is possible to alter the format used in the generation of dates. The date format is whatever you type in the entry field, except that certain characters preceeded by the '%' character have special meaning. These special codes are the following: %w - This code becomes the day of the week (Sunday, Monday, etc.). %d - This code becomes the day of the month, in numeric form. %m - This becomes the month of the year, in numeric form. %M - This is the month of the year (January, February, etc.). %y - This is the full year (not the last two digits only). Any other text entered in the field is copied directly to the generated date. For instance, the format string "%w, %M %d, %y" could become "Wednesday, March 16, 1994". You may enter the new date format, then click the OK button to save the new value. The currently active document will be reformatted appropriately. If you press the APPLY button, the new date format is applied to the currently active document at once, and becomes the new value. To escape the dialog without saving any more changes, then click the ESCAPE button. Changes made with the APPLY button are not discarded. ═══ 12. Font Menu ═══ From this menu you may choose a font to be applied from the cursor location onwards, or over the entire area currently selected in the document. The fonts are displayed at 18 points, and are displayed exactly as they will be shown in the document. The font currently active at the cursor location is check-marked. ═══ 13. Size Menu ═══ From this menu you may select a point-size to be applied from the cursor location onwards, or over the entire area currently selected. The font currently selected at the cursor location is used for the display, and each menu entry is shown in the actual point size. The size currently active at the cursor location is check-marked. ═══ 14. Attribute Menu ═══ From the Attribute Menu it is possible to insert font attribute commands into the document. All the font attributes supported natively by the Presentation Manager are here: Normal, Bold, Italic, Underscore, Strikeout and Outline. To cause all text from the cursor's current location onwards, or all text currently highlighted, to have one of these attributes, simply select the menu option with the mouse or with the keyboard. The font attribute menu entries are shown in the currently selected font and size, and the currently active attributes are checkmarked. Any combination of attributes (except NORMAL) can be active at any given time. Normal is the setting when none of the others is active. ■Normal ■Bold ■Italic ■Underscore ■Strikeout ■Outline ■Caps ■Expand 50% ■Expand 75% ■Expand 100% ■Expand 125% ■Expand 150% ■Expand 175% ■Expand 200% ═══ 14.1. Normal (Menu Option) ═══ This menu option, if selected, will cancel any currently active font attributes (like bold, italic, etc.). If this option is selected while text has been highlighted, then the effect will be applied only to the highlighted text. If nothing was selected, the effect is applied from the cursor onwards. Attribute commands embedded in the document further along are not affected. The short-cut key for this function is Ctrl+N. ═══ 14.2. Bold (Menu Option) ═══ This menu option, when selected, will apply the Bold font attribute to the currently selected text, or from the cursor location onwards. Attribute commands embedded further along in the document are not affected. The short-cut key for this function is Ctrl+B. ═══ 14.3. Italic (Menu Option) ═══ This menu option, when selected, will apply the Italic font attribute to the currently selected text, or from the cursor location onwards. Attribute commands embedded further along in the document are not affected. The short-cut key for this function is Ctrl+I. ═══ 14.4. Underscore (Menu Option) ═══ This menu option, when selected, will apply the Underscore font attribute to the currently selected text, or from the cursor location onwards. Attribute commands embedded further along in the document are not affected. The short-cut key for this function is Ctrl+U. ═══ 14.5. Strikeout (Menu Option) ═══ This menu option, when selected, will apply the Strikeout font attribute to the currently selected text, or from the cursor location onwards. Attribute commands embedded further along in the document are not affected. ═══ 14.6. Outline (Menu Option) ═══ This menu option, when selected, will apply the Outline font attribute to the currently selected text, or from the cursor location onwards. Attribute commands embedded further along in the document are not affected. ═══ 14.7. Caps (Menu Option) ═══ This menu option, when selected, will apply the Caps font attribute to the currently selected text, or from the cursor location onwards. Attribute commands embedded further along in the document are not affected. ═══ 14.8. Expand 50% (Menu Option) ═══ See Expand 100% for more information. ═══ 14.9. Expand 75% (Menu Option) ═══ See Expand 100% for more information. ═══ 14.10. Expand 100% (Menu Option) ═══ The Expand options, when selected, apply an expansion factor to the currently selected text or from the cursor location onwards. Expansion codes embedded further along in the document are not affected and expansion codes are not cumulative. ═══ 14.11. Expand 125% (Menu Option) ═══ See Expand 100% for more information. ═══ 14.12. Expand 150% (Menu Option) ═══ See Expand 100% for more information. ═══ 14.13. Expand 175% (Menu Option) ═══ See Expand 100% for more information. ═══ 14.14. Expand 200% (Menu Option) ═══ See Expand 100% for more information. ═══ 15. Color Menu ═══ From this menu you may choose a color to be applied from the cursor location onwards (until the next change), or over the currently selected text. This option chooses the text color, not its background color. The color currently active at the cursor location is check-marked. ═══ 16. Window Menu ═══ From the Window Menu several document window manipulation functions are available, along with a list of all the document windows currently open. The following commands are available: ■Tile ■Cascade ■Arrange Icons ═══ 16.1. Tile (Menu Option) ═══ This command arranges the non-minimized document windows so that all are completely visible, and so that all the minimized document icons are also visible at the bottom of the workspace. The minimized document icons are rearranged as necessary. ═══ 16.2. Cascade (Menu Option) ═══ This command arranges the non-minimized document windows so that they are as large as they can be, yet still have all their titles showing and so that all the minimized document icons are also visible. The minimized document icons are rearranged as necessary. ═══ 16.3. Arrange Icons (Menu Option) ═══ This command will rearrange the minimized document window icons to the bottom-left of the workspace. This is done automatically when the Tile and Cascade commands are executed. ═══ 17. Help Menu ═══ The Help Menu has been set up in the SAA standard format, providing the following commands: ■Help Index ■General Help ■Using Help ■Keys Help ■Product Information ═══ 17.1. Help Index (Menu Option) ═══ Selecting this menu option will cause the help library index to be displayed. ═══ 17.2. General Help (Menu Option) ═══ Selecting this menu option will display general information about the application. ═══ 17.3. Using Help (Menu Option) ═══ Selecting this menu option will display the basic information on how to use the Help Facility. None of this information is specific to this application. ═══ 17.4. Keys Help (Menu Option) ═══ The following function key assignments have been made for use within the PM Word Processor. Every effort has been made to conform with the SAA CUA standard, as I understand it. There's been an incredible lack of documentation available (to me) on the matter. F1 - Display help information F2 - Save Current Document F3 - Exit F4 - Save and Close Current Document F10 - Menu Ctrl+O - Open Document Ctrl+P - Print Entire Document Alt+P - Print Current Page Ctrl+N - Set Normal (Reset Text Attributes) Ctrl+B - Set Bold Ctrl+I - Set Italic Ctrl+U - Set Underscore ═══ 17.5. Product Information (Menu Option) ═══ Selecting this menu option will cause the program's Product Information and Copyright dialog to be displayed. See Product Information (Dialog) for more information. ═══ 17.6. Product Information (Dialog) ═══ This dialog box displays the program name, icon and copyright information. To exit the dialog, press the ENTER key, the SPACE bar or the ESCAPE key, or click on the OK button with the mouse. ═══ 18. Set Profile Path ═══ This dialog is displayed when the program cannot find its profile (INI) file, and asks you where the file is or where it is to be created. Only a valid existing directory name will be accepted. Once you have entered the name, press the ENTER key or click on the OK button for the program to continue. If you wish to abort the program's initialization sequence, press the ESC key or click on the escape button. ═══ 19. Save Confirm (Dialog) ═══ If this dialog has been displayed, then you are attempting to save your document with a new name over a file that already exists. If you really wish to replace the already existing file, then either press the 'Y' key or click on the Yes button. If you do not wish to replace the file on disk, simply press Enter or the 'N' key. In this case, your document will not have been saved, and you will have to try again giving a different name. ═══ 20. Class Registration Error ═══ If this message has been displayed, the application could not register one of its window classes properly. Try shutting down your system and restarting it. If the problem persists, notify the application programmer. ═══ 21. Save Changed Document? ═══ You are trying to exit the program or close a document window, but you have changes to the current document which have not yet been saved. Answer 'Y'es or click on the YES button if you wish to save the changes to the current file name. Answer 'N'o or click on the NO button if you do not wish to do so (you don't care about the changes). Press the ESC key or click on the Escape button if you wish to abort the program termination or document close operation in progress. ═══ 22. Help Manager Error ═══ If this message has been displayed, then something's wrong with the application help file. Please inform the application programmer. ═══ 23. File Not Named ═══ You have attempted to do a normal file save on new document that has not been given a file name yet. You must save this document with the Save As... command on the File menu. ═══ 24. Out Of Memory ═══ You have attempted to copy a block of text or graphics that is too large. There was insufficient memory to hold a copy of the block for the system clipboard.