10.0;wc (window_close) *DM*, revision 1.0, 87/12/23
wc (window_close) close window and associated functions
usage: wc [entry_name [-q | -f | -a | -s]]
DESCRIPTION
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
leaves the pad open. However, if there are no other windows into the pad,
the DM closes it. The DM then either deletes the closed pad (if it was
temporary) or saves it under its pathname (if it was named and permanent,
that is, 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 filename. 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 SAVE keys (see below).
You normally cannot close a transcript (output) window if it is the last
window into an active process (see -f below).
Note that the DM cannot delete a permanent pad (file).
Three keys are predefined to perform related functions:
pw;wc -q (or) <EXIT> (r5)
Close window, pad; update file
wc -q (or) <ABORT> (r5s)
Close window, pad; ignore changes
pw;ro (or) <SAVE> (r4s)
Save pad and put it in read-only mode; do not close
it
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 you do not specify an option, wc closes the window and pad, then
deletes the pad (if temporary) or rewrites it (if permanent) as described
above. You can specify only one of the following options at a time.
-q Quit without updating the pad (file). The DM ignores any
changes made while the window was open. The DM prompts you
with "File modified. OK to quit?" if you made changes, to
verify that you really wish to discard them.
-f Force window closure, even if this window is the last one open
into a process. However, the process becomes inaccessible if
no windows are left.
-a Enable auto-close for the current window. When auto-close is
enabled, the current window closes when the pad into which it
looks is closed.
-s Disable auto-close for the current window. If auto-close is
disabled (the default condition), the current window persists
after the pad into which it looks is closed.
SEE ALSO
More information is available. Type the following at an Aegis shell
prompt:
help windows For general information about windows
help dm commands For a list of other window management commands