kappdock"> ]> Henning Burchardt

h_burchardt@gmx.net

2001 Henning Burchardt 2001-02-11 0.04.04 Kappdock is a tool for KDE 2 that is able to swallow small X-applications KDE Kappdock WindowMaker embed Kappdock is a tool for KDE 2 that can swallow small X-applications, including WindowMaker dock applets. Please report any problems or feature requests to Henning Burchardt h_burchardt@gmx.net Kappdock can be found on http://www.Informatik.Uni-Oldenburg.DE/~bigboss/kappdock/ or in the kdenonbeta package of KDE (e.g. on ftp://ftp.kde.org/pub/kde/unstable/CVS/snapshots/current/ ). In order to succesfully compile Kappdock, you need 2.x libraries (can be found on ftp://ftp.kde.org/pub/kde/ It is important that you have the qt and KDE headers installed, otherwise Kappdock will not compile. ). In order to compile and install Kappdock on your system, execute the following commands in the base directory of the Kappdock distribution: > ./configure > make > make install Note that the variables QTDIR and KDEDIR have to be set properly before you run ./configure. Example 1 (on a Redhat distribution): > export QTDIR=/usr/lib/qt-2.2.2 > export KDEDIR=/usr Example 2 (on a SuSE distribution): > export QTDIR=/usr/lib/qt-2.2.2 > export KDEDIR=/opt/kde2 Of course the path names might vary on your box. Please report any bugs or feature requests to Henning Burchardt h_burchardt@gmx.net Screenshot The main window contains several application frames which contains the embedded applications. If you right-click on one of the toolbars next to the appliction frames there will appear a menu with the following entrys: Start Executes the command of the application frame (see The Edit dialog). Stop Stops the command of the application frame (see The Edit dialog). This only works when Kappdock has started the process of the embedded application. If the process has been invoked outside of Kappdock this menu entry will be without effect. Edit... Shows the Edit Dialog. Delete If there are two ore more application frames, the frame which the popup menu belongs to will be deleted. In the other case nothing will happen. New... Create a new application frame. Preferences... Shows the Preferences dialog. Help Shows the documentation. About Shows information about Kappdock. Exit Exits the application after all settings are saved. Save Options Saves all settings. These include the position of Kappdock on the desktop, the position and settings of the application frames in the main window and everything you can change with the preferences dialog. You can drag the main window over the desktop by left-clicking on the drag bar and move the mouse pointer while holding the left mouse button pressed. If you want that Kappdock has a fixed position in one the edges of the desktop or that you can move it only along the left, right, upper or lower border of the screen, look at the Preferences Dialog. If there are two or more application frames you can arrange them by dragging them on their toolbar. Everytime you drag one application frame over another they change their position. Double-clicking on an application frame starts the application (if it is not already started). You can minimize Kappdock by klicking on the small arrow in the upper left of the window. To save space in the taskbar Kappdock has no entry there. Instead you can control it by a small system tray icon. Left-clicking on the icon will show and hide Kappdock, a right click will show the popup menu. The system tray icon can be disabled in the Preferences Dialog. Screenshot With the Edit dialog you can change settings of one application frame. It can be invoked by right-clicking on the toolbar next to the frame and selecting "Edit...". Icon select an icon for the application. You do not need that if you choose "run app on startup". Name If you want a tooltip to be shown on your application choose a name for it. Command The command to be executed when you double-click on the application frame or when you select "start" from the popup menu. Window title The window title of the application. You must choose a window title if you want your application to be swallowed. Select If you do not know the window title of the application you can try this button. First start the application you want to be swallowed, then click on the "Select" button, and finally click on the application window. Note that under KDE2 WindowMaker applets are minimized when they are started. So you have to click on their entry in the task bar before you click on the "Select" button. Clear clear the entrys "Icon", "Name", "Command" and "Window title". swallow app select this entry if you want to want a WindowMaker applet or another application to be embedded. only start app once Usually this checkbox is selected. Only uncheck it if you want to have several instances of an application (e.g. an editor). Of course, you should uncheck the "swallow app" checkbox then. run app on startup If you do not want to start the application by hand everytime select this entry. If the application is a WindowMaker applets this box should be checked. close app on exit select this checkbox if you want the application to be closed when Kappdock exits. Normally you should choose this with WindowMaker applets. Screenshot With this dialog you can alter global settings of Kappdock. Direction Choose "Vertical" if you want the application frames to be aligned from top to bottom and "Horizontal" if they should be aligned from left to right. Frame size Here you can change the width and the height of the application frames. Horizontal position This option determines how the main window can be moved horizontally. If you choose "left" ("right") it can only be moved along the left (right) border of the desktop. The main window can be moved freely in horizontal direction if you select "free". Vertical position This option determines how the main window can be moved verically. If you choose "top" ("bottom") it can only be moved along the upper (lower) border of the desktop. The main window can be moved freely in vertical direction if you select "free". Position of toolbar Here you can choose the position of the toolbar of the application frames. Style If you do not like the default KDE background color for kappdock you can choose a style here. A style contains a set of pixmaps for the application frames and the tool bars. You can find some hints for creating styles in the file $KDEDIR/share/apps/kappdock/styles/sample.stylerc. Show systray icon Here you can disable the systray icon. Note that you cannot hide kappdock without it.