wsm(1X)

NAME
wsm—Motif Workspace Manager demo

SYNOPSIS
wsm [options]

DESCRIPTION
The Motif Workspace Manager (Wsm) uses the new Workspace Manager protocol supported in the Motif Window Manager (Mwm) 2.0. This application will only work with Mwm Version 2.0.

Wsm provides a way for users to group windows and applications into workspaces or rooms. Only one room or workspace is visible at one time. By only viewing windows in one workspace at a time, your desktop can be greatly reduced of clutter.

With Wsm, it is possible to have one window duplicated in multiple workspaces. These duplicates can be either references to each other, where the width, height, stacking order and other attributes are kept the same in each workspace, or they can be copies, where each instance can have a different position, size, or other attribute from its counterparts in the other workspaces. The term Link is used to refer to duplicates that each reference the same set of attributes. The term Copy is used to refer to duplicates that contain their own attribute sets independent from each other.

There are two methods of accessing all the functionality of the workspace manager. The first is through commands added by Wsm to Mwm menus. The second is through the interface provided through the initial Wsm dialog.

  Options
Wsm supports the following command-line options:

-fileName, -file, -f Specifies the name of the workspace
                        manager configuration file.

-workspaceList, -wL Specifies the list of workspaces
                        to use.

-backgroundList, -bL Specifies the background color
                        to apply to each of the workspaces.

-labelPixmapList, -labelPL
                        Specifies the label image to
                        use for each of the workspace
                        buttons.

-currentWorkspace, -cW Specifies the default workspace
                        from the list of workspaces.

-showWSDialog, -s If True, a menuBar is displayed
                        in the Wsm main dialog window.
                        The default is True.

  The Mwm Menu Interface
Wsm will add menu entries to Mwm's menus that provide you with the needed tools to use the capabilities of Wsm. Each window menu will be modified by adding the following items:

Occupy... This will display a dialog window
                        allowing you to select which
                        workspaces the associated window
                        should be duplicated into.
                        The dialog also allows either
                        Link or Copy the window
                        to each of the selected workspaces.

Copy To All This will cause the window to be
                        copied to each of the workspaces.

Link To All This will cause the window to be
                        linked to each of the workspaces.

Remove From Workspace This will remove the window from
                        this workspace. If the window is
                        only in one workspace, then this
                        command will be inactive. It is
                        not possible to remove a window
                        from all workspaces using this
                        command.

Wsm will modify the root menu (specified by Mwm's resource rootMenu) by adding the following commands:

Switch Workspace This is a cascade menu which
                        will cascade to a menu containing
                        an entry for each workspace. Selecting
                        an item will cause Wsm to swith
                        to the corresponding workspace.

Hide Workspace Manager
(Show Workspace Manager)
                        This will cause the workspace to be
                        unmapped (mapped) and the menu item
                        label to be switched to
                        Show Workspace Manager
                        (Hide Workspace Manager).

  Wsm Dialog Interface
The Wsm dialog window contains a menu bar and a rowcolumn contining a toggle button associated with each workspace. A popup menu can also be displayed by pressing Button3 in the rowcolumn area.

The menu bar contains the following:

File
----

Save Saves the state of the workspace
                        manager and the information it
                        holds for each window.
                        The data is stored in the workspace
                        manager configuration file which, by
                        default, is $HOME/.wsmdb.

Save As... Prompts for the name of the file
                        to save the workspace manager
                        data into.

Quit Terminates the workspace.
                        Note that there may be
                        a slight delay before the
                        workspace manager fully
                        terminates since it does some
                        cleaning-up of Mwm's menus
                        and removes the items it added.

Workspace
---------

New Workspace Creates a new workspace and
                        adds to associated toggle
                        button to the rowcolumn.

Rename Workspaces... Displays a dialog window
                        you to rename each of the
                        workspaces. It also allows
                        you to enter a fully qualified
                        bitmap to use as the label
                        instead of the name.

Set Background... This displays a dialog that
                        allows you to specify the
                        background color of the workspace.

Configure Workspaces... This displays a dialog that
                        allows you to move windows
                        from one workspace to another.
                        In the dialog, two lists are
                        displayed. On top of each list
                        is an option menu that allows
                        you to select the corresponding
                        workspace for the windows
                        in the list. By selecting a
                        window or windows in the left
                        list, you can copy or move the to
                        the workspace specified in the
                        list on the right. By selecting
                        Remove, you can, instead,
                        remove them from the workspace
                        on the left. The buttons at the
                        bottom, Client and
                        Window, will cause either
                        all windows for a client to
                        automatically be selected,
                        or individual windows.

Delete Workspaces... This displays a dialog prompting
                        you to select the workspace(s)
                        you with to delete.

View
----

Hide Workspace Manager This will cause the workspace
                        manager to unmap. Make sure that
                        Wsm has inserted the command
                        Hide Workspace Manager
                        into your root menu. If not, then
                        you will not be able to restore
                        the workspace manager.

The popup menu, displayed by pressing Button3 in the workspace rowcolumn contains the following items and matches the descriptions above:

        New Workspace
        Rename Workspaces...
        Set Background...
        Configure Workspaces...
        Delete Workspaces...
        -------------------
        Hide Workspace Manager
        -------------------
        Save
        Save As...
        -------------------
        Exit

Note, by default the workspace manager does not occupy all workspaces. You should select 'Copy To All' or 'Link To All' the first time Wsm is used. After you have saved your configuration, this is no longer necessary.

Wsm supports the following resources:

fileName Specifies the name of the workspace
                        manager configuration file.

workspaceList Specifies the list of workspaces
                        to use.

backgroundList Specifies the background color
                        to apply to each of the workspaces.

labelPixmapList Specifies the label image to
                        use for each of the workspace
                        buttons.

currentWorkspace Specifies the default workspace
                        from the list of workspaces.

useMenuBar If True, a menuBar is
                        displayed in the Wsm main dialog
                        window. The default is True.