.f3                              - # -         Chapter 3 - Starting Word Fugue
.rm70
.mt5
.mb5
.pl66
.tc
.tc 3. STARTING WORD FUGUE ................................#
3. STARTING WORD FUGUE

When you start Word Fugue, you can create new files, edit old files,
and apply macros to the files you load. You can open multiple files,
and even search for the file you want.

.tc    Creating a New File ................................#
  Creating a New File

  To create a new text file, type

       WF filename

  at the DOS prompt, where "filename" is the name you want to give to
  the new file. Include a disk drive specification, extension, or
  pathname, if necessary.

  Word Fugue will load up, display a comment New File at the top of
  the screen, and display the editing screen ready for you to enter
  text.

  Alternatively, you can load up Word Fugue without entering the file
  name by typing

      WF  <Enter>

  Word Fugue will load up, display a comment New File at the top of
  the screen, and display the editing screen ready for you to enter
  text. The file name will be set to <none>, and you will be prompted
  for a file name if you try to save it or exit.

.tc    Loading an Existing File ...........................#
  Loading an Existing File

  To load an existing file, type

       WF filename

  at the DOS prompt, where "filename" is the name you want to edit.
  Include a disk drive specification, extension, or pathname, if
  necessary.

  Word Fugue will load up and display the editing screen ready for you
  to enter text.

  Alternatively, you can load up Word Fugue without entering the file
  name by typing

      WF  <Enter>

  Word Fugue will load up, display a comment New File at the top of
  the screen, and display the editing screen ready for you to enter
  text. Press F3 (see below Edit New file), and you will be prompted
  for the name of the file to edit. Press Enter after entering the
  file name, and the file will be loaded.

.cp5
.tc    Saving a File ......................................#
  Saving a File

  There are a number of ways to save a file, depending on whether you
  wish to continue editing a new file, or finish.

.tc       Save and Exit ...................................#
    Save and Exit

    This is used if you wish to save your work and terminate the
    program.

    Press F10, and all changed files will be saved automatically, and
    the program will terminate. Altrnatively, you can press Ctl K X,
    which is a Wordstar command.

.tc       Edit a New File .................................#
    Edit a New File

    This command is used if you wish to edit a new file, and to be
    prompted to save the old file if it has been changed. If the old
    file has not been changed, you will not be prompted about saving
    it.

    Press F3 and you will be prompted for the name of the file to
    edit. Press Enter after entering the file name, and the file will
    be loaded if it exists, or created if it does not.

.tc       Save and Edit New File ..........................#
    Save and Edit a New File

    This works the same as the equivalent WordStar command - it always
    saves the file, regardless of whether the program thinks the file
    has been saved.

    Press Ctrl K D, and the file will be saved. You will then be
    prompted for the name of the next file to edit.

.tc       Save and Continue Editing .......................#
    Save and Continue Editing

    To save a file and continue editing it press Ctrl K S or F9. word
    fugue will save the file, and you will be able to continue editing
    it. It is advisable to do this on a regular basis, in case a power
    failure or similar stops your machine. Regular saving of your work
    will prevent you losing an entire days' work.

.tc       Save As Different File and Continue Edit ........#
    Save As Different File and Continue Edit

    This writes the changed file out to disk as a different file, and
    then continues editing the file under the new name. This is very
    useful if you have to create a file that is similar to another
    one. You accomplish this by pressing Ctrl K A or by pressing Shift
    F9.

    If you change your mind when the filename prompt appears, press
    ESC.

.cp6
.tc    Abandon Changes ....................................#
  Abandon Changes

  Sometimes you wish to abandon the changes to a file.

  For a single file, press F3, Edit Another file, and you will be
  prompted to save the current file. Enter N for no.

  To abandon all files and exit, press Ctrl K Q. You will be prompted
  to save each file that has been changed. In each case, press N for
  no. Once all files have been abandoned, the program will terminate.

.tc    Loading Multiple Files .............................#
  Loading Multiple Files

  You can load multiple files by including their names on the command
  line separated by spaces. If you type the same file name more than
  once, you will have several windows onto the same file. (Not
  multiple copies, but one file with several window. See the chapter
  on Window for more information)

  For example

  WF  fred zap          will load files FRED. and ZAP. with a window
                        onto each.

  wf  fred zap fred     will load files FRED. and ZAP. with one window
                        on ZAP., and 2 windows on FRED.

.tc    Searching For a File ...............................#
  Searching For a File

  You can search for a file if you are not sure of its name by
  entering Wild Card characters * and ? in the name. ? represents a
  single character, while * stands for any number of characters.

  If you enter a wild card file name, Word Fugue will not open any
  other files if their names appear after the wild card file name. If
  you wish to open multiple files, you should put the ones you know
  first, and the wild card file name at the end of the list.

  For example

  WF  FRED.*            will look for a file with a name of FRED.
                        followed by any extension. It would thus match
                             FRED.
                             FRED.1
                             FRED.TXT
                        and so on.

  WF FRED.?             will look for a file with a name of FRED
                        followed by a single character. It will match
                        FRED.1 and FRED.2, but not FRED.TXT

.tc    Applying Macros At Startup .........................#
  Applying Macros At Startup

  When Word Fugue is first started, it looks for a macro file WF.MAC
  in the default directory, as well as the installed Home directory.
  (See the chapter on macros for further information on macros.) If
  you include on the parameter line + followed by a macro identifier
  (0 - 9 A - Z), that macro will be invoked. You can place as many
  macros as you like on the parameter line (subject to DOS limits),
  and each will be invoked. If you have several file names on the
  parameter line, the macros will be applied to the file name they
  follow.

  For example:

  WF +m                 Loads an empty file and applies the macro M to
                        it.

  WF fred +a            Loads the file FRED. and applies macro A to
                        it.

  WF fred +a zap +m +p +1  Loads the file FRED. and applies macro A to
                        it, and then loads the file ZAP. and applies
                        the macros M, P and 1 to it.

.tc    Run Time Options ...................................#
Run Time Options

Run time options are entered on the command line along with file names
and macro names. They should be separated from file names and macros by
at least one space.  Each run time option is prefixed by a forward
slash (/).

Use Black and White      /B

This option specifies that Word Fugue is to use the black and white
colors despite what the video adapter appears to say. This is used
when you have a color adapter connected to a black and white (or green
and white ...) video monitor. Normally, if Word Fugue detects a video
monitor in color mode, it will use colors instead of black and white.
However, if you place /B (must be capital letter) on the command line,
you will override the automatic selection.

Use BIOS for Screen IO     /G

For speed in screen updates, Word Fugue writes directly to screen
memory instead of going through the BIOS. However, not all IBM
compatibles have the screen hardware compatible with direct access
techniques. For these situations, it is necessary to go through the
BIOS, with the consequent loss of speed for screen updates. If you
place /G on the command line, Word Fugue will always use BIOS, which
means that computers that are otherwise incompatible because of their
screen architecture can run Word fugue.

Use BIOS but Replace Hardware Cursor With Software Cursor     /Q

This option works similarly to /G above, but instead of using the
machine's cursor, it replaces it with a solid block of color. Simply
place /Q on the command line.

During BIOS screen IO, the cursor must be positioned at each character
location for the character to be written. If the cursor were not
turned off during this operation, it would appear to move all over the
screen. However, turning the cursor off means that it disappears for a
period of time. On some of the older and slower machines, this means a
noticable time delay, and can be annoying. Replacing the hardware
cursor with a solid block of color can alleviate this effect. This can
be achieved either by use of /Q, or by means of /G and using the
configurable options to turn the Block Cursor on. This option is on
the Display options sub menu of the Options menu of the pulldown menu.

Example

   WF  myfile /B/G              edit file MYFILE and use the black and
                                white set of colors. also use BIOS for
                                all screen IO

   WF myfile /G +m              edit file MYFILE and use BIOS for
                                screen IO. apply macro m to the file
                                once it is loaded.
