9.5;wc (window_close) *DM*, revision 9.5, 86/09/25
WC (WINDOW_CLOSE) -- Close window and associated functions.
usage:  wc [entry_name] [-q | -f | -a | -s]


FORMAT

  WC [entry_name] [-Q | -F | -A | -S]


  The  WC  command closes (deletes) a window or window group.  It may also close
  the pad into which the window looks, depending on the following conditions.

  If other windows into the pad besides the  one  being  closed  exist,  the  DM
  naturally  leaves  the  pad open.  If there are no other windows into the pad,
  however, the DM closes it.  The closed pad is then either deleted (if  it  was
  temporary) or saved under its pathname (if it was named and permanent, i.e., a
  permanent disk file).

  If the pad is a writable edit pad,  and  is  being  viewed  only  through  the
  current window, the DM renames the old file by appending .BAK to its name, and
  writes the edited version to the original file name.  If multiple windows  are
  viewing  the  edit  pad,  WC simply closes the window -- it does not write the
  file or rename the old file.  To force the DM to write the file and create the
  .BAK  version,  use the DM command PW (PAD_WRITE) or the <EXIT> or CTRL/Y keys
  (see below).

  A transcript (output) window normally cannot be  closed  if  it  is  the  last
  window into an active process (see -F below).

  Note  that the DM cannot delete a permanent pad (file); you must use the Shell
  command DLF (DELETE_FILE) for this purpose.

  Two keys (or control/key sequences) have been predefined  to  perform  related
  functions:

                      low-profile     880

  PW;WC -Q    (or)    <EXIT>  (R5)    CTRL/Y           Close window, pad;
                                                        update file

  WC -Q       (or)    <ABORT> (R5S)   CTRL/N           Close window, pad;
                                                        ignore changes


ARGUMENTS

  entry_name
  (optional)          Specify  the  name  of  the  window  or window group to be
                     closed.  If the name of the window or group  appears  as  a
                     text  string  somewhere  on  the  display,  you may use the
                     following time-saving feature:  place  the  cursor  on  the
                     name,  then  press  <MARK>.   Now issue the WC command.  WC
                     uses the MARKed name for the 'entry_name' argument.

                     Default if omitted:  close the window under the cursor.


OPTIONS

  If no options are specified, WC closes the window and pad,  then  deletes  the
  pad (if temporary) or rewrites it (if permanent) as described above.  Only one
  of the following options may be specified at a time.

  Default options are indicated by "(D)."

  -Q                 Quit without updating pad (file).  Any changes  made  while
                     window  was  open are ignored.  The system prompts you with
                     "File modified. OK to quit?" if you have  made  changes  to
                     verify that you really wish to discard them.

  -F                  Force window closure, even if this window was the last one
                     open into a process.  Note that  the  process  will  become
                     inaccessible, however, if no windows are left.

  -A                  Enable  auto-close for current window.  When auto-close is
                     enabled, the current window will close when  the  pad  into
                     which it looks is closed.

  -S           (D)    Disable  auto-close  for current window.  If auto-close is
                     disabled (the default condition), then the  current  window
                     persists after the pad into which it looks is closed.


RELATED TOPICS

  More information is available.  Type:

  - HELP WINDOWS
   for general information about windows.

  - HELP DM COMMANDS
   for a list of other window management commands.