NAME

       amiwm - Amiga Workbench-like X Window Manager

SYNOPSIS

       amiwm

DESCRIPTION

       amiwm is an X Window manager that tries to make your workstation look like an Amiga®

OPTIONS

       Amiwm  is  configurable with a $HOME/.amiwmrc-file containing some or all of the following
       options:

FastQuit: {yes|no}

       Specifies whether amiwm should quit directly when the Quit menu item is  selected,  rather
       than popping up a requester.  (on/off or true/false can be used instead of yes/no.)

SizeBorder {right|bottom|both|none}

       Specifies which border should be enlarged when a sizegadget is present.

ForceMove {manual|auto|always}

       Enables  you to move windows outside the perimeter of the root window when pressing shift,
       when trying to drag at least 25% of the window ofscreen, or always, respectively.

IconDir path

       Specifies a directory in which amiwm will look for icons.

DefaultIcon name

       Gives the filename of the .info file to use as a default icon.   It  is  relative  to  the
       IconDir.

IconPalette {system|magicwb|schwartz|“filename"}

       Selects  either the Workbench® default palette, or the MagicWorkbench standard palette for
       use with icons.  The third option is a  16  color  palette  used  on  the  "Eric  Schwartz
       Productions  CD  Archive".   Alternatively,  the  filename  of a PPM file representing the
       palette to use can be used.

ScreenFont “fontname"

       Selects a font to use for windowtitles etc.

IconFont “fontname"

       Selects a font for icontitles.

{detailpen|blockpen|textpen|shinepen|shadowpen|fillpen|filltextpen|

               backgroundpen|highlighttextpen|bardetailpen|barblockpen|
               bartrimpen} “colorname"

       Modifies the colour scheme for the window manager.

ToolItem “name" “command" “hotkey"

       Adds an item in the Tools menu with the specified name, which executes  the  command  when
       selected.   A  string  containing  a single uppercase letter may be specified as the third
       argument, making this letter a hotkey for the item.

ToolItem Separator

       Inserts a separator bar in the Tools menu.

ToolItem “name" { <tool item commands>}

       Create ToolItem:s in a submenu with the specified name.  It  is  not  legal  to  create  a
       submenu inside another submenu.

Screen [<number>] “name"

       Create  a new screen with the specified name.  It will be placed below all earlier created
       screens.  To move a window between two screens, iconify it and drag the icon over  to  the
       other screen.  If the second argument is given, this screen is placed on the corresponding
       X screen.

ModulePath “path(:path...)"

       Sets one or more directories where amiwm will look for module binaries.   The  default  is
       AMIWM_HOME.    Note   that   the  module  binaries  cannot  be  shared  amongst  different
       architectures.

Module “name" ["initstring"]

       Start a module with the specified name.  If initstring is specified, it  is  sent  to  the
       module.   There  are  currently  two  modules shipped with amiwm; Background and Keyboard.
       These are documented in the file README.modules.  If a  module  is  limited  to  a  single
       screen, like the Background module, the screen that was created last is used.

InterScreenGap number

       Sets the size in number of pixels of the "video DMA off" area that appears between screens
       when they are dragged.

AutoRaise {yes|no}

       Selects whether windows will automatically be moved to the front when they are activated.

Focus {followmouse|sloppy|clicktotype}

       Sets the policy by which windows are given focus.  Followmouse is the  default  and  means
       that  the  window  that contains the mouse pointer will have focus.  Sloppy means that the
       window that had focus  last  will  keep  it  when  the  pointer  is  not  over  a  window.
       ClickToType  is  the original AmigaOS policy in which you have to explicitly give focus to
       windows by clicking in them.

TROUBLESHOOTING

       The most likely reason for amiwm to crash is if it can't find its default icon, or if this
       is  not accepted as a *.info file.  If this happens, amiwm _will_ dump core.  So make sure
       that either 'make install' runs successfully (in which case amiwm will know where its icon
       is), or that the file .amiwmrc contains a correct specification of the icon's location.

FILES

       $HOME/.amiwmrc
       $AMIWM_HOME/system.amiwmrc

COPYRIGHT NOTICES

       This  program  is distributed as freeware. The copyright remains with the author.  See the
       file LICENSE for more information.  Amiga and Workbench are registered trademarks of AMIGA
       International Inc.

AUTHOR

       Marcus Comstedt, marcus@lysator.liu.se

                                           14 Mar 1998                                   amiwm(1)