Home

wmoo

wmoo
Current Version is 0.1

 wmoos

Contents

Please submit any questions, comments or bugs to: [email protected]

Introduction
Getting the Software
Compiling and Installation
Using wmoo
Configuring
Contributors

Introduction

wmoo is a simple application to enable the OpenOffice Quickstart in the WindowMaker dock.
It start a background OpenOffice task and check every minute if it is still alive. Furthermore it makes you available four icons to launch the related applications.
There is two icons set, one for OpenOffice and one for StarOffice.

Back to Contents


Getting the Software

Currently wmoo is available as a source tarball

wmoo Download wmoo as tgz wmoos

and as debian binary

Back to Contents


Compiling and Installation


   Extract the archive:
        tar -xvzf wmoo-0.1.tgz

   Enter the wmoo directory and edit the Makefile:
        cd wmoo-0.1/
        vi Makefile

   The Makefile should be fairly straight forward. You may need
   to change the INCDIR and LIBDIR variables to point to their
   correct locations.
   Particular libraries required:
   libgtop1 (to run)
   libgtop1-devel (to compile)
   XFree86-devel (to compile)

   Make the binary:
        make

   Install the binary:
        make install

   This will copy the binary to /usr/X11R6/bin with appropriate
   permissions. This destination directory may be changed by
   changing the DESTDIR variable at the top of the Makefile.

Back to Contents


Using wmoo

Usage:
  wmoo [OPTIONS]

  -f, --rcfile [arg]  	absolute path of configuration file
  -i, --iconpath [arg]	path to search for icons (paths separated by :'s)
  -d, --debug         	dump debug information to stderr
  -V, --version       	show version information
  -w, --window       	causes the dockapp to be run in windowed mode
  -h, --help          	show usage information (this info)

Defaults:
  rcfile=~/.wmoorc
  iconpath=/usr/share/icons/wmoo

Back to Contents


Configuring

By default, wmoo looks for it's configuration in ~/.wmoorc. This can be changed on the command line using the -f or --rcfile argument. The configuration format is fairly simple.

[quickstart]
icon = name of the bottom icon.
command = launches the application in background.
check = string to check if the background is alive.

[swriter][scalc][simpress][sdraw]
icon = name of the command icon.
command = program that starts when you click on the icon.

    # /home/piera/.wmoorc
    [quickstart]
    icon = oo_logo.xpm
    command = /usr/lib/office60/program/soffice -plugin -quickstart &
    check = soffice.bin

    [swriter]
    icon = oo_swriter.xpm
    command = /usr/lib/office60/program/soffice private:factory/swriter &

    [scalc]
    icon = oo_scalc.xpm
    command = /usr/lib/office60/program/soffice private:factory/scalc &

    [simpress]
    icon = oo_simpress.xpm
    command = /usr/lib/office60/program/soffice private:factory/simpress &

    [sdraw]
    icon = oo_sdraw.xpm
    command = /usr/lib/office60/program/soffice private:factory/sdraw &

There are a few things you should take note of in this example. First each command ends in an ampersand (&) character. This is to run the process in the background, therefore returning control to wmoo. If you leave this out, when you press that button wmoo won't respond to anything until that process exits. Second, the icons don't have paths. You may specify an absolute path with the icon name, however using the -i or --iconpath argument is more convienient. The icons specified should be 16x16, or things will get really ugly! For a more detailed example see the sample.wmoorc included with the distribution. Third, and very important, in all the command tags change the path only, unless you use very customized wrappers

Back to Contents


Contributors

I'd like to thank all those who have sent in comments, requests, patches, etc.
Piera "Vampiera" Poggio
Gianluca "Kosta" Costantini -- translations
Davide "Dadda" Gambarelli -- Beta Test
Adrian Neumaier -- debian binary and man

Back to Contents


Home