10.0;cpb (create_paste_buffer) *DM*, revision 1.0, 88/03/17
cpb (create_paste_buffer) display a list of the windows in a group
usage: cpb group_name [-i [-c 'char']]
DESCRIPTION
The cpb command creates a window on a named paste buffer specific to the
given group. The paste buffer contains a list of the windows in the
group. Because these group lists are held in paste buffers, your
programs can access the groups by using the pbufs routines described in
the Domain System Call Reference.
The DM automatically creates three special paste buffers to help you
manage your windows and icons. These paste buffers contain the following
groups:
- The invis_group. This buffer holds the pathnames of all the windows that
you have made invisible.
- The icon_group. This buffer holds the pathnames of all the windows that are
represented by icons.
- The all_group This buffer holds the pathnames of every window open on
your node: shell process windows, DM windows, visible and invisible windows, and
windows represented by icons.
These special groups are created regardless of any other groups, and
their members may overlap with the members of any other group (just as
any group can have the same member(s) as another).
A special feature of the cpb command allows you to access the windows in
a group directly, when the paste buffer holding the group is displayed on
your screen. To use this feature do the following:
1. Use the cpb command to display the list of windows.
2. Position the cursor on the pathname of the window you want to
access.
3. Press <CMD>, and issue the dr (mark) command.
4. Press <CMD> again, and issue the desired DM command.
By using this feature you can directly access windows that are invisible,
represented by icons, and so on.
ARGUMENTS
group_name (required)
Specify the name of the group you want to display.
OPTIONS
-i Specify that the window created will be in icon format.
-c 'char' Specify the icon character to be used in the icon
window. char must reside in the current icon font. If
you do not specify this option and -i is present, the DM
uses the default icon character for this pad type.
SEE ALSO
More information is available. Type the following at an Aegis shell
prompt:
help wgra For information on creating window groups
help icon For information on creating icons